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) |