Freigeben über


FINDMSGSTRING-Nachricht

Ein Dialogfeld Suchen oder Ersetzen sendet die registrierte FINDMSGSTRING-Nachricht an die Fensterprozedur des Besitzerfensters, wenn der Benutzer auf die Schaltfläche Weiter suchen, Ersetzen oder Alle ersetzen klickt oder das Dialogfeld schließt.

#define FINDMSGSTRING TEXT("commdlg_FindReplace")

Parameter

wParam

Dieser Parameter wird nicht verwendet.

lParam

Ein Zeiger auf eine FINDREPLACE-Struktur . Die Member dieser Struktur enthalten die neueste Benutzereingabe, einschließlich der zu suchden Zeichenfolge, der Ersatzzeichenfolge (falls vorhanden) und der Such- und Ersetzungsoptionen.

Rückgabewert

Diese Nachricht hat keinen Rückgabewert.

Bemerkungen

Sie müssen die FINDMSGSTRING-Konstante in einem Aufruf der RegisterWindowMessage-Funktion angeben, um den Bezeichner für die vom Dialogfeld gesendete Nachricht abzurufen.

Wenn Sie das Dialogfeld erstellen, verwenden Sie den hwndOwner-Member der FINDREPLACE-Struktur , um das Fenster zu identifizieren, in dem FINDMSGSTRING-Nachrichten empfangen werden.

Das Flags-Element der FINDREPLACE-Struktur enthält eines der folgenden Flags, um das Ereignis anzugeben, das die Nachricht verursacht hat.

Flag Bedeutung
FR_DIALOGTERM (0x00000040) Das Dialogfeld wird geschlossen. Nachdem das Besitzerfenster diese Nachricht verarbeitet hat, ist ein Handle für das Dialogfeld nicht mehr gültig.
FR_FINDNEXT (0x00000008) Der Benutzer hat in einem Dialogfeld Suchen oder Ersetzen auf die Schaltfläche Weiter suchen geklickt. Der lpstrFindWhat-Member gibt die Zeichenfolge an, nach der gesucht werden soll.
FR_REPLACE (0x00000010) Der Benutzer hat in einem Dialogfeld Ersetzen auf die Schaltfläche Ersetzen geklickt. Das lpstrFindWhat-Element gibt die zu ersetzende Zeichenfolge an, und das lpstrReplaceWith-Element gibt die Ersetzungszeichenfolge an.
FR_REPLACEALL (0x00000020) Der Benutzer hat in einem Dialogfeld Ersetzen auf die Schaltfläche Alle ersetzen geklickt. Das lpstrFindWhat-Element gibt die zu ersetzende Zeichenfolge an, und das lpstrReplaceWith-Element gibt die Ersetzungszeichenfolge an.

Für eine Nachricht Weiter suchen oder Alle ersetzen kann das Flags-Element eines oder mehrere der folgenden Flags enthalten, um die Suchoptionen anzugeben.

Flag Bedeutung
FR_DOWN (0x00000001) Wenn diese Option festgelegt ist, wird die Schaltfläche Nach unten der Optionsfelder richtung ausgewählt, die angibt, dass der Benutzer von der aktuellen Position bis zum Ende des Dokuments suchen möchte. Wenn FR_DOWN nicht festgelegt ist, wird die Schaltfläche Nach oben ausgewählt, sodass der Benutzer bis zum Anfang des Dokuments suchen möchte.
FR_MATCHCASE (0x00000004) Wenn diese Option festgelegt ist, ist das Kontrollkästchen Groß-/Kleinschreibung übereinstimmen aktiviert, das angibt, dass der Benutzer die Groß-/Kleinschreibung bei der Suche beachten möchte. Wenn FR_MATCHCASE nicht festgelegt ist, ist das Kontrollkästchen deaktiviert, sodass bei der Suche die Groß-/Kleinschreibung nicht beachtet werden sollte.
FR_WHOLEWORD (0x00000002) Wenn festgelegt, ist das Kontrollkästchen Ganze Word nur übereinstimmen aktiviert, was angibt, dass der Benutzer nur nach ganzen Wörtern suchen möchte, die der Suchzeichenfolge entsprechen. Wenn FR_WHOLEWORD nicht festgelegt ist, ist das Kontrollkästchen deaktiviert, sodass Sie auch nach Wortfragmenten suchen sollten, die der Suchzeichenfolge entsprechen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Commdlg.h (Einschließen von Windows.h)
Unicode- und ANSI-Name
FINDMSGSTRINGW (Unicode) und FINDMSGSTRINGA (ANSI)

Siehe auch

Referenz

FINDREPLACE

RegisterWindowMessage

Konzept

Allgemeine Dialogfeldbibliothek