共用方式為

WinHelpA 函式 （winuser.h）

  • 發行項

啟動 Windows 說明 （Winhelp.exe），並傳遞其他數據，指出應用程式所要求說明的本質。

語法

BOOL WinHelpA(
  HWND      hWndMain,
  LPCSTR    lpszHelp,
  UINT      uCommand,
  ULONG_PTR dwData
);

參數

hWndMain

類型：HWND

要求說明之視窗的句柄。 WinHelp 函式會使用此句柄來追蹤哪些應用程式已要求協助。 如果 uCommand 參數指定 HELP_CONTEXTMENU 或 HELP_WM_HELP，hWndMain 會識別要求說明的控件。

lpszHelp

類型：LPCTSTR

如有必要，包含路徑的 Null 終止字串位址，以及 WinHelp 的說明檔名稱將會顯示。

如果主題要顯示在次要視窗中，而不是在主要視窗中顯示，則檔名後面可以加上角括號（>）和次要視窗的名稱。 您必須在說明專案 （.hpj） 檔案的 [WINDOWS] 區段中定義次要視窗的名稱。

uCommand

類型：UINT

所要求的說明類型。 如需可能值的清單，以及它們如何影響值放在 dwData 參數中，請參閱一節。

dwData

類型：ULONG_PTR

其他數據。 所使用的值取決於 uCommand 參數 的值。 如需可能 dwData 值的清單，請參閱一節。

傳回值

類型：BOOL

如果成功，則傳回非零，否則傳回零。 若要擷取擴充的錯誤資訊，請呼叫 GetLastError。

言論

關閉要求協助的視窗之前，應用程式必須呼叫 WinHelp，並將 uCommand 參數設定為 HELP_QUIT。 在所有應用程式都完成之前，Windows 說明將不會終止。 請注意，如果您使用 HELP_CONTEXTPOPUP 命令啟動 Windows 說明，則不需要使用 HELP_QUIT 命令呼叫 Windows 說明。

如果從任何內容呼叫，但目前使用者，此函式會失敗。

下表顯示 uCommand 參數的可能值，以及 dwData 參數的對應格式。

uCommand 行動 dwData
HELP_COMMAND 執行 Help 巨集或巨集字串。 字串的位址，指定要執行之說明巨集的名稱。 如果字串指定多個巨集名稱，名稱必須以分號分隔。 您必須針對某些巨集使用巨集名稱的簡短格式，因為 Windows 說明不支援長名稱。
HELP_CONTENTS 在 .hpj 檔案的 [OPTIONS] 區段中，顯示 Contents 選項所指定的主題。 此命令是為了回溯相容性。 新的應用程式應該提供 .cnt 檔案，並使用 HELP_FINDER 命令。 忽視;設定為 0。
HELP_CONTEXT 顯示 .hpj 檔案之 [MAP] 區段中所定義之指定內容標識碼所識別的主題。 包含主題的內容識別碼。
HELP_CONTEXTMENU 顯示所選取視窗 說明 選單，然後在彈出視窗中顯示所選控件的主題。 DWORD 組陣列的位址。 每個配對中的第一個 DWORD 是控件識別碼，第二個是主題的內容標識符。 陣列必須以一對零終止，{0,0}。 如果您不想將說明新增至特定控件，請將其內容識別符設定為 -1。
HELP_CONTEXTPOPUP 顯示彈出視窗中 .hpj 檔案 [MAP] 區段中所定義之指定內容識別碼所識別的主題。 包含主題的內容識別碼。
HELP_FINDER 顯示 [說明主題] 對話框。 忽視;設定為 0。
HELP_FORCEFILE 確定 Windows 說明顯示正確的說明檔。 如果顯示不正確的說明檔，Windows 說明會開啟正確的說明檔案;否則，沒有任何動作。 忽視;設定為 0。
HELP_HELPONHELP 如果 Winhlp32.hlp 檔案可用，則顯示如何使用 Windows 說明的說明。 忽視;設定為 0。
HELP_INDEX 在 .hpj 檔案的 [OPTIONS] 區段中，顯示 Contents 選項所指定的主題。 此命令是為了回溯相容性。 新的應用程式應該使用 HELP_FINDER 命令。 忽視;設定為 0。
HELP_KEY 如果完全相符，則會在關鍵詞數據表中顯示符合指定關鍵詞的主題。 如果有一個以上的相符專案，則會顯示 [索引]，其中包含 [找到 主題] 列表框中所列的主題。 關鍵字字串的位址。 多個關鍵詞必須以分號分隔。
HELP_MULTIKEY 在替代關鍵詞數據表中顯示關鍵詞所指定的主題。 指定數據表腳注字元和關鍵詞之 MULTIKEYHELP 結構的位址。
HELP_PARTIALKEY 如果完全相符，則會在關鍵詞數據表中顯示符合指定關鍵詞的主題。 如果有一個以上的相符專案，則會顯示 [找到 主題] 對話框 。 若要顯示索引而不傳遞關鍵詞，請使用空字串的指標。 關鍵字字串的位址。 多個關鍵詞必須以分號分隔。
HELP_QUIT 通知 Windows 說明不再需要它。 如果沒有其他應用程式要求協助，Windows 會關閉 Windows 說明。 忽視;設定為 0。
HELP_SETCONTENTS 指定 Contents 主題。 當使用者按兩下 [說明] 檔案沒有相關聯的 .cnt 檔案時，Windows 說明會顯示本主題 按鈕。 包含 Contents 主題的內容識別碼。
HELP_SETPOPUP_POS 設定後續彈出視窗的位置。 包含位置數據。 使用 MAKELONG，將水平和垂直座標串連成單一值。 彈出視窗的位置就像在叫用彈出視窗時，滑鼠游標位於指定的點。
HELP_SETWINPOS 如果視窗最小化或記憶體中，則會顯示 [Windows 說明] 視窗，並依照指定設定其大小和位置。 HELPWININFO 結構位址，指定主要或次要說明視窗的大小和位置。
HELP_TCARD 指出命令適用於 Windows 說明的定型卡片實例。 使用位 OR 運算符，將此命令與其他命令結合。 取決於結合此命令的命令。
HELP_WM_HELP 顯示彈出視窗中由 hWndMain 參數所識別控件的主題。 DWORD 組陣列的位址。 每個配對中的第一個 DWORD 是控件識別碼，第二個是主題的內容標識符。 陣列必須以一對零終止，{0,0}。 如果您不想將說明新增至特定控件，請將其內容識別符設定為 -1。
 

注意

winuser.h 標頭會將 WinHelp 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 winuser.h
連結庫 User32.lib
DLL User32.dll
API 集 ext-ms-win-ntuser-misc-l1-5-1 （在 Windows 10 版本 10.0.14393 中引進）

另請參閱

HELPWININFO

MULTIKEYHELP