Partager via


IFileDialogCustomize ::SetControlItemState, méthode (shobjidl_core.h)

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

Syntaxe

HRESULT SetControlItemState(
  [in] DWORD           dwIDCtl,
  [in] DWORD           dwIDItem,
  [in] CDCONTROLSTATEF dwState
);

Paramètres

[in] dwIDCtl

Type : DWORD

ID du contrôle conteneur.

[in] dwIDItem

Type : DWORD

ID de l'élément.

[in] dwState

Type : CDCONTROLSTATEF

Une ou plusieurs valeurs de l’énumération CDCONTROLSTATE qui indiquent le nouvel état du contrôle.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

L’état par défaut d’un élément de contrôle est activé et visible. Les éléments des groupes de contrôles ne peuvent pas être modifiés après leur création, à l’exception de leurs états activés et visibles.

Les contrôles de conteneur incluent des groupes de boutons d’option, des zones de liste déroulante, des listes déroulantes sur le bouton Ouvrir ou Enregistrer et des menus.

Configuration requise

Condition requise Valeur
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)