Hjelpe støtte

Vanlige dialogboksene inneholder kontekstavhengig hjelp for standardkontroller i dialogboksen. Du vil ha mer hjelp for en felles dialogboksen, kan du vise en Hjelp -knapp og behandle meldinger som genereres når brukeren klikker knappen. Knappen Hjelp er et supplement til standard kontekstavhengig hjelp. Knappen Hjelp er nyttig for å beskrive hva som er hensikten i dialogboksen som det gjelder for søknaden.

Kontekstavhengig hjelp

Alle vanlige dialogbokser gi kontekstsensitiv Hjelp for standardkontroller i dialogboksen. Brukeren kan vise Hjelp for individuelle kontroller av noen av metodene nedenfor:

Hvis du tilpasser en dialogboks ved å legge til nye kontroller, må du også utvide hjelp støtte for disse kontrollene ved behandling av forespørsler om hjelp i hook-prosedyre. Bindingsprosedyren mottar de følgende meldingene når brukeren ber om hjelp.

Brukerhandling Melding
Brukeren klikket høyre museknapp over en kontroll. WM_CONTEXTMENU
Brukeren trykket f1-tasten. WM_HELP
Brukeren klikket på ? -knappen på tittellinjen og deretter en kontroll. WM_HELP

Du skal behandle disse meldingene for kontrollene du har lagt til, men la standard dialogboksen boksen prosedyre Meldingsbehandling for standardkontrollene. Hvis du vil ha mer informasjon om hvordan du behandler disse meldingene, se den Hjelp -oversikt.

På Hjelp-knappen

Du kan vise en Hjelp -knapp i noen av de vanlige dialogboksene ved å angi en verdi for SHOWHELP i flagg -medlem av initialisering strukturen for dialogboksen. Hvis du viser Hjelp -knappen, må du behandle brukerens forespørsel om hjelp. Behandlingen kan gjøres i en av programmets vindu prosedyrer eller i en Bindingsprosedyren for dialogboksen. Vanligvis, du ville behandle forespørselen for hjelp ved å kalle den WinHelp -funksjonen.

Behandle hjelpemeldinger i en av dine vinduet prosedyrer, må du få en meldings-IDen for strengen som er definert av HELPMSGSTRING -verdien og identifisere i vinduet for å motta meldinger. For å få meldings-IDen, kan du angi HELPMSGSTRING som parameter i et kall til funksjonen RegisterWindowMessage . Når du oppretter den felles dialogboksen, kan du bruke hwndOwner -medlem av dialogboksen boksen initialisering strukturen til å identifisere vinduet som skal motta meldingene. Dialogboksen boksen fremgangsmåten sender meldingen i vinduet prosedyren når brukeren klikker Hjelp -knappen.

Behandle hjelpemeldinger i en Bindingsprosedyren, bør du behandle meldingen WM_COMMAND . Bindingsprosedyren gir hjelp hvis parameteren wParam av denne meldingen angir at brukeren klikket knappen Hjelp . Identifikator for knappen Hjelp er konstanten pshHelp som er definert i DLGS.H-fil.

Hook prosedyrer for Explorer-stil Åpne og Lagre som vanlige dialogboksene mottar ikke WM_COMMAND meldinger for Hjelp -knappen. I stedet, dialogboksen sender en varslingsmelding CDN_HELP til Bindingsprosedyren når Hjelp -knappen klikkes.

Index