Classe CMFCColorPopupMenu

Representa um menu pop-up que os usuários usam para selecionar cores em um documento ou aplicativo.

Sintaxe

class CMFCColorPopupMenu : public CMFCPopupMenu

Membros

Construtores públicos

Nome	Descrição
CMFCColorPopupMenu::CMFCColorPopupMenu	Constrói um objeto CMFCColorPopupMenu.
CMFCColorPopupMenu::~CMFCColorPopupMenu	Destruidor.

Métodos públicos

Nome	Descrição
CMFCColorPopupMenu::CreateTearOffBar	Cria uma barra de cores removível e encaixável. (Substitui CMFCPopupMenu::CreateTearOffBar.)
CMFCColorPopupMenu::GetMenuBar	Retorna o CMFCPopupMenuBar inserido no menu pop-up. (Substitui CMFCPopupMenu::GetMenuBar.)
CMFCColorPopupMenu::GetThisClass	Usado pela estrutura para obter um ponteiro para o objeto CRuntimeClass associado a esse tipo de classe.
CMFCColorPopupMenu::SetPropList	Define o objeto de controle de grade da propriedade do objeto inserido CMFCColorBar.

Membros de dados

Nome	Descrição
m_bEnabledInCustomizeMode	Um valor booliano que determina se a barra de cores deve ser mostrada.
m_wndColorBar	O objeto CMFCColorBar que fornece a seleção de cores.

Comentários

Essa classe herda a funcionalidade de menu pop-up da classe CMFCPopupMenu e gerencia um objeto CMFCColorBar que fornece a seleção de cores. Quando a estrutura da barra de ferramentas está no modo de personalização e o membro m_bEnabledInCustomizeMode é definido como FALSE, o objeto da barra de cores não é mostrado. Para obter mais informações sobre o modo de personalização, confira CMFCToolBar::IsCustomizeMode

Para obter mais informações sobre CMFCColorBar, confira Classe CMFCColorBar.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CFrameWnd

CMiniFrameWnd

CMFCPopupMenu

CMFCColorPopupMenu

Requisitos

Cabeçalho: afxcolorpopupmenu.h

CMFCColorPopupMenu::CMFCColorPopupMenu

Constrói um objeto CMFCColorPopupMenu.

CMFCColorPopupMenu(
    const CArray<COLORREF, COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors, CList<COLORREF, COLORREF>& lstDocColors,
    int nColumns,
    int nHorzDockRows,
    int nVertDockColumns,
    COLORREF colorAutomatic,
    UINT uiCommandID,
    BOOL bStdColorDlg = FALSE);

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

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

Parâmetros

colors
[in] Uma matriz de cores que a estrutura exibe no menu pop-up.

color
[in] A cor selecionada padrão.

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.

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

nVertDockColumns
[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.

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

bStdColorDlg
[in] 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.

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

Nid
[in] A ID de comando.

Comentários

Cada construtor sobrecarregado define o membro m_bEnabledInCustomizeMode como FALSE.

Exemplo

O exemplo a seguir demonstra como construir um objeto CMFCColorPopupMenu.

COLORREF color;
CArray<COLORREF, COLORREF> colors;
CString strAutoColorText;
CString strOtherText;
CString strDocColorsText;
CList<COLORREF, COLORREF> lstDocColors;
COLORREF colorAutomatic;
int nColumns;
CMFCColorButton colorButton;
CMFCColorPopupMenu *pPopup = new CMFCColorPopupMenu(&colorButton, colors, color, strAutoColorText, strOtherText, strDocColorsText, lstDocColors, nColumns, colorAutomatic);

CMFCColorPopupMenu::CreateTearOffBar

Cria uma barra de cores removível e encaixável.

virtual CPane* CreateTearOffBar(
    CFrameWnd* pWndMain,
    UINT uiID,
    LPCTSTR lpszName);

Parâmetros

pWndMain
[in] Ponteiro para a janela pai da barra removível.

uiID
[in] A ID de comando da barra removível.

lpszName
[in] O texto da janela da barra removível.

Valor de retorno

Um ponteiro para o novo objeto de barra de controle removível.

Comentários

Esse método cria um objeto da classe CMFCColorBar e o converte em um ponteiro da classe CPane. Você pode converter esse valor de volta em um ponteiro da classe CMFCColorBar usando uma das macros de conversão descritas em Conversão de tipos de objetos de classe do MFC.

CMFCColorPopupMenu::GetMenuBar

Retorna o CMFCPopupMenuBar inserido no menu pop-up.

virtual CMFCPopupMenuBar* GetMenuBar();

Valor de retorno

Um ponteiro para o CMFCPopupMenuBar inserido.

Comentários

O menu pop-up de cores tem um objeto de classe CMFCPopupMenuBar inserido. Substitua esse método em uma classe derivada se o aplicativo usar um tipo inserido diferente.

CMFCColorPopupMenu::SetPropList

Define o objeto de controle de grade da propriedade do objeto inserido CMFCColorBar.

void SetPropList(CMFCPropertyGridCtrl* pWndList);

Parâmetros

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

Confira também

Gráfico da hierarquia
Classes