Classe CMFCColorPopupMenu

Representa um menu pop-up que os utilizadores usam para selecionar cores num documento ou aplicação.

Sintaxe

class CMFCColorPopupMenu : public CMFCPopupMenu

Membros

Construtores Públicos

Métodos Públicos

Membros de Dados

Observações

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

Para mais informações sobre CMFCColorBar, consulte CMFCColorBar Class.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CFrameWnd

CMiniFrameWnd

CMFCPopupMenu

CMFCColorPopupMenu

Requerimentos

Cabeçalho: afxcolorpopupmenu.h

CMFCColorPopupMenu::CMFCColorPopupMenu

Constrói um CMFCColorPopupMenu objeto.

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

Cores
[dentro] Um conjunto de cores que a estrutura apresenta no menu pop-up.

cor
[dentro] A cor escolhida por defeito.

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

A etiqueta padrão para o botão automático é Automático.

lpszOtherColor
[dentro] O rótulo de texto do outro botão, que mostra mais escolhas de cor, ou NULL.

A etiqueta padrão para o outro botão é Mais Cores....

lpszDocColors
[dentro] A etiqueta de texto do botão de cores do documento. A paleta de cores do documento lista todas as cores que o documento utiliza atualmente.

lstDocColors
[dentro] Uma lista de cores que o documento utiliza atualmente.

nColunas
[dentro] O número de colunas que o array de cores tem.

nHorzDockRows
[dentro] O número de linhas que a barra de cor tem quando está acoplada horizontalmente.

nVertDockColumns
[dentro] O número de colunas que a barra de cor tem quando está encaixada verticalmente.

colorAutomatic
[dentro] A cor padrão que a estrutura aplica quando clicas no botão automático.

uiCommandID
[dentro] O ID do comando de controlo da barra de cores.

bStdColorDlg
[dentro] Um Booleano que indica se deve mostrar a caixa de diálogo padrão de cor do sistema ou a caixa de diálogo CMFCColorDialog .

pParentBtn
[dentro] Um apontador para um botão parental.

nID
[dentro] O ID do comando.

Observações

Cada construtor sobrecarregado define o m_bEnabledInCustomizeMode membro para FALSE.

Example

O exemplo seguinte demonstra como construir um CMFCColorPopupMenu objeto.

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

CMFCColorMenuPopup::CreateTearOffBar

Cria uma barra de cor removível acoplável.

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

Parâmetros

pWndMain
[dentro] Aponta para a janela principal do bar de remoção.

uiID
[dentro] O ID do comando da barra de remoção.

lpszName
[dentro] O texto da janela do bar removível.

Valor de retorno

Um apontador para o novo objeto de barra de controlo removível.

Observações

Este método cria um objeto CMFCColorBar Class e converte-o num ponteiro CPane Class . Pode castar este valor de volta para um ponteiro de classe CMFCColorBar usando uma das macros de casting descritas em Type Casting of MFC Class Objects.

CMFCColorMenuPopup::GetMenuBar

Devolve o CMFCPopupMenuBar que está embutido no menu pop-up.

virtual CMFCPopupMenuBar* GetMenuBar();

Valor de retorno

Um apontador para o embutido CMFCPopupMenuBar.

Observações

O menu pop-up a cores tem um objeto CMFCPopupMenuBar Class incorporado. Substitua este método numa classe derivada se a sua aplicação usar um tipo embutido diferente.

CMFCColorMenuPopup::SetPropList

Define o objeto de controlo da grelha de propriedades do objeto embutido CMFCColorBar .

void SetPropList(CMFCPropertyGridCtrl* pWndList);

Parâmetros

pWndList
[dentro] Apontador para um objeto de controlo de grelha de propriedade.

Consulte também

Gráfico de Hierarquia
Classes