CMFCRibbonColorButton Class

Artículo
06/10/2015

La clase de CMFCRibbonColorButton implementa un botón en color que puede agregar a una barra de la cinta de opciones. El botón de color de la cinta de opciones muestra un menú desplegable que contiene una o varias paletas de colores.

class CMFCRibbonColorButton : public CMFCRibbonGallery

Members

Constructores públicos

Name	Descripción
CMFCRibbonColorButton::CMFCRibbonColorButton

Métodos públicos

Name	Descripción
CMFCRibbonColorButton::AddColorsGroup	Agrega un grupo de colores al área de color normal.
CMFCRibbonColorButton::EnableAutomaticButton	especifica si el botón de Automático está habilitado.
CMFCRibbonColorButton::EnableOtherButton	habilita el botón de Otro .
CMFCRibbonColorButton::GetAutomaticColor
CMFCRibbonColorButton::GetColor	Devuelve el color seleccionado actualmente.
CMFCRibbonColorButton::GetColorBoxSize	Devuelve el tamaño de los elementos de color que aparecen en la barra de color.
CMFCRibbonColorButton::GetColumns
CMFCRibbonColorButton::GetHighlightedColor	Devuelve el color del elemento seleccionado de la paleta de colores móvil.
CMFCRibbonColorButton::RemoveAllColorGroups	Quita todos los grupos de color del área de color normal.
CMFCRibbonColorButton::SetColor	Selecciona el color del área de color normal.
CMFCRibbonColorButton::SetColorBoxSize	Establece el tamaño de todos los elementos de color que aparecen en la barra de color.
CMFCRibbonColorButton::SetColorName
CMFCRibbonColorButton::SetColumns
CMFCRibbonColorButton::SetDocumentColors	Especifica una lista de valores RGB para mostrar en el área de color del documento.
CMFCRibbonColorButton::SetPalette
CMFCRibbonColorButton::UpdateColor

Comentarios

El botón de color de la cinta de opciones muestra una barra de color cuando un usuario lo presiona. De forma predeterminada, esta barra de color contiene una paleta de selección de color con el área de color normal. Opcionalmente, la barra de color puede mostrar un botón de Automático , que permite que el usuario seleccione un color predeterminado, y un botón de Otro , que muestra una paleta de colores móvil que contiene colores adicionales.

Ejemplo

El ejemplo siguiente se muestra cómo utilizar varios métodos en la clase de CMFCRibbonColorButton . El ejemplo muestra cómo construir un objeto de CMFCRibbonColorButton , establece la imagen grande, habilita el botón de Automático , habilita el botón de Otro , establece el número de columnas, establezca el tamaño de todos los elementos de color que aparecen en la barra de color, agregue un grupo de colores al área de color normal, y especifique una lista de valores RGB para mostrar en el área de color del documento. Este fragmento de código es parte de Ejemplo de cliente de dibujo.

    // Create the "Paper Color" button
    CMFCRibbonColorButton* pBtnPaperColor = new CMFCRibbonColorButton(ID_VIEW_PAPERCOLOR, _T("Paper Color\ng"), TRUE, 13, 1);
    pBtnPaperColor->SetAlwaysLargeImage();
    pBtnPaperColor->EnableAutomaticButton(_T("&Automatic"), RGB(255, 255, 255));
    pBtnPaperColor->EnableOtherButton(_T("&More Colors..."), _T("More Colors"));
    pBtnPaperColor->SetColumns(10);
    pBtnPaperColor->SetColorBoxSize(CSize(17, 17));
    // CList<COLORREF,COLORREF> m_lstMainColors
    pBtnPaperColor->AddColorsGroup(_T("Theme Colors"), m_lstMainColors, TRUE);
    // CList<COLORREF,COLORREF> m_lstAdditionalColors
    pBtnPaperColor->AddColorsGroup(_T(""), m_lstAdditionalColors, FALSE);
    // CList<COLORREF,COLORREF> m_lstStandardColors
    pBtnPaperColor->AddColorsGroup(_T("Standard Colors"), m_lstStandardColors, TRUE);
    CList<COLORREF,COLORREF> lstColors;
    lstColors.AddTail(RGB(255,0,0));
    lstColors.AddTail(RGB(0,255,0));
    lstColors.AddTail(RGB(0,0,255));
    pBtnPaperColor->SetDocumentColors( _T("Document Colors"), lstColors );