Partager via


Méthode IFileDialogCustomize ::AddControlItem (shobjidl_core.h)

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

Syntaxe

HRESULT AddControlItem(
  [in] DWORD   dwIDCtl,
  [in] DWORD   dwIDItem,
  [in] LPCWSTR pszLabel
);

Paramètres

[in] dwIDCtl

Type : DWORD

ID du contrôle de conteneur auquel l’élément doit être ajouté.

[in] dwIDItem

Type : DWORD

ID de l'élément.

[in] pszLabel

Type : LPCWSTR

Pointeur vers une mémoire tampon qui contient le texte de l’élément, qui peut être une étiquette ou, dans le cas d’une liste déroulante, l’élément lui-même. Ce texte est une chaîne Unicode terminée par null.

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 de cet élément est activé et visible. Les éléments des groupes de contrôles ne peuvent pas être modifiés une fois qu’ils ont été créés, à 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 (inclure Shobjidl.h)