CWinApp::WinHelp

아티클
06/10/2015

WinHelp 응용 프로그램을 호출 하려면이 멤버 함수를 호출 합니다.

virtual void WinHelp( 
   DWORD_PTR dwData, 
   UINT nCmd = HELP_CONTEXT  
);

매개 변수

dwData
추가 데이터를 지정합니다. 사용 되는 값의 값에 종속 된 nCmd 매개 변수.
nCmd
요청한 도움말 유형을 지정 합니다. 가능한 값과는 어떻게 목록을 dwData 매개 변수를 참조를 WinHelp Windows 함수.

설명

프레임 워크는 또한 WinHelp 응용 프로그램을 호출 하려면이 함수를 호출 합니다.

응용 프로그램이 종료 될 때 WinHelp 응용 프로그램을 프레임 워크는 자동으로 닫힙니다.

예제

// Header File: HELPIDS.H 
// 
// This example header file is #include'd twice: 
// (1) It is #include'd by the .CPP file that passes the DWORD 
//     context i.d. to CWinApp::WinHelp. 
// (2) It is #include'd in the [MAP] section of the .HPJ file, 
//     to associate the help context string "HID_MYTOPIC" with
//     the help context numeric i.d., 101. 
// The help context string "HID_MYTOPIC" is what identifies the
// help topic in the help .RTF source file, in the "#" footnote:
//     # HID_MYTOPIC 
// 
// Note, it is not necessary to manage help context id's this way 
// for help topics associated with command id's and user interface 
// id's defined in your RESOURCE.H file; you should use the MAKEHM 
// tool via the custom build rule on your resource.h file to produce  
// a help map (.HM) file for these id's.  It is necessary to manage  
// help context id's as illustrated here only for help topics not  
// associated with command id's or user interface id's. 

#define HID_MYTOPIC 101

// Show the custom help topic that has the context string 
// "HID_MYTOPIC" in the help .RTF file, and which is mapped
// to the DWORD i.d. HID_MYTOPIC in the above HELPIDS.H file.
AfxGetApp()->WinHelp(HID_MYTOPIC);


// The following is one line of code in the help map (.HM) 
// file produced by the MAKEHM tool, which is called by the custom 
// build rule on the resource.h file.  The MAKEHM tool reads the  
// following #define in the application's RESOURCE.H file:
#define ID_MYCOMMAND 0x08004
// and adds a help id offset value of 0x10000 to create the 
// help context DWORD value 0x18004: 
// HID_MYCOMMAND                           0x18004 
// See MFC Tech Note 28 for more information on help id offset values. 

// Rarely will you need to directly call WinHelp yourself 
// with the help context i.d. for a command or user interface 
// object. The framework will call WinHelp automatically when 
// the user, for example, hits F1 when the focus is on a 
// My Command menu item. However, if you do want to directly 
// call WinHelp for the help topic associated with the command, 
// here is how you would do it:

AfxGetApp()->WinHelp(0x10000 + ID_MYCOMMAND);