ホーム › UI.WindowsAndMessaging › PROPENUMPROCEXW

PROPENUMPROCEXW

コールバック

シグネチャ

BOOL PROPENUMPROCEXW(
    HWND param0,
    LPWSTR param1,
    HANDLE param2,
    UINT_PTR param3
);

パラメーター

フィールド	型	説明
param0	HWND	プロパティリストが列挙されるウィンドウへのハンドルです。このパラメーターは通常 hWnd という名前が付けられます。
param1	LPWSTR	プロパティリストエントリの文字列コンポーネントです。これは、SetProp 関数の呼び出しによってプロパティがウィンドウのプロパティリストに追加されたときに、データハンドルと共に指定された文字列です。このパラメーターは通常 lpString という名前が付けられます。
param2	HANDLE	データへのハンドルです。このハンドルは、プロパティリストエントリのデータコンポーネントです。このパラメーターは通常 hData という名前が付けられます。
param3	UINT_PTR	アプリケーション定義のデータです。これは、列挙を開始した EnumPropsEx の呼び出しで lParam パラメーターとして指定された値です。このパラメーターは通常 dwData という名前が付けられます。

公式ドキュメント

EnumPropsEx 関数と共に使用される、アプリケーション定義のコールバック関数です。この関数は、ウィンドウのプロパティリストからプロパティエントリを受け取ります。PROPENUMPROCEX 型は、このコールバック関数へのポインターを定義します。PropEnumProcEx は、アプリケーション定義の関数名のプレースホルダーです。

戻り値

型: BOOL

プロパティリストの列挙を継続するには TRUE を返します。

プロパティリストの列挙を停止するには FALSE を返します。

解説(Remarks)

メモ

パラメーターはヘッダー内で名前を付けずに定義されています: typedef BOOL (CALLBACK* PROPENUMPROCEXW)(HWND, LPWSTR, HANDLE, ULONG_PTR);。そのため、構文ブロックでは unnamedParam1 ～ unnamedParam4 として記載されています。これらのパラメーターには、アプリ内で任意の名前を付けることができます。ただし、通常はパラメーターの説明に示したとおりの名前が使用されます。

このコールバック関数には次の制限が適用されます。

コールバック関数は RemoveProp 関数を呼び出すことができます。ただし、RemoveProp が削除できるのは、コールバック関数のパラメーターを通じてコールバック関数に渡されたプロパティだけです。
コールバック関数でプロパティを追加しようとしてはいけません。

メモ

winuser.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版と Unicode 版を自動的に選択するエイリアスとして PROPENUMPROCEX を定義しています。エンコーディング中立のエイリアスの使用を、エンコーディング中立でないコードと混在させると、不一致が生じてコンパイルエラーや実行時エラーの原因になることがあります。詳細については、「Conventions for Function Prototypes」を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)