Help ondersteuning

Algemene dialoogvensters bieden contextafhankelijke Help voor de standaard besturingselementen van het dialoogvenster. Om hulp te bieden extra voor een common dialog box, kunt u een knop Help weergeven en verwerken van berichten die worden gegenereerd wanneer de gebruiker op de knop klikt. De knop Help is een aanvulling op de standaard contextgevoelige Help. De knop Help is nuttig voor het beschrijven van het algemene doel van het dialoogvenster toepassing op uw toepassing.

Contextafhankelijke Help

Alle gemeenschappelijke dialoogvensters bevatten contextafhankelijke Help voor de standaard besturingselementen van het dialoogvenster. De gebruiker kan Help voor de afzonderlijke besturingselementen weergeven door een van de volgende methoden:

Als u een dialoogvenster aanpassen door het toevoegen van nieuwe besturingselementen, moet u ook help ondersteuning voor deze besturingselementen uitbreiden door de verwerking van aanvragen voor hulp in de haak procedure. De haak procedure ontvangt de volgende berichten wanneer de gebruiker help opvraagt.

Actie van de gebruiker Bericht
De gebruiker heeft geklikt de rechter muisknop op een besturingselement. WM_CONTEXTMENU
De gebruiker op de toets f1 drukt. WM_HELP
De gebruiker ? de knop op de titelbalk en vervolgens op een besturingselement hebt geklikt. WM_HELP

U moet deze berichten voor de besturingselementen die u hebt toegevoegd, maar laat de standaard dialoogvenster vak procedure verwerken van berichten voor de standaardbesturingselementen worden verwerkt. Zie voor meer informatie over hoe om deze berichten te verwerken, de helpen overzicht.

De helpknop

U kunt een knop Help weergeven in een van de gemeenschappelijke dialoogvensters door een SHOWHELP-waarde in de vlaggen lid van de structuur van de initialisatie van het dialoogvenster. Als u de knop Help wordt weergegeven, moet u het verzoek van de gebruiker voor hulp verwerken. De verwerking kan worden gedaan in een van uw toepassing venster procedures of in een procedure van de haak voor het dialoogvenster. Typisch, u zou verwerken van het verzoek voor hulp door te bellen naar de WinHelp functie.

Help berichten verwerken in een van uw venster procedures, moet u een bericht-id voor de tekenreeks die wordt gedefinieerd door de HELPMSGSTRING waarde krijgen en identificeren van het venster om berichten te ontvangen. Wilt krijgen de bericht-id, geeft u HELPMSGSTRING als de parameter in een aanroep naar de functie RegisterWindowMessage . Wanneer u het dialoogvenster gemeenschappelijke maakt, gebruiken het hwndOwner lid van het dialoogvenster vak initialisatie structuur te identificeren van het venster dat is om de berichten te ontvangen. Het dialoogvenster vak procedure verzendt het bericht naar de venster procedure wanneer de gebruiker op de knop Help klikt.

Om berichten te verwerken help in een haak procedure, moet u het bericht WM_COMMAND worden verwerkt. De haak stapsgewijze procedure help als de parameter wParam van dit bericht geeft aan dat de gebruiker heeft geklikt op de knop Help . De id van de Help -knop is de constante pshHelp gedefinieerd in de DLGS.H bestand.

Haak procedures voor de Verkenner-stijl Open dialoogvensters en Opslaan als gemeenschappelijk doen WM_COMMAND voor de knop Help berichten niet ontvangen. In plaats daarvan stuurt het dialoogvenster een melding CDN_HELP volgens de haak wanneer op de knop Help wordt geklikt.

Index