Classe CMFCRibbonColorButton

La classe CMFCRibbonColorButton implementa un pulsante colore che è possibile aggiungere a una barra multifunzione. Il pulsante colore della barra multifunzione visualizza un menu a discesa contenente una o più tavolozze dei colori.

Sintassi

class CMFCRibbonColorButton : public CMFCRibbonGallery

Membri

Costruttori pubblici

Metodi pubblici

Osservazioni:

Se selezionato, il pulsante colore della barra multifunzione visualizza una barra dei colori. Per impostazione predefinita, la barra dei colori contiene una tavolozza denominata area dei colori normali. Facoltativamente, la barra dei colori può visualizzare un pulsante Automatico che consente all'utente di selezionare un colore predefinito e un pulsante Altro che visualizza una tavolozza dei colori popup contenente altri colori.

Esempio

L'esempio seguente illustra come usare i vari metodi nella classe CMFCRibbonColorButton . L'esempio illustra come costruire un oggetto CMFCRibbonColorButton , impostare l'immagine di grandi dimensioni, abilitare il pulsante Automatico , abilitare il pulsante Altro , impostare il numero di colonne, impostare le dimensioni di tutti gli elementi di colore visualizzati nella barra dei colori, aggiungere un gruppo di colori nell'area dei colori normali e specificare un elenco di valori RGB da visualizzare nell'area dei colori del documento. Questo frammento di codice fa parte dell' esempio Draw Client.

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

Gerarchia di ereditarietà

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonGallery

CMFCRibbonColorButton

Requisiti

Intestazione: afxribboncolorbutton.h

CMFCRibbonColorButton::AddColorsGroup

Aggiunge un gruppo di colori nell'area dei colori normali.

void AddColorsGroup(
    LPCTSTR lpszName,
    const CList<COLORREF,COLORREF>& lstColors,
    BOOL bContiguousColumns=FALSE);

Parametri

lpszName
[in] Nome del gruppo.

lstColors
[in] Elenco di colori.

bContiguousColumns
[in] Controlla la modalità di visualizzazione degli elementi colore nel gruppo. Se TRUE, gli elementi colore vengono disegnati senza spaziatura verticale. Se FALSE, gli elementi colore vengono disegnati con una spaziatura verticale.

Osservazioni:

Usare questa funzione per visualizzare i colori popup diversi gruppi di colori. È possibile controllare la modalità di visualizzazione dei colori nel gruppo.

CMFCRibbonColorButton::CMFCRibbonColorButton

Costruisce un oggetto CMFCRibbonColorButton.

CMFCRibbonColorButton();

CMFCRibbonColorButton(
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex,
    COLORREF color = RGB(0, 0, 0));

CMFCRibbonColorButton(
    UINT nID,
    LPCTSTR lpszText,
    BOOL bSimpleButtonLook,
    int nSmallImageIndex,
    int nLargeImageIndex,
    COLORREF color = RGB(0, 0, 0));

Parametri

nID
[in] Specifica l'ID comando del comando da eseguire quando un utente fa clic sul pulsante.

lpszText
[in] Specifica il testo da visualizzare sul pulsante.

nSmallImageIndex
[in] Indice in base zero dell'immagine piccola da visualizzare sul pulsante.

color
[in] Colore del pulsante (il valore predefinito è nero).

bSimpleButtonLook
[in] Se TRUE, il pulsante viene disegnato come rettangolo semplice.

nLargeImageIndex
[in] Indice in base zero dell'immagine di grandi dimensioni da visualizzare sul pulsante.

Valore restituito

Osservazioni:

CMFCRibbonColorButton::EnableAutomaticButton

Specifica se il pulsante Automatico è abilitato.

void EnableAutomaticButton(
    LPCTSTR lpszLabel,
    COLORREF colorAutomatic,
    BOOL bEnable=TRUE,
    LPCTSTR lpszToolTip=NULL,
    BOOL bOnTop=TRUE,
    BOOL bDrawBorder=FALSE);

Parametri

lpszLabel
[in] Etichetta per il pulsante Automatico .

colorAutomatic
[in] Valore RGB che specifica il colore predefinito del pulsante Automatico .

bEnable
[in] TRUE se il pulsante Automatico è abilitato; FALSE se è disabilitato.

lpszToolTip
[in] Descrizione comando del pulsante Automatico .

bOnTop
[in] Specifica se il pulsante Automatico si trova nella parte superiore, prima della tavolozza dei colori.

bDrawBorder
[in] TRUE se l'applicazione disegna un bordo attorno alla barra dei colori sul pulsante colore della barra multifunzione. La barra dei colori visualizza il colore attualmente selezionato. FALSE se l'applicazione non disegna un bordo

CMFCRibbonColorButton::EnableOtherButton

Abilita il pulsante Altro .

void EnableOtherButton(
    LPCTSTR lpszLabel,
    LPCTSTR lpszToolTip=NULL);

Parametri

lpszLabel
Etichetta del pulsante.

lpszToolTip
Testo della descrizione comando per il pulsante Altro .

Osservazioni:

Il pulsante Altro è il pulsante visualizzato sotto il gruppo di colori. Quando l'utente fa clic sul pulsante Altro , viene visualizzata una finestra di dialogo colore.

CMFCRibbonColorButton::GetAutomaticColor

Recupera il colore corrente del pulsante automatico.

COLORREF GetAutomaticColor() const;

Valore restituito

Valore di colore RGB che rappresenta il colore corrente del pulsante automatico.

Osservazioni:

Il colore del pulsante automatico viene impostato dal colorAutomatic parametro passato al CMFCRibbonColorButton::EnableAutomaticButton metodo .

CMFCRibbonColorButton::GetColor

Restituisce il colore attualmente selezionato.

COLORREF GetColor() const;

Valore restituito

Colore selezionato facendo clic sul pulsante.

CMFCRibbonColorButton::GetColorBoxSize

Restituisce le dimensioni degli elementi di colore visualizzati nella barra dei colori.

CSize GetColorBoxSize() const;

Valore restituito

Dimensioni dei pulsanti colore nella tavolozza dei colori a discesa.

CMFCRibbonColorButton::GetColumns

Ottiene il numero di elementi in una riga della visualizzazione della raccolta del pulsante colore della barra multifunzione.

int GetColumns() const;

Valore restituito

Restituisce il numero di icone in ogni riga.

Osservazioni:

CMFCRibbonColorButton::GetHighlightedColor

Restituisce il colore dell'elemento attualmente selezionato nella tavolozza dei colori popup.

COLORREF GetHighlightedColor() const;

Valore restituito

Colore dell'elemento attualmente selezionato nella tavolozza dei colori popup.

CMFCRibbonColorButton::RemoveAllColorGroups

Rimuove tutti i gruppi di colore dall'area dei colori normali.

void RemoveAllColorGroups();

CMFCRibbonColorButton::SetColor

Seleziona un colore dall'area dei colori normali.

void SetColor(COLORREF color);

Parametri

color
[in] Colore da impostare.

CMFCRibbonColorButton::SetColorBoxSize

Imposta le dimensioni di tutti gli elementi di colore visualizzati nella barra dei colori.

void SetColorBoxSize(CSize sizeBox);

Parametri

sizeBox
[in] Nuova dimensione dei pulsanti colore nella tavolozza dei colori.

CMFCRibbonColorButton::SetColorName

Imposta un nuovo nome per un colore specificato.

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

Parametri

color
[in] Valore RGB di un colore.

strName
[in] Nuovo nome per il colore specificato.

Osservazioni:

Poiché chiama CMFCColorBar::SetColorName, questo metodo modifica il nome del colore specificato in tutti gli CMFCColorBar oggetti nell'applicazione.

CMFCRibbonColorButton::SetColumns

Imposta il numero di colonne visualizzate nella tabella dei colori presentati all'utente durante il processo di selezione dei colori dell'utente.

void SetColumns(int nColumns);

Parametri

nColumns
[in] Numero di icone a colori da visualizzare in ogni riga.

Osservazioni:

CMFCRibbonColorButton::SetDocumentColors

Specifica un elenco di valori RGB da visualizzare nell'area dei colori del documento.

void SetDocumentColors(
    LPCTSTR lpszLabel,
    CList<COLORREF,COLORREF>& lstColors);

Parametri

lpszLabel
[in] Testo da visualizzare con i colori del documento.

lstColors
[in] Riferimento a un elenco di valori RGB.

CMFCRibbonColorButton::SetPalette

Specifica i colori standard da visualizzare nella tabella colori visualizzata dal pulsante colore.

void SetPalette(CPalette* pPalette);

Parametri

pPalette
[in] Puntatore a una tavolozza dei colori.

Osservazioni:

CMFCRibbonColorButton::UpdateColor

Chiamato dal framework quando l'utente seleziona un colore dalla tabella dei colori visualizzata quando l'utente fa clic sul pulsante colore.

void UpdateColor(COLORREF color);

Parametri

color
[in] Colore selezionato dall'utente.

Osservazioni:

Il CMFCRibbonColorButton::UpdateColor metodo modifica il colore del pulsante attualmente selezionato e ne notifica l'elemento padre inviando un messaggio di WM_COMMAND con una notifica standard BN_CLICKED. Utilizzare il metodo CMFCRibbonColorButton::GetColor per recuperare il colore selezionato.

Vedi anche

Grafico della gerarchia
Classi
Classe CMFCRibbonGallery