Classe CMFCColorButton

Artigo
08/25/2010

The CMFCColorButton e Classe CMFCColorBar classes são usados juntos para implementar um controle de selecionador de cor.

class CMFCColorButton : public CMFCButton

Membros

Construtores públicos

Nome	Descrição
CMFCColorButton::CMFCColorButton	Cria um novo CMFCColorButton objeto.

Métodos públicos

Nome	Descrição
CMFCColorButton::EnableAutomaticButton	Habilita e desabilita um botão "automático" que está posicionado acima dos botões de cor normal.(O botão automática padrão do sistema é rotulado Automático.)
CMFCColorButton::EnableOtherButton	Habilita e desabilita um botão "Outros" que é posicionado abaixo dos botões de cor normal.(O padrão do sistema "Outros" botão é rotulado comMais Colors….)
CMFCColorButton::GetAutomaticColor	Recupera a corrente cor automático.
CMFCColorButton::GetColor	Recupera a cor do botão.
CMFCColorButton::SetColor	Define a cor do botão.
CMFCColorButton::SetColorName	Define um nome de cor.
CMFCColorButton::SetColumnsNumber	Define o número de colunas no seletor de cor caixa de diálogo.
CMFCColorButton::SetDocumentColors	Especifica uma lista de cores específicas de documentos que são exibidos na seletor de cor caixa de diálogo.
CMFCColorButton::SetPalette	Especifica uma paleta de cores de exibição padrão.
CMFCColorButton::SizeToContent	Altera o dimensionar do controle de botão, dependendo do dimensionar do texto e imagem.

Métodos protegidos

Nome	Descrição
CMFCColorButton::IsDrawXPTheme	Indica se o botão de cor corrente será 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 borda do botão.
CMFCColorButton::OnDrawFocusRect	Chamado pela estrutura para exibir um retângulo de foco quando o botão tem um foco.
CMFCColorButton::OnShowColorPopup	Chamada pela estrutura quando o seletor de cor caixa de diálogo está prestes a ser exibido.
CMFCColorButton::RebuildPalette	Inicializa o m_pPalette membro de dados protegidos para a paleta especificada ou a paleta de sistema padrão.
CMFCColorButton::UpdateColor	Chamado pela estrutura quando o usuário seleciona uma cor na paleta do seletor de cor caixa de diálogo.

Membros de dados

Nome	Descrição
m_bAltColorDlg	Um valor booliano.If TRUE, exibe a estrutura do CMFCColorDialog caixa de diálogo de cor de quando o outros botão é clicado, ou se FALSE, a caixa de diálogo de cor do sistema. O valor padrão é TRUE. Para obter mais informações, consulte CMFCColorButton::EnableOtherButton.
m_bAutoSetFocus	Um valor booliano.If TRUE, a estrutura define o foco no menu 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 personalização está ativado para o botão cor.
m_Color	A COLORREFvalor de .Contém a cor selecionada atualmente.
m_ColorAutomatic	A COLORREFvalor de .Contém a cor do padrão selecionado no momento.
m_Colors	A CArray of COLORREF valores.Contém as cores disponível no momento.
m_lstDocColors	A CList of COLORREF valores.Contém as cores do documento corrente.
m_nColumns	Um inteiro.Contém o número de colunas a ser exibido na grade de cores em um menu de seleção de cor.
m_pPalette	Um ponteiro para um CPalette.Contém as cores que estão disponível no menu seleção de cores corrente.
m_pPopup	Um ponteiro para um Classe CMFCColorPopupMenu objeto. O menu de seleção de cor que é exibido quando você clicar no botão cor.
m_strAutoColorText	Uma sequência de caracteresO rótulo do botão "automático" em um menu de seleção de cor.
m_strDocColorsText	Uma sequência de caracteresO rótulo do botão em um menu de seleção de cores que exibe as cores do documento.
m_strOtherText	Uma sequência de caracteresO rótulo do botão "Outros" em um menu de seleção de cor.

Comentários

Por padrão, a CMFCColorButton classe se comporta sistema autônomo um botão de ação que abre um seletor de cor caixa de diálogo. A caixa de diálogo Seletor de cores contém uma matriz de cor pequenos botões e um "Outros" botão que exibe um seletor de cores personalizado.(O padrão do sistema "Outros" botão é rotulado comMais Colors….) Quando um usuário seleciona uma nova cor, a CMFCColorButton objeto refletirá a alterar e exibe a cor selecionada.

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

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

The CMFCColorButton objeto notifica seu pai de uma cor está mudando, enviando-um WM_COMMAND | BN_CLICKED notificação. O pai usa o CMFCColorButton::GetColor método para recuperar a cor corrente.

Exemplo

O exemplo a seguir demonstra como configurar um botão de cor usando vários métodos no CMFCColorButton classe. Os métodos de conjunto a cor do botão cor e seu número de colunas e habilitar o automático e os outros botões.Este exemplo faz parte o Exemplo do StatusBarDemo: BAR de status Aplicativo MFC.

  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);

Requisitos

Cabeçalho: afxcolorbutton.h

Consulte também

Compartilhar via