Klasa CMFCRibbonColorButton
Klasa CMFCRibbonColorButton implementuje przycisk koloru, który można dodać do paska wstążki. Przycisk koloru wstążki wyświetla menu rozwijane zawierające co najmniej jedną paletę kolorów.
Składnia
class CMFCRibbonColorButton : public CMFCRibbonGallery
Elementy członkowskie
Konstruktory publiczne
| Nazwa/nazwisko | opis |
|---|---|
| CMFCRibbonColorButton::CMFCRibbonColorButton |
Metody publiczne
Uwagi
Przycisk koloru wstążki wyświetla pasek kolorów po naciśnięciu go przez użytkownika. Domyślnie ten pasek kolorów zawiera paletę wyboru kolorów o nazwie zwykły obszar kolorów. Opcjonalnie pasek kolorów może wyświetlić przycisk Automatyczny , który umożliwia użytkownikowi wybranie koloru domyślnego oraz przycisk Inny , który wyświetla paletę kolorów podręcznych, która zawiera dodatkowe kolory.
Przykład
W poniższym przykładzie pokazano, jak używać różnych metod w CMFCRibbonColorButton klasie . W przykładzie pokazano, jak utworzyć CMFCRibbonColorButton obiekt, ustawić duży obraz, włączyć przycisk Automatyczny, włączyć przycisk Inne, ustawić liczbę kolumn, ustawić rozmiar wszystkich elementów kolorów wyświetlanych na pasku kolorów, dodać grupę kolorów do zwykłego obszaru kolorów i określić listę wartości RGB do wyświetlenia w obszarze kolorów dokumentu. Ten fragment kodu jest częścią przykładu 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);
Hierarchia dziedziczenia
Wymagania
Nagłówek: afxribboncolorbutton.h
CMFCRibbonColorButton::AddColorsGroup
Dodaje grupę kolorów do zwykłego obszaru kolorów.
void AddColorsGroup(
LPCTSTR lpszName,
const CList<COLORREF,COLORREF>& lstColors,
BOOL bContiguousColumns=FALSE);
Parametry
lpszName
[in] Nazwa grupy.
lstColors
[in] Lista kolorów.
bContiguousColumns
[in] Określa sposób wyświetlania elementów kolorów w grupie. Jeśli wartość TRUE, elementy kolorów są rysowane bez odstępów pionowych. Jeśli fałsz, elementy kolorów są rysowane z odstępami pionowymi.
Uwagi
Użyj tej funkcji, aby kolor wyskakujące okienko wyświetlało kilka grup kolorów. Możesz kontrolować sposób wyświetlania kolorów w grupie.
CMFCRibbonColorButton::CMFCRibbonColorButton
CMFCRibbonColorButton Tworzy obiekt.
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));
Parametry
Nid
[in] Określa identyfikator polecenia do wykonania, gdy użytkownik kliknie przycisk.
lpszText
[in] Określa tekst, który ma być wyświetlany na przycisku.
nSmallImageIndex
[in] Indeks na podstawie zera małego obrazu, który ma być wyświetlany na przycisku.
Kolor
[in] Kolor przycisku (domyślnie jest).
bSimpleButtonLook
[in] Jeśli wartość TRUE, przycisk jest rysowany jako prosty prostokąt.
nLargeImageIndex
[in] Indeks zera dużego obrazu, który ma być wyświetlany na przycisku.
Wartość zwracana
Uwagi
CMFCRibbonColorButton::EnableAutomaticButton
Określa, czy przycisk Automatyczny jest włączony.
void EnableAutomaticButton(
LPCTSTR lpszLabel,
COLORREF colorAutomatic,
BOOL bEnable=TRUE,
LPCTSTR lpszToolTip=NULL,
BOOL bOnTop=TRUE,
BOOL bDrawBorder=FALSE);
Parametry
lpszLabel
[in] Etykieta przycisku Automatyczne .
colorAutomatic
[in] Wartość RGB określająca domyślny kolor przycisku Automatycznego .
bEnable
[in] WARTOŚĆ TRUE, jeśli przycisk Automatyczny jest włączony; WARTOŚĆ FALSE, jeśli jest wyłączona.
lpszToolTip
[in] Etykietka narzędzia przycisku Automatyczne .
bOnTop
[in] Określa, czy przycisk Automatyczny znajduje się u góry, przed paletą kolorów.
bDrawBorder
[in] Wartość TRUE, jeśli aplikacja rysuje obramowanie wokół paska kolorów na przycisku koloru wstążki. Pasek kolorów wyświetla aktualnie wybrany kolor. FAŁSZ, jeśli aplikacja nie narysuje obramowania
CMFCRibbonColorButton::EnableOtherButton
Włącza przycisk Inne.
void EnableOtherButton(
LPCTSTR lpszLabel,
LPCTSTR lpszToolTip=NULL);
Parametry
lpszLabel
Etykieta przycisku.
lpszToolTip
Tekst etykietki narzędzia dla przycisku Inne .
Uwagi
Przycisk Inne to przycisk wyświetlany poniżej grupy kolorów. Gdy użytkownik kliknie przycisk Inne , wyświetli okno dialogowe koloru.
CMFCRibbonColorButton::GetAutomaticColor
Pobiera bieżący kolor przycisku automatycznego.
COLORREF GetAutomaticColor() const;
Wartość zwracana
Wartość koloru RGB reprezentująca bieżący kolor przycisku automatycznego.
Uwagi
Kolor przycisku automatycznego jest ustawiany przez colorAutomatic parametr przekazany do CMFCRibbonColorButton::EnableAutomaticButton metody .
CMFCRibbonColorButton::GetColor
Zwraca aktualnie wybrany kolor.
COLORREF GetColor() const;
Wartość zwracana
Kolor wybrany przez kliknięcie przycisku.
CMFCRibbonColorButton::GetColorBoxSize
Zwraca rozmiar elementów kolorów wyświetlanych na pasku kolorów.
CSize GetColorBoxSize() const;
Wartość zwracana
Rozmiar przycisków kolorów na palecie kolorów listy rozwijanej.
CMFCRibbonColorButton::GetColumns
Pobiera liczbę elementów w wierszu wyświetlania galerii przycisku koloru wstążki.
int GetColumns() const;
Wartość zwracana
Zwraca liczbę ikon w każdym wierszu.
Uwagi
CMFCRibbonColorButton::GetHighlightedColor
Zwraca kolor aktualnie wybranego elementu na palecie kolorów wyskakujących okienek.
COLORREF GetHighlightedColor() const;
Wartość zwracana
Kolor aktualnie wybranego elementu na wyskakującym palecie kolorów.
CMFCRibbonColorButton::RemoveAllColorGroups
Usuwa wszystkie grupy kolorów ze zwykłego obszaru kolorów.
void RemoveAllColorGroups();
CMFCRibbonColorButton::SetColor
Wybiera kolor z zwykłego obszaru kolorów.
void SetColor(COLORREF color);
Parametry
Kolor
[in] Kolor do ustawienia.
CMFCRibbonColorButton::SetColorBoxSize
Ustawia rozmiar wszystkich elementów kolorów wyświetlanych na pasku kolorów.
void SetColorBoxSize(CSize sizeBox);
Parametry
sizeBox
[in] Nowy rozmiar przycisków kolorów w palecie kolorów.
CMFCRibbonColorButton::SetColorName
Ustawia nową nazwę dla określonego koloru.
static void __stdcall SetColorName(
COLORREF color,
const CString& strName);
Parametry
Kolor
[in] Wartość RGB koloru.
strName
[in] Nowa nazwa określonego koloru.
Uwagi
Ponieważ wywołuje CMFCColorBar::SetColorNamemetodę , ta metoda zmienia nazwę określonego koloru we wszystkich CMFCColorBar obiektach w aplikacji.
CMFCRibbonColorButton::SetColumns
Ustawia liczbę kolumn wyświetlanych w tabeli kolorów wyświetlanych użytkownikowi podczas procesu wyboru kolorów użytkownika.
void SetColumns(int nColumns);
Parametry
nKolumny
[in] Liczba ikon kolorów do wyświetlenia w każdym wierszu.
Uwagi
CMFCRibbonColorButton::SetDocumentColors
Określa listę wartości RGB do wyświetlenia w obszarze koloru dokumentu.
void SetDocumentColors(
LPCTSTR lpszLabel,
CList<COLORREF,COLORREF>& lstColors);
Parametry
lpszLabel
[in] Tekst, który ma być wyświetlany z kolorami dokumentu.
lstColors
[in] Odwołanie do listy wartości RGB.
CMFCRibbonColorButton::SetPalette
Określa kolory standardowe do wyświetlenia w tabeli kolorów wyświetlanej przez przycisk koloru.
void SetPalette(CPalette* pPalette);
Parametry
pPalette
[in] Wskaźnik do palety kolorów.
Uwagi
CMFCRibbonColorButton::UpdateColor
Wywoływana przez platformę, gdy użytkownik wybierze kolor z tabeli kolorów wyświetlanej, gdy użytkownik kliknie przycisk koloru.
void UpdateColor(COLORREF color);
Parametry
Kolor
[in] Kolor wybrany przez użytkownika.
Uwagi
Metoda CMFCRibbonColorButton::UpdateColor zmienia kolor aktualnie wybranego przycisku i powiadamia jego element nadrzędny, wysyłając komunikat WM_COMMAND z BN_CLICKED powiadomieniem standardowym. Użyj metody CMFCRibbonColorButton::GetColor, aby pobrać wybrany kolor.