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
| Nome | Descrizione |
|---|---|
| CMFCRibbonColorButton::CMFCRibbonColorButton |
Metodi pubblici
| Nome | Descrizione |
|---|---|
| CMFCRibbonColorButton::AddColorsGroup | Aggiunge un gruppo di colori nell'area dei colori normali. |
| CMFCRibbonColorButton::EnableAutomaticButton | Specifica se il pulsante Automatico è abilitato. |
| CMFCRibbonColorButton::EnableOtherButton | Abilita il pulsante Altro . |
| CMFCRibbonColorButton::GetAutomaticColor | |
| CMFCRibbonColorButton::GetColor | Restituisce il colore attualmente selezionato. |
| CMFCRibbonColorButton::GetColorBoxSize | Restituisce le dimensioni degli elementi di colore visualizzati nella barra dei colori. |
| CMFCRibbonColorButton::GetColumns | |
| CMFCRibbonColorButton::GetHighlightedColor | Restituisce il colore dell'elemento attualmente selezionato nella tavolozza dei colori popup. |
| CMFCRibbonColorButton::RemoveAllColorGroups | Rimuove tutti i gruppi di colore dall'area dei colori normali. |
| CMFCRibbonColorButton::SetColor | Seleziona un colore dall'area dei colori normali. |
| CMFCRibbonColorButton::SetColorBoxSize | Imposta le dimensioni di tutti gli elementi di colore visualizzati nella barra dei colori. |
| CMFCRibbonColorButton::SetColorName | |
| CMFCRibbonColorButton::SetColumns | |
| CMFCRibbonColorButton::SetDocumentColors | Specifica un elenco di valori RGB da visualizzare nell'area dei colori del documento. |
| CMFCRibbonColorButton::SetPalette | |
| CMFCRibbonColorButton::UpdateColor |
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à
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.