CPLINFO 構造体 (cpl.h)

  • [アーティクル]

コントロール パネル アプリケーションでサポートされているダイアログ ボックスのリソース情報とアプリケーション定義値が含まれます。 コントロール パネル アプリケーションの CPlApplet 関数は、CPL_INQUIRE メッセージに応答してこの情報をコントロール パネルに返します。

構文

typedef struct tagCPLINFO {
  int      idIcon;
  int      idName;
  int      idInfo;
  LONG_PTR lData;
} CPLINFO, *LPCPLINFO;

メンバー

idIcon

型: int

ダイアログ ボックスを表すアイコンのリソース識別子。

idName

型: int

ダイアログ ボックスの短い名前を含む文字列のリソース識別子。 この名前は、アイコンの下に表示されることを意図しています。

idInfo

型: int

アプリケーション アイコンが選択されたときに表示されるダイアログ ボックスの説明を含む文字列のリソース識別子。

lData

種類: LONG_PTR

アプリケーションによって定義されたデータへのポインター。 コントロール パネルがCPL_DBLCLKを送信し、メッセージをCPL_STOPすると、この値がアプリケーションに返されます。

解説

コンピューターの状態に基づいてダイアログ ボックスのアイコンまたは表示文字列を変更できる場合は、有効なリソース識別子を指定するのではなく、 idIcon、 idName、または idInfo メンバーのCPL_DYNAMIC_RES値を指定できます。 これにより、アイコンと表示文字列が必要なたびに、コントロール パネルはCPL_NEWINQUIRE メッセージを送信します。 ただし、CPL_NEWINQUIRE メッセージを送信するたびにコントロール パネルがアプリケーションを読み込む必要があるため、この手法の使用は大幅に遅くなります。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header cpl.h