CFindReplaceDialog-Klasse

Artikel
02/26/2013

Ermöglicht, Sie zu Werkzeugstandardzeichenfolge Suchen/ersetzt Dialogfelder in der Anwendung.

class CFindReplaceDialog : public CCommonDialog

Mitglieder

Öffentliche Konstruktoren

Name	Description
CFindReplaceDialog::CFindReplaceDialog	Rufen Sie diese Funktion auf, um ein CFindReplaceDialog-Objekt zu erstellen.

Öffentliche Methoden

Name	Description
CFindReplaceDialog::Create	Erstellt CFindReplaceDialog und zeigt ein Dialogfeld an.
CFindReplaceDialog::FindNext	Rufen Sie diese Funktion, um zu bestimmen, ob der Benutzer das nächste Vorkommen der Suchzeichenfolge finden möchte.
CFindReplaceDialog::GetFindString	Rufen Sie diese Funktion auf, um die aktuelle Suchzeichenfolge abzurufen.
CFindReplaceDialog::GetNotifier	Rufen Sie diese Funktion auf, um die FINDREPLACE-Struktur im registrierten Meldungshandler abzurufen.
CFindReplaceDialog::GetReplaceString	Rufen Sie diese Funktion auf, um die aktuelle Ersetzungszeichenfolge abzurufen.
CFindReplaceDialog::IsTerminating	Rufen Sie diese Funktion, um zu bestimmen, ob das Dialogfeld beendet wird.
CFindReplaceDialog::MatchCase	Rufen Sie diese Funktion, um zu bestimmen, ob der Benutzer den Fall von der Suchzeichenfolge genau übereinstimmen möchte.
CFindReplaceDialog::MatchWholeWord	Rufen Sie diese Funktion, um zu bestimmen, ob der Benutzer nur ganze Wörter entsprechen möchte.
CFindReplaceDialog::ReplaceAll	Rufen Sie diese Funktion, um zu bestimmen, ob der Benutzer alle Vorkommen der Zeichenfolge ersetzt werden wünscht.
CFindReplaceDialog::ReplaceCurrent	Rufen Sie diese Funktion, um zu bestimmen, ob der Benutzer das aktuelle Wort ersetzt werden wünscht.
CFindReplaceDialog::SearchDown	Rufen Sie diese Funktion, um zu bestimmen, ob der Benutzer die Suche in eine Abwärtsrichtung fortfahren wünscht.

Öffentliche Datenmember

Name	Description
CFindReplaceDialog::m_fr	Eine Struktur verwendet, um ein CFindReplaceDialog-Objekt anzupassen.

Hinweise

Im Gegensatz zu den anderen Windows-häufigverwendetes Dialogfeld sind CFindReplaceDialog-Objekte nicht modale und ermöglichen Benutzern, um mit anderen Fenstern zu interagieren, während es auf dem Bildschirm sind.Es gibt zwei Arten von CFindReplaceDialog-Objekte: Suchendialogfelder und Suchen/ersetzen Dialogfelder.Obwohl die Dialogfelder den Benutzer zur Eingabesuche und zur Suche/zu den Ersetzungszeichenfolgen ermöglichen, verwenden sie keine der suchenden oder ersetzenden Funktionen.Sie müssen diese der Anwendung hinzufügen.

Um ein CFindReplaceDialog-Objekt zu erstellen, verwenden Sie den bereitgestellten Konstruktor (den keine Argumente enthält).Da dies ein nicht modales Dialogfeld handelt, ordnen Sie das Objekt auf dem Heap mithilfe des Operators new, anstatt auf dem Stapel.

Sobald ein CFindReplaceDialog-Objekt erstellt wurde, müssen Sie die Erstellen Sie-Memberfunktion aufrufen, um das Dialogfeld zu erstellen und anzuzeigen.

Verwenden Sie die m_fr-Struktur, um das Dialogfeld zu initialisieren, bevor Sie Create aufrufen.Die m_fr-Struktur ist vom Typ FINDREPLACE.Weitere Informationen über diese Struktur, finden Sie unter Windows SDK.

Damit das übergeordnete Fenster der Ermittlung benachrichtigt werden kann/ersetzen Sie Anforderungen, müssen Sie die Funktion Windows RegisterWindowMessage verwenden und das ON_REGISTERED_MESSAGE Meldungszuordnungsmakro im Rahmenfenster verwenden, das diese registrierte Meldung verarbeitet.

Sie können bestimmen, ob der Benutzer entschieden hat, um das Dialogfeld mit der IsTerminating-Memberfunktion zu beenden.

CFindReplaceDialog beruht auf der COMMDLG.DLL-Datei, die mit Windows-Versionen 3,1 und höher bereitgestellt wird.

Um das Dialogfeld anzupassen, leiten Sie eine Klasse von CFindReplaceDialog, erstellen Sie eine benutzerdefinierte Dialogfeldvorlage, und fügen Sie eine Meldungszuordnung hinzu um die Benachrichtigungsmeldungen aus den erweiterten - Steuerelementen verarbeiten.Alle nicht verarbeiteten Nachrichten sollten die Basisklasse übergeben werden.

Die Hookfunktion anzupassen ist nicht erforderlich.

Weitere Informationen zur Verwendung von CFindReplaceDialog, finden Sie unter Allgemeine Dialogfeldklassen.