Partager via


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

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.

Syntaxe

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

Paramètres

[in] dwIDCtl

Type : DWORD

ID du groupe de visuels.

[in] pszLabel

Type : LPCWSTR

Pointeur vers une mémoire tampon qui contient du texte, sous la forme d’une chaîne Unicode terminée par null, qui apparaît en regard du groupe visuel.

Valeur retournée

Type : HRESULT

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

Remarques

Les contrôles continueront d’être ajoutés à ce groupe de visuels jusqu’à ce que vous appeliez IFileDialogCustomize ::EndVisualGroup.

Un groupe de visuels peut être masqué et désactivé comme n’importe quel autre contrôle, sauf que cela affecte tous les contrôles qu’il contient. Les membres individuels du groupe de visuels peuvent également être masqués et désactivés isolément.

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)