CFindReplaceDialog クラス

標準の文字列の検索用と置換用ダイアログ ボックスを実装できます。

class CFindReplaceDialog : public CCommonDialog

メンバー

パブリック コンストラクター

名前	説明
CFindReplaceDialog::CFindReplaceDialog	CFindReplaceDialog のオブジェクトを構築するには、この関数を呼び出します。

パブリック メソッド

名前	説明
CFindReplaceDialog::Create	CFindReplaceDialog のダイアログ ボックスを作成し、表示します。
CFindReplaceDialog::FindNext	ユーザーが検索文字列の次の出現箇所を検索するかどうかを判定するためにこの関数を呼び出します。
CFindReplaceDialog::GetFindString	現在の検索文字列を取得するには、この関数を呼び出します。
CFindReplaceDialog::GetNotifier	は、登録されたメッセージ ハンドラーの [FINDREPLACE] の構造を取得するには、この関数を呼び出します。
CFindReplaceDialog::GetReplaceString	現在の置換文字列を取得するには、この関数を呼び出します。
CFindReplaceDialog::IsTerminating	ダイアログ ボックスを終了するかどうかを判定するためにこの関数を呼び出します。
CFindReplaceDialog::MatchCase	ユーザーが検索文字列の例と完全に一致するかどうかを判定するためにこの関数を呼び出します。
CFindReplaceDialog::MatchWholeWord	単語全体が一致するものだけを検索するかどうかを調べます。
CFindReplaceDialog::ReplaceAll	ユーザーが文字列のすべての生成対象にするかどうかを判定するためにこの関数を呼び出します。
CFindReplaceDialog::ReplaceCurrent	ユーザーが現在の単語に置き換えられてするかどうかを判定するためにこの関数を呼び出します。
CFindReplaceDialog::SearchDown	ユーザーが検索に降順で続行するかどうかを判定するためにこの関数を呼び出します。

パブリック データ メンバー

名前	説明
CFindReplaceDialog::m_fr	CFindReplaceDialog オブジェクトをカスタマイズするために使われる構造体。

解説

ほかのコモン ダイアログ ボックスとは違って、CFindReplaceDialog オブジェクトはダイアログ ボックスの表示中にほかのウィンドウと対話できるモードレス ダイアログ ボックスです。CFindReplaceDialog オブジェクトは 2 種類あります。[検索] ダイアログ ボックスと [置換] ダイアログ ボックスです。ダイアログ ボックスに検索用および検索置換用の文字列を入力できますが、検索用または置換用の関数は実行されません。このような関数をアプリケーションに追加する必要があります。

CFindReplaceDialog オブジェクトを構築するには、用意されている引数を持たないコンストラクターを使います。このダイアログ ボックスはモードレス ダイアログ ボックスなので、オブジェクトはスタック上ではなく、new 演算子を使ってヒープ領域に確保されます。

CFindReplaceDialog オブジェクトを構築したら、Create メンバー関数を呼び出して、ダイアログ ボックスを作成し、表示します。

Create メンバー関数を呼び出す前に、m_fr 構造体を使ってダイアログ ボックスを初期化します。m_fr 構造体の型は、FINDREPLACE です。この構造体の詳細については、Windows SDK を参照してください。

親ウィンドウに検索または置換を要求するときは、Windows の RegisterWindowMessage 関数を使用します。さらに、登録されたメッセージを処理する ON_REGISTERED_MESSAGE メッセージ マップ マクロをフレーム ウィンドウで使用します。

ダイアログ ボックスが終了したかどうかを調べるには、IsTerminating メンバー関数を使います。

CFindReplaceDialog は、Windows Versions 3.1 以降で配布される COMMDLG.DLL ファイルを使います。

ダイアログ ボックスをカスタマイズするには、CFindReplaceDialog からクラスを派生し、独自のダイアログ テンプレートを作成します。さらに、外部のコントロールからの通知メッセージを処理するためにメッセージ マップを追加します。処理されないメッセージは基本クラスに渡されます。

フック関数のカスタマイズは必要ありません。

CFindReplaceDialog の使い方の詳細については、「コモン ダイアログ クラス」を参照してください。

継承階層

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

CFindReplaceDialog

必要条件

ヘッダー: afxdlgs.h

参照

関連項目

CCommonDialog クラス

階層図