Share via


Klasse CMFCColorDialog

Opmerking

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

De CMFCColorDialog klasse vertegenwoordigt een dialoogvenster voor kleurselectie.

Syntaxis

class CMFCColorDialog : public CDialogEx

Leden

Openbare constructors

Naam Description
CMFCColorDialog::CMFCColorDialog Maakt een CMFCColorDialog object.
CMFCColorDialog::~CMFCColorDialog Destructor.

Openbare methoden

Naam Description
CMFCColorDialog::GetColor Retourneert de huidige geselecteerde kleur.
CMFCColorDialog::GetPalette Retourneert het palet van de kleur.
CMFCColorDialog::PreTranslateMessage Hiermee worden vensterberichten vertaald voordat ze worden verzonden naar de windows-functies TranslateMessage en DispatchMessage . Zie CWnd::P reTranslateMessage voor syntaxis en meer informatie. (Onderdrukkingen CDialogEx::PreTranslateMessage.)
CMFCColorDialog::RebuildPalette Hiermee wordt een palet afgeleid van het systeempalet.
CMFCColorDialog::SetCurrentColor Hiermee stelt u de huidige geselecteerde kleur in.
CMFCColorDialog::SetNewColor Hiermee stelt u de kleur die het meest overeenkomt met een opgegeven RGB-waarde.
CMFCColorDialog::SetPageOne Hiermee selecteert u een RGB-waarde voor de eerste eigenschappenpagina.
CMFCColorDialog::SetPageTwo Hiermee selecteert u een RGB-waarde voor de tweede eigenschappenpagina.

Beveiligde gegevensleden

Naam Description
m_bIsMyPalette TRUE als in het dialoogvenster kleurselectie een eigen kleurenpalet of ONWAAR wordt gebruikt als in het dialoogvenster een palet wordt gebruikt dat is opgegeven in de CMFCColorDialog constructor.
m_bPickerMode WAAR terwijl de gebruiker een kleur selecteert in het selectiedialoogvenster; anders, ONWAAR.
m_btnColorSelect De kleurknop die de gebruiker heeft geselecteerd.
m_CurrentColor De geselecteerde kleur.
m_hcurPicker De cursor die wordt gebruikt om een kleur te kiezen.
m_NewColor De potentiële geselecteerde kleur, die permanent kan worden geselecteerd of teruggezet naar de oorspronkelijke kleur.
m_pColourSheetOne Een aanwijzer naar de eerste eigenschappenpagina van het eigenschappenvenster voor kleurselectie.
m_pColourSheetTwo Een aanwijzer naar de tweede eigenschappenpagina van het eigenschappenvenster voor kleurselectie.
m_pPalette Het huidige logische palet.
m_pPropSheet Een aanwijzer naar het eigenschappenvenster voor het dialoogvenster kleurselectie.
m_wndColors Een besturingselementobject voor kleurenkiezer.
m_wndStaticPlaceHolder Een statisch besturingselement dat een tijdelijke aanduiding is voor het eigenschappenvenster van de kleurkiezer.

Opmerkingen

Het dialoogvenster kleurselectie wordt weergegeven als een eigenschappenvenster met twee pagina's. Op de eerste pagina selecteert u een standaardkleur in het systeempalet; op de tweede pagina selecteert u een aangepaste kleur.

U kunt een CMFCColorDialog object op de stack maken en vervolgens DoModalde initiële kleur doorgeven als een parameter aan de CMFCColorDialog constructor. In het dialoogvenster kleurselectie worden vervolgens verschillende CMFCColorPickerCtrl-klasseobjecten gemaakt om elk kleurenpalet te verwerken.

Overnamehiërarchie

CObject

CCmdTarget-

CWnd

CDialog

CDialogEx

CMFCColorDialog

Example

In het volgende voorbeeld ziet u hoe u een kleurendialoogvenster configureert met behulp van verschillende methoden in de CMFCColorDialog klasse. In het voorbeeld ziet u hoe u de huidige en de nieuwe kleuren van het dialoogvenster instelt en hoe u de rode, groene en blauwe onderdelen van een geselecteerde kleur instelt op de twee eigenschappenpagina's van het kleurendialoogvenster. Dit voorbeeld maakt deel uit van het voorbeeld Nieuwe besturingselementen.

// COLORREF m_Color
CMFCColorDialog dlg(m_Color, 0, this);
dlg.SetCurrentColor(RGB(0, 255, 0));
dlg.SetNewColor(RGB(0, 0, 255));
// set the red, green, and blue components of a selected
// color on the two property pages of the color dialog
dlg.SetPageOne(255, 0, 0);
dlg.SetPageTwo(0, 255, 0);

Requirements

Koptekst: afxcolordialog.h

CMFCColorDialog::CMFCColorDialog

Maakt een CMFCColorDialog object.

CMFCColorDialog(
    COLORREF clrInit=0,
    DWORD dwFlags=0,
    CWnd* pParentWnd=NULL,
    HPALETTE hPal=NULL);

Parameterwaarden

clrInit
[in] De standaardkleurselectie. Als er geen waarde is opgegeven, is de standaardwaarde RGB(0,0,0) (zwart).

dwFlags
[in] Gereserveerd.

pParentWnd
[in] Een aanwijzer naar het bovenliggende of eigenaarsvenster van het dialoogvenster.

Hpal
[in] Een handgreep naar een kleurenpalet.

Retourwaarde

Opmerkingen

CMFCColorDialog::GetColor

Hiermee haalt u de kleur op die de gebruiker selecteert in het kleurendialoogvenster.

COLORREF GetColor() const;

Retourwaarde

Een COLORREF-waarde die de RGB-informatie bevat voor de kleur die is geselecteerd in het kleurendialoogvenster.

Opmerkingen

Roep deze functie aan nadat u de DoModal methode hebt aangeroepen.

CMFCColorDialog::GetPalette

Hiermee haalt u het kleurenpalet op dat beschikbaar is in het huidige kleurendialoogvenster.

CPalette* GetPalette() const;

Retourwaarde

Een aanwijzer naar het CPalette object dat is opgegeven in de CMFCColorDialog constructor.

Opmerkingen

Het kleurenpalet geeft de kleuren op die de gebruiker kan kiezen.

CMFCColorDialog::RebuildPalette

Hiermee wordt een palet afgeleid van het systeempalet.

void RebuildPalette();

CMFCColorDialog::SetCurrentColor

Hiermee stelt u de huidige kleur van het dialoogvenster in.

void SetCurrentColor(COLORREF rgb);

Parameterwaarden

Rgb
[in] Een RGB-kleurwaarde

Opmerkingen

CMFCColorDialog::SetNewColor

Hiermee stelt u de huidige kleur in op de kleur in het huidige palet dat het meest vergelijkbaar is.

void SetNewColor(COLORREF rgb);

Parameterwaarden

Rgb
[in] Een COLORREF waarmee een RGB-kleur wordt opgegeven.

Opmerkingen

CMFCColorDialog::SetPageOne

Hiermee geeft u expliciet de rode, groene en blauwe onderdelen van een geselecteerde kleur op de eerste eigenschappenpagina van een kleurendialoogvenster op.

void SetPageOne(
    BYTE R,
    BYTE G,
    BYTE B);

Parameterwaarden

R
[in] Hiermee geeft u het rode onderdeel van de RGB-waarde.

G
[in] Hiermee geeft u het groene onderdeel van de RGB-waarde.

B
[in] Hiermee geeft u het blauwe onderdeel van de RGB-waarde.

Opmerkingen

CMFCColorDialog::SetPageTwo

Hiermee geeft u expliciet de rode, groene en blauwe onderdelen van een geselecteerde kleur op de tweede eigenschappenpagina van een kleurendialoogvenster op.

void SetPageTwo(
    BYTE R,
    BYTE G,
    BYTE B);

Parameterwaarden

R
[in] Hiermee geeft u een rood onderdeel van de RGB-waarde

G
[in] Hiermee geeft u een groen onderdeel van een RGB-waarde

B
[in] Hiermee geeft u een blauw onderdeel van een RGB-waarde

Opmerkingen

Zie ook

Hiërarchiegrafiek
Klassen
Klasse CMFCColorPickerCtrl