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

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

Syntaxe

HRESULT GetControlItemState(
  [in]  DWORD           dwIDCtl,
  [in]  DWORD           dwIDItem,
  [out] CDCONTROLSTATEF *pdwState
);

Paramètres

[in] dwIDCtl

Type : DWORD

ID du contrôle conteneur.

[in] dwIDItem

Type : DWORD

ID de l'élément.

[out] pdwState

Type : CDCONTROLSTATEF*

Pointeur vers une variable qui reçoit l’une des autres valeurs de l’énumération CDCONTROLSTATE qui indiquent l’état actuel 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)