FinnTekst

FinnTekst -funksjonen oppretter en systemdefinert uten modus dialogboksen Søk som lar brukeren angi en streng for å søke etter og alternativer til bruk når du søker etter tekst i et dokument.

() HWND FinnTekst LPFINDREPLACE  lpfr / / peker til struktur med initialisering / / data);
 

Parametere

lpfr

Pekeren til en FINDREPLACE struktur som inneholder informasjon som brukes til å initialisere dialogboksen. Dialogboksen bruker denne strukturen til å sende informasjon om brukerens inndata til applikasjonen. Hvis du vil ha mer informasjon, kan du se under følgende kommentarer.

Returverdier

Hvis funksjonen er vellykket, er returverdien vindusreferansen til dialogboksen. Du kan bruke vindusreferansen til å kommunisere med, eller for å lukke dialogboksen.

Hvis funksjonen mislykkes, er verdien som returneres NULL. For å få utvidet feilinformasjon, kan du kalle funksjonen CommDlgExtendedError . CommDlgExtendedError kan returnere en av følgende feilkoder:

Merknader

Funksjonen FinnTekst utfører ikke søkeoperasjon. I stedet sender dialogboksen FINDMSGSTRING registrert meldinger i vinduet prosedyren i eiervinduet i dialogboksen. Når du oppretter dialogboksen, identifiserer hwndOwner medlem av FINDREPLACE -strukturen eiervinduet.

Før du kaller FinnTekst, må du kalle funksjonen RegisterWindowMessage å få identifikatoren for FINDMSGSTRING-melding. Dialogboksen boksen fremgangsmåten bruker denne identifikatoren til å sende meldinger når brukeren klikker på Finn Neste -knappen, eller når dialogboksen lukkes. LParam -parameteren for FINDMSGSTRING meldingen inneholder en peker til en FINDREPLACE struktur. Flagg -medlem av denne strukturen angir hendelsen som fikk meldingen. Andre medlemmer av strukturen angi brukerens inndata.

Hvis du oppretter en dialogboksen Søk , må du også bruke funksjonen IsDialogMessage i hovedmeldingsløkke av programmet for å sikre at dialogboksen riktig behandler inndata fra tastaturet, for eksempel kategorien og esc-nøkler. IsDialogMessage returnerer en verdi som angir om dialogboksen Søk , behandles meldingen.

Du kan gi en FRHookProc hook-prosedyre for en finne dialogboks. Bindingsprosedyren kan behandle meldinger som er sendt til dialogboksen. Hvis du vil aktivere en Bindingsprosedyren, sette FR_ENABLEHOOK-flagget i flagg -medlem av FINDREPLACE -strukturen og angir adressen til Bindingsprosedyren i lpfnHook -medlem.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Som ikke støttes.
Topptekst:Deklarert i commdlg.h.
Importere biblioteket:Bruk comdlg32.lib.
Unicode:Implementert som Unicode- og ANSI-versjoner på Windows NT.

Se også

Felles biblioteket dialogboksoversikt, felles dialogboksen fungerer, CommDlgExtendedError, FINDMSGSTRING, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, Fortløpande endringar

Index