MLWinHelp 함수
[이 함수는 Windows XP 및 Windows Server 2003을 통해 사용할 수 있습니다. 이후 버전의 Windows에서는 변경되거나 사용하지 못할 수 있습니다.]
Windows 도움말(Winhelp.exe)을 시작하고 애플리케이션에서 요청한 도움말의 특성을 나타내는 추가 데이터를 전달합니다.
BOOL MLWinHelp(
_In_ HWND hWndMain,
_In_ LPCTSTR lpszHelp,
_In_ UINT uCommand,
_In_ DWORD_PTR dwData
);
-
hWndMain [in]
-
형식: HWND
도움말을 요청하는 창에 대한 핸들입니다. MLWinHelp 함수는 이 핸들을 사용하여 도움을 요청한 애플리케이션을 추적합니다. uCommand 매개 변수가 HELP_CONTEXTMENU 또는 HELP_WM_HELP 지정하는 경우 hWndMain은 도움을 요청하는 컨트롤을 식별합니다.
-
lpszHelp [in]
-
형식: LPCTSTR
필요한 경우 경로를 포함하는 null로 끝나는 문자열의 주소와 MLWinHelp에서 표시할 도움말 파일의 이름입니다.
항목이 기본 창이 아닌 보조 창에 표시될 경우 파일 이름 뒤에 꺾쇠괄호(>) 및 보조 창의 이름이 뒤따를 수 있습니다. 도움말 프로젝트(.hpj) 파일의 [WINDOWS] 섹션에서 보조 창의 이름을 정의해야 합니다.
-
uCommand [in]
-
형식: UINT
요청된 도움말의 유형입니다. 가능한 값 목록 및 dwData 매개 변수에 배치할 값에 미치는 영향은 주의 섹션을 참조하세요.
-
dwData [in]
-
형식: DWORD_PTR
추가 데이터입니다. 사용되는 값은 uCommand 매개 변수의 값에 따라 달라집니다. 가능한 dwData 값 목록은 주의 섹션을 참조하세요.
형식: BOOL
성공에 대해 0이 아닌 값을 반환하거나, 그렇지 않으면 0을 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
이 함수는 헤더 파일에 포함되지 않으며 MLWinHelpA의 경우 서수 395, MLWinHelpW의 경우 397로 호출해야 합니다.
MLWinHelp는 기본적으로 WinHelp의 래퍼입니다. WinHelp를 호출하기 전에 현재 UI 언어 설정에 해당하는 도움말 파일의 경로를 가져오려고 시도합니다. 성공하면 해당 경로를 전달합니다. 실패하면 lpszHelp가 가리키는 경로를 전달합니다.
현재 사용자를 제외한 모든 컨텍스트에서 호출되면 이 함수가 실패합니다.
도움을 요청한 창을 닫기 전에 애플리케이션은 uCommand 매개 변수가 HELP_QUIT 설정된 MLWinHelp 를 호출해야 합니다. 모든 애플리케이션이 이 작업을 수행할 때까지 Windows 도움말은 종료되지 않습니다. HELP_CONTEXTPOPUP 명령을 사용하여 Windows 도움말을 시작한 경우에는 HELP_QUIT 명령을 사용하여 Windows 도움말을 호출할 필요가 없습니다.
다음 표에서는 uCommand 매개 변수의 가능한 값과 dwData 매개 변수의 해당 형식을 보여 줍니다.
uCommand | 작업 | dwData |
---|---|---|
HELP_COMMAND | 도움말 매크로 또는 매크로 문자열을 실행합니다. | 실행할 도움말 매크로의 이름을 지정하는 문자열의 주소입니다. 문자열이 여러 매크로 이름을 지정하는 경우 이름을 세미콜론으로 구분해야 합니다. Windows 도움말에서 긴 이름을 지원하지 않으므로 일부 매크로에 대해 짧은 형식의 매크로 이름을 사용해야 합니다. |
HELP_CONTENTS | .hpj 파일의 [OPTIONS] 섹션에 콘텐츠 옵션으로 지정된 항목을 표시합니다. 이 명령은 이전 버전과의 호환성을 위한 것입니다. 새 애플리케이션은 .cnt 파일을 제공하고 HELP_FINDER 명령을 사용해야 합니다. | 무시; 0으로 설정합니다. |
HELP_CONTEXT | .hpj 파일의 [MAP] 섹션에 정의된 지정된 컨텍스트 식별자에 의해 식별되는 토픽을 표시합니다. | 토픽의 컨텍스트 식별자를 포함합니다. |
HELP_CONTEXTMENU | 선택한 창에 대한 도움말 메뉴를 표시한 다음 팝업 창에 선택한 컨트롤에 대한 항목을 표시합니다. | DWORD 쌍 배열의 주소입니다. 각 쌍의 첫 번째 DWORD 는 컨트롤 식별자이고, 두 번째는 토픽의 컨텍스트 식별자입니다. 배열은 0 쌍으로 종료되어야 합니다 {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] 섹션에 콘텐츠 옵션으로 지정된 항목을 표시합니다. 이 명령은 이전 버전과의 호환성을 위한 것입니다. 새 애플리케이션은 HELP_FINDER 명령을 사용해야 합니다. | 무시; 0으로 설정합니다. |
HELP_KEY | 정확히 일치하는 항목이 있는 경우 지정된 키워드(keyword) 일치하는 항목을 키워드(keyword) 표에 표시합니다. 일치하는 항목이 두 개 이상 있는 경우 항목 찾은 항목 목록 상자에 항목이 나열된 인덱스를 표시합니다. | 키워드(keyword) 문자열의 주소입니다. 여러 키워드(keyword) 세미콜론으로 구분해야 합니다. |
HELP_MULTIKEY | 대체 키워드(keyword) 테이블에 키워드(keyword) 지정된 항목을 표시합니다. | 표 각주 문자와 키워드(keyword) 지정하는 MULTIKEYHELP 구조체의 주소입니다. |
HELP_PARTIALKEY | 정확히 일치하는 항목이 있는 경우 지정된 키워드(keyword) 일치하는 항목을 키워드(keyword) 표에 표시합니다. 일치하는 항목이 두 개 이상 있는 경우 찾을 수 있는 항목 대화 상자를 표시합니다 . 키워드(keyword) 전달하지 않고 인덱스 표시하려면 빈 문자열에 대한 포인터를 사용합니다. | 키워드(keyword) 문자열의 주소입니다. 여러 키워드(keyword) 세미콜론으로 구분해야 합니다. |
HELP_QUIT | 더 이상 필요하지 않음을 Windows 도움말에 알릴 수 있습니다. 다른 응용 프로그램에서 도움을 요청하지 않은 경우 Windows는 Windows 도움말을 닫습니다. | 무시; 0으로 설정합니다. |
HELP_SETCONTENTS | 콘텐츠 항목을 지정합니다. 도움말 파일에 연결된 .cnt 파일이 없는 경우 사용자가 콘텐츠 단추를 클릭하면 Windows 도움말이 이 항목을 표시합니다. | 콘텐츠 항목에 대한 컨텍스트 식별자를 포함합니다. |
HELP_SETPOPUP_POS | 후속 팝업 창의 위치를 설정합니다. | 위치 데이터를 포함합니다. MAKELONG 매크로를 사용하여 가로 및 세로 좌표를 단일 값으로 연결합니다. 팝업 창은 팝업 창이 호출될 때 마우스 커서가 지정된 지점에 있는 것처럼 배치됩니다. |
HELP_SETWINPOS | Windows 도움말 창이 최소화되거나 메모리에 있는 경우 표시되며 크기 및 위치를 지정된 대로 설정합니다. | 기본 또는 보조 도움말 창의 크기와 위치를 지정하는 HELPWININFO 구조체의 주소입니다. |
HELP_TCARD | 명령이 Windows 도움말의 학습 카드 인스턴스용임을 나타냅니다. 비트 OR 연산자를 사용하여 이 명령을 다른 명령과 결합합니다. | 이 명령이 결합된 명령에 따라 달라집니다. |
HELP_WM_HELP | 팝업 창에서 hWndMain 매개 변수로 식별되는 컨트롤에 대한 항목을 표시합니다. | DWORD 쌍 배열의 주소입니다. 각 쌍의 첫 번째 DWORD는 컨트롤 식별자이고, 두 번째 DWORD 는 토픽의 컨텍스트 식별자입니다. 배열은 0 쌍으로 종료되어야 합니다 {0,0}. 특정 컨트롤에 도움말을 추가하지 않으려면 컨텍스트 식별자를 -1로 설정합니다. |
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 |
Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
지원되는 최소 서버 |
Windows Server 2003[데스크톱 앱만 해당] |
헤더 |
|
DLL |
|
유니코드 및 ANSI 이름 |
MLWinHelpW (유니코드) 및 MLWinHelpA (ANSI) |