Share via

CMFCColorBar-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

De CMFCColorBar klasse vertegenwoordigt een dockingbesturingsbalk die kleuren in een document of toepassing kan selecteren.

Syntaxis

class CMFCColorBar : public CMFCPopupMenuBar

Leden

Beveiligde constructors

Naam Description
CMFCColorBar::CMFCColorBar Maakt een CMFCColorBar object.

Openbare methoden

Naam Description
CMFCColorBar::ContextToSize Berekent de verticale en horizontale marges die nodig zijn om de knoppen op het besturingselement voor de kleurenbalk te bevatten en past vervolgens de locatie van deze knoppen aan.
CMFCColorBar::CreateControl Hiermee maakt u een besturingselementvenster voor de kleurenbalk, koppelt u het aan het CMFCColorBar object en wijzigt u het formaat van het besturingselement zodat het opgegeven kleurenpalet wordt weergegeven.
CMFCColorBar::Maken Hiermee maakt u een besturingselementvenster voor een kleurenbalk en koppelt u het aan het CMFCColorBar object.
CMFCColorBar::EnableAutomaticButton Hiermee wordt de automatische knop weergegeven of verborgen.
CMFCColorBar::EnableOtherButton Hiermee schakelt u de weergave van een dialoogvenster in of uit waarmee de gebruiker meer kleuren kan selecteren.
CMFCColorBar::GetColor Hiermee haalt u de geselecteerde kleur op.
CMFCColorBar::GetCommandID Hiermee haalt u de opdracht-id van het huidige besturingselement voor de kleurenbalk op.
CMFCColorBar::GetHighlightedColor Haalt de kleur op die aantekent dat een kleurknop de focus heeft; Dat wil gezegd, de knop is heet.
CMFCColorBar::GetHorzMargin Hiermee haalt u de horizontale marge op, de ruimte tussen de linker- of rechterkleurcel en de grens van het clientgebied.
CMFCColorBar::GetVertMargin Hiermee haalt u de verticale marge op, de ruimte tussen de bovenste of onderste kleurcel en de grens van het clientgebied.
CMFCColorBar::IsTearOff Geeft aan of de huidige kleurenbalk kan worden gekoppeld.
CMFCColorBar::SetColor Hiermee stelt u de kleur in die momenteel is geselecteerd.
CMFCColorBar::SetColorName Hiermee stelt u een nieuwe naam in voor een opgegeven kleur.
CMFCColorBar::SetCommandID Hiermee stelt u een nieuwe opdracht-id in voor een besturingselement voor een kleurenbalk.
CMFCColorBar::SetDocumentColors Hiermee stelt u de lijst met kleuren in die worden gebruikt in het huidige document.
CMFCColorBar::SetHorzMargin Hiermee stelt u de horizontale marge in. Dit is de ruimte tussen de linker- of rechterkleurcel en de grens van het clientgebied.
CMFCColorBar::SetVertMargin Hiermee stelt u de verticale marge in. Dit is de ruimte tussen de bovenste of onderste kleurcel en de grens van het clientgebied.

Beveiligde methoden

Naam Description
CMFCColorBar::AdjustLocations Hiermee past u de posities van de kleurknoppen op het besturingselement van de kleurenbalk aan.
CMFCColorBar::AllowChangeTextLabels Hiermee wordt aangegeven of het tekstlabel met kleurknoppen kan worden gewijzigd.
CMFCColorBar::AllowShowOnList Geeft aan of het besturingselementobject van de kleurenbalk tijdens het aanpassingsproces in een werkbalklijst kan worden weergegeven.
CMFCColorBar::CalcSize Aangeroepen door het framework als onderdeel van het indelingsberekeningsproces.
CMFCColorBar::CreatePalette Initialiseert een palet met de kleuren in een opgegeven matrix met kleuren.
CMFCColorBar::GetColorGridSize Berekent het aantal rijen en kolommen in het raster van een besturingselement voor een kleurenbalk.
CMFCColorBar::GetExtraHeight Berekent de extra hoogte die de huidige kleurenbalk nodig heeft om diverse elementen van de gebruikersinterface weer te geven, zoals de knop Overige , documentkleuren enzovoort.
CMFCColorBar::InitColors Initialiseert een matrix met kleuren met de kleuren in een opgegeven palet of het standaardpalet van het systeem.
CMFCColorBar::OnKey Aangeroepen door het framework wanneer een gebruiker op een toetsenbordknop drukt.
CMFCColorBar::OnSendCommand Aangeroepen door het framework om een hiërarchie van pop-upbesturingselementen te sluiten.
CMFCColorBar::OnUpdateCmdUI Aangeroepen door het framework om een gebruikersinterface-item van een kleurenbalkbesturingselement in of uit te schakelen voordat het item wordt weergegeven.
CMFCColorBar::OpenColorDialog Hiermee opent u een kleurendialoogvenster.
CMFCColorBar::Rebuild Hiermee wordt het besturingselement voor de kleurenbalk volledig opnieuw getekend.
CMFCColorBar::SelectPalette Hiermee stelt u het logische palet van de opgegeven apparaatcontext in op het palet van de bovenliggende knop van het huidige besturingselement voor de kleurenbalk.
CMFCColorBar::SetPropList Hiermee stelt u het m_pWndPropList beveiligde gegevenslid in op de opgegeven aanwijzer op een eigenschapsrasterbesturingselement.
CMFCColorBar::ShowCommandMessageString Vraagt het framevenster aan dat eigenaar is van het besturingselement voor de kleurenbalk om de berichtregel in de statusbalk bij te werken.

Beveiligde gegevensleden

Naam Description
m_bInternal Een Booleaanse veld dat bepaalt of muisgebeurtenissen worden verwerkt. Normaal gesproken worden muisgebeurtenissen verwerkt wanneer dit veld WAAR is en de aanpassingsmodus ONWAAR is.
m_bIsEnabled Een Booleaanse waarde die aangeeft of een besturingselement is ingeschakeld.
m_bIsTearOff Een Booleaanse waarde die aangeeft of het besturingselement voor de kleurenbalk docking ondersteunt.
m_BoxSize Een CSize-object dat de grootte van een cel in een kleurenbalkraster aangeeft.
m_bShowDocColorsWhenDocked Een Booleaanse waarde die aangeeft of documentkleuren moeten worden weergegeven wanneer de kleurenbalk is gedokt. Zie CMFCColorBar::SetDocumentColors voor meer informatie.
m_bStdColorDlg Een Booleaanse waarde die aangeeft of het standaarddialoogvenster systeemkleur of het dialoogvenster CMFCColorDialog moet worden weergegeven. Zie CMFCColorBar::EnableOtherButton voor meer informatie.
m_ColorAutomatic Een COLORREF waarmee de huidige automatische kleur wordt opgeslagen. Zie CMFCColorBar::EnableOtherButton voor meer informatie.
m_ColorNames Een CMap-object dat een set RGB-kleuren koppelt aan hun namen.
m_colors Een CArray van COLORREF-waarden die de kleuren bevatten die worden weergegeven in het besturingselement voor de kleurenbalk.
m_ColorSelected Een COLORREF-waarde die de kleur is die de gebruiker momenteel heeft geselecteerd in het besturingselement voor de kleurenbalk.
m_lstDocColors Een CList met COLORREF-waarden die de kleuren bevat die momenteel in een document worden gebruikt.
m_nCommandID Een niet-ondertekend geheel getal dat de opdracht-id van een kleurknop is.
m_nHorzMargin Een geheel getal dat de horizontale marge is tussen de kleurknoppen in een raster met kleuren.
m_nHorzOffset Een geheel getal dat de horizontale verschuiving is naar het midden van de kleurknop. Deze waarde is belangrijk als de knop tekst of een afbeelding naast een kleur weergeeft.
m_nNumColumns Een geheel getal dat het aantal kolommen in een kleurenbalk besturingselementraster met kleuren is.
m_nNumColumnsVert Een geheel getal dat het aantal kolommen in een verticaal georiënteerd raster met kleuren is.
m_nNumRowsHorz Een geheel getal dat het aantal kolommen in een horizontaal georiënteerd raster met kleuren is.
m_nRowHeight Een geheel getal dat de hoogte is van een rij met kleurknoppen in een raster met kleuren.
m_nVertMargin Een geheel getal dat de verticale marge is tussen de kleurknoppen in een raster met kleuren.
m_nVertOffset Een geheel getal dat de verticale verschuiving naar het midden van de kleurknop is. Deze waarde is belangrijk als de knop tekst of een afbeelding naast een kleur weergeeft.
m_Palette Een CPalette van de kleuren die worden gebruikt in het besturingselement voor de kleurenbalk.
m_pParentBtn Een aanwijzer naar een CMFCColorButton-object dat het bovenliggende element van de huidige knop is. Deze waarde is belangrijk als de kleurknop zich in een hiërarchie van werkbalkbesturingselementen bevindt of zich in een besturingselement voor kleureigenschappenraster bevindt.
m_pParentRibbonBtn Een aanwijzer naar een CMFCRibbonColorButton-object dat zich op het lint bevindt en de bovenliggende knop van de huidige knop is. Deze waarde is belangrijk als de kleurknop zich in een hiërarchie van werkbalkbesturingselementen bevindt of zich in een besturingselement voor kleureigenschappenraster bevindt.
m_pWndPropList Een aanwijzer naar een CMFCPropertyGridCtrl-object .
m_strAutoColor Een CString die de tekst is die wordt weergegeven op de knop Automatisch . Zie CMFCColorBar::EnableAutomaticButton voor meer informatie.
m_strDocColors Een CString die de tekst is die wordt weergegeven op de knop Documentkleuren. Zie CMFCColorBar::SetDocumentColors voor meer informatie.
m_strOtherColor Een CString die de tekst is die op de andere knop wordt weergegeven. Zie CMFCColorBar::EnableOtherButton voor meer informatie.

Opmerkingen

Meestal maakt CMFCColorBar u geen object rechtstreeks. In plaats daarvan maakt de CMFCColorMenuButton-klasse (gebruikt in menu's en werkbalken) of de klasse CMFCColorButton het CMFCColorBar object.

De CMFCColorBar klasse biedt de volgende functionaliteit:

  • Hiermee wordt de lijst met documentkleuren automatisch aangepast.

  • Slaat de status op en herstelt deze, samen met de documentstatus.

  • Hiermee beheert u de knop 'automatisch'.

  • Hiermee gebruikt u het besturingselement CMFCColorPickerCtrl Class om een aangepaste kleur te selecteren.

  • Ondersteunt de status 'scheuren' (als deze is gemaakt met behulp van de klasse CMFCColorMenuButton).

CMFCColorBar De functionaliteit opnemen in uw toepassing:

  1. Maak een gewone menuknop en wijs deze een id toe, bijvoorbeeld ID_CHAR_COLOR.

  2. In de klasse framevenster overschrijft u de methode CFrameWndEx::OnShowPopupMenu en vervangt u de normale menuknop door een CMFCColorMenuButton Class-object (door CMFCToolBar::ReplaceButton aan te roepen).

  3. Stel alle stijlen in en schakel de functies van het object in of uit tijdens het CMFCColorBar maken van de klasse CMFCColorMenuButton. Het CMFCColorMenuButton object maakt het CMFCColorBar object dynamisch nadat het framework de CreatePopupMenu methode aanroept.

Wanneer de gebruiker op een besturingselement voor een kleurenbalk klikt, gebruikt het framework de ON_COMMAND macro om het bovenliggende besturingselement van de kleurenbalk op de hoogte te stellen. In de macro is de parameter opdracht-id de waarde die u hebt toegewezen aan de knop kleurenbalk in stap 1 (ID_CHAR_COLOR in dit voorbeeld). Zie de klassen CMFCColorMenuButton, CMFCColorButton Class, CMFCColorPickerCtrl Class, CFrameWndEx Class en CMFCToolBar Class voor meer informatie.

Example

In het volgende voorbeeld ziet u hoe u een kleurenbalk configureert met behulp van verschillende methoden in de CMFCColorBar klasse. Met de methoden kunt u de horizontale en verticale marges instellen, de andere knop inschakelen, een besturingselementvenster voor een kleurenbalk maken en de geselecteerde kleur instellen. Dit voorbeeld maakt deel uit van het voorbeeld Nieuwe besturingselementen.

CMFCColorBar m_wndColorBar;

// set the margins
m_wndColorBar.SetHorzMargin(0);
m_wndColorBar.SetVertMargin(0);
// enable the display of a dialog box that
// lets the user select more colors
m_wndColorBar.EnableOtherButton(_T("Other..."));
// create a color bar control window
m_wndColorBar.CreateControl(this, rectColorBar, IDC_COLORBAR, 5 /* columns */);
// set the currently selected color
m_wndColorBar.SetColor(RGB(255, 0, 0));

Overnamehiërarchie

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

Menubalk CMFC-pop-upmenu

CMFCColorBar

Requirements

Koptekst: afxcolorbar.h

CMFCColorBar::AdjustLocations

Hiermee past u de posities van de kleurknoppen op het besturingselement van de kleurenbalk aan.

virtual void AdjustLocations();

Opmerkingen

Deze methode wordt aangeroepen door het framework tijdens WM_SIZE berichtverwerking.

CMFCColorBar::AllowChangeTextLabels

Hiermee wordt aangegeven of het tekstlabel met kleurknoppen kan worden gewijzigd.

virtual BOOL AllowChangeTextLabels() const;

Retourwaarde

Altijd ONWAAR.

Opmerkingen

Deze methode retourneert standaard altijd FALSE, wat betekent dat tekstlabels niet kunnen worden gewijzigd. Overschrijf deze methode om het wijzigen van tekstlabels in te schakelen.

CMFCColorBar::AllowShowOnList

Geeft aan of het besturingselementobject van de kleurenbalk tijdens het aanpassingsproces in een werkbalklijst kan worden weergegeven.

virtual BOOL AllowShowOnList() const;

Retourwaarde

Altijd WAAR.

Opmerkingen

Deze methode retourneert standaard altijd TRUE, wat betekent dat het framework het besturingselement voor de kleurenbalk kan weergeven tijdens het aanpassingsproces. Overschrijf deze methode om een ander gedrag te implementeren.

CMFCColorBar::CalcSize

Aangeroepen door het framework als onderdeel van het indelingsberekeningsproces.

virtual CSize CalcSize(BOOL bVertDock);

Parameterwaarden

bVertDock
[in] TRUE om op te geven dat het besturingselement van de kleurenbalk verticaal wordt vastgezet; FALSE om op te geven dat het besturingselement voor de kleurenbalk horizontaal wordt vastgezet.

Retourwaarde

De grootte van de matrix met kleurknoppen in een besturingselement voor een kleurenbalk.

CMFCColorBar::CMFCColorBar

Maakt een CMFCColorBar object.

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    int nRowsDockHorz,
    int nColDockVert,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCColorButton* pParentBtn);

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCRibbonColorButton* pParentRibbonBtn);

CMFCColorBar(
    CMFCColorBar& src,
    UINT uiCommandID);

Parameterwaarden

Kleuren
[in] Een matrix met kleuren die het framework weergeeft op het besturingselement voor de kleurenbalk.

kleur
[in] De oorspronkelijk geselecteerde kleur.

lpszAutoColor
[in] Het tekstlabel van de automatische (standaard) kleurknop of NULL.

Het standaardlabel voor de automatische knop is Automatisch.

lpszOtherColor
[in] Het tekstlabel van de andere knop, waarin meer kleurkeuzen of NULL worden weergegeven.

Het standaardlabel voor de andere knop is Meer kleuren....

lpszDocColors
[in] Het tekstlabel van de knop Documentkleuren. Het kleurenpalet van het document bevat alle kleuren die het document momenteel gebruikt.

lstDocColors
[in] Een lijst met kleuren die het document momenteel gebruikt.

nColumns
[in] Het aantal kolommen dat de matrix met kleuren heeft.

nRowsDockHorz
[in] Het aantal rijen dat de kleurenbalk heeft wanneer deze horizontaal wordt vastgezet.

nColDockVert
[in] Het aantal kolommen dat de kleurenbalk heeft wanneer deze verticaal wordt vastgezet.

colorAutomatic
[in] De standaardkleur die het framework toepast wanneer u op de automatische knop klikt.

nCommandID
[in] De opdracht-id van het besturingselement voor de kleurenbalk.

pParentBtn
[in] Een aanwijzer naar een bovenliggende knop.

Src
[in] Een bestaand CMFCColorBar object dat moet worden gekopieerd naar het nieuwe CMFCColorBar object.

uiCommandID
[in] De opdracht-id.

CMFCColorBar::ContextToSize

Berekent de verticale en horizontale marges die nodig zijn om de knoppen op het besturingselement van de kleurenbalk te bevatten en past de locatie van deze knoppen aan.

void ContextToSize(
    BOOL bSquareButtons = TRUE,
    BOOL bCenterButtons = TRUE);

Parameterwaarden

bSquareButtons
[in] WAAR om op te geven dat de vorm van de knoppen op een kleurenbalk besturingselement vierkant is; anders, ONWAAR. De standaardwaarde is WAAR.

bCenterButtons
[in] WAAR om op te geven dat de inhoud op het gezicht van een knop voor het besturingselement van een kleurenbalk is gecentreerd; anders, ONWAAR. De standaardwaarde is WAAR.

Opmerkingen

CMFCColorBar::Maken

Hiermee maakt u een besturingselementvenster voor een kleurenbalk en koppelt u het aan het CMFCColorBar object.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle,
    UINT nID,
    CPalette* pPalette=NULL,
    int nColumns=0,
    int nRowsDockHorz=0,
    int nColDockVert=0);

Parameterwaarden

pParentWnd
[in] Aanwijzer naar het bovenliggende venster.

dwStyle
[in] Een bitsgewijze combinatie (OR) van vensterstijlen.

nID
[in] De opdracht-id.

pPalette
[in] Wijs een palet met kleuren aan. De standaardwaarde is NULL.

nColumns
[in] Het aantal kolommen in het besturingselement voor de kleurenbalk. De standaardwaarde is 0.

nRowsDockHorz
[in] Het aantal rijen in het besturingselement voor de kleurenbalk wanneer het horizontaal wordt vastgezet. De standaardwaarde is 0.

nColDockVert
[in] Het aantal kolommen in het besturingselement voor de kleurenbalk wanneer deze verticaal wordt vastgezet. De standaardwaarde is 0.

Retourwaarde

WAAR als deze methode is geslaagd; anders, ONWAAR.

Opmerkingen

Als u een CMFCColorBar object wilt maken, roept u de klasseconstructor en vervolgens deze methode aan. De Create methode maakt het Windows-besturingselement en initialiseert een lijst met kleuren.

CMFCColorBar::CreateControl

Hiermee maakt u een besturingselementvenster voor een kleurenbalk, koppelt u het aan het CMFCColorBar object en wijzigt u het formaat van het besturingselementvenster zodat het opgegeven kleurenpalet wordt weergegeven.

virtual BOOL CreateControl(
    CWnd* pParentWnd,
    const CRect& rect,
    UINT nID,
    int nColumns=-1,
    CPalette* pPalette=NULL);

Parameterwaarden

pParentWnd
[in] Aanwijzer naar het bovenliggende venster. Kan niet NULL zijn.

Rect
[in] Een begrenzingsrechthoek die aangeeft waar het besturingselement voor de kleurenbalk moet worden getekend.

nID
[in] De besturingselement-id.

nColumns
[in] Het ideale aantal kolommen in het besturingselement voor de kleurenbalk. Met deze methode wordt dat getal aangepast aan het opgegeven kleurenpalet. De standaardwaarde is -1, wat betekent dat deze parameter niet is opgegeven.

pPalette
[in] Aanwijzer naar een palet met kleuren of NULL. Als deze parameter NULL is, berekent deze methode de grootte van het besturingselement voor de kleurenbalk alsof er 20 kleuren zijn opgegeven. De standaardwaarde is NULL.

Retourwaarde

WAAR als deze methode slaagt; anders ONWAAR.

Opmerkingen

Deze methode gebruikt de parameters rect, nColumns en pPalette om het juiste aantal of rijen en kolommen in het besturingselement voor de kleurenbalk te berekenen en roept vervolgens de methode CMFCColorBar::Create aan.

CMFCColorBar::CreatePalette

Initialiseert een palet met de kleuren in een opgegeven matrix met kleuren.

static BOOL CreatePalette(
    const CArray<COLORREF, COLORREF>& arColors,
    CPalette& palette);

Parameterwaarden

arColors
[in] Een matrix met kleuren.

Palet
[in] Een palet met kleuren.

Retourwaarde

WAAR als deze methode is geslaagd; anders, ONWAAR.

CMFCColorBar::EnableAutomaticButton

Hiermee wordt de automatische knop weergegeven of verborgen.

void EnableAutomaticButton(
    LPCTSTR lpszLabel,
    COLORREF colorAutomatic,
    BOOL bEnable=TRUE);

Parameterwaarden

lpszLabel
[in] Het tekstlabel van de automatische (standaard) kleurknop of NULL.

Het standaardlabel voor de automatische knop is Automatisch.

colorAutomatic
[in] De standaardkleur die het framework toepast wanneer u op de automatische knop klikt.

bEnable
[in] TRUE om de automatische knop in te schakelen; FALSE om de automatische knop uit te schakelen. De standaardwaarde is WAAR.

Opmerkingen

Het tekstlabel van de automatische knop wordt verwijderd als de parameter lpszLabel NULL is of de parameter bEnable FALSE is.

CMFCColorBar::EnableOtherButton

Hiermee schakelt u de weergave van een dialoogvenster in of uit waarmee de gebruiker meer kleuren kan selecteren.

void EnableOtherButton(
    LPCTSTR lpszLabel,
    BOOL bAltColorDlg=TRUE,
    BOOL bEnable=TRUE);

Parameterwaarden

lpszLabel
[in] Het tekstlabel van de andere knop, waarin meer kleurkeuzen of NULL worden weergegeven.

Het standaardlabel voor deze knop is Meer kleuren....

bAltColorDlg
[in] TRUE om het dialoogvenster CMFCColorDialog weer te geven; FALSE om het standaarddialog-dialoogvenster CColorDialog weer te geven. De standaardwaarde is WAAR.

bEnable
[in] WAAR om de knop in te schakelen; FALSE om de knop uit te schakelen. De standaardwaarde is WAAR.

CMFCColorBar::GetColor

Hiermee haalt u de geselecteerde kleur op.

COLORREF GetColor() const;

Retourwaarde

De geselecteerde kleur.

CMFCColorBar::GetColorGridSize

Berekent het aantal rijen en kolommen in het raster van een besturingselement voor een kleurenbalk.

CSize GetColorGridSize(BOOL bVertDock) const;

Parameterwaarden

bVertDock
[in] TRUE om de berekening uit te voeren voor een verticaal gedokt kleurenbalk besturingselement; voer anders de berekening uit voor een horizontaal gedokt besturingselement.

Retourwaarde

Een CSize-object waarvan cx het onderdeel het aantal kolommen bevat en waarvan cy het onderdeel het aantal rijen bevat.

CMFCColorBar::GetCommandID

Hiermee haalt u de opdracht-id van het huidige besturingselement voor de kleurenbalk op.

UINT GetCommandID() const;

Retourwaarde

Een opdracht-id.

Opmerkingen

Wanneer de gebruiker een nieuwe kleur selecteert, verzendt het framework de opdracht-id in een WM_COMMAND bericht om het bovenliggende object op de CMFCColorBar hoogte te stellen.

CMFCColorBar::GetExtraHeight

Berekent de extra hoogte die de huidige kleurenbalk nodig heeft om diverse elementen van de gebruikersinterface weer te geven, zoals de knop Overige of documentkleuren.

int GetExtraHeight(int nNumColumns) const;

Parameterwaarden

nNumColumns
[in] Als het besturingselement voor de kleurenbalk documentkleuren bevat, wordt het aantal kolommen dat moet worden weergegeven in het raster met documentkleuren. Anders wordt deze waarde niet gebruikt.

Retourwaarde

De berekende extra hoogte die vereist is.

CMFCColorBar::GetHighlightedColor

Haalt de kleur op die aantekent dat een kleurknop de focus heeft; Dat wil gezegd, de knop is heet.

COLORREF GetHighlightedColor() const;

Retourwaarde

Een RGB-waarde.

Opmerkingen

CMFCColorBar::GetHorzMargin

Hiermee haalt u de horizontale marge op, de ruimte tussen de linker- of rechterkleurcel en de grens van het clientgebied.

int GetHorzMargin();

Retourwaarde

De horizontale marge.

CMFCColorBar::GetVertMargin

Hiermee haalt u de verticale marge op, de ruimte tussen de bovenste of onderste kleurcel en de grens van het clientgebied.

int GetVertMargin() const;

Retourwaarde

De verticale marge.

CMFCColorBar::InitColors

Initialiseert een matrix met kleuren met de kleuren in een opgegeven palet of met het standaardpalet van het systeem.

static int InitColors(
    CPalette* pPalette,
    CArray<COLORREF, COLORREF>& arColors);

Parameterwaarden

pPalette
[in] Een aanwijzer naar een paletobject of NULL. Als deze parameter NULL is, gebruikt deze methode het standaardpalet van het besturingssysteem.

arColors
[in] Een matrix met kleuren.

Retourwaarde

Het aantal elementen in de matrix met kleuren.

CMFCColorBar::IsTearOff

Geeft aan of de huidige kleurenbalk kan worden gekoppeld.

BOOL IsTearOff() const;

Retourwaarde

WAAR als het huidige besturingselement van de kleurenbalk kan worden vastzet; anders, ONWAAR.

Opmerkingen

Als het besturingselement van de kleurenbalk kan worden vastgezet, kan het worden gescheurd van een besturingsbalk en op een andere locatie worden gedokt.

CMFCColorBar::OnKey

Aangeroepen door het framework wanneer een gebruiker op een toetsenbordknop drukt.

virtual BOOL OnKey(UINT nChar);

Parameterwaarden

Nchar
[in] De code van de virtuele sleutel voor de sleutel waarop een gebruiker heeft gedrukt.

Retourwaarde

WAAR als deze methode de opgegeven sleutel verwerkt; anders, ONWAAR.

CMFCColorBar::OnSendCommand

Aangeroepen door het framework om een hiërarchie van pop-upbesturingselementen te sluiten.

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Parameterwaarden

pButton
[in] Aanwijzer naar een besturingselement dat zich op een werkbalk bevindt.

Retourwaarde

WAAR als deze methode is geslaagd; anders, ONWAAR.

CMFCColorBar::OnUpdateCmdUI

Aangeroepen door het framework om een gebruikersinterface-item van een kleurenbalkbesturingselement in of uit te schakelen voordat het item wordt weergegeven.

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

Parameterwaarden

pTarget
[in] Wijs een venster aan dat een gebruikersinterface-item bevat dat moet worden bijgewerkt.

bDisableIfNoHndler
[in] TRUE om het gebruikersinterface-item uit te schakelen als er geen handler is gedefinieerd in een berichtoverzicht; anders, ONWAAR.

Opmerkingen

Wanneer een gebruiker van uw toepassing op een gebruikersinterface-item klikt, moet het item weten of het moet worden weergegeven als ingeschakeld of uitgeschakeld. Het doel van het opdrachtbericht biedt deze informatie door een ON_UPDATE_COMMAND_UI opdrachthandler te implementeren. Gebruik deze methode om de opdracht te verwerken. Zie CCmdUI-klasse voor meer informatie.

CMFCColorBar::OpenColorDialog

Hiermee opent u een kleurendialoogvenster.

virtual BOOL OpenColorDialog(
    const COLORREF colorDefault,
    COLORREF& colorRes);

Parameterwaarden

colorDefault
[in] De kleur die standaard is geselecteerd wanneer het kleurendialoogvenster wordt geopend.

colorRes
[uit] De kleur die een gebruiker heeft geselecteerd.

Retourwaarde

WAAR als de gebruiker een kleur heeft geselecteerd; ONWAAR als de gebruiker het kleurendialoogvenster heeft geannuleerd.

Opmerkingen

CMFCColorBar::Rebuild

Hiermee wordt het besturingselement voor de kleurenbalk volledig opnieuw getekend.

virtual void Rebuild();

CMFCColorBar::SelectPalette

Hiermee stelt u het logische palet van de opgegeven apparaatcontext in op het palet van de bovenliggende knop van het huidige besturingselement voor de kleurenbalk.

CPalette* SelectPalette(CDC* pDC);

Parameterwaarden

Pdc
[in] Aanwijzer naar de apparaatcontext van de bovenliggende knop van het huidige besturingselement voor de kleurenbalk.

Retourwaarde

Wijs het palet aan dat wordt vervangen door het palet van de bovenliggende knop van het huidige besturingselement voor de kleurenbalk.

CMFCColorBar::SetColor

Hiermee stelt u de kleur in die momenteel is geselecteerd.

void SetColor(COLORREF color);

Parameterwaarden

kleur
[in] Een RGB-kleurwaarde.

CMFCColorBar::SetColorName

Hiermee stelt u een nieuwe naam in voor een opgegeven kleur.

static void 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

Met deze methode wordt de naam van de opgegeven kleur in alle CMFCColorBar objecten in uw toepassing gewijzigd.

CMFCColorBar::SetCommandID

Hiermee stelt u een nieuwe opdracht-id in voor een besturingselement voor een kleurenbalk.

void SetCommandID(UINT nCommandID);

Parameterwaarden

nCommandID
[in] Een opdracht-id.

Opmerkingen

Roep deze methode aan om de opdracht-id van een besturingselement op de kleurenbalk te wijzigen en om het bovenliggende venster van het besturingselement te waarschuwen dat de id is gewijzigd.

CMFCColorBar::SetDocumentColors

Hiermee stelt u de lijst met kleuren in die worden gebruikt in het huidige document.

void SetDocumentColors(
    LPCTSTR lpszCaption,
    CList<COLORREF,COLORREF>& lstDocColors,
    BOOL bShowWhenDocked=FALSE);

Parameterwaarden

lpszCaption
[in] Een bijschrift dat wordt weergegeven wanneer het besturingselement voor de kleurenbalk niet is vastgezet.

lstDocColors
[in] Een lijst met kleuren die de huidige documentkleuren vervangen.

bShowWhenDocked
[in] TRUE om documentkleuren weer te geven wanneer het besturingselement voor de kleurenbalk is vastgezet; anders, ONWAAR. De standaardwaarde is FALSE.

Opmerkingen

Documentkleuren zijn de kleuren die momenteel in een document worden gebruikt. In het framework wordt automatisch een lijst met documentkleuren bijgehouden, maar u kunt deze methode gebruiken om de lijst te wijzigen.

CMFCColorBar::SetHorzMargin

Hiermee stelt u de horizontale marge in. Dit is de ruimte tussen de linker- of rechterkleurcel en de grens van het clientgebied.

void SetHorzMargin(int nHorzMargin);

Parameterwaarden

nHorzMargin
[in] De horizontale marge, in pixels.

Opmerkingen

Standaard stelt de CMFCColorBar::CMFCColorBar-constructor de horizontale marge in op 4 pixels.

CMFCColorBar::SetPropList

Hiermee stelt u het m_pWndPropList beveiligde gegevenslid in op de opgegeven aanwijzer op een eigenschapsrasterbesturingselement.

void SetPropList(CMFCPropertyGridCtrl* pWndList);

Parameterwaarden

pWndList
[in] Aanwijzer naar eigenschapsrasterbesturingselementobject.

CMFCColorBar::SetVertMargin

Hiermee stelt u de verticale marge in. Dit is de ruimte tussen de bovenste of onderste kleurcel en de grens van het clientgebied.

void SetVertMargin(int nVertMargin);

Parameterwaarden

nVertMargin
[in] De verticale marge, in pixels.

Opmerkingen

Standaard stelt de CMFCColorBar::CMFCColorBar-constructor de verticale marge in op 4 pixels.

CMFCColorBar::ShowCommandMessageString

Vraagt het framevenster aan dat eigenaar is van het besturingselement voor de kleurenbalk om de berichtregel in de statusbalk bij te werken.

virtual void ShowCommandMessageString(UINT uiCmdId);

Parameterwaarden

uiCmdId
[in] Een opdracht-id. (Deze parameter wordt genegeerd.)

Opmerkingen

Met deze methode wordt het WM_SETMESSAGESTRING bericht verzonden naar de eigenaar van het besturingselement voor de kleurenbalk.

Zie ook

Hiërarchiegrafiek
Klassen

  • Last updated on