NEWCPLINFOW 構造体 (cpl.h)

  • [アーティクル]

コントロール パネル アプリケーションでサポートされているダイアログ ボックスのリソース情報とアプリケーション定義の値が含まれます。

構文

typedef struct tagNEWCPLINFOW {
  DWORD    dwSize;
  DWORD    dwFlags;
  DWORD    dwHelpContext;
  LONG_PTR lData;
  HICON    hIcon;
  WCHAR    szName[32];
  WCHAR    szInfo[64];
  WCHAR    szHelpFile[128];
} NEWCPLINFOW, *LPNEWCPLINFOW;

メンバー

dwSize

型: DWORD

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

dwFlags

型: DWORD

このメンバーは無視されます。

dwHelpContext

型: DWORD

このメンバーは無視されます。

lData

種類: LONG_PTR

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

hIcon

種類: HICON

ダイアログ ボックスを表すアイコンの識別子。 このアイコンは、コントロール パネル アプリケーションを制御するアプリケーションによって表示されることを目的としています。

szName[32]

種類: TCHAR[32]

ダイアログ ボックス名を含む null で終わる文字列。 名前は、アイコンの下に表示されることを目的としています。

szInfo[64]

種類: TCHAR[64]

ダイアログ ボックスの説明を含む null で終わる文字列。 説明は、ダイアログ ボックスのアイコンが選択されたときに表示されることを目的としています。

szHelpFile[128]

種類: TCHAR[128]

このメンバーは無視されます。

注釈

コントロール パネル アプリケーションの CPlApplet 関数は、CPL_NEWINQUIRE メッセージに応答して、この情報をコントロール パネルに返します。

注意

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

要件

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

こちらもご覧ください

CPLINFO