萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML 腳本教學

Win32 SDK 建立三窗格 HTML Help 視窗:Workshop 與 API 兩種方法完整教學

兩種建立方式

  1. HTML Help Workshop:視覺化定義視窗類型,再由應用程式呼叫
  2. HTML Help API:程式碼直接建構 HH_WINTYPE 結構,動態建立視窗

方法一:使用預定義視窗

  1. 在 Workshop 中建立視窗定義(如 "mywindow")
  2. VC++ 專案包含 htmlhelp.h,連結 hhctrl.lib 或 htmlhelp.lib
  3. 呼叫 API:
void CMainFrame::OnHelp() {
    HtmlHelp(m_hWnd, "sample.chm::intro.htm>mywindow", HH_DISPLAY_TOPIC, 0);
}

方法二:API 動態建立三窗格視窗

HH_WINTYPE m_hhWinType;
ZeroMemory(&m_hhWinType, sizeof(HH_WINTYPE));
m_hhWinType.cbStruct = sizeof(HH_WINTYPE);

#define IDD_HELPTAB 69999

// 視窗屬性:三窗格、自動同步
m_hhWinType.fsWinProperties = HHWIN_PROP_TRI_PANE | HHWIN_PROP_AUTO_SYNC;

// 工具列按鈕
m_hhWinType.fsToolBarFlags = HHWIN_BUTTON_BACK | HHWIN_BUTTON_HOME | 
                             HHWIN_BUTTON_FORWARD | HHWIN_BUTTON_EXPAND;

// 檔案路徑(可用 chm:: 內部路徑)
m_hhWinType.pszFile = "intro.htm";
m_hhWinType.pszHome = "c:\\mypath\\intro.htm";
m_hhWinType.pszToc = "c:\\mypath\\contents.hhc";
m_hhWinType.pszIndex = "c:\\mypath\\index.hhk";

// 導覽窗寬度、初始狀態、標籤位置
m_hhWinType.iNavWidth = 175;
m_hhWinType.nShowState = SW_RESTORE;
m_hhWinType.curNavType = HHWIN_NAVTYPE_TOC;
m_hhWinType.tabpos = HHWIN_NAVTAB_TOP;
m_hhWinType.idNotify = IDD_HELPTAB;
m_hhWinType.pszCaption = "My Title";

// 指出哪些欄位有效
m_hhWinType.fsValidMembers = HHWIN_PARAM_STYLES | HHWIN_PARAM_PROPERTIES |
                             HHWIN_PARAM_RECT | HHWIN_PARAM_TB_FLAGS |
                             HHWIN_PARAM_NAV_WIDTH | HHWIN_PARAM_SHOWSTATE |
                             HHWIN_PARAM_TABPOS | HHWIN_PARAM_CUR_TAB;

m_hhWinType.pszType = "MyWindowName";

// 建立視窗類型
HtmlHelp(m_hWnd, "c:\\mypath\\sample.chm", HH_SET_WIN_TYPE, (DWORD)&m_hhWinType);

// 顯示主題
HtmlHelp(m_hWnd, "sample.chm>MyWindowName", HH_DISPLAY_TOPIC, 0);

VC++ 專案設定關鍵點

  1. 包含 Htmlhelp.h(位於 Workshop Include 目錄)
  2. 連結 Htmlhelp.lib(位於 Workshop lib 目錄)
  3. 若出現 LIBCMT 衝突警告:專案設定 → Link → Input → Ignore Libraries 加入 LIBCMT

參考資源

微軟知識庫 Q189084:HOWTO: Create a Tri-pane Window with HTML Help Workshop

copyright © 萬盛學電腦網 all rights reserved