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

Obtém o estado atual de um item em um controle de contêiner encontrado no diálogo.

Sintaxe

HRESULT GetControlItemState(
  [in]  DWORD           dwIDCtl,
  [in]  DWORD           dwIDItem,
  [out] CDCONTROLSTATEF *pdwState
);

Parâmetros

[in] dwIDCtl

Tipo: DWORD

A ID do controle de contêiner.

[in] dwIDItem

Tipo: DWORD

O ID do item.

[out] pdwState

Tipo: CDCONTROLSTATEF*

Um ponteiro para uma variável que recebe um dos valores a mais da enumeração CDCONTROLSTATE que indicam o estado atual do controle.

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 de um item de controle 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