Método IFileDialogControlEvents::OnItemSelected (shobjidl.h)

Chamado quando um item é selecionado em uma caixa de combinação, quando um usuário clica em um botão de opção (também conhecido como botão de opção) ou um item é escolhido no menu Ferramentas .

Sintaxe

HRESULT OnItemSelected(
  [in] IFileDialogCustomize *pfdc,
  [in] DWORD                dwIDCtl,
  [in] DWORD                dwIDItem
);

Parâmetros

[in] pfdc

Tipo: IFileDialogCustomize*

Um ponteiro para a interface pela qual o aplicativo adicionou controles à caixa de diálogo.

[in] dwIDCtl

Tipo: DWORD

A ID do controle no qual o usuário fez uma seleção.

[in] dwIDItem

Tipo: DWORD

A ID da seleção.

Valor retornado

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

Essa notificação não é enviada quando o usuário escolhe um item no menu suspenso anexado ao botão Abrir , pois a ação executada nesse caso é sempre a mesma: feche a caixa de diálogo como se o usuário tivesse simplesmente clicado no botão Abrir . Para essa situação, o aplicativo pode chamar GetSelectedControlItem para obter o item que o usuário escolheu nesse menu.

Requisitos

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.h