FINDREPLACEA-Struktur (commdlg.h)

Enthält Informationen, mit denen die Funktionen FindText und ReplaceText- zum Initialisieren der Dialogfelder Suchen und Ersetzen verwendet werden. Die FINDMSGSTRING- registrierte Nachricht verwendet diese Struktur, um die Such- oder Ersetzungseingabe des Benutzers an das Besitzerfenster eines Suchen oder Dialogfeld " ersetzen" zu übergeben.

Syntax

typedef struct tagFINDREPLACEA {
  DWORD        lStructSize;
  HWND         hwndOwner;
  HINSTANCE    hInstance;
  DWORD        Flags;
  LPSTR        lpstrFindWhat;
  LPSTR        lpstrReplaceWith;
  WORD         wFindWhatLen;
  WORD         wReplaceWithLen;
  LPARAM       lCustData;
  LPFRHOOKPROC lpfnHook;
  LPCSTR       lpTemplateName;
} FINDREPLACEA, *LPFINDREPLACEA;

Angehörige

lStructSize

Typ: DWORD-

Die Länge der Struktur in Byte.

hwndOwner

Typ: HWND-

Ein Handle für das Fenster, das das Dialogfeld besitzt. Die Fensterprozedur des angegebenen Fensters empfängt FINDMSGSTRING Nachrichten aus dem Dialogfeld. Dieses Element kann ein beliebiges gültiges Fensterhandle sein, darf jedoch nicht NULL-sein.

hInstance

Typ: HINSTANCE-

Wenn das FR_ENABLETEMPLATEHANDLE Flag in der Flagsfestgelegt ist, ist hInstance ein Handle für ein Speicherobjekt, das eine Dialogfeldvorlage enthält. Wenn das FR_ENABLETEMPLATE Flag festgelegt ist, ist hInstance ein Handle für ein Modul, das eine Dialogfeldvorlage enthält, die vom element lpTemplateName benannt ist. Wenn keines der Kennzeichnungen festgelegt ist, wird dieses Element ignoriert.

Flags

Typ: DWORD-

Eine Reihe von Bitkennzeichnungen, die Sie zum Initialisieren des Dialogfelds verwenden können. Im Dialogfeld werden diese Flags festgelegt, wenn die FINDMSGSTRING registrierte Nachricht gesendet wird, um die Eingabe des Benutzers anzugeben. Bei diesem Element kann es sich um einen oder mehrere der folgenden Werte handeln.

lpstrFindWhat

Typ: LPTSTR-

Die Suchzeichenfolge, die der Benutzer in die Find What Bearbeitungssteuerelement eingegeben hat. Sie müssen den Puffer dynamisch zuweisen oder ein globales oder statisches Array verwenden, damit er nicht außerhalb des Gültigkeitsbereichs liegt, bevor das Dialogfeld geschlossen wird. Der Puffer sollte mindestens 80 Zeichen lang sein. Wenn der Puffer beim Initialisieren des Dialogfelds eine Zeichenfolge enthält, wird die Zeichenfolge im Find What Bearbeitungssteuerelement angezeigt. Wenn eine FINDMSGSTRING- Meldung das FR_FINDNEXT Flag angibt, enthält lpstrFindWhat die Zeichenfolge, nach der gesucht werden soll. Die Flags FR_DOWN, FR_WHOLEWORDund FR_MATCHCASE geben die Richtung und art der Suche an. Wenn eine FINDMSGSTRING- Meldung die FR_REPLACE- oder FR_REPLACE Flags angibt, enthält lpstrFindWhat die zu ersetzende Zeichenfolge.

lpstrReplaceWith

Typ: LPTSTR-

Die Ersetzungszeichenfolge, die der Benutzer im Ersetzen durch Bearbeitungssteuerelement eingegeben hat. Sie müssen den Puffer dynamisch zuweisen oder ein globales oder statisches Array verwenden, damit er nicht außerhalb des Gültigkeitsbereichs liegt, bevor das Dialogfeld geschlossen wird. Wenn der Puffer beim Initialisieren des Dialogfelds eine Zeichenfolge enthält, wird die Zeichenfolge im Ersetzen durch Bearbeitungssteuerelement angezeigt.

Wenn eine FINDMSGSTRING- Meldung die FR_REPLACE- oder FR_REPLACEALL Flags angibt, enthält lpstrReplaceWith die Ersetzungszeichenfolge.

Die FindText--Funktion ignoriert dieses Element.

wFindWhatLen

Typ: WORD-

Die Länge des Puffers in Bytes, auf den der lpstrFindWhat Member verweist.

wReplaceWithLen

Typ: WORD-

Die Länge des Puffers in Bytes, auf den der lpstrReplaceWith Member verweist.

lCustData

Typ: LPARAM-

Anwendungsdefinierte Daten, die das System an die Hook-Prozedur übergibt, die vom lpfnHook Mitglied identifiziert wird. Wenn das System die WM_INITDIALOG Nachricht an die Hook-Prozedur sendet, ist der lParam- Parameter der Nachricht ein Zeiger auf die FINDREPLACE- Struktur, die beim Erstellen des Dialogfelds angegeben wurde. Die Hook-Prozedur kann diesen Zeiger verwenden, um den wert lCustData abzurufen.

lpfnHook

Typ: LPFRHOOKPROC-

Ein Zeiger auf eine FRHookProc Hook-Prozedur, die Nachrichten verarbeiten kann, die für das Dialogfeld vorgesehen sind. Dieses Element wird ignoriert, es sei denn, das FR_ENABLEHOOK Flag wird im Flags Member festgelegt. Wenn die Hook-Prozedur FALSE- als Reaktion auf die meldung WM_INITDIALOG zurückgibt, muss die Hook-Prozedur das Dialogfeld anzeigen, sonst wird das Dialogfeld nicht angezeigt. Führen Sie dazu zunächst alle anderen Malvorgänge aus, und rufen Sie dann die ShowWindow- und UpdateWindow--Funktionen auf.

lpTemplateName

Typ: LPCTSTR-

Der Name der Dialogfeldvorlagenressource im Modul, das vom hInstance Member identifiziert wird. Diese Vorlage wird durch die Standarddialogfeldvorlage ersetzt. Für nummerierte Dialogfeldressourcen kann dies ein Wert sein, der vom MAKEINTRESOURCE Makros zurückgegeben wird. Dieses Element wird ignoriert, es sei denn, das FR_ENABLETEMPLATE Flag wird im Flags Mitglied festgelegt.

Bemerkungen

Anforderungen

Siehe auch

allgemeine Dialogfeldbibliothek

Konzeptionelle

FRHookProc-

FindText-

MAKEINTRESOURCE-

Referenz-

ReplaceText-

ShowWindow-

WM_INITDIALOG