FindText

De functie FindText maakt een systeem gedefinieerde zonder modus vinden in een dialoogvenster waarin de gebruiker een tekenreeks zoeken en opties te gebruiken bij het zoeken naar tekst in een document opgeven.

(HWND FindText LPFINDREPLACE  lpfr / / aanwijzer structuur met initialisatie / / gegevens);
 

Parameters

lpfr
Aanwijzer naar een FINDREPLACE structuur waarin de gegevens gebruikt voor het initialiseren van het dialoogvenster. Het dialoogvenster gebruikt deze structuur te sturen informatie over de invoer van de gebruiker aan uw toepassing. Voor meer informatie, zie de volgende sectie opmerkingen.

Retourwaarden

Als de functie slaagt, is de geretourneerde waarde de vensteringang voor het dialoogvenster. U kunt de vensteringang gebruiken om te communiceren met of om het dialoogvenster te sluiten.

Als de functie mislukt, is de retourwaarde NULL. Om uitgebreide foutinformatie, de CommDlgExtendedError functie aanroepen. CommDlgExtendedError kan resulteren in één van de volgende foutcodes:

CDERR_FINDRESFAILURE CDERR_MEMLOCKFAILURE
CDERR_INITIALIZATION CDERR_NOHINSTANCE
CDERR_LOCKRESFAILURE CDERR_NOHOOK
CDERR_LOADRESFAILURE CDERR_NOTEMPLATE
CDERR_LOADSTRFAILURE CDERR_STRUCTSIZE
CDERR_MEMALLOCFAILURE FRERR_BUFFERLENGTHZERO

Opmerkingen

De functie FindText voert geen gevonden tijdens de zoekopdracht. In plaats daarvan verzendt het dialoogvenster FINDMSGSTRING geregistreerd naar de venster-procedure van het venster van de eigenaar van het dialoogvenster. Wanneer u het dialoogvenster maakt, identificeert de hwndOwner lid van de structuur FINDREPLACE de eigenaar venster.

FindTextbelt, moet u de functie RegisterWindowMessage om de id voor het bericht FINDMSGSTRING aanroepen. Het dialoogvenster vak procedure wordt deze id gebruikt om berichten te verzenden wanneer de gebruiker op de knopvolgende zoeken, of wanneer het dialoogvenster wordt gesloten. De parameter lParam van het FINDMSGSTRING bericht bevat een pointer naar een FINDREPLACE -structuur. De vlaggen lid van deze structuur geeft aan de gebeurtenis die het bericht wordt veroorzaakt. Andere leden van de structuur geven aan invoer van de gebruiker .

Als u een dialoogvenster zoeken maakt, moet u de functie IsDialogMessage in de hoofdberichtlus van uw toepassing om ervoor te zorgen dat het dialoogvenster invoer van het toetsenbord, zoals de toetsen tab en esc correct verwerkt. IsDialogMessage retourneert een waarde die aangeeft of het dialoogvenster zoeken het bericht verwerkt.

U kunt een FRHookProc haak procedure voorzien in een dialoogvenster zoeken . De haak procedure kan verwerken berichten die worden verzonden naar het dialoogvenster. Om een haak procedure, in het vlaggen lid van het FINDREPLACE -structuur de FR_ENABLEHOOK vlag instellen en opgeven van het adres van de haak-procedure in de lpfnHook lid.

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Niet-ondersteunde.
Header:Verklaard in commdlg.h.
Bibliotheek importeren:Gebruik comdlg32.lib.
Unicode:Geïmplementeerd als Unicode en ANSI-versies van Windows NT.

Zie ook

Overzicht van bibliotheek het gemeenschappelijk dialoogvenster, gemeenschappelijk dialoogvenster vak functies, CommDlgExtendedError, FINDMSGSTRING, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, ReplaceText

Index