Partager via


IFileDialogCustomize, interface (shobjidl_core.h)

Expose des méthodes qui permettent à une application d’ajouter des contrôles à une boîte de dialogue de fichiers commune.

Héritage

L’interface IFileDialogCustomize hérite de l’interface IUnknown. IFileDialogCustomize a également les types de membres suivants :

Méthodes

L’interface IFileDialogCustomize a ces méthodes.

 
IFileDialogCustomize::AddCheckButton

Ajoute un bouton case activée (zone case activée) à la boîte de dialogue.
IFileDialogCustomize::AddComboBox

Ajoute une zone de liste déroulante à la boîte de dialogue.
IFileDialogCustomize::AddControlItem

Ajoute un élément à un contrôle conteneur dans la boîte de dialogue.
IFileDialogCustomize::AddEditBox

Ajoute un contrôle de zone d’édition à la boîte de dialogue.
IFileDialogCustomize::AddMenu

Ajoute un menu à la boîte de dialogue.
IFileDialogCustomize::AddPushButton

Ajoute un bouton à la boîte de dialogue.
IFileDialogCustomize::AddRadioButtonList

Ajoute un groupe de bouton d’option (également appelé case d’option) à la boîte de dialogue.
IFileDialogCustomize::AddSeparator

Ajoute un séparateur à la boîte de dialogue, ce qui permet une séparation visuelle des contrôles.
IFileDialogCustomize::AddText

Ajoute du contenu texte à la boîte de dialogue.
IFileDialogCustomize::EnableOpenDropDown

Active une liste déroulante sur le bouton Ouvrir ou Enregistrer dans la boîte de dialogue.
IFileDialogCustomize::EndVisualGroup

Arrête l’ajout d’éléments à un groupe de visuels dans la boîte de dialogue.
IFileDialogCustomize::GetCheckButtonState

Obtient l’état actuel d’un bouton case activée (zone case activée) dans la boîte de dialogue.
IFileDialogCustomize::GetControlItemState

Obtient l’état actuel d’un élément dans un contrôle conteneur trouvé dans la boîte de dialogue.
IFileDialogCustomize::GetControlState

Obtient la visibilité actuelle et les états activés d’un contrôle donné.
IFileDialogCustomize::GetEditBoxText

Obtient le texte actuel dans un contrôle de zone d’édition.
IFileDialogCustomize::GetSelectedControlItem

Obtient un élément particulier à partir des contrôles de conteneur spécifiés dans la boîte de dialogue.
IFileDialogCustomize::MakeProminent

Place un contrôle dans la boîte de dialogue afin qu’il se distingue des autres contrôles ajoutés.
IFileDialogCustomize::RemoveAllControlItems

Non implémenté. (IFileDialogCustomize.RemoveAllControlItems)
IFileDialogCustomize::RemoveControlItem

Supprime un élément d’un contrôle conteneur dans la boîte de dialogue.
IFileDialogCustomize::SetCheckButtonState

Définit l’état d’un bouton case activée (zone case activée) dans la boîte de dialogue.
IFileDialogCustomize::SetControlItemState

Définit l’état actuel d’un élément dans un contrôle conteneur trouvé dans la boîte de dialogue.
IFileDialogCustomize::SetControlItemText

Définit le texte d’un élément de contrôle. Par exemple, le texte qui accompagne une case d’option ou un élément dans un menu.
IFileDialogCustomize::SetControlLabel

Définit le texte associé à un contrôle, tel que le texte du bouton ou une étiquette de zone d’édition.
IFileDialogCustomize::SetControlState

Définit la visibilité actuelle et les états activés d’un contrôle donné.
IFileDialogCustomize::SetEditBoxText

Définit le texte dans un contrôle de zone d’édition qui se trouve dans la boîte de dialogue.
IFileDialogCustomize::SetSelectedControlItem

Définit l’état sélectionné d’un élément particulier dans un groupe de boutons d’option ou une zone de liste modifiable qui se trouve dans la boîte de dialogue.
IFileDialogCustomize::StartVisualGroup

Déclare un groupe de visuels dans la boîte de dialogue. Les appels suivants à toute méthode « add » ajoutent ces éléments à ce groupe.

Remarques

Quand implémenter

IFileDialogControlEvents est implémenté par la boîte de dialogue commune d’ouverture de fichier (CLSID_FileOpenDialog) et la boîte de dialogue d’enregistrement de fichier (CLSID_FileSaveDialog).

Les contrôles sont ajoutés au dialogue avant l’affichage du dialogue. Leur disposition est implicite par l’ordre dans lequel ils sont ajoutés. Une fois la boîte de dialogue affichée, les contrôles ne peuvent pas être ajoutés ou supprimés, mais les contrôles existants peuvent être masqués ou désactivés à tout moment. Leurs étiquettes peuvent également être modifiées à tout moment.

Les contrôles de conteneur sont des contrôles auxquels des éléments peuvent être ajoutés. Les contrôles de conteneur incluent des zones de liste déroulante, des menus, la liste déroulante attachée au bouton Ouvrir et des groupes de boutons d’option. L’ordre dans lequel les éléments apparaissent dans un conteneur est l’ordre dans lequel ils ont été ajoutés. Il n’y a pas de possibilité de les réorganiser. Les ID sont limités au contrôle parent. Les contrôles de conteneur, à l’exception des menus, ont un élément sélectionné.

Les éléments avec un contrôle conteneur ne peuvent pas être modifiés après leur création, à l’exception de leurs états activés et visibles. Toutefois, ils peuvent être ajoutés et supprimés à tout moment. Par exemple, si vous devez modifier le texte d’un menu, vous devez supprimer le menu actuel et en ajouter un autre avec le texte correct.

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (incluez Shobjidl.h)