FINDREPLACEA 構造体 (commdlg.h)

FindText および ReplaceText 関数 Find の初期化と置換 ダイアログ ボックス 使用する情報が含まれます。 FINDMSGSTRING 登録済みメッセージは、この構造体を使用して、ユーザーの検索または置換の入力を 検索 または 置換 ダイアログ ボックスの所有者ウィンドウに渡します。

構文

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;

メンバーズ

lStructSize

型: DWORD

構造体の長さ (バイト単位)。

hwndOwner

型: HWND

ダイアログ ボックスを所有するウィンドウへのハンドル。 指定されたウィンドウのウィンドウ・プロシージャーは、ダイアログ・ボックスから FINDMSGSTRING メッセージ 受け取ります。 このメンバーには任意の有効なウィンドウ ハンドルを指定できますが、NULLすることはできません。

hInstance

型: HINSTANCE

フラグで FR_ENABLETEMPLATEHANDLE フラグが設定されている場合、hInstance は、ダイアログ ボックス テンプレートを含むメモリ オブジェクトへのハンドルです。 FR_ENABLETEMPLATE フラグが設定されている場合、hInstance は、lpTemplateName メンバーによって名前付けされたダイアログ ボックス テンプレートを含むモジュールへのハンドルです。 どちらのフラグも設定されていない場合、このメンバーは無視されます。

Flags

型: DWORD

ダイアログ ボックスの初期化に使用できるビット フラグのセット。 ダイアログ ボックスは、ユーザーの入力を示す FINDMSGSTRING 登録済みメッセージを送信するときに、これらのフラグを設定します。 このメンバーには、次の値のうち 1 つ以上を指定できます。

lpstrFindWhat

型: LPTSTR

ユーザーが Find What edit コントロールに入力した検索文字列。 ダイアログ ボックスが閉じる前にスコープ外に出ないように、バッファーを動的に割り当てるか、グローバル配列または静的配列を使用する必要があります。 バッファーの長は 80 文字以上にする必要があります。 ダイアログ ボックスを初期化するときにバッファーに文字列が含まれている場合、文字列は 検索 編集コントロールに表示されます。 FINDMSGSTRING メッセージで FR_FINDNEXT フラグが指定されている場合、lpstrFindWhat 検索する文字列が含まれます。 FR_DOWN、FR_WHOLEWORD、および FR_MATCHCASE フラグは、検索の方向と種類を示します。 FINDMSGSTRING メッセージが FR_REPLACE または FR_REPLACE フラグを指定している場合、lpstrFindWhat 置き換える文字列が含まれます。

lpstrReplaceWith

型: LPTSTR

ユーザーが Replace With edit コントロールに入力した置換文字列。 ダイアログ ボックスが閉じる前にスコープ外に出ないように、バッファーを動的に割り当てるか、グローバル配列または静的配列を使用する必要があります。 ダイアログ ボックスを初期化するときにバッファーに文字列が含まれている場合、文字列は Replace With 編集コントロールに表示されます。

FINDMSGSTRING メッセージが FR_REPLACE フラグまたは FR_REPLACEALL フラグを指定する場合、lpstrReplaceWith には置換文字列が含まれます。

FindText 関数は、このメンバーを無視します。

wFindWhatLen

型: word

lpstrFindWhat メンバーが指すバッファーの長さ (バイト単位)。

wReplaceWithLen

型: word

lpstrReplaceWith メンバーが指すバッファーの長さ (バイト単位)。

lCustData

型: LPARAM

lpfnHook メンバーによって識別されるフック・プロシージャーにシステムが渡すアプリケーション定義データ。 システムが WM_INITDIALOG メッセージをフック・プロシージャーに送信する場合、メッセージの lParam パラメーターは、ダイアログの作成時に指定された FINDREPLACE 構造体へのポインターです。 フック プロシージャでは、このポインターを使用して、lCustData 値を取得できます。

lpfnHook

型: LPFRHOOKPROC

ダイアログ ボックス用のメッセージを処理できる FRHookProc フック プロシージャへのポインター。 Flags メンバーで FR_ENABLEHOOK フラグが設定されていない限り、このメンバーは無視されます。 フック プロシージャが WM_INITDIALOG メッセージに応答して FALSE 返す場合、フック プロシージャはダイアログ ボックスを表示する必要があります。そうしないと、ダイアログ ボックスは表示されません。 これを行うには、まず他のペイント操作を実行してから、ShowWindow を呼び出し、UpdateWindow 関数を します。

lpTemplateName

型: LPCTSTR

hInstance メンバーによって識別されるモジュール内のダイアログ ボックス テンプレート リソースの名前。 このテンプレートは、標準のダイアログ ボックス テンプレートに置き換えられます。 番号付きダイアログ ボックス リソースの場合は、MAKEINTRESOURCE マクロによって返される値を指定できます。 Flags メンバーで FR_ENABLETEMPLATE フラグが設定されていない限り、このメンバーは無視されます。

備考

必要条件

関連項目

共通ダイアログ ボックス ライブラリ

概念

FRHookProc の

FindText の

MAKEINTRESOURCE を する

リファレンス

ReplaceText の

ShowWindow の

WM_INITDIALOG