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

Adiciona um item a um controle de contêiner no diálogo.

Sintaxe

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

Parâmetros

[in] dwIDCtl

Tipo: DWORD

A ID do controle de contêiner ao qual o item deve ser adicionado.

[in] dwIDItem

Tipo: DWORD

O ID do item.

[in] pszLabel

Tipo: LPCWSTR

Um ponteiro para um buffer que contém o texto do item, que pode ser um rótulo ou, no caso de uma lista suspensa, o item em si. Esse texto é uma cadeia de caracteres Unicode terminada em nulo.

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

O estado padrão desse item está habilitado e visível. Os itens em grupos de controle não podem ser alterados depois de criados, com exceção de seus estados habilitados e visíveis.

Os controles de contêiner incluem grupos de botões de opção, caixas de combinação, listas suspensas no botão Abrir ou Salvar e menus.

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)