Classe CMFCColorButton

Artigo
06/10/2015

CMFCColorButton e as classes de Classe CMFCColorBar são usados em conjunto para implementar um controle do selecionador de cores.

class CMFCColorButton : public CMFCButton

Membros

Construtores public

Nome	Descrição
CMFCColorButton::CMFCColorButton	Constrói um novo objeto de CMFCColorButton .

Métodos públicos

Nome	Descrição
CMFCColorButton::EnableAutomaticButton	Ativar e desativar um botão “automático” que está localizado acima dos botões normais de cor. (O botão automático do sistema padrão é rotulado Automático.)
CMFCColorButton::EnableOtherButton	Ativar e desativar um “outro” botão que está localizado abaixo dos botões normais de cor. (O sistema padrão “outro” botão é rotulado Cores mais….)
CMFCColorButton::GetAutomaticColor	Recupera a cor automático atual.
CMFCColorButton::GetColor	Recupera a cor de um botão.
CMFCColorButton::SetColor	Define a cor de um botão.
CMFCColorButton::SetColorName	Define um nome de cor.
CMFCColorButton::SetColumnsNumber	Define o número de colunas na caixa de diálogo seletor de cor.
CMFCColorButton::SetDocumentColors	Especifica uma lista de cores a específicas que são exibidas na caixa de diálogo seletor de cor.
CMFCColorButton::SetPalette	Especifica uma paleta de cores padrão de exibição.
CMFCColorButton::SizeToContent	Altera o tamanho do controle de botão, dependendo seu tamanho do texto e da imagem.

Métodos protegidos

Nome	Descrição
CMFCColorButton::IsDrawXPTheme	Indica se o botão atual de cor é exibido no estilo visual do Windows XP.
CMFCColorButton::OnDraw	Chamado pela estrutura para exibir uma imagem do botão.
CMFCColorButton::OnDrawBorder	Chamado pela estrutura para exibir a borda do botão.
CMFCColorButton::OnDrawFocusRect	Chamado pela estrutura para exibir um retângulo de foco quando o botão tem o foco.
CMFCColorButton::OnShowColorPopup	Chamado pela estrutura quando a caixa de diálogo seletor de cor está prestes a ser exibida.
CMFCColorButton::RebuildPalette	Inicializa o membro de dados protegidos de m_pPalette a paleta especificada ou à paleta padrão do sistema.
CMFCColorButton::UpdateColor	Chamado pela estrutura quando o usuário selecione uma cor de paleta da caixa de diálogo seletor de cor.

Membros de dados

Nome	Descrição
m_bAltColorDlg	Um valor booleano. Se TRUE, a estrutura exibe a caixa de diálogo de cor de CMFCColorDialog quando outro botão é clicado, ou se FALSE, a caixa de diálogo de cor do sistema. o valor padrão é TRUE. Para mais informações, consulte CMFCColorButton::EnableOtherButton.
m_bAutoSetFocus	Um valor booleano. Se TRUE, a estrutura define o foco no menu de cor quando o menu é exibido, ou se FALSE, não altera o foco. o valor padrão é TRUE.
CMFCColorButton::m_bEnabledInCustomizeMode	Indica se o modo de personalização está ativado para o botão de cor.
m_Color	Um valor de COLORREF . Contém a cor selecionada.
m_ColorAutomatic	Um valor de COLORREF . Contém a cor padrão selecionada.
m_Colors	CArray de valores de COLORREF . Contém as cores atualmente disponíveis.
m_lstDocColors	CList de valores de COLORREF . Contém as cores do documento atual.
m_nColumns	Um número inteiro. Contém o número de colunas para exibir na grade de cores em um menu de seleção de cor.
m_pPalette	Um ponteiro para CPalette. Contém as cores que estão disponíveis no menu de seleção atual da cor.
m_pPopup	Um ponteiro para um objeto de Classe CMFCColorPopupMenu . O menu de seleção de cor que é exibido quando você clica no botão de cor.
m_strAutoColorText	Uma cadeia de caracteres. A etiqueta do botão “automático” em um menu de seleção de cor.
m_strDocColorsText	Uma cadeia de caracteres. O rótulo de botão em um menu de seleção de cores que exibe o documento cores.
m_strOtherText	Uma cadeia de caracteres. O rótulo de “outro” botão em um menu de seleção de cor.

Comentários

Por padrão, a classe de CMFCColorButton se comporta como um botão de ação que abre uma caixa de diálogo seletor de cor. A caixa de diálogo seletor de cor contém uma matriz de botões pequenos de cor de um “e” outro botão que exibe um selecionador de cores personalizado. (O sistema padrão “outro” botão é rotulado Cores mais….) Quando um usuário seleciona uma nova cor, o objeto de CMFCColorButton refletir a alteração e exibe a cor selecionada.

Crie um controle de botão de cores diretamente em seu código, ou usando a ferramenta de ClassWizard e um modelo da caixa de diálogo. Se você criar um controle de botão de cores diretamente, adicione uma variável de CMFCColorButton ao seu aplicativo, e então chame o construtor e métodos de Create de CMFCColorButton objeto. Se você usar ClassWizard, adicione uma variável de CButton para seu aplicativo em seguida, altere o tipo da variável de CButton a CMFCColorButton.

A caixa de diálogo seletor de cor (Classe CMFCColorBar) é exibida pelo método de CMFCColorButton::OnShowColorPopup quando a estrutura chama o manipulador de eventos de OnLButtonDown . O método de CMFCColorButton::OnShowColorPopup pode ser substituído para oferecer suporte a seleção de cores personalizado.

O objeto de CMFCColorButton notifica o pai que uma cor for alterada enviá-la uma notificação de WM_COMMAND | BN_CLICKED . o pai usa o método de CMFCColorButton::GetColor para recuperar a cor atual.

Exemplo

O exemplo a seguir demonstra como configurar um botão de cores usando vários métodos na classe de CMFCColorButton . Os métodos define a cor do botão de cor e o número de colunas, e permitem o automático e outros botões. Este exemplo é parte de Exemplo de demonstração statusbar.

    CMFCColorButton m_wndTextColor;


...


    m_wndTextColor.EnableAutomaticButton (_T("Default"), afxGlobalData.clrBtnText);
    m_wndTextColor.EnableOtherButton (_T("Other..."));
    m_wndTextColor.SetColor ((COLORREF)-1);
    m_wndTextColor.SetColorName((COLORREF)-1, "Default Color");
    m_wndTextColor.SetColumnsNumber(3);