영어로 읽기

다음을 통해 공유


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_TOPICHH_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
Shlwapi.dll(버전 5.0 이상)
유니코드 및 ANSI 이름
MLHtmlHelpW (유니코드) 및 MLHtmlHelpA (ANSI)