Typowych okien dialogowych zapewniają pomoc kontekstową dla standardowych formantów okna dialogowego. Aby zapewnić dodatkową pomoc wspólne okno dialogowe, można wyświetlić przycisk Pomoc i przetwarzać komunikaty generowane, gdy użytkownik kliknie przycisk. Przycisk Pomoc stanowi uzupełnienie domyślnie pomocy kontekstowej. Przycisk Pomoc jest przydatne do opisywania ogólnego przeznaczenia okno dialogowe, jako że stosuje się do aplikacji.
Wszystkie wspólne oknach dialogowych przewidują pomoc kontekstową standardowych formantów okna dialogowego. Użytkownik może wyświetlić pomoc dla poszczególnych formantów przez każdą z następujących metod:
Jeśli okno dialogowe można dostosować, dodając nowe formanty, musi również rozszerzenie pomocy wsparcia dla tych formantów za rozpatrywanie wniosków o pomoc w procedura haka. Procedura haka otrzymuje następujące komunikaty, gdy użytkownik zażąda pomocy.
| Akcja użytkownika | Komunikat |
|---|---|
| Kliknięty prawym przyciskiem myszy nad formantem. | WM_CONTEXTMENU |
| Użytkownik nacisnął klawisz f1. | WM_HELP |
| Użytkownik kliknął przycisk ? na pasku tytułu, a następnie kliknięciu formantu. | WM_HELP |
Należy przetworzyć te wiadomości do kontroli zostały dodane, ale pozwól procedury pole dialogowe domyślne przetwarzania wiadomości dla formantów standardowych. Aby uzyskać więcej informacji na temat przetwarzania tych wiadomości, zobacz pomocy.
Przycisk Pomoc można wyświetlić w jednym z typowych okien dialogowych przez ustawienie wartości SHOWHELP Członkowskie flag struktury inicjujące w oknie dialogowym. Podczas wyświetlania przycisku Pomoc , musi przetworzyć żądania użytkownika o pomoc. Przetwarzanie może odbywać się w jednej z procedur okno aplikacji lub w procedura haka okna dialogowego. Zazwyczaj może przetwarzać żądania pomocy przez wywołanie funkcji WinHelp.
Aby przetwarzać komunikatów pomocy w jednej z procedur okna, musi uzyskać identyfikator wiadomości ciąg określony przez wartość HELPMSGSTRING i identyfikację okna, aby odbierać wiadomości. Aby uzyskać identyfikator wiadomości, należy określić HELPMSGSTRING jako parametr w wywołaniu funkcji RegisterWindowMessage . Podczas tworzenia wspólne okno dialogowe umożliwia członek hwndOwner strukturze inicjowania pole dialogowe zidentyfikować okno, w którym ma się pojawić komunikaty. Procedura pole dialogowe wysyła wiadomość do procedury okna, gdy użytkownik kliknie przycisk Pomoc.
Do przetwarzania komunikatów pomocy w procedura haka, należy przetwarzać komunikat WM_COMMAND . Procedura haka zapewnia pomoc, jeśli parametr wParam ten komunikat wskazuje, że użytkownik kliknął przycisk Pomoc . Identyfikator przycisku Pomoc jest stałą pshHelp , określonych w DLGS.H pliku.
Procedury haka stylu Eksploratora Otwórz i Zapisz jako wspólne pola dialogowe nie otrzymują WM_COMMAND wiadomości przycisk Pomoc . Zamiast tego okna dialogowego wysyła wiadomość z powiadomieniem CDN_HELP procedura haka po kliknięciu przycisku Help.