Compartir a través de


CMFCRibbonColorButton Class

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

Jerarquía de herencia

CObject

   CMFCRibbonBaseElement

      CMFCRibbonButton

         CMFCRibbonGallery

            CMFCRibbonColorButton

Requisitos

encabezado: afxribboncolorbutton.h

Vea también

Referencia

Gráfico de jerarquías

CMFCRibbonGallery Class

Otros recursos

Clases de MFC