PROPENUMPROCEXA コールバック関数 (winuser.h)

  • [アーティクル]

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

構文

PROPENUMPROCEXA Propenumprocexa;

BOOL Propenumprocexa(
  HWND unnamedParam1,
  LPSTR unnamedParam2,
  HANDLE unnamedParam3,
  ULONG_PTR unnamedParam4
)
{...}

パラメーター

unnamedParam1

型: HWND

プロパティ リストが列挙されているウィンドウへのハンドル。

unnamedParam2

種類: LPTSTR

プロパティ リスト エントリの文字列コンポーネント。 これは、 SetProp 関数の呼び出しによってプロパティがウィンドウのプロパティ リストに追加されたときに、データ ハンドルと共に指定された文字列です。

unnamedParam3

型: HANDLE

データのハンドル。 このハンドルは、プロパティ リスト エントリのデータ コンポーネントです。

unnamedParam4

種類: ULONG_PTR

アプリケーション定義データ。 これは、列挙を開始した EnumPropsEx の呼び出しの lParam パラメーターとして指定された値です。

戻り値

種類: BOOL

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

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

解説

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

  • コールバック関数は 、RemoveProp 関数を呼び出すことができます。 ただし、 RemoveProp では 、コールバック関数のパラメーターを使用してコールバック関数に渡されたプロパティのみを削除できます。
  • コールバック関数は、プロパティの追加を試みてはなりません。

注意

winuser.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして PROPENUMPROCEX を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)

関連項目

概念

EnumPropsEx

リファレンス

RemoveProp

SetProp

ウィンドウ プロパティ