IFileDialogCustomize::AddControlItem メソッド (shobjidl_core.h)

ダイアログ内のコンテナー コントロールに項目を追加します。

構文

HRESULT AddControlItem(
  [in] DWORD   dwIDCtl,
  [in] DWORD   dwIDItem,
  [in] LPCWSTR pszLabel
);

パラメーター

[in] dwIDCtl

型: DWORD

項目を追加するコンテナー コントロールの ID。

[in] dwIDItem

型: DWORD

項目の ID。

[in] pszLabel

種類: LPCWSTR

項目のテキストを含むバッファーへのポインター。ラベルまたはドロップダウン リストの場合はアイテム自体のいずれかです。 このテキストは null で終わる Unicode 文字列です。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

このアイテムの既定の状態が有効になり、表示されます。 コントロール グループ内の項目は、作成後は変更できません。有効な状態と表示状態を除きます。

コンテナー コントロールには、オプション ボタン グループ、コンボ ボックス、 [開く ] または [保存] ボタンのドロップダウン リスト、およびメニューが含まれます。

要件

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