Edit

IFileDialogCustomize interface (shobjidl_core.h)

  • Article

Exposes methods that allow an application to add controls to a common file dialog.

Inheritance

The IFileDialogCustomize interface inherits from the IUnknown interface. IFileDialogCustomize also has these types of members:

Methods

The IFileDialogCustomize interface has these methods.

 
IFileDialogCustomize::AddCheckButton

Adds a check button (check box) to the dialog.
IFileDialogCustomize::AddComboBox

Adds a combo box to the dialog.
IFileDialogCustomize::AddControlItem

Adds an item to a container control in the dialog.
IFileDialogCustomize::AddEditBox

Adds an edit box control to the dialog.
IFileDialogCustomize::AddMenu

Adds a menu to the dialog.
IFileDialogCustomize::AddPushButton

Adds a button to the dialog.
IFileDialogCustomize::AddRadioButtonList

Adds an option button (also known as radio button) group to the dialog.
IFileDialogCustomize::AddSeparator

Adds a separator to the dialog, allowing a visual separation of controls.
IFileDialogCustomize::AddText

Adds text content to the dialog.
IFileDialogCustomize::EnableOpenDropDown

Enables a drop-down list on the Open or Save button in the dialog.
IFileDialogCustomize::EndVisualGroup

Stops the addition of elements to a visual group in the dialog.
IFileDialogCustomize::GetCheckButtonState

Gets the current state of a check button (check box) in the dialog.
IFileDialogCustomize::GetControlItemState

Gets the current state of an item in a container control found in the dialog.
IFileDialogCustomize::GetControlState

Gets the current visibility and enabled states of a given control.
IFileDialogCustomize::GetEditBoxText

Gets the current text in an edit box control.
IFileDialogCustomize::GetSelectedControlItem

Gets a particular item from specified container controls in the dialog.
IFileDialogCustomize::MakeProminent

Places a control in the dialog so that it stands out compared to other added controls.
IFileDialogCustomize::RemoveAllControlItems

Not implemented. (IFileDialogCustomize.RemoveAllControlItems)
IFileDialogCustomize::RemoveControlItem

Removes an item from a container control in the dialog.
IFileDialogCustomize::SetCheckButtonState

Sets the state of a check button (check box) in the dialog.
IFileDialogCustomize::SetControlItemState

Sets the current state of an item in a container control found in the dialog.
IFileDialogCustomize::SetControlItemText

Sets the text of a control item. For example, the text that accompanies a radio button or an item in a menu.
IFileDialogCustomize::SetControlLabel

Sets the text associated with a control, such as button text or an edit box label.
IFileDialogCustomize::SetControlState

Sets the current visibility and enabled states of a given control.
IFileDialogCustomize::SetEditBoxText

Sets the text in an edit box control found in the dialog.
IFileDialogCustomize::SetSelectedControlItem

Sets the selected state of a particular item in an option button group or a combo box found in the dialog.
IFileDialogCustomize::StartVisualGroup

Declares a visual group in the dialog. Subsequent calls to any "add" method add those elements to this group.

Remarks

When to Implement

IFileDialogControlEvents is implemented by the common file open dialog (CLSID_FileOpenDialog) and file save dialog (CLSID_FileSaveDialog).

Controls are added to the dialog before the dialog is shown. Their layout is implied by the order in which they are added. Once the dialog is shown, controls cannot be added or removed, but the existing controls can be hidden or disabled at any time. Their labels can also be changed at any time.

Container controls are controls that can have items added to them. Container controls include combo boxes, menus, the drop-down list attached to the Open button, and any option button groups. The order that items appear in a container is the order in which they were added. There is no facility for reordering them. IDs are scoped to the parent control. Container controls, with the exception of menus, have a selected item.

Items with a container control cannot be changed after they have been created, except for their enabled and visible states. However, they can be added and removed at any time. For example, if you needed to change the text of a menu, you would have to remove the current menu and add another with the correct text.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)