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)