IFileDialogCustomize インターフェイス (shobjidl_core.h)
アプリケーションが共通のファイル ダイアログにコントロールを追加できるようにするメソッドを公開します。
継承
IFileDialogCustomize インターフェイスは、IUnknown インターフェイスから継承します。 IFileDialogCustomize には、次の種類のメンバーもあります。
メソッド
IFileDialogCustomize インターフェイスには、これらのメソッドがあります。
| IFileDialogCustomize::AddCheckButton ダイアログにチェック ボタン (チェック ボックス) を追加します。 |
| IFileDialogCustomize::AddComboBox ダイアログにコンボ ボックスを追加します。 |
| IFileDialogCustomize::AddControlItem ダイアログ内のコンテナー コントロールに項目を追加します。 |
| IFileDialogCustomize::AddEditBox ダイアログに編集ボックス コントロールを追加します。 |
| IFileDialogCustomize::AddMenu ダイアログにメニューを追加します。 |
| IFileDialogCustomize::AddPushButton ダイアログにボタンを追加します。 |
| IFileDialogCustomize::AddRadioButtonList オプション ボタン (ラジオ ボタンとも呼ばれます) グループをダイアログに追加します。 |
| IFileDialogCustomize::AddSeparator ダイアログに区切り記号を追加し、コントロールを視覚的に分離できるようにします。 |
| IFileDialogCustomize::AddText ダイアログにテキスト コンテンツを追加します。 |
| IFileDialogCustomize::EnableOpenDropDown ダイアログの [開く] または [保存] ボタンのドロップダウン リストを有効にします。 |
| IFileDialogCustomize::EndVisualGroup ダイアログ内のビジュアル グループへの要素の追加を停止します。 |
| IFileDialogCustomize::GetCheckButtonState ダイアログ内のチェック ボタン (チェック ボックス) の現在の状態を取得します。 |
| IFileDialogCustomize::GetControlItemState ダイアログで見つかったコンテナー コントロール内の項目の現在の状態を取得します。 |
| IFileDialogCustomize::GetControlState 特定のコントロールの現在の可視性と有効な状態を取得します。 |
| IFileDialogCustomize::GetEditBoxText 編集ボックス コントロールの現在のテキストを取得します。 |
| IFileDialogCustomize::GetSelectedControlItem ダイアログ内の指定したコンテナー コントロールから特定の項目を取得します。 |
| IFileDialogCustomize::MakeProminent ダイアログにコントロールを配置して、他の追加されたコントロールと比較して目立たないようにします。 |
| IFileDialogCustomize::RemoveAllControlItems 実装されていません。 (IFileDialogCustomize.RemoveAllControlItems) |
| IFileDialogCustomize::RemoveControlItem ダイアログ内のコンテナー コントロールから項目を削除します。 |
| IFileDialogCustomize::SetCheckButtonState ダイアログのチェック ボタン (チェック ボックス) の状態を設定します。 |
| IFileDialogCustomize::SetControlItemState ダイアログで見つかったコンテナー コントロール内の項目の現在の状態を設定します。 |
| IFileDialogCustomize::SetControlItemText コントロール項目のテキストを設定します。 たとえば、ラジオ ボタンやメニュー内の項目に付随するテキストなどです。 |
| IFileDialogCustomize::SetControlLabel ボタン テキストや編集ボックス ラベルなど、コントロールに関連付けられているテキストを設定します。 |
| IFileDialogCustomize::SetControlState 特定のコントロールの現在の可視性と有効な状態を設定します。 |
| IFileDialogCustomize::SetEditBoxText ダイアログで見つかった編集ボックス コントロールのテキストを設定します。 |
| IFileDialogCustomize::SetSelectedControlItem オプション ボタン グループまたはダイアログで見つかったコンボ ボックス内の特定の項目の選択状態を設定します。 |
| IFileDialogCustomize::StartVisualGroup ダイアログでビジュアル グループを宣言します。 後続の "add" メソッドの呼び出しによって、これらの要素がこのグループに追加されます。 |
解説
実装するタイミング
IFileDialogControlEvents は、共通のファイルを開くダイアログ (CLSID_FileOpenDialog) とファイルの保存ダイアログ (CLSID_FileSaveDialog) によって実装されます。
ダイアログが表示される前に、ダイアログにコントロールが追加されます。 レイアウトは、追加される順序によって暗黙的に指定されます。 ダイアログが表示されたら、コントロールを追加または削除することはできませんが、既存のコントロールはいつでも非表示または無効にすることができます。 ラベルはいつでも変更できます。
コンテナー コントロールは、項目を追加できるコントロールです。 コンテナー コントロールには、コンボ ボックス、メニュー、 [開く ] ボタンに添付されているドロップダウン リスト、およびオプション ボタン グループが含まれます。 項目がコンテナーに表示される順序は、項目が追加された順序です。 それらを並べ替える機能はありません。 ID のスコープは親コントロールに設定されます。 コンテナー コントロールには、メニューを除く項目が選択されています。
コンテナー コントロールを持つ項目は、有効な状態と表示状態を除き、作成後に変更することはできません。 ただし、いつでも追加および削除できます。 たとえば、メニューのテキストを変更する必要がある場合は、現在のメニューを削除し、正しいテキストで別のメニューを追加する必要があります。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shobjidl_core.h (Shobjidl.h を含む) |