Método IFileDialogCustomize::StartVisualGroup (shobjidl_core.h)

Declara um grupo visual no diálogo. Chamadas subsequentes a qualquer método "add" adicionam esses elementos a esse grupo.

Sintaxe

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

Parâmetros

[in] dwIDCtl

Tipo: DWORD

A ID do grupo visual.

[in] pszLabel

Tipo: LPCWSTR

Um ponteiro para um buffer que contém texto, como uma cadeia de caracteres Unicode terminada em nulo, que aparece ao lado do grupo visual.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Os controles continuarão a ser adicionados a esse grupo visual até que você chame IFileDialogCustomize::EndVisualGroup.

Um grupo visual pode ser oculto e desabilitado como qualquer outro controle, exceto que isso afeta todos os controles dentro dele. Membros individuais do grupo visual também podem ser ocultos e desabilitados.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)