Classe CMFCToolBarComboBoxButton

Artigo
08/04/2024

Um botão de barra de ferramentas que contém um controle de caixa de combinação (Classe CComboBox).

Sintaxe

class CMFCToolBarComboBoxButton : public CMFCToolBarButton

Membros

Construtores públicos

Nome	Descrição
CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton	Constrói um `CMFCToolBarComboBoxButton`.

Métodos públicos

Nome	Descrição
CMFCToolBarComboBoxButton::AddItem	Adiciona um item ao final da lista de caixas de combinação.
CMFCToolBarComboBoxButton::AddSortedItem	Adiciona um item à lista de caixas de combinação. A ordem dos itens na lista é especificada por `Compare`.
CMFCToolBarComboBoxButton::Compare	Compara dois itens. Chamado para classificar itens que `AddSortedItems` adiciona à lista de caixas de combinação.
CMFCToolBarComboBoxButton::CreateEdit	Cria um controle de edição para o botão da caixa de combinação.
CMFCToolBarComboBoxButton::DeleteItem	Exclui um item da lista de caixas de combinação.
CMFCToolBarComboBoxButton::FindItem	Retorna o índice do item que contém uma cadeia de caracteres especificada.
CMFCToolBarComboBoxButton::GetByCmd	Retorna um ponteiro para o botão da caixa de combinação com uma ID de comando especificada.
CMFCToolBarComboBoxButton::GetComboBox	Retorna um ponteiro para o controle da caixa de combinação inserido no botão da caixa de combinação.
CMFCToolBarComboBoxButton::GetCount	Retorna o número de itens na lista de caixas de combinação.
CMFCToolBarComboBoxButton::GetCountAll	Localiza o botão da caixa de combinação que tem uma ID de comando especificada. Retorna o número de itens na lista de caixas de combinação desse botão.
CMFCToolBarComboBoxButton::GetCurSel	Retorna o índice do item selecionado na lista de caixas de combinação.
CMFCToolBarComboBoxButton::GetCurSelAll	Localiza o botão da caixa de combinação que tem uma ID de comando especificada e retorna o índice do item selecionado na lista de caixas de combinação desse botão.
CMFCToolBarComboBoxButton::GetEditCtrl	Retorna um ponteiro para o controle de edição inserido no botão da caixa de combinação.
CMFCToolBarComboBoxButton::GetItem	Retorna a cadeia de caracteres associada a um índice especificado na lista de caixas de combinação.
CMFCToolBarComboBoxButton::GetItemAll	Localiza o botão da caixa de combinação que tem uma ID de comando especificada e retorna a cadeia de caracteres associada a um índice na lista de caixas de combinação desse botão.
CMFCToolBarComboBoxButton::GetItemData	Retorna o valor de 32 bits associado a um índice especificado na lista de caixas de combinação.
CMFCToolBarComboBoxButton::GetItemDataAll	Localiza o botão da caixa de combinação que tem uma ID de comando especificada e retorna o valor de 32bits associado a um índice na lista de caixas de combinação desse botão.
CMFCToolBarComboBoxButton::GetItemDataPtrAll	Localiza o botão da caixa de combinação que tem uma ID de comando especificada. Recupera o valor de 32 bits associado a um índice na lista de caixas de combinação desse botão e retorna o valor de 32 bits como um ponteiro.
CMFCToolBarComboBoxButton::GetText	Retorna o texto do controle de edição da caixa de combinação.
CMFCToolBarComboBoxButton::GetTextAll	Localiza o botão da caixa de combinação que tem uma ID de comando especificada e retorna o texto do controle de edição desse botão.
CMFCToolBarComboBoxButton::IsCenterVert	Determina se os botões da caixa de combinação no aplicativo estão centralizados ou alinhados à parte superior da barra de ferramentas.
CMFCToolBarComboBoxButton::IsFlatMode	Determina se os botões da caixa de combinação no aplicativo têm uma aparência plana.
CMFCToolBarComboBoxButton::RemoveAllItems	Remove todos os itens da caixa de listagem e do controle de edição da caixa de combinação.
CMFCToolBarComboBoxButton::SelectItem	Seleciona um item na caixa de combinação de acordo com o índice, o valor de 32 bits ou a cadeia de caracteres e notifica o controle da caixa de combinação sobre a seleção.
CMFCToolBarComboBoxButton::SelectItemAll	Localiza o botão da caixa de combinação que tem uma ID de comando especificada. Chama `SelectItem` para selecionar um item na caixa de combinação desse botão de acordo com a cadeia de caracteres, o índice ou o valor de 32 bits.
CMFCToolBarComboBoxButton::SetCenterVert	Especifica se os botões da caixa de combinação no aplicativo estão centralizados verticalmente ou alinhados à parte superior da barra de ferramentas.
CMFCToolBarComboBoxButton::SetDropDownHeight	Define a altura da caixa de listagem suspensa.
CMFCToolBarComboBoxButton::SetFlatMode	Especifica se os botões da caixa de combinação no aplicativo têm uma aparência plana.

Comentários

Para adicionar um botão de caixa de combinação a uma barra de ferramentas, siga estas etapas:

Reserve uma ID do recurso fictícia para o botão no recurso da barra de ferramentas pai.
Construir um objeto CMFCToolBarComboBoxButton.
No manipulador de mensagens que processa a mensagem AFX_WM_RESETTOOLBAR, substitua o botão fictício pelo novo botão de caixa de combinação usando CMFCToolBar::ReplaceButton.

Para saber mais, confira Passo a passo: colocando controles em barras de ferramentas. Para ver um exemplo de botão de barra de ferramentas de caixa de combinação, consulte o projeto de exemplo VisualStudioDemo.

Exemplo

O exemplo a seguir demonstra como usar vários métodos na classe CMFCToolBarComboBoxButton. O exemplo mostra como habilitar as caixas de edição e combinação, definir a posição vertical dos botões da caixa de combinação no aplicativo, definir a altura da caixa de listagem quando ela for acionada, definir a aparência de estilo plano dos botões da caixa de combinação no aplicativo e definir o texto na caixa de edição do botão da caixa de combinação. Esse snippet de código faz parte do exemplo de Demonstração do Visual Studio.

// CObList listButtons
// POSITION posCombo
CMFCToolBarComboBoxButton* pCombo = DYNAMIC_DOWNCAST(CMFCToolBarComboBoxButton, listButtons.GetNext(posCombo));

pCombo->EnableWindow(true);
pCombo->SetCenterVert();
pCombo->SetDropDownHeight(25);
pCombo->SetFlatMode();
pCombo->SetText(_T("this is a combo box"));

Hierarquia de herança

CObject

CMFCToolBarButton

CMFCToolBarComboBoxButton

Requisitos

Cabeçalho: afxtoolbarcomboboxbutton.h

CMFCToolBarComboBoxButton::AddItem

Acrescenta um item exclusivo à caixa de listagem.

virtual INT_PTR AddItem(
    LPCTSTR lpszItem,
    DWORD_PTR dwData=0);

Parâmetros

lpszItem
[in] O texto do item a ser adicionado à caixa de listagem.

dwData
[in] Os dados associados ao item a ser adicionado à caixa de listagem.

Valor de retorno

O índice do último item na caixa de listagem.

Comentários

Não use esse método quando o estilo da caixa de listagem for classificado.

Se o texto do item já estiver na caixa de listagem, os novos dados serão armazenados com o item existente. A pesquisa do item diferencia maiúsculas de minúsculas.

CMFCToolBarComboBoxButton::AddSortedItem

Adiciona um item à caixa de listagem na ordem definida pelo método Compare.

virtual INT_PTR AddSortedItem(
    LPCTSTR lpszItem,
    DWORD_PTR dwData=0);

Parâmetros

lpszItem
[in] O texto do item a ser adicionado à caixa de listagem.

dwData
[in] Os dados associados ao item a ser adicionado à caixa de listagem.

Valor de retorno

Índice do item que foi adicionado à caixa de listagem.

Comentários

Use essa função para adicionar itens à caixa de listagem em uma ordem específica.

CMFCToolBarComboBoxButton::CanBeStretched

Indica se o tamanho do botão da caixa de combinação pode mudar.

virtual BOOL CanBeStretched() const;

Valor de retorno

Retorna TRUE.

CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton

Constrói um objeto CMFCToolBarComboBoxButton.

CMFCToolBarComboBoxButton(
    UINT uiID,
    int iImage,
    DWORD dwStyle=CBS_DROPDOWNLIST,
    int iWidth=0);

Parâmetros

uiID
[in] A ID de comando do novo botão.

iImage
[in] O índice da imagem associada ao novo botão.

dwStyle
[in] O estilo do novo botão.

iWidth
[in] A largura, em pixels, do novo botão.

Comentários

A largura padrão é de 150 pixels.

Para obter uma lista de estilos de botão da barra de ferramentas, confira Estilos de controle da barra de ferramentas

CMFCToolBarComboBoxButton::ClearData

Exclui dados definidos pelo usuário.

virtual void ClearData();

Comentários

Por padrão, esse método não faz nada. Substitua esse método em uma classe derivada se quiser excluir dados definidos pelo usuário.

CMFCToolBarComboBoxButton::Compare

Compara duas cadeias de caracteres.

virtual int Compare(
    LPCTSTR lpszItem1,
    LPCTSTR lpszItem2);

Parâmetros

lpszItem1
[in] A primeira cadeia de caracteres a ser comparada.

lpszItem2
[in] A segunda cadeia de caracteres a ser comparada.

Valor de retorno

Um valor que indica a relação lexicográfica que diferencia maiúsculas de minúsculas entre as cadeias de caracteres. A tabela a seguir lista os valores possíveis:

Valor	Descrição
<0	A primeira cadeia de caracteres é menor que a segunda.
0	A primeira cadeia de caracteres é igual à segunda.
>0	A primeira cadeia de caracteres é maior que a segunda.

Comentários

Substitua esse método para alterar a forma como os itens são classificados na caixa de listagem.

A comparação diferencia maiúsculas de minúsculas.

Esse método é chamado somente do método AddSortedItem.

CMFCToolBarComboBoxButton::CopyFrom

Copia o estado do CMFCToolBarComboBoxButton especificado para o objeto atual.

virtual void CopyFrom(const CMFCToolBarButton& src);

Parâmetros

src
[in] O objeto CMFCToolBarComboBoxButton de origem.

CMFCToolBarComboBoxButton::CreateCombo

Cria uma caixa de combinação para o botão de caixa de combinação.

virtual CComboBox* CreateCombo(
    CWnd* pWndParent,
    const CRect& rect);

Parâmetros

pWndParent
[in] Um ponteiro para a janela pai do botão.

rect
[in] Retângulo delimitador da caixa de combinação.

Valor de retorno

Um ponteiro para a nova caixa de combinação se o método tiver sido bem-sucedido; caso contrário, NULL.

CMFCToolBarComboBoxButton::CreateEdit

Cria uma caixa de edição para o botão da caixa de combinação.

virtual CMFCToolBarComboBoxEdit* CreateEdit(
    CWnd* pWndParent,
    const CRect& rect,
    DWORD dwEditStyle);

Parâmetros

pWndParent
[in] Um ponteiro para a janela pai do botão.

rect
[in] Retângulo delimitador da nova caixa de edição.

dwEditStyle
[in] Estilo de controle da nova caixa de edição.

Valor de retorno

Um ponteiro para a nova caixa de edição se o método tiver sido bem-sucedido; caso contrário, NULL.

Comentários

A estrutura chama esse método quando cria uma caixa de edição para um botão de caixa de combinação. Substitua esse método para alterar a forma como CMFCToolBarComboBoxEdit é criado.

CMFCToolBarComboBoxButton::DeleteItem

Exclui um item especificado da caixa de listagem.

BOOL DeleteItem(int iIndex);
BOOL DeleteItem(DWORD_PTR dwData);
BOOL DeleteItem(LPCTSTR lpszText);

Parâmetros

iIndex
[in] O índice de base zero do item a ser excluído.

dwData
[in] Os dados associados ao item a ser excluído.

lpszTexto
[in] O texto do item a ser excluído. Se houver vários itens com o mesmo texto, o primeiro será excluído.

Valor de retorno

TRUE se o item foi localizado e excluído com êxito; caso contrário, FALSE.

Comentários

CMFCToolBarComboBoxButton::DuplicateData

Duplica dados definidos pelo usuário.

virtual void DuplicateData();

Comentários

Por padrão, esse método não faz nada. Substitua esse método em uma classe derivada se quiser copiar dados definidos pelo usuário.

CMFCToolBarComboBoxButton::EnableWindow

Habilita ou desabilita as caixas de edição e combinação.

virtual void EnableWindow(BOOL bEnable = TRUE);

Parâmetros

bEnable
[in] TRUE para habilitar as caixas de edição e combinação; FALSE para desabilitá-las.

Comentários

Quando desabilitados, os controles não podem ficar ativos nem podem aceitar entrada de usuário.

CMFCToolBarComboBoxButton::ExportToMenuButton

Copia uma cadeia de caracteres da tabela de cadeia de caracteres do aplicativo para o menu especificado usando a ID de comando do botão da caixa de combinação.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Parâmetros

menuButton
[out] Referência a um botão do menu.

Valor de retorno

Sempre TRUE.

CMFCToolBarComboBoxButton::FindItem

Retorna o índice do primeiro item na caixa de listagem que contém uma cadeia de caracteres especificada.

int FindItem(LPCTSTR lpszText) const;

Parâmetros

lpszTexto
[in] O texto a ser pesquisado na caixa de listagem.

Valor de retorno

O índice do item ou CB_ERR se o item não for encontrado.

Comentários

CMFCToolBarComboBoxButton::GetByCmd

Obtém um ponteiro para o botão da caixa de combinação que tem uma ID de comando especificada.

static CMFCToolBarComboBoxButton* GetByCmd(
    UINT uiCmd,
    BOOL bIsFocus=FALSE);

Parâmetros

uiCmd
[in] A ID de comando de um botão da caixa de combinação.

bIsFocus
[in] TRUE para pesquisar apenas botões focados; FALSE para pesquisar todos os botões.

Valor de retorno

Um ponteiro para um botão da caixa de combinação ou NULL se o botão não for encontrado.

Comentários

CMFCToolBarComboBoxButton::GetComboBox

Retorna um ponteiro para a caixa de combinação no botão da caixa de combinação.

CComboBox* GetComboBox() const;

Valor de retorno

Um ponteiro para o objeto da Classe CComboBox se o método foi bem-sucedido; caso contrário, NULL.

Comentários

CMFCToolBarComboBoxButton::GetContextMenuID

Obtém a ID do recurso do menu de atalho para o botão da caixa de combinação.

UINT GetContextMenuID();

Valor de retorno

A ID do recurso do menu de atalho.

CMFCToolBarComboBoxButton::GetCount

Retorna o número de itens na caixa de listagem.

INT_PTR GetCount() const;

Valor de retorno

O número de itens na caixa de listagem.

Comentários

CMFCToolBarComboBoxButton::GetCountAll

Obtém o número de itens na caixa de listagem de um botão da caixa de combinação que tem uma ID de comando especificada.

static int GetCountAll(UINT uiCmd);

Parâmetros

uiCmd
[in] A ID de comando de um botão da caixa de combinação.

Valor de retorno

O número de itens na caixa de listagem; caso contrário, CB_ERR se o botão da caixa de combinação não for encontrado.

Comentários

CMFCToolBarComboBoxButton::GetCurSel

Obtém o índice do item selecionado no momento na caixa de listagem.

int GetCurSel() const;

Valor de retorno

O índice do item selecionado no momento na caixa de listagem ou CB_ERR se nenhum item estiver selecionado.

Comentários

O índice da caixa de listagem é baseado em zero.

CMFCToolBarComboBoxButton::GetCurSelAll

Retorna o índice do item selecionado no momento na caixa de listagem de um botão da caixa de combinação que tem uma ID de comando especificada.

static int GetCurSelAll(UINT uiCmd);

Parâmetros

uiCmd
[in] A ID de comando de um botão da caixa de combinação.

Valor de retorno

O índice do item selecionado no momento na caixa de listagem; caso contrário, CB_ERR se nenhum item estiver selecionado ou um botão da caixa de combinação não for encontrado.

Comentários

O índice da caixa de listagem é baseado em zero.

CMFCToolBarComboBoxButton::GetEditCtrl

Retorna um ponteiro para a caixa de edição no botão da caixa de combinação.

virtual CEdit* GetEditCtrl();

Valor de retorno

Um ponteiro para a caixa de edição se o método tiver sido bem-sucedido; caso contrário, NULL.

Comentários

CMFCToolBarComboBoxButton::GetHwnd

Retorna o identificador da janela da caixa de combinação.

virtual HWND GetHwnd();

Valor de retorno

O identificador de janela ou NULL se a caixa de combinação não estiver associada a um objeto de janela.

CMFCToolBarComboBoxButton::GetItem

Retorna a cadeia de caracteres associada a um item em um índice especificado na caixa de listagem.

LPCTSTR GetItem(int iIndex=-1) const;

Parâmetros

iIndex
[in] Índice baseado em zero de um item na caixa de listagem.

Valor de retorno

Um ponteiro para a cadeia de caracteres associada ao item; caso contrário, NULL se o parâmetro do índice for inválido ou for -1 e não houver um item selecionado na caixa de combinação.

Comentários

Um parâmetro de índice -1 retorna a cadeia de caracteres do item selecionado no momento.

CMFCToolBarComboBoxButton::GetItemAll

Retorna a cadeia de caracteres associada a um item em um índice especificado na caixa de listagem de um botão da caixa de combinação que tem uma ID de comando especificada.

static LPCTSTR GetItemAll(
    UINT uiCmd,
    int iIndex=-1);

Parâmetros

uiCmd
[in] A ID de comando de um botão da caixa de combinação.

iIndex
[in] O índice baseado em zero de um item na caixa de listagem.

Valor de retorno

Um ponteiro para a cadeia de caracteres do item se o método tiver sido bem-sucedido; caso contrário, NULL se o índice for inválido, um botão da caixa de combinação não for encontrado ou se o índice for -1 e não houver um item selecionado na caixa de combinação.

Comentários

Um valor de índice -1 retorna a cadeia de caracteres do item selecionado no momento.

CMFCToolBarComboBoxButton::GetItemData

Retorna os dados associados a um item em um índice específico na caixa de listagem.

DWORD_PTR GetItemData(int iIndex=-1) const;

Parâmetros

iIndex
[in] O índice baseado em zero de um item na caixa de listagem.

Valor de retorno

Os dados associados ao item ou 0 se o item não existir.

Comentários

Um parâmetro de índice -1 retorna os dados associados ao item selecionado no momento.

CMFCToolBarComboBoxButton::GetItemDataAll

Retorna os dados associados a um item em um índice especificado na caixa de listagem de um botão da caixa de combinação que tem uma ID de comando específica.

static DWORD_PTR GetItemDataAll(
    UINT uiCmd,
    int iIndex=-1);

Parâmetros

uiCmd
[in] A ID de comando de um botão da caixa de combinação.

iIndex
[in] O índice baseado em zero de um item na caixa de listagem.

Valor de retorno

Os dados associados ao item se o método tiver sido bem-sucedido; caso contrário, 0 se o índice especificado não for válido ou CB_ERR se o botão da caixa de combinação não for encontrado.

Comentários

Um parâmetro de índice -1 retorna os dados associados ao item selecionado no momento.

CMFCToolBarComboBoxButton::GetItemDataPtrAll

Retorna os dados associados a um item em um índice especificado na caixa de listagem de um botão da caixa de combinação que tem uma ID de comando específica. Esses dados são retornados como um ponteiro.

static void* GetItemDataPtrAll(
    UINT uiCmd,
    int iIndex=-1);

Parâmetros

uiCmd
[in] A ID de comando do botão da caixa de combinação.

iIndex
[in] O índice baseado em zero de um item na caixa de listagem.

Valor de retorno

Um ponteiro associado ao item se o método tiver sido bem-sucedido; caso contrário, -1 se ocorrer um erro ou NULL se o botão da caixa de combinação não for encontrado.

Comentários

CMFCToolBarComboBoxButton::GetPrompt

Retorna a cadeia de caracteres de prompt do botão da caixa de combinação.

virtual CString GetPrompt() const;

Valor de retorno

A cadeia de caracteres de prompt.

Comentários

Atualmente, esse método não está implementado.

CMFCToolBarComboBoxButton::GetText

Obtém o texto na caixa de edição.

LPCTSTR GetText() const;

Valor de retorno

O texto na caixa de edição.

Comentários

CMFCToolBarComboBoxButton::GetTextAll

Obtém o texto na caixa de edição de um botão da caixa de combinação que tem uma ID de comando especificada.

static LPCTSTR GetTextAll(UINT uiCmd);

Parâmetros

uiCmd
[in] A ID de comando de um botão específico da caixa de combinação.

Valor de retorno

O texto na caixa de edição se o método tiver sido bem-sucedido; caso contrário, NULL.

Comentários

CMFCToolBarComboBoxButton::HasFocus

Indica se a caixa de combinação tem o foco atualmente.

virtual BOOL HasFocus() const;

Valor de retorno

TRUE se a caixa de combinação tiver o foco atualmente; caso contrário, FALSE.

Comentários

Esse método também retornará TRUE se qualquer janela filho da caixa de combinação tiver o foco.

CMFCToolBarComboBoxButton::IsCenterVert

Retorna a posição vertical dos botões da caixa de combinação no aplicativo.

static BOOL IsCenterVert();

Valor de retorno

TRUE se os botões estiverem centralizados; FALSE se estiverem alinhados na parte superior.

Comentários

CMFCToolBarComboBoxButton::IsFlatMode

Retorna a aparência de estilo plano dos botões da caixa de combinação no aplicativo.

static BOOL IsFlatMode();

Valor de retorno

TRUE se os botões tiverem um estilo plano; caso contrário, FALSE.

Comentários

O estilo plano padrão para botões da caixa de combinação é FALSE.

CMFCToolBarComboBoxButton::IsOwnerOf

Indica se o identificador especificado está associado ao botão da caixa de combinação ou a um de seus filhos.

virtual BOOL IsOwnerOf(HWND hwnd);

Parâmetros

hwnd
[in] Um identificador de janela.

Valor de retorno

TRUE se o identificador estiver associado ao botão da caixa de combinação ou um de seus filhos; caso contrário, FALSE.

CMFCToolBarComboBoxButton::IsRibbonButton

Indica se o botão da caixa de combinação reside em um painel de faixa de opções.

BOOL IsRibbonButton() const;

Valor de retorno

Sempre FALSE.

Comentários

Por padrão, esse método sempre retorna FALSE, o que significa que o botão da caixa de combinação nunca é exibido em um painel de faixa de opções.

CMFCToolBarComboBoxButton::IsWindowVisible

Retorna o estado de visibilidade do botão da caixa de combinação.

virtual BOOL IsWindowVisible();

Valor de retorno

O estado de visibilidade do botão da caixa de combinação.

CMFCToolBarComboBoxButton::NotifyCommand

Indica se o botão da caixa de combinação processa a mensagem.

virtual BOOL NotifyCommand(int iNotifyCode);

Parâmetros

iNotifyCode
[in] A mensagem de notificação associada ao comando.

Valor de retorno

Se o botão da caixa de combinação processa a mensagem.

CMFCToolBarComboBoxButton::OnAddToCustomizePage

Chamado pela estrutura quando o botão é adicionado à caixa de diálogo Personalizar.

virtual void OnAddToCustomizePage();

CMFCToolBarComboBoxButton::OnCalculateSize

Chamado pela estrutura para calcular o tamanho do botão.

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Parâmetros

pDC
[in] O contexto do dispositivo que exibe o botão da caixa de combinação.

sizeDefault
[in] O tamanho padrão do botão da caixa de combinação.

bHorz
[in] O estado do encaixe da barra de ferramentas pai. TRUE quando a barra de ferramentas está encaixada horizontalmente e FALSE quando está encaixada verticalmente.

Valor de retorno

Uma estrutura SIZE que contém as dimensões do botão da caixa de combinação em pixels.

CMFCToolBarComboBoxButton::OnChangeParentWnd

Chamado pela estrutura quando o botão da caixa de combinação é inserido em uma nova barra de ferramentas.

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parâmetros

pWndParent
[in] Ponteiro para a nova barra de ferramentas pai.

CMFCToolBarComboBoxButton::OnClick

Chamado pela estrutura quando o usuário clica no botão da caixa de combinação.

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay = TRUE);

Parâmetros

pWnd
[in] Ponteiro para a janela pai do botão da caixa de combinação.

bDelay
[in] Reservado para uso em uma classe derivada.

Valor de retorno

TRUE se o método manipular o evento; caso contrário, FALSE.

CMFCToolBarComboBoxButton::OnCtlColor

Chamado pela estrutura quando o usuário altera a cor da barra de ferramentas pai para definir a cor do botão da caixa de combinação.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Parâmetros

pDC
[in] O contexto do dispositivo que exibe o botão da caixa de combinação.

nCtlColor
[in] Não é usado.

Valor de retorno

Identificador do pincel que a estrutura usa para pintar a tela de fundo do botão da caixa de combinação.

Comentários

Esse método também define a cor do texto do botão da caixa de combinação.

CMFCToolBarComboBoxButton::OnDraw

Chamado pela estrutura para desenhar o botão da caixa de combinação usando os estilos e as opções especificados.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz = TRUE,
    BOOL bCustomizeMode = FALSE,
    BOOL bHighlight = FALSE,
    BOOL bDrawBorder = TRUE,
    BOOL bGrayDisabledButtons = TRUE);

Parâmetros

Pdc
[in] O contexto do dispositivo que exibe o botão.

rect
[in] O retângulo delimitador do botão.

pImages
[in] A coleção de imagens associadas ao botão.

bHorz
[in] O estado do encaixe da barra de ferramentas pai. TRUE quando a barra de ferramentas está encaixada horizontalmente e FALSE quando está encaixada verticalmente.

bCustomizeMode
[in] Se o aplicativo está no modo de personalização.

bHighlight
[in] Se o botão da caixa de combinação deve ser desenhado realçado.

bDrawBorder
[in] Se o botão da caixa de combinação deve ser desenhado com uma borda.

bGrayDisabledButtons
[in] TRUE para desenhar os botões desabilitados sombreados; FALSE para usar a coleção de imagens desabilitadas.

CMFCToolBarComboBoxButton::OnDrawOnCustomizeList

Chamado pela estrutura para desenhar o botão da caixa de combinação no painel Comandos da caixa de diálogo Personalizar.

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Parâmetros

pDC
[in] O contexto do dispositivo que exibe o botão da caixa de combinação.

rect
[in] O retângulo delimitador do botão da caixa de combinação.

bSelected
[in] TRUE se o botão da caixa de combinação estiver selecionado; caso contrário, FALSE.

Valor de retorno

A largura, em pixels, do botão da caixa de combinação.

CMFCToolBarComboBoxButton::OnGlobalFontsChanged

Chamado pela estrutura para definir a fonte do botão da caixa de combinação quando a fonte do aplicativo é alterada.

virtual void OnGlobalFontsChanged();

CMFCToolBarComboBoxButton::OnMove

Chamado pela estrutura para alterar o local do botão da caixa de combinação quando a barra de ferramentas pai é movida.

virtual void OnMove();

CMFCToolBarComboBoxButton::OnShow

Chamado pela estrutura quando o botão da caixa de combinação é ocultado ou exibido.

virtual void OnShow(BOOL bShow);

Parâmetros

bShow
[in] Se o botão da caixa de combinação deve ser ocultado ou exibido.

CMFCToolBarComboBoxButton::OnSize

Chamado pela estrutura para alterar o tamanho do botão da caixa de combinação quando a barra de ferramentas pai muda de tamanho.

virtual void OnSize(int iSize);

Parâmetros

iSize
[in] A nova largura do botão da caixa de combinação.

CMFCToolBarComboBoxButton::OnUpdateToolTip

Chamado pela estrutura quando o usuário altera a dica de ferramenta do botão da caixa de combinação.

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

Parâmetros

pWndParent
[in] Ponteiro para a janela pai do botão da caixa de combinação.

iButtonIndex
[in] ID do botão da caixa de combinação.

wndToolTip
[in] A dica de ferramenta a ser associada ao botão da caixa de combinação.

str
[in] O texto da dica de ferramenta.

Valor de retorno

TRUE se o método manipular o evento; caso contrário, FALSE.

CMFCToolBarComboBoxButton::RemoveAllItems

Exclui todos os itens das caixas de listagem e edição.

void RemoveAllItems();

Comentários

Remove todos os itens da caixa de listagem e do controle de edição de uma caixa de combinação.

CMFCToolBarComboBoxButton::SelectItem

Seleciona um item na caixa de listagem.

BOOL SelectItem(
    int iIndex,
    BOOL bNotify=TRUE);

BOOL SelectItem(DWORD_PTR dwData);
BOOL SelectItem(LPCTSTR lpszText);

Parâmetros

iIndex
[in] O índice baseado em zero de um item na caixa de listagem.

bNotify
[in] TRUE para notificar o botão da caixa de combinação da seleção; caso contrário, FALSE.

dwData
[in] Os dados associados a um item na caixa de listagem.

lpszTexto
[in] O texto de um item na caixa de listagem.

Valor de retorno

TRUE se o método foi bem-sucedido; caso contrário, FALSE.

Comentários

CMFCToolBarComboBoxButton::SelectItemAll

Selecione um item na caixa de listagem de um botão da caixa de combinação que tem uma ID de comando especificada.

static BOOL SelectItemAll(
    UINT uiCmd,
    int iIndex);

static BOOL SelectItemAll(
    UINT uiCmd,
    DWORD_PTR dwData);

static BOOL SelectItemAll(
    UINT uiCmd,
    LPCTSTR lpszText);

Parâmetros

uiCmd
[in] A ID do comando do botão da caixa de combinação que contém a caixa de listagem.

iIndex
[in] O índice baseado em zero do item da caixa de listagem. Um valor de -1 remove qualquer seleção atual na caixa de listagem e limpa a caixa de edição.

dwData
[in] Os dados de um item na caixa de listagem.

lpszTexto
[in] O texto de um item na caixa de listagem.

Valor de retorno

TRUE se o método foi bem-sucedido; caso contrário, FALSE.

Comentários

CMFCToolBarComboBoxButton::Serialize

Lê esse objeto de um arquivo morto ou grava-o em um arquivo morto.

virtual void Serialize(CArchive& ar);

Parâmetros

ar
[in, out] O objeto CArchive a ser serializado.

Comentários

As configurações no objeto CArchive determinam se esse método lê ou grava no arquivo.

CMFCToolBarComboBoxButton::SetACCData

Popula o objeto CAccessibilityData especificado usando dados de acessibilidade do botão da caixa de combinação.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parâmetros

pParent
[in] A janela pai do botão da caixa de combinação.

data
[out] Um objeto CAccessibilityData que recebe os dados de acessibilidade do botão da caixa de combinação.

Valor de retorno

TRUE se o método foi bem-sucedido; caso contrário, FALSE.

CMFCToolBarComboBoxButton::SetCenterVert

Define a posição vertical dos botões da caixa de combinação no aplicativo.

static void SetCenterVert(BOOL bCenterVert=TRUE);

Parâmetros

bCenterVert
[in] TRUE para centralizar o botão da caixa de combinação na barra de ferramentas; FALSE para alinhar o botão da caixa de combinação à parte superior da barra de ferramentas.

Comentários

Por padrão, os botões da caixa de combinação são alinhados à parte superior.

CMFCToolBarComboBoxButton::SetContextMenuID

Define a ID do recurso do menu de atalho para o botão da caixa de combinação.

void SetContextMenuID(UINT uiResID);

Parâmetros

uiResID
[in] A ID do recurso do menu de atalho.

CMFCToolBarComboBoxButton::SetDropDownHeight

Define a altura da caixa de listagem quando ela é acionada.

void SetDropDownHeight(int nHeight);

Parâmetros

nHeight
[in] A altura, em pixels, da caixa de listagem.

Comentários

A altura padrão é 150 pixels.

CMFCToolBarComboBoxButton::SetFlatMode

Define a aparência de estilo plano dos botões da caixa de combinação no aplicativo.

static void SetFlatMode(BOOL bFlat=TRUE);

Parâmetros

bFlat
[in] TRUE para uma aparência de estilo plano; caso contrário, FALSE.

Comentários

O estilo plano padrão para botões da caixa de combinação é FALSE.

CMFCToolBarComboBoxButton::SetStyle

Define o estilo especificado para o botão da caixa de combinação e desenha novamente o controle se ele não estiver desabilitado.

virtual void SetStyle(UINT nStyle);

Parâmetros

nEstilo
[in] Uma combinação bit a bit (OR) de estilos de barras de ferramentas.

Comentários

Para obter uma lista de estilos de botão da barra de ferramentas, confira Estilos de controle da barra de ferramentas

CMFCToolBarComboBoxButton::SetText

Define o texto na caixa de edição do botão da caixa de combinação.

void SetText(LPCTSTR lpszText);

Parâmetros

lpszTexto
[in] Ponteiro para uma cadeia de caracteres que contém o texto da caixa de edição.

Confira também

Gráfico da hierarquia
Classes
Classe CMFCToolBarButton
Classe CComboBox
CMFCToolBar::ReplaceButton
Instruções passo a passo: colocando controles em barras de ferramentas

Partilhar via

Classe CMFCToolBarComboBoxButton

Sintaxe

Membros

Construtores públicos

Métodos públicos

Comentários

Exemplo

Hierarquia de herança

Requisitos

CMFCToolBarComboBoxButton::AddItem

Parâmetros

Valor de retorno

Comentários

CMFCToolBarComboBoxButton::AddSortedItem

Parâmetros

Valor de retorno

Comentários

CMFCToolBarComboBoxButton::CanBeStretched

Valor de retorno

CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton

Parâmetros

Comentários

CMFCToolBarComboBoxButton::ClearData

Comentários

CMFCToolBarComboBoxButton::Compare

Parâmetros

Valor de retorno

Comentários

CMFCToolBarComboBoxButton::CopyFrom

Parâmetros

CMFCToolBarComboBoxButton::CreateCombo

Parâmetros

Valor de retorno

CMFCToolBarComboBoxButton::CreateEdit

Parâmetros

Valor de retorno

Comentários

CMFCToolBarComboBoxButton::DeleteItem

Parâmetros

Valor de retorno

Comentários

CMFCToolBarComboBoxButton::DuplicateData

Comentários

CMFCToolBarComboBoxButton::EnableWindow

Parâmetros

Comentários

CMFCToolBarComboBoxButton::ExportToMenuButton

Parâmetros

Valor de retorno

CMFCToolBarComboBoxButton::FindItem

Parâmetros

Valor de retorno

Comentários

CMFCToolBarComboBoxButton::GetByCmd

Parâmetros

Valor de retorno

Comentários

CMFCToolBarComboBoxButton::GetComboBox

Valor de retorno

Comentários

CMFCToolBarComboBoxButton::GetContextMenuID

Valor de retorno

CMFCToolBarComboBoxButton::GetCount

Valor de retorno

Comentários

CMFCToolBarComboBoxButton::GetCountAll

Parâmetros

Valor de retorno

Comentários

CMFCToolBarComboBoxButton::GetCurSel

Valor de retorno

Comentários

CMFCToolBarComboBoxButton::GetCurSelAll

Parâmetros

Valor de retorno

Comentários

CMFCToolBarComboBoxButton::GetEditCtrl

Valor de retorno

Comentários