Шаг 54 - CWinApp::WinHelp

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

Параметры
dwData
Определяет дополнительные данные. Используемое значение зависит от значения nCmd параметра.
nCmd
Определяет тип запрошенной справки. Для списка возможных значений и как они воздействуют смотри функцию WinHelp Windows.

Замечания
Вызовите этот метод, чтобы вызвать приложение WinHelp. Каркас также вызывает эту функцию, чтобы вызвать приложение WinHelp. Каркас автоматически закроет приложение WinHelp, когда ваше приложение завершается.

Пример

// Файл Заголовка: HELPIDS.H 
// 
// В этом примере заголовочный файл включен дважды 
// (1) Это -включение в  .CPP файл, который передает DWORD 
// контекст i.d.  в CWINAPP:: WinHelp. 
// (2) Это - включение в раздел [MAP] .HPJ файла, 
// что бы  связывать строку контекста справки "HID_MYTOPIC" 
// с контекстом справки числового i.d., 101. 
// Строка контекста справки "HID_MYTOPIC" - 
// идентифицирует тему справки в  .RTF исходном файле, 
// в "#" сноске: # HID_MYTOPIC  
//
// Обратите внимание, что нет необходимости управлять идентификатором 
// контекста справки этот способ связаваеи с идентификатор справки с
// идентификатором  команды и интерфейсом пользователя Идентификатор,
// определенный в вашем RESOURCE.H файле Вы должны использовать MAKEHM
// инструмент через произвольную сборку формируя правило в вашем resource.h
// файле, чтобы произвести карту справки (.HM) файл для этого идентификатора.
// Необходимо управлять идентификатором контекста справки как иллюстрируется
// здесь только для разделов справки, не связанных с идентификатором команды
// или идентификатором интерфейса пользователя.  

#define HID_MYTOPIC 101

// Показать заказанный разделу справки, которая имеет строку контекста
// "HID_MYTOPIC" в справке .RTF файлом, и которая отображена к 
// DWORD HID_MYTOPIC в вышеупомянутом HELPIDS.H файле. 
 
AfxGetApp()->WinHelp(HID_MYTOPIC);


// Следующее - одна строка программы в карте справки (.HM) файл, 
// произведенный MAKEHM инструментом, который вызывается произвольной
// сборкой формируют правило в resource.h файле. 
// MAKEHM инструмент читается следующий #define в файле приложения RESOURCE.H:
// #define  ID_MYCOMMAND 0x08004 
// И добавляет значение смещения идентификатора справки 0x10000, 
// чтобы создать контекст справки значение 0x18004 DWORD.  


HID_MYCOMMAND                           0x18004

 
// Редко будете Вы нуждаться непосредственном вызове WinHelp с контекстом 
// справки i.d. для команды или объекта интерфейса пользователя. 
// Каркас вызовет WinHelp автоматически, когда пользователь, 
// например, нажимает F1, когда фокус находится на пункте меню My Command.
// Однако, если Вы хотите непосредственно вызывать WinHelp для раздела справки,
// связанной с командой, здесь показано как Вы можете сделать это 


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

Предыдущий Шаг | Следующий Шаг | Оглавление
Автор Каев Артем - 21.12.2001