Classe CMFCToolBarComboBoxButton
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
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 Devolução
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 Devolução
Í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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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 Devolução
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
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários