Interface IFileDialogCustomize (shobjidl_core.h)

Expõe métodos que permitem que um aplicativo adicione controles a uma caixa de diálogo de arquivo comum.

Herança

A interface IFileDialogCustomize herda da interface IUnknown . IFileDialogCustomize também tem estes tipos de membros:

Métodos

A interface IFileDialogCustomize tem esses métodos.

IFileDialogCustomize::AddCheckButton Adiciona um botão de marcar (caixa marcar) à caixa de diálogo.
IFileDialogCustomize::AddComboBox Adiciona uma caixa de combinação à caixa de diálogo.
IFileDialogCustomize::AddControlItem Adiciona um item a um controle de contêiner no diálogo.
IFileDialogCustomize::AddEditBox Adiciona um controle de caixa de edição à caixa de diálogo.
IFileDialogCustomize::AddMenu Adiciona um menu ao diálogo.
IFileDialogCustomize::AddPushButton Adiciona um botão ao diálogo.
IFileDialogCustomize::AddRadioButtonList Adiciona um grupo de botões de opção ao diálogo.
IFileDialogCustomize::AddSeparator Adiciona um separador à caixa de diálogo, permitindo uma separação visual de controles.
IFileDialogCustomize::AddText Adiciona conteúdo de texto ao diálogo.
IFileDialogCustomize::EnableOpenDropDown Habilita uma lista suspensa no botão Abrir ou Salvar no diálogo.
IFileDialogCustomize::EndVisualGroup Interrompe a adição de elementos a um grupo visual no diálogo.
IFileDialogCustomize::GetCheckButtonState Obtém o estado atual de um botão de seleção (caixa de seleção) no diálogo.
IFileDialogCustomize::GetControlItemState Obtém o estado atual de um item em um controle de contêiner encontrado no diálogo.
IFileDialogCustomize::GetControlState Obtém a visibilidade atual e os estados habilitados de determinado controle.
IFileDialogCustomize::GetEditBoxText Obtém o texto atual em um controle de caixa de edição.
IFileDialogCustomize::GetSelectedControlItem Obtém um item específico de controles de contêiner especificados no diálogo.
IFileDialogCustomize::MakeProminent Coloca um controle no diálogo para que ele se destaque em comparação com outros controles adicionados.
IFileDialogCustomize::RemoveAllControlItems Não implementado. (IFileDialogCustomize.RemoveAllControlItems)
IFileDialogCustomize::RemoveControlItem Remove um item de um controle de contêiner no diálogo.
IFileDialogCustomize::SetCheckButtonState Define o estado de um botão marcar (caixa marcar) na caixa de diálogo.
IFileDialogCustomize::SetControlItemState Define o estado atual de um item em um controle de contêiner encontrado no diálogo.
IFileDialogCustomize::SetControlItemText Define o texto de um item de controle. Por exemplo, o texto que acompanha um botão de opção ou um item em um menu.
IFileDialogCustomize::SetControlLabel Define o texto associado a um controle, como texto de botão ou rótulo de caixa de edição.
IFileDialogCustomize::SetControlState Define a visibilidade atual e os estados habilitados de determinado controle.
IFileDialogCustomize::SetEditBoxText Define o texto em um controle de caixa de edição encontrado na caixa de diálogo.
IFileDialogCustomize::SetSelectedControlItem Define o estado selecionado de um item específico em um grupo de botões de opção ou em uma caixa de combinação encontrada no diálogo.
IFileDialogCustomize::StartVisualGroup Declara um grupo visual no diálogo. Chamadas subsequentes a qualquer método "add" adicionam esses elementos a esse grupo.

Comentários

Quando implementar

IFileDialogControlEvents é implementado pela caixa de diálogo de abertura de arquivo comum (CLSID_FileOpenDialog) e caixa de diálogo de salvamento de arquivo (CLSID_FileSaveDialog).

Os controles são adicionados à caixa de diálogo antes que a caixa de diálogo seja mostrada. Seu layout está implícito pela ordem em que são adicionados. Depois que a caixa de diálogo é mostrada, os controles não podem ser adicionados ou removidos, mas os controles existentes podem ser ocultos ou desabilitados a qualquer momento. Seus rótulos também podem ser alterados a qualquer momento.

Os controles de contêiner são controles que podem ter itens adicionados a eles. Os controles de contêiner incluem caixas de combinação, menus, a lista suspensa anexada ao botão Abrir e quaisquer grupos de botões de opção. A ordem em que os itens aparecem em um contêiner é a ordem em que eles foram adicionados. Não há nenhuma instalação para reordená-los. As IDs têm como escopo o controle pai. Os controles de contêiner, com exceção dos menus, têm um item selecionado.

Os itens com um controle de contêiner não podem ser alterados depois de terem sido criados, exceto para seus estados habilitados e visíveis. No entanto, eles podem ser adicionados e removidos a qualquer momento. Por exemplo, se você precisasse alterar o texto de um menu, precisaria remover o menu atual e adicionar outro com o texto correto.

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_core.h (inclua Shobjidl.h)