MLHtmlHelp 함수
[이 함수는 Windows XP 및 Windows Server 2003을 통해 사용할 수 있습니다. 이후 버전의 Windows에서는 변경되거나 사용하지 못할 수 있습니다.]
현재 UI 언어 설정에 해당하는 도움말 창을 표시합니다.
HWND MLHtmlHelp(
_In_ HWND hwndCaller,
_In_ LPCTSTR pszFile,
_In_ UINT uCommand,
_In_ DWORD_PTR dwData,
_In_ DWORD dwCrossCodePage
);
-
hwndCaller [in]
-
형식: HWND
이 함수를 호출하는 부모 창에 대한 핸들입니다.
-
pszFile [in]
-
형식: LPCTSTR
컴파일된 도움말(.chm) 파일의 정규화된 경로 또는 지정된 도움말 파일 내의 토픽 파일이 포함된 버퍼에 대한 포인터입니다.
-
uCommand [in]
-
형식: UINT
완료할 명령입니다. 이 함수는 HH_DISPLAY_TOPIC 및 HH_DISPLAY_TEXT_POPUP만 직접 지원합니다. 다른 명령의 경우 dwCrossCodePage 값 없이 호출이 HtmlHelp에 전달됩니다.
-
dwData [in]
-
형식: DWORD_PTR
uCommand 매개 변수의 값에 따라 필요할 수 있는 모든 데이터입니다.
-
dwCrossCodePage [in]
-
형식:DWORD
CP_ACP 같은 현재 UI 언어 설정의 코드 페이지를 나타내는 DWORD 값입니다.
형식: HWND
지정된 uCommand 및 결과에 따라 MLHtmlHelp 은 다음 중 하나 또는 둘 다를 반환합니다.
- 도움말 창의 핸들(hwnd)입니다.
- NULL. 경우에 따라 NULL 은 실패를 나타냅니다. 다른 경우에 NULL 은 도움말 창이 아직 만들어지지 않았다는 것을 나타냅니다.
현재 언어의 도움말 파일 경로에 문제가 발생하면 표준 처리를 위해 HtmlHelp 에 호출이 전달됩니다.
도움말 창이 닫혀 있으면 소유자가 바탕 화면이 아닌 한 포커스가 소유자에게 돌아갑니다. hwndCaller가 데스크톱인 경우 운영 체제는 포커스가 반환되는 위치를 결정합니다.
또한 MLHtmlHelp이 도움말 창에서 알림 메시지를 보내는 경우 도움말 창 정의에서 알림 메시지 추적을 사용하도록 설정한 경우 메시지가 hwndCaller로 전송됩니다.
다음 예제에서는 HH_DISPLAY_TOPIC 명령을 호출하여 Help.chm이라는 도움말 파일을 열고 라는 Mainwin
도움말 창에 기본 항목을 표시합니다. 일반적으로 이 명령에 지정된 도움말 창은 표준 HTML 도움말 뷰어입니다.
HWND hwnd = HtmlHelp(GetDesktopWindow(),
"c:\\Help.chm::/Intro.htm>Mainwin",
HH_DISPLAY_TOPIC,
NULL,
CP_ACP);
참고
이 함수를 사용하는 경우 호스팅 실행 파일의 스택 크기를 100k 이상으로 설정합니다. 정의된 스택 크기가 너무 작으면 HTML 도움말을 실행하기 위해 만든 스레드도 이 스택 크기로 만들어지고 작업이 실패할 수 있습니다. 필요에 따라 링크 명령줄에서 /STACK을 제거하고 실행 파일의 DEF 파일에서 STACK 설정을 제거할 수도 있습니다(이 경우 기본 스택 크기는 1MB임). /Fnumber 컴파일러 명령을 사용하여 스택 크기를 설정할 수도 있습니다(컴파일러는 이를 링커에 /STACK으로 전달합니다).
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 |
Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
헤더 |
|
DLL |
|
유니코드 및 ANSI 이름 |
MLHtmlHelpW (유니코드) 및 MLHtmlHelpA (ANSI) |