HtmlHelpA 함수(htmlhelp.h)

도움말 창을 표시합니다.

API 명령을 사용하여 도움말 창에 표시할 토픽, 도움말 창이 3개 창 도움말 뷰어인지 팝업 창인지, 컨텍스트 ID, HTML 도움말 URL 또는 키워드 링크(KLink) 조회를 통해 HTML 토픽 파일에 액세스해야 하는지 여부를 지정할 수 있습니다.

구문

HWND HtmlHelpA(
  [in, optional] HWND      hwndCaller,
  [in]           LPCSTR    pszFile,
  [in]           UINT      uCommand,
  [in]           DWORD_PTR dwData
);

매개 변수

[in, optional] hwndCaller

HtmlHelp을 호출하는 창의 핸들(hwnd)을 지정합니다. 도움말 창은 이 창에서 소유합니다.

도움말 창이 닫혀 있으면 소유자가 바탕 화면이 아닌 한 HtmlHelp 에서 소유자에게 포커스를 반환합니다. hwndCaller가 데스크톱인 경우 운영 체제는 포커스가 반환되는 위치를 결정합니다.

또한 HtmlHelp이 도움말 창에서 알림 메시지를 보내는 경우 도움말 창 정의에서 알림 메시지 추적을 사용하도록 설정한 경우 hwndCaller로 전송됩니다.

[in] pszFile

uCommand 값에 따라 는 컴파일된 도움말(.chm) 파일 또는 지정된 도움말 파일 내의 토픽 파일에 대한 파일 경로를 지정합니다.

창 형식 이름을 지정하고 앞에 보다 큰(>) 문자를 지정할 수도 있습니다.

지정된 명령에 파일이 필요하지 않은 경우 이 값은 NULL일 수 있습니다.

[in] uCommand

완료할 명령을 지정합니다.

[in] dwData

uCommand 매개 변수의 값에 따라 필요할 수 있는 모든 데이터를 지정합니다.

반환 값

지정한 uCommand 및 결과에 따라 HtmlHelp 은 다음 중 하나 또는 둘 다를 반환합니다.

• 도움말 창의 핸들(hwnd)입니다.
• NULL. 경우에 따라 NULL은 실패를 나타냅니다. 다른 경우에 NULL은 도움말 창이 아직 만들어지지 않았다는 것을 나타냅니다.

설명

구문은 ANSI 문자 집합에 적용됩니다. 유니코드 문자 집합을 사용하는 경우 pszFile 매개 변수의 형식은 "LPCTSTR"이어야 합니다.

HTML 도움말 API를 사용하는 경우 호스팅 실행 파일의 스택 크기를 100k 이상으로 설정합니다. 정의된 스택 크기가 너무 작으면 HTML 도움말을 실행하기 위해 만든 스레드도 이 스택 크기로 만들어지고 오류가 발생할 수 있습니다. 필요에 따라 링크 명령줄에서 /STACK을 제거하고 실행 파일의 DEF 파일에서 STACK 설정을 제거할 수 있습니다(이 경우 기본 스택 크기는 1MB임). /Fnumber 컴파일러 명령을 사용하여 스택 크기를 설정할 수도 있습니다(컴파일러는 이를 링커에 /STACK으로 전달).

예제

다음 예제에서는 HH_DISPLAY_TOPIC 명령을 호출하여 Help.chm이라는 도움말 파일을 열고 기본 항목을 Mainwin이라는 도움말 창에 표시합니다. 일반적으로 이 명령에 지정된 도움말 창은 표준 HTML 도움말 뷰어입니다.

HWND hwnd =
   HtmlHelp(
            GetDesktopWindow(),
            "c:\\Help.chm::/Intro.htm>Mainwin",
            HH_DISPLAY_TOPIC,
            NULL) ;

참고

htmlhelp.h 헤더는 HTMLHelp을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	htmlhelp.h
라이브러리	Htmlhelp.lib
DLL	hhctrl.ocx

추가 정보

HTML 도움말 API 정보