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