Partilhar via

Classe CMFCColorBar

  • Artigo

A classe CMFCColorBar representa uma barra de controle de encaixe que pode selecionar cores em um documento ou aplicativo.

Sintaxe

class CMFCColorBar : public CMFCPopupMenuBar

Membros

Construtores Protegidos

Nome Descrição
CMFCColorBar::CMFCColorBar Constrói um objeto CMFCColorBar.

Métodos públicos

Nome Descrição
CMFCColorBar::ContextToSize Calcula as margens vertical e horizontal necessárias para conter os botões no controle de barra de cores e, em seguida, ajusta o local desses botões.
CMFCColorBar::CreateControl Cria uma janela de controle de barra de cores, anexa-a ao objeto CMFCColorBar e redimensiona o controle para conter a paleta de cores especificada.
CMFCColorBar::Create Cria uma janela de controle de barra de cores e a anexa ao objeto CMFCColorBar.
CMFCColorBar::EnableAutomaticButton Mostra ou oculta o botão automático.
CMFCColorBar::EnableOtherButton Habilita ou desabilita a exibição de uma caixa de diálogo que permite que o usuário selecione mais cores.
CMFCColorBar::GetColor Recupera a co selecionada no momento.
CMFCColorBar::GetCommandID Recupera a ID de comando do controle de barra de cores atual.
CMFCColorBar::GetHighlightedColor Recupera a cor que significa que um botão de cor tem o foco; ou seja, o botão está ativo.
CMFCColorBar::GetHorzMargin Recupera a margem horizontal, que é o espaço entre a célula de cor esquerda ou direita e o limite da área do cliente.
CMFCColorBar::GetVertMargin Recupera a margem vertical, que é o espaço entre a célula de cor superior ou inferior e o limite da área do cliente.
CMFCColorBar::IsTearOff Indica se a barra de cores atual é encaixável.
CMFCColorBar::SetColor Define a cor selecionada no momento.
CMFCColorBar::SetColorName Define um novo nome para uma cor especificada.
CMFCColorBar::SetCommandID Define uma nova ID de comando para um controle de barra de cores.
CMFCColorBar::SetDocumentColors Define a lista de cores usadas no documento atual.
CMFCColorBar::SetHorzMargin Define a margem horizontal, que é o espaço entre a célula de cor esquerda ou direita e o limite da área do cliente.
CMFCColorBar::SetVertMargin Define a margem vertical, que é o espaço entre a célula de cor superior ou inferior e o limite da área do cliente.

Métodos protegidos

Nome Descrição
CMFCColorBar::AdjustLocations Ajusta as posições dos botões de cor no controle de barra de cores.
CMFCColorBar::AllowChangeTextLabels Indica se o rótulo de texto dos botões de cor pode ser alterado.
CMFCColorBar::AllowShowOnList Indica se o objeto de controle de barra de cores pode ser exibido em uma lista de barras de ferramentas, durante o processo de personalização.
CMFCColorBar::CalcSize Chamado pela estrutura como parte do processo de cálculo de layout.
CMFCColorBar::CreatePalette Inicializa uma paleta com as cores em uma matriz de cores especificada.
CMFCColorBar::GetColorGridSize Calcula o número de linhas e colunas na grade de um controle de barra de cores.
CMFCColorBar::GetExtraHeight Calcula a altura adicional que a barra de cores atual exige para exibir diversos elementos da interface do usuário, como o botão Outros, as cores do documento e assim por diante.
CMFCColorBar::InitColors Inicializa uma matriz de cores com as cores em uma paleta especificada ou na paleta padrão do sistema.
CMFCColorBar::OnKey Chamado pela estrutura quando um usuário pressiona um botão do teclado.
CMFCColorBar::OnSendCommand Chamado pela estrutura para fechar uma hierarquia de controles pop-up.
CMFCColorBar::OnUpdateCmdUI Chamado pela estrutura para habilitar ou desabilitar um item da interface do usuário de um controle de barra de cores, antes que o item seja exibido.
CMFCColorBar::OpenColorDialog Abre uma caixa de diálogo de cores.
CMFCColorBar::Rebuild Redesenha completamente o controle de barra de cores.
CMFCColorBar::SelectPalette Define a paleta lógica do contexto de dispositivo especificado como a paleta do botão pai do controle de barra de cores atual.
CMFCColorBar::SetPropList Define o membro de dados protegido m_pWndPropList como o ponteiro especificado para um controle de grade de propriedade.
CMFCColorBar::ShowCommandMessageString Solicita a janela com moldura que possui o controle de barra de cores para atualizar a linha de mensagem na barra de status.

Membros de dados protegidos

Nome Descrição
m_bInternal Um campo booliano que determina se os eventos do mouse foram processados. Normalmente, os eventos do mouse são processados quando esse campo é TRUE e o modo de personalização é FALSE.
m_bIsEnabled Um booliano que indica se um controle está habilitado.
m_bIsTearOff Um booliano que indica se o controle de barra de cores permite encaixe.
m_BoxSize Um objeto CSize que especifica o tamanho de uma célula em uma grade de barras de cores.
m_bShowDocColorsWhenDocked Um booliano que indica se as cores do documento devem ser mostradas quando a barra de cores está encaixada. Para obter mais informações, confira CMFCColorBar::SetDocumentColors.
m_bStdColorDlg Um booliano que indica se a caixa de diálogo de cores do sistema padrão ou a caixa de diálogo CMFCColorDialog deve ser exibida. Para obter mais informações, confira CMFCColorBar::EnableOtherButton.
m_ColorAutomatic Um COLORREF que armazena a cor automática atual. Para obter mais informações, confira CMFCColorBar::EnableOtherButton.
m_ColorNames Um objeto CMap que associa um conjunto de cores RGB a seus nomes.
m_colors Um CArray dos valores COLORREF que contém as cores exibidas no controle de barra de cores.
m_ColorSelected Um valor COLORREF que é a cor selecionada no momento pelo usuário no controle de barra de cores.
m_lstDocColors Um CList de valores COLORREF que contém as cores usadas em um documento no momento.
m_nCommandID Um inteiro sem sinal que é a ID de comando de um botão de cor.
m_nHorzMargin Um inteiro que é a margem horizontal entre os botões de cor em uma grade de cores.
m_nHorzOffset Um inteiro que é o deslocamento horizontal para o centro do botão de cor. Esse valor será significativo se o botão exibir um texto ou uma imagem além de uma cor.
m_nNumColumns Um inteiro que é o número de colunas em uma grade de cores do controle de barra de cores.
m_nNumColumnsVert Um inteiro que é o número de colunas em uma grade de cores orientada verticalmente.
m_nNumRowsHorz Um inteiro que é o número de colunas em uma grade de cores orientada horizontalmente.
m_nRowHeight Um inteiro que é a altura de uma linha de botões de cor em uma grade de cores.
m_nVertMargin Um inteiro que é a margem vertical entre os botões de cor em uma grade de cores.
m_nVertOffset Um inteiro que é o deslocamento vertical para o centro do botão de cor. Esse valor será significativo se o botão exibir um texto ou uma imagem além de uma cor.
m_Palette Um CPalette das cores usadas no controle de barra de cores.
m_pParentBtn Um ponteiro para um objeto CMFCColorButton que é o pai do botão atual. Esse valor será significativo se o botão de cor estiver em uma hierarquia de controles de barra de ferramentas ou em um controle de grade de propriedades de cores.
m_pParentRibbonBtn Um ponteiro para um objeto CMFCRibbonColorButton que está na faixa de opções e é o botão pai do botão atual. Esse valor será significativo se o botão de cor estiver em uma hierarquia de controles de barra de ferramentas ou em um controle de grade de propriedades de cores.
m_pWndPropList Um ponteiro para um objeto CMFCPropertyGridCtrl.
m_strAutoColor Um CString que é o texto exibido no botão Automático. Para obter mais informações, confira CMFCColorBar::EnableAutomaticButton.
m_strDocColors Um CString que é o texto exibido no botão de cores do documento. Para obter mais informações, confira CMFCColorBar::SetDocumentColors.
m_strOtherColor Um CString que é o texto exibido no botão Outros. Para obter mais informações, confira CMFCColorBar::EnableOtherButton.

Comentários

Normalmente, você não cria um objeto CMFCColorBar diretamente. Em vez disso, a Classe CMFCColorMenuButton (usada em menus e barras de ferramentas) ou a Classe CMFCColorButton cria o objeto CMFCColorBar.

A classe CMFCColorBar fornece a seguinte funcionalidade:

  • Ajusta automaticamente a lista de cores do documento.

  • Salva e restaura seu estado, juntamente com o estado do documento.

  • Gerencia o botão "automático".

  • Usa o controle Classe CMFCColorPickerCtrl para selecionar uma cor personalizada.

  • Permite um estado "destacado" (se ele foi criado usando a Classe CMFCColorMenuButton).

Para incorporar a funcionalidade CMFCColorBar ao aplicativo:

  1. Crie um botão de menu regular e atribua a ele uma ID, por exemplo, ID_CHAR_COLOR.

  2. Na classe da janela com moldura, substitua o método CFrameWndEx::OnShowPopupMenu e substitua o botão de menu regular por um objeto Classe CMFCColorMenuButton (chamando CMFCToolBar::ReplaceButton).

  3. Defina todos os estilos e habilite ou desabilite os recursos do objeto CMFCColorBar durante a criação da Classe CMFCColorMenuButton. O objeto CMFCColorMenuButton cria dinamicamente o objeto CMFCColorBar depois que a estrutura chama o método CreatePopupMenu.

Quando o usuário clica em um botão de controle de barra de cores, a estrutura usa a macro ON_COMMAND para notificar o pai do controle de barra de cores. Na macro, o parâmetro de ID de comando é o valor atribuído ao botão de controle de barra de cores na etapa 1 (ID_CHAR_COLOR, neste exemplo). Para obter mais informações, confira as classes Classe CMFCColorMenuButton, Classe CMFCColorButton, Classe CMFCColorPickerCtrl, Classe CFrameWndEx e Classe CMFCToolBar.

Exemplo

O exemplo a seguir demonstra como configurar uma barra de cores usando vários métodos na classe CMFCColorBar. Os métodos definem as margens horizontal e vertical, habilitam o botão Outros, criam uma janela de controle de barra de cores e definem a cor selecionada no momento. Este exemplo faz parte da amostra de Novos Controles.

CMFCColorBar m_wndColorBar;

// set the margins
m_wndColorBar.SetHorzMargin(0);
m_wndColorBar.SetVertMargin(0);
// enable the display of a dialog box that
// lets the user select more colors
m_wndColorBar.EnableOtherButton(_T("Other..."));
// create a color bar control window
m_wndColorBar.CreateControl(this, rectColorBar, IDC_COLORBAR, 5 /* columns */);
// set the currently selected color
m_wndColorBar.SetColor(RGB(255, 0, 0));

Hierarquia de herança

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCPopupMenuBar

CMFCColorBar

Requisitos

Cabeçalho: afxcolorbar.h

CMFCColorBar::AdjustLocations

Ajusta as posições dos botões de cor no controle de barra de cores.

virtual void AdjustLocations();

Comentários

Esse método é chamado pela estrutura durante o processamento de mensagens WM_SIZE.

CMFCColorBar::AllowChangeTextLabels

Indica se o rótulo de texto dos botões de cor pode ser alterado.

virtual BOOL AllowChangeTextLabels() const;

Valor de retorno

Sempre FALSE.

Comentários

Por padrão, esse método sempre retorna FALSE, o que significa que não é possível modificar os rótulos de texto. Substitua esse método para habilitar a modificação dos rótulos de texto.

CMFCColorBar::AllowShowOnList

Indica se o objeto de controle de barra de cores pode ser exibido em uma lista de barras de ferramentas, durante o processo de personalização.

virtual BOOL AllowShowOnList() const;

Valor de retorno

Sempre TRUE.

Comentários

Por padrão, esse método sempre retorna TRUE, o que significa que a estrutura pode exibir o controle de barra de cores durante o processo de personalização. Substitua esse método para implementar um comportamento diferente.

CMFCColorBar::CalcSize

Chamado pela estrutura como parte do processo de cálculo de layout.

virtual CSize CalcSize(BOOL bVertDock);

Parâmetros

bVertDock
[in] TRUE para especificar que o controle de barra de cores está encaixado verticalmente. FALSE para especificar que o controle de barra de cores está encaixado horizontalmente.

Valor de retorno

O tamanho da matriz de botões de cor em um controle de barra de cores.

CMFCColorBar::CMFCColorBar

Constrói um objeto CMFCColorBar.

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    int nRowsDockHorz,
    int nColDockVert,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCColorButton* pParentBtn);

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCRibbonColorButton* pParentRibbonBtn);

CMFCColorBar(
    CMFCColorBar& src,
    UINT uiCommandID);

Parâmetros

colors
[in] Uma matriz de cores que a estrutura exibe no controle de barra de cores.

color
[in] A cor selecionada inicialmente.

lpszAutoColor
[in] O rótulo de texto do botão de cor automático (padrão) ou NULL.

O rótulo padrão do botão automático é Automático.

lpszOtherColor
[in] O rótulo de texto do botão Outros, que exibe mais opções de cores ou NULL.

O rótulo padrão do botão Outros é Mais Cores....

lpszDocColors
[in] O rótulo de texto do botão de cores do documento. A paleta de cores do documento lista todas as cores que o documento usa no momento.

lstDocColors
[in] Uma lista de cores que o documento usa no momento.

nColunas
[in] O número de colunas da matriz de cores.

nRowsDockHorz
[in] O número de linhas da barra de cores, quando ela está encaixada horizontalmente.

nColDockVert
[in] O número de colunas no controle de barra de cores, quando ele está encaixado verticalmente.

colorAutomatic
[in] A cor padrão que a estrutura aplica quando você clica no botão automático.

nCommandID
[in] A ID de comando do controle de barra de cores.

pParentBtn
[in] Um ponteiro para um botão pai.

src
[in] Um objeto CMFCColorBar existente a ser copiado no novo objeto CMFCColorBar.

uiCommandID
[in] A ID de comando.

CMFCColorBar::ContextToSize

Calcula as margens vertical e horizontal necessárias para conter os botões no controle de barra de cores e, em seguida, ajusta o local desses botões.

void ContextToSize(
    BOOL bSquareButtons = TRUE,
    BOOL bCenterButtons = TRUE);

Parâmetros

bSquareButtons
[in] TRUE para especificar que a forma dos botões em um controle de barra de cores é quadrada. Caso contrário, FALSE. O valor padrão é TRUE.

bCenterButtons
[in] TRUE para especificar que o conteúdo na face de um botão de controle de barra de cores está centralizado. Caso contrário, FALSE. O valor padrão é TRUE.

Comentários

CMFCColorBar::Create

Cria uma janela de controle de barra de cores e a anexa ao objeto CMFCColorBar.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle,
    UINT nID,
    CPalette* pPalette=NULL,
    int nColumns=0,
    int nRowsDockHorz=0,
    int nColDockVert=0);

Parâmetros

pParentWnd
[in] Ponteiro para a janela pai.

dwStyle
[in] Uma combinação bit a bit (OU) de estilos de janela.

Nid
[in] A ID de comando.

pPalette
[in] Ponteiro para uma paleta de cores. O padrão é NULL.

nColunas
[in] O número de colunas no controle de barra de cores. O padrão é 0.

nRowsDockHorz
[in] O número de linhas no controle de barra de cores, quando ele está encaixado horizontalmente. O padrão é 0.

nColDockVert
[in] O número de colunas no controle de barra de cores, quando ele está encaixado verticalmente. O padrão é 0.

Valor de retorno

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

Comentários

Para criar um objeto CMFCColorBar, chame o construtor de classes e depois esse método. O método Create cria o controle do Windows e inicializa uma lista de cores.

CMFCColorBar::CreateControl

Cria uma janela de controle de barra de cores, anexa-a ao objeto CMFCColorBar e redimensiona a janela de controle para conter a paleta de cores especificada.

virtual BOOL CreateControl(
    CWnd* pParentWnd,
    const CRect& rect,
    UINT nID,
    int nColumns=-1,
    CPalette* pPalette=NULL);

Parâmetros

pParentWnd
[in] Ponteiro para a janela pai. Não pode ser NULL.

rect
[in] Um retângulo delimitador que especifica onde desenhar o controle de barra de cores.

Nid
[entrada] A ID de controle.

nColunas
[in] O número ideal de colunas no controle de barra de cores. Esse método modifica esse número para se ajustar à paleta de cores especificada. O padrão é -1, o que significa que esse parâmetro não foi especificado.

pPalette
[in] Ponteiro para uma paleta de cores ou NULL. Se esse parâmetro for NULL, esse método calculará o tamanho do controle de barra de cores como se 20 cores fossem especificadas. O padrão é NULL.

Valor de retorno

TRUE se esse método tiver êxito. Caso contrário, FALSE.

Comentários

Esse método usa os parâmetros rect, nColumns e pPalette para calcular o número ou as linhas e colunas apropriadas no controle de barra de cores e, em seguida, chama o método CMFCColorBar::Create.

CMFCColorBar::CreatePalette

Inicializa uma paleta com as cores em uma matriz de cores especificada.

static BOOL CreatePalette(
    const CArray<COLORREF, COLORREF>& arColors,
    CPalette& palette);

Parâmetros

arColors
[in] Uma matriz de cores.

palette
[in] Uma paleta de cores.

Valor de retorno

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

CMFCColorBar::EnableAutomaticButton

Mostra ou oculta o botão automático.

void EnableAutomaticButton(
    LPCTSTR lpszLabel,
    COLORREF colorAutomatic,
    BOOL bEnable=TRUE);

Parâmetros

lpszLabel
[in] O rótulo de texto do botão de cor automático (padrão) ou NULL.

O rótulo padrão do botão automático é Automático.

colorAutomatic
[in] A cor padrão que a estrutura aplica quando você clica no botão automático.

bEnable
[in] TRUE para habilitar o botão automático. FALSE para desabilitar o botão automático. O valor padrão é TRUE.

Comentários

O rótulo de texto do botão automático será excluído, se o parâmetro lpszLabel for NULL ou o parâmetro bEnable for FALSE.

CMFCColorBar::EnableOtherButton

Habilita ou desabilita a exibição de uma caixa de diálogo que permite que o usuário selecione mais cores.

void EnableOtherButton(
    LPCTSTR lpszLabel,
    BOOL bAltColorDlg=TRUE,
    BOOL bEnable=TRUE);

Parâmetros

lpszLabel
[in] O rótulo de texto do botão Outros, que exibe mais opções de cores ou NULL.

O rótulo padrão desse botão é Mais Cores....

bAltColorDlg
[in] TRUE para exibir a caixa de diálogo CMFCColorDialog. FALSE para exibir a caixa de diálogo CColorDialog padrão. O valor padrão é TRUE.

bEnable
[in] TRUE para habilitar o botão. FALSE para desabilitá-lo. O valor padrão é TRUE.

CMFCColorBar::GetColor

Recupera a co selecionada no momento.

COLORREF GetColor() const;

Valor de retorno

A cor selecionada no momento.

CMFCColorBar::GetColorGridSize

Calcula o número de linhas e colunas na grade de um controle de barra de cores.

CSize GetColorGridSize(BOOL bVertDock) const;

Parâmetros

bVertDock
[in] TRUE para executar o cálculo de um controle de barra de cores encaixado verticalmente. Caso contrário, execute o cálculo para um controle encaixado horizontalmente.

Valor de retorno

Um objeto CSize cujo componente cx contém o número de colunas e cujo componente cy contém o número de linhas.

CMFCColorBar::GetCommandID

Recupera a ID de comando do controle de barra de cores atual.

UINT GetCommandID() const;

Valor de retorno

Uma ID de comando.

Comentários

Quando o usuário seleciona uma nova cor, a estrutura envia a ID de comando em uma mensagem WM_COMMAND, para notificar o pai do objeto CMFCColorBar.

CMFCColorBar::GetExtraHeight

Calcula a altura adicional que a barra de cores atual exige para exibir diversos elementos da interface do usuário, como o botão Outros ou as cores do documento.

int GetExtraHeight(int nNumColumns) const;

Parâmetros

nNumColumns
[in] Se o controle de barra de cores contiver as cores do documento, o número de colunas a serem exibidas na grade de cores do documento. Caso contrário, esse valor não será usado.

Valor de retorno

A altura adicional calculada que é necessária.

CMFCColorBar::GetHighlightedColor

Recupera a cor que significa que um botão de cor tem o foco; ou seja, o botão está ativo.

COLORREF GetHighlightedColor() const;

Valor de retorno

Um valor RGB.

Comentários

CMFCColorBar::GetHorzMargin

Recupera a margem horizontal, que é o espaço entre a célula de cor esquerda ou direita e o limite da área do cliente.

int GetHorzMargin();

Valor de retorno

A margem horizontal.

CMFCColorBar::GetVertMargin

Recupera a margem vertical, que é o espaço entre a célula de cor superior ou inferior e o limite da área do cliente.

int GetVertMargin() const;

Valor de retorno

A margem vertical.

CMFCColorBar::InitColors

Inicializa uma matriz de cores com as cores em uma paleta especificada ou com a paleta padrão do sistema.

static int InitColors(
    CPalette* pPalette,
    CArray<COLORREF, COLORREF>& arColors);

Parâmetros

pPalette
[in] Um ponteiro para um objeto da paleta ou NULL. Se esse parâmetro for NULL, esse método usará a paleta padrão do sistema operacional.

arColors
[in] Uma matriz de cores.

Valor de retorno

O número de elementos na matriz de cores.

CMFCColorBar::IsTearOff

Indica se a barra de cores atual é encaixável.

BOOL IsTearOff() const;

Valor de retorno

TRUE se o controle de barra de cores atual estiver encaixado. Caso contrário, FALSE.

Comentários

Se o controle de barra de cores estiver encaixado, poderá ser destacado de uma barra de controle e encaixado em outro local.

CMFCColorBar::OnKey

Chamado pela estrutura quando um usuário pressiona um botão do teclado.

virtual BOOL OnKey(UINT nChar);

Parâmetros

nChar
[in] O código de chave virtual da chave que um usuário pressionou.

Valor de retorno

TRUE se esse método processar a chave especificada. Caso contrário, FALSE.

CMFCColorBar::OnSendCommand

Chamado pela estrutura para fechar uma hierarquia de controles pop-up.

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Parâmetros

pButton
[in] Ponteiro para um controle que reside em uma barra de ferramentas.

Valor de retorno

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

CMFCColorBar::OnUpdateCmdUI

Chamado pela estrutura para habilitar ou desabilitar um item da interface do usuário de um controle de barra de cores, antes que o item seja exibido.

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

Parâmetros

pTarget
[in] Ponteiro para uma janela que contém um item de interface do usuário a ser atualizado.

bDisableIfNoHndler
[in] TRUE para desabilitar o item de interface do usuário, se nenhum identificador for definido em um mapa de mensagens. Caso contrário, FALSE.

Comentários

Quando um usuário do aplicativo clica em um item de interface do usuário, o item deve saber se deve ser exibido como habilitado ou desabilitado. O destino da mensagem de comando fornece essas informações, implementando um identificador de comando ON_UPDATE_COMMAND_UI. Use esse método para ajudar a processar o comando. Para obter mais informações, confira Classe CCmdUI.

CMFCColorBar::OpenColorDialog

Abre uma caixa de diálogo de cores.

virtual BOOL OpenColorDialog(
    const COLORREF colorDefault,
    COLORREF& colorRes);

Parâmetros

colorDefault
[in] A cor selecionada por padrão quando a caixa de diálogo de cores é aberta.

colorRes
[out] A cor selecionada por um usuário.

Valor de retorno

TRUE se o usuário selecionou uma cor. FALSE se o usuário cancelou a caixa de diálogo de cores.

Comentários

CMFCColorBar::Rebuild

Redesenha completamente o controle de barra de cores.

virtual void Rebuild();

CMFCColorBar::SelectPalette

Define a paleta lógica do contexto de dispositivo especificado como a paleta do botão pai do controle de barra de cores atual.

CPalette* SelectPalette(CDC* pDC);

Parâmetros

pDC
[in] Ponteiro para o contexto de dispositivo do botão pai do controle de barra de cores atual.

Valor de retorno

Ponteiro para a paleta substituída pela paleta do botão pai do controle de barra de cores atual.

CMFCColorBar::SetColor

Define a cor selecionada no momento.

void SetColor(COLORREF color);

Parâmetros

color
[in] Um valor de cor RGB.

CMFCColorBar::SetColorName

Define um novo nome para uma cor especificada.

static void SetColorName(
    COLORREF color,
    const CString& strName);

Parâmetros

color
[in] O valor RGB de uma cor.

strName
[in] O novo nome da cor especificada.

Comentários

Esse método altera o nome da cor especificada em todos os objetos CMFCColorBar no aplicativo.

CMFCColorBar::SetCommandID

Define uma nova ID de comando para um controle de barra de cores.

void SetCommandID(UINT nCommandID);

Parâmetros

nCommandID
[in] Uma ID de comando.

Comentários

Chame esse método para modificar a ID de comando de um controle de barra de cores e notificar a janela pai do controle de que a ID foi alterada.

CMFCColorBar::SetDocumentColors

Define a lista de cores usadas no documento atual.

void SetDocumentColors(
    LPCTSTR lpszCaption,
    CList<COLORREF,COLORREF>& lstDocColors,
    BOOL bShowWhenDocked=FALSE);

Parâmetros

lpszCaption
[in] Uma legenda exibida quando o controle de barra de cores não está encaixado.

lstDocColors
[in] Uma lista de cores que substitui as cores do documento atuais.

bShowWhenDocked
[in] TRUE para mostrar as cores do documento quando o controle de barra de cores estiver encaixado. Caso contrário, FALSE. O valor padrão é FALSE.

Comentários

As cores do documento são as cores usadas em um documento no momento. A estrutura mantém automaticamente uma lista de cores do documento, mas você pode usar esse método para modificar a lista.

CMFCColorBar::SetHorzMargin

Define a margem horizontal, que é o espaço entre a célula de cor esquerda ou direita e o limite da área do cliente.

void SetHorzMargin(int nHorzMargin);

Parâmetros

nHorzMargin
[in] A margem horizontal, em pixels.

Comentários

Por padrão, o construtor CMFCColorBar::CMFCColorBar define a margem horizontal como 4 pixels.

CMFCColorBar::SetPropList

Define o membro de dados protegido m_pWndPropList como o ponteiro especificado para um controle de grade de propriedade.

void SetPropList(CMFCPropertyGridCtrl* pWndList);

Parâmetros

pWndList
[in] Ponteiro para o objeto de controle da grade de propriedades.

CMFCColorBar::SetVertMargin

Define a margem vertical, que é o espaço entre a célula de cor superior ou inferior e o limite da área do cliente.

void SetVertMargin(int nVertMargin);

Parâmetros

nVertMargin
[in] A margem vertical, em pixels.

Comentários

Por padrão, o construtor CMFCColorBar::CMFCColorBar define a margem vertical como 4 pixels.

CMFCColorBar::ShowCommandMessageString

Solicita a janela com moldura que possui o controle de barra de cores para atualizar a linha de mensagem na barra de status.

virtual void ShowCommandMessageString(UINT uiCmdId);

Parâmetros

uiCmdId
[in] Uma ID de comando. (Este parâmetro é ignorado.)

Comentários

Esse método envia a mensagem WM_SETMESSAGESTRING para o proprietário do controle de barra de cores.

Confira também

Gráfico da hierarquia
Classes