Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
Opmerking
De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.
De CMFCRibbonColorButton klasse implementeert een kleurknop die u aan een lintbalk kunt toevoegen. De knop Met de lintkleur wordt een vervolgkeuzemenu met een of meer kleurenpalletten weergegeven.
Syntaxis
class CMFCRibbonColorButton : public CMFCRibbonGallery
Leden
Openbare constructors
| Naam | Description |
|---|---|
| CMFCRibbonColorButton::CMFCRibbonColorButton |
Openbare methoden
| Naam | Description |
|---|---|
| CMFCRibbonColorButton::AddColorsGroup | Voegt een groep kleuren toe aan het normale kleurgebied. |
| CMFCRibbonColorButton::EnableAutomaticButton | Hiermee geeft u op of de knop Automatisch is ingeschakeld. |
| CMFCRibbonColorButton::EnableOtherButton | Hiermee schakelt u de knop Overige in. |
| CMFCRibbonColorButton::GetAutomaticColor | |
| CMFCRibbonColorButton::GetColor | Retourneert de geselecteerde kleur. |
| CMFCRibbonColorButton::GetColorBoxSize | Retourneert de grootte van de kleurelementen die worden weergegeven op de kleurenbalk. |
| CMFCRibbonColorButton::GetColumns | |
| CMFCRibbonColorButton::GetHighlightedColor | Retourneert de kleur van het geselecteerde element in het pop-upkleurenpalet. |
| CMFCRibbonColorButton::RemoveAllColorGroups | Hiermee verwijdert u alle kleurgroepen uit het normale kleurgebied. |
| CMFCRibbonColorButton::SetColor | Selecteert een kleur in het normale kleurgebied. |
| CMFCRibbonColorButton::SetColorBoxSize | Hiermee stelt u de grootte in van alle kleurelementen die op de kleurenbalk worden weergegeven. |
| CMFCRibbonColorButton::SetColorName | |
| CMFCRibbonColorButton::SetColumns | |
| CMFCRibbonColorButton::SetDocumentColors | Hiermee geeft u een lijst met RGB-waarden op die moeten worden weergegeven in het documentkleurgebied. |
| CMFCRibbonColorButton::SetPalette | |
| CMFCRibbonColorButton::UpdateColor |
Opmerkingen
Op de lintkleurknop wordt een kleurenbalk weergegeven wanneer een gebruiker erop drukt. Deze kleurenbalk bevat standaard een kleurenselectiepalet dat het normale kleurgebied wordt genoemd. Optioneel kan de kleurenbalk een automatische knop weergeven, waarmee de gebruiker een standaardkleur kan selecteren en een andere knop, waarin een pop-upkleurenpalet met extra kleuren wordt weergegeven.
Example
In het volgende voorbeeld ziet u hoe u verschillende methoden in de CMFCRibbonColorButton klasse gebruikt. In het voorbeeld ziet u hoe u een CMFCRibbonColorButton object maakt, de grote afbeelding instelt, de knop Automatisch inschakelt, de knop Overige inschakelt, het aantal kolommen instelt, de grootte instelt van alle kleurelementen die op de kleurenbalk worden weergegeven, een groep kleuren toevoegt aan het normale kleurgebied en een lijst met RGB-waarden opgeeft die in het documentkleurgebied moet worden weergegeven. Dit codefragment maakt deel uit van het voorbeeld van de 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);
Overnamehiërarchie
Requirements
Koptekst: afxribboncolorbutton.h
CMFCRibbonColorButton::AddColorsGroup
Voegt een groep kleuren toe aan het normale kleurgebied.
void AddColorsGroup(
LPCTSTR lpszName,
const CList<COLORREF,COLORREF>& lstColors,
BOOL bContiguousColumns=FALSE);
Parameterwaarden
lpszName
[in] De groepsnaam.
lstColors
[in] De lijst met kleuren.
bContiguousColumns
[in] Hiermee bepaalt u hoe de kleuritems worden weergegeven in de groep. Indien WAAR, worden de kleuritems getekend zonder verticale afstand. Als ONWAAR, worden de kleuritems getekend met een verticale afstand.
Opmerkingen
Gebruik deze functie om ervoor te zorgen dat in het pop-upvenster verschillende kleurengroepen worden weergegeven. U kunt bepalen hoe de kleuren in de groep worden weergegeven.
CMFCRibbonColorButton::CMFCRibbonColorButton
Maakt een CMFCRibbonColorButton object.
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));
Parameterwaarden
nID
[in] Hiermee geeft u de opdracht-id van de opdracht die moet worden uitgevoerd wanneer een gebruiker op de knop klikt.
lpszText
[in] Hiermee geeft u de tekst op die op de knop moet worden weergegeven.
nSmallImageIndex
[in] De op nul gebaseerde index van de kleine afbeelding die op de knop wordt weergegeven.
kleur
[in] De kleur van de knop (standaard zwart).
bSimpleButtonLook
[in] Als WAAR, wordt de knop getekend als een eenvoudige rechthoek.
nLargeImageIndex
[in] De op nul gebaseerde index van de grote afbeelding die op de knop wordt weergegeven.
Retourwaarde
Opmerkingen
CMFCRibbonColorButton::EnableAutomaticButton
Hiermee geeft u op of de knop Automatisch is ingeschakeld.
void EnableAutomaticButton(
LPCTSTR lpszLabel,
COLORREF colorAutomatic,
BOOL bEnable=TRUE,
LPCTSTR lpszToolTip=NULL,
BOOL bOnTop=TRUE,
BOOL bDrawBorder=FALSE);
Parameterwaarden
lpszLabel
[in] Het label voor de knop Automatisch .
colorAutomatic
[in] Een RGB-waarde die de standaardkleur van de knop Automatisch aangeeft.
bEnable
[in] WAAR als de knop Automatisch is ingeschakeld; ONWAAR als deze is uitgeschakeld.
lpszToolTip
[in] De knopinfo van de knop Automatisch .
bOnTop
[in] Hiermee geeft u op of de knop Automatisch bovenaan staat, vóór het kleurenpalet.
bDrawBorder
[in] WAAR als de toepassing een rand rond de kleurbalk van het lint tekent. Op de kleurenbalk wordt de geselecteerde kleur weergegeven. ONWAAR als de toepassing geen rand tekent
CMFCRibbonColorButton::EnableOtherButton
Hiermee schakelt u de knop Overige in.
void EnableOtherButton(
LPCTSTR lpszLabel,
LPCTSTR lpszToolTip=NULL);
Parameterwaarden
lpszLabel
Het label van de knop.
lpszToolTip
De knopinfotekst voor de knop Overige .
Opmerkingen
De knop Overige is de knop die wordt weergegeven onder de groep kleuren. Wanneer de gebruiker op de knop Overige klikt, wordt er een kleurendialoogvenster weergegeven.
CMFCRibbonColorButton::GetAutomaticColor
Hiermee haalt u de huidige kleur van de automatische knop op.
COLORREF GetAutomaticColor() const;
Retourwaarde
Een RGB-kleurwaarde die de huidige kleur van de automatische knop vertegenwoordigt.
Opmerkingen
De kleur van de automatische knop wordt ingesteld door de colorAutomatic parameter die wordt doorgegeven aan de CMFCRibbonColorButton::EnableAutomaticButton methode.
CMFCRibbonColorButton::GetColor
Retourneert de geselecteerde kleur.
COLORREF GetColor() const;
Retourwaarde
De kleur die is geselecteerd door op de knop te klikken.
CMFCRibbonColorButton::GetColorBoxSize
Retourneert de grootte van de kleurelementen die worden weergegeven op de kleurenbalk.
CSize GetColorBoxSize() const;
Retourwaarde
De grootte van de kleurknoppen in het vervolgkeuzelijstkleurenpalet.
CMFCRibbonColorButton::GetColumns
Hiermee haalt u het aantal items in een rij van de galerie van de lintkleurknop op.
int GetColumns() const;
Retourwaarde
Retourneert het aantal pictogrammen in elke rij.
Opmerkingen
CMFCRibbonColorButton::GetHighlightedColor
Retourneert de kleur van het geselecteerde element in het pop-upkleurenpalet.
COLORREF GetHighlightedColor() const;
Retourwaarde
De kleur van het geselecteerde element in het pop-upkleurenpalet.
CMFCRibbonColorButton::RemoveAllColorGroups
Hiermee verwijdert u alle kleurgroepen uit het normale kleurgebied.
void RemoveAllColorGroups();
CMFCRibbonColorButton::SetColor
Selecteert een kleur in het normale kleurgebied.
void SetColor(COLORREF color);
Parameterwaarden
kleur
[in] Een kleur die moet worden ingesteld.
CMFCRibbonColorButton::SetColorBoxSize
Hiermee stelt u de grootte in van alle kleurelementen die op de kleurenbalk worden weergegeven.
void SetColorBoxSize(CSize sizeBox);
Parameterwaarden
sizeBox
[in] De nieuwe grootte van de kleurknoppen in het kleurenpalet.
CMFCRibbonColorButton::SetColorName
Hiermee stelt u een nieuwe naam in voor een opgegeven kleur.
static void __stdcall SetColorName(
COLORREF color,
const CString& strName);
Parameterwaarden
kleur
[in] De RGB-waarde van een kleur.
strName
[in] De nieuwe naam voor de opgegeven kleur.
Opmerkingen
Omdat deze methode aanroept CMFCColorBar::SetColorName, wordt de naam van de opgegeven kleur in alle CMFCColorBar objecten in uw toepassing gewijzigd.
CMFCRibbonColorButton::SetColumns
Hiermee stelt u het aantal kolommen in dat wordt weergegeven in de tabel met kleuren die tijdens het selectieproces van de gebruiker worden weergegeven.
void SetColumns(int nColumns);
Parameterwaarden
nColumns
[in] Het aantal kleurpictogrammen dat in elke rij moet worden weergegeven.
Opmerkingen
CMFCRibbonColorButton::SetDocumentColors
Hiermee geeft u een lijst met RGB-waarden op die moeten worden weergegeven in het documentkleurgebied.
void SetDocumentColors(
LPCTSTR lpszLabel,
CList<COLORREF,COLORREF>& lstColors);
Parameterwaarden
lpszLabel
[in] De tekst die moet worden weergegeven met de documentkleuren.
lstColors
[in] Een verwijzing naar een lijst met RGB-waarden.
CMFCRibbonColorButton::SetPalette
Hiermee geeft u de standaardkleuren op die moeten worden weergegeven in de kleurentabel die door de kleurenknop wordt weergegeven.
void SetPalette(CPalette* pPalette);
Parameterwaarden
pPalette
[in] Een aanwijzer naar een kleurenpalet.
Opmerkingen
CMFCRibbonColorButton::UpdateColor
Aangeroepen door het framework wanneer de gebruiker een kleur selecteert in de kleurentabel die wordt weergegeven wanneer de gebruiker op de kleurknop klikt.
void UpdateColor(COLORREF color);
Parameterwaarden
kleur
[in] Een kleur die door de gebruiker is geselecteerd.
Opmerkingen
Met CMFCRibbonColorButton::UpdateColor de methode wordt de kleur van de geselecteerde knop gewijzigd en wordt de bovenliggende knop op de hoogte gesteld door een WM_COMMAND bericht te verzenden met een BN_CLICKED standaardmelding. Gebruik de methode CMFCRibbonColorButton::GetColor om de geselecteerde kleur op te halen.