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 |
|
| Unicode- und ANSI-Name |
FINDMSGSTRINGW (Unicode) und FINDMSGSTRINGA (ANSI) |
Siehe auch
-
Referenz
-
Konzept