ReplaceText

De functie ReplaceText een systeem gedefinieerde niet-modaal dialoogvenster gemaakt waarmee de gebruiker opgeven om te zoeken naar een tekenreeks en een vervangende tekenreeks, evenals opties om te controleren de vondst en vervangbewerkingen.

(HWND ReplaceText 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. De vensteringang kunt u communiceren met het dialoogvenster of het sluiten.

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

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

Opmerkingen

De functie ReplaceText doet een tekst vervanging bewerking niet uitvoeren. 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.

ReplaceTextbelt, 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 knoppen volgende zoeken, vervangen of Alles vervangen, of wanneer het dialoogvenster wordt gesloten. De parameter lParam van een FINDMSGSTRING-bericht bevat een pointer naar het 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 vervangen 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. De IsDialogMessage functie een waarde retourneert die aangeeft of het dialoogvenster vervangen het bericht verwerkt.

U kunt een FRHookProc haak procedure voorzien in een dialoogvenster vervangen . 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, FINDREPLACE, FRHookProc, IsDialogMessage, RegisterWindowMessage, WM_CTLCOLORDLG