CMFCColorPickerCtrl osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Az CMFCColorPickerCtrl osztály funkciókkal rendelkezik a színek kiválasztásához használt vezérlőkhöz.

Szemantika

class CMFCColorPickerCtrl : public CButton

Tagok

Nyilvános konstruktorok

Név	Description
CMFCColorPickerCtrl::CMFCColorPickerCtrl	Egy CMFCColorPickerCtrl objektumot hoz létre.

Nyilvános metódusok

Név	Description
CMFCColorPickerCtrl::GetColor	Lekéri a felhasználó által kiválasztott színt.
CMFCColorPickerCtrl::GetHLS	Lekéri a felhasználó által kiválasztott szín színének színét, fényerejét és telítettségi értékeit.
CMFCColorPickerCtrl::GetHue	Lekéri a felhasználó által kiválasztott szín színösszetevőjét.
CMFCColorPickerCtrl::GetLuminance	Lekéri a felhasználó által kiválasztott szín fényerejének összetevőjét.
CMFCColorPickerCtrl::GetSaturation	Lekéri a felhasználó által kiválasztott szín telítettségi összetevőjét.
CMFCColorPickerCtrl::SelectCellHexagon	Az aktuális színt a megadott RGB-színösszetevők vagy a megadott cella hatszöge által meghatározott színre állítja.
CMFCColorPickerCtrl::SetColor	Az aktuális színt a megadott RGB színértékre állítja.
CMFCColorPickerCtrl::SetHLS	Az aktuális színt a megadott HLS-színértékre állítja.
CMFCColorPickerCtrl::SetHue	Módosítja az aktuálisan kiválasztott szín színösszetevőjét.
CMFCColorPickerCtrl::SetLuminance	Módosítja az aktuálisan kijelölt szín fényerejének összetevőjét.
CMFCColorPickerCtrl::SetLuminanceBarWidth	Beállítja a fényerősáv szélességét a színválasztó vezérlőelemben.
CMFCColorPickerCtrl::SetOriginalColor	Beállítja a kezdeti kijelölt színt.
CMFCColorPickerCtrl::SetPalette	Beállítja az aktuális színpalettát.
CMFCColorPickerCtrl::SetSaturation	Módosítja az aktuálisan kijelölt szín telítettségi összetevőjét.
CMFCColorPickerCtrl::SetType	Beállítja a színválasztó vezérlő megjelenítésének típusát.

Védett metódusok

Név	Description
CMFCColorPickerCtrl::DrawCursor	A keretrendszer meghívta, mielőtt megjelenik egy kurzor, amely a kijelölt színre mutat.

Megjegyzések

A normál színeket a hatszögletű színpalettából választja ki, az egyéni színeket pedig egy olyan fényerősávból választja ki, ahol a színek piros/zöld/kék jelöléssel vagy színárnyalat/telítettség/fényerő jelöléssel vannak megadva.

Az alábbi ábra több CMFCColorPickerCtrl objektumot ábrázol.

A CMFCColorPickerCtrl két stíluspárt támogatja. A HEX stílusok megfelelnek HEX_GREYSCALE a normál színválasztásnak. A PICKER stílusok az LUMINANCE egyéni színkijelöléshez megfelelőek.

A vezérlő párbeszédpanelbe való beépítéséhez hajtsa végre az CMFCColorPickerCtrl alábbi lépéseket:

1. Ha a ClassWizardot használja, szúrjon be egy új gombvezérlőt a párbeszédpanelsablonba (mivel az CMFCColorPickerCtrl osztály öröklődik az CButton osztálytól).

2. Szúrjon be egy tagváltozót, amely az új gombvezérlőhöz van társítva a párbeszédpanel-osztályba. Ezután módosítsa a változó típusát CButton a következőre CMFCColorPickerCtrl: .

3. WM_INITDIALOG A párbeszédpanel-osztály üzenetkezelőjének beszúrása. A kezelőben állítsa be a vezérlőelem típusát, palettáját és kezdeti színét CMFCColorPickerCtrl .

Öröklési hierarchia

CObject
CCmdTarget
CWnd
CButton
CMFCColorPickerCtrl

Requirements

Fejléc:afxcolorpickerctrl.h

CMFCColorPickerCtrl::CMFCColorPickerCtrl

Egy CMFCColorPickerCtrl objektumot hoz létre.

CMFCColorPickerCtrl();

Visszaadott érték

Megjegyzések

CMFCColorPickerCtrl::DrawCursor

A keretrendszer meghívta, mielőtt megjelenik egy kurzor, amely a kijelölt színre mutat.

virtual void DrawCursor(
    CDC* pDC,
    const CRect& rect);

Paraméterek

pDC
[in] Mutasson egy eszközkörnyezetre.

rect
[in] A kijelölt szín körüli téglalap alakú területet adja meg.

Megjegyzések

Bírálja felül ezt a módszert, ha módosítania kell a kurzornak a kijelölt színre mutató alakját.

CMFCColorPickerCtrl::GetColor

Lekéri a felhasználó által kiválasztott színt.

COLORREF GetColor() const;

Visszaadott érték

A kijelölt szín RGB-értéke.

Megjegyzések

CMFCColorPickerCtrl::GetHLS

Lekéri a felhasználó által kiválasztott szín színének színét, fényerejét és telítettségi értékeit.

void GetHLS(
    double* hue,
    double* luminance,
    double* saturation);

Paraméterek

hue
[kifelé] Mutasson egy dupla típusú változóra, amely árnyalatinformációkat fogad.

luminance
[kifelé] Mutasson egy dupla típusú változóra, amely fényinformációkat kap.

saturation
[kifelé] Mutasson egy dupla típusú változóra, amely telítettségi információkat kap.

Megjegyzések

CMFCColorPickerCtrl::GetHue

Lekéri a felhasználó által kiválasztott szín színösszetevőjét.

double GetHue() const;

Visszaadott érték

A kiválasztott szín színösszetevője.

Megjegyzések

CMFCColorPickerCtrl::GetLuminance

Lekéri a felhasználó által kiválasztott szín fényerejének összetevőjét.

double GetLuminance() const;

Visszaadott érték

A kiválasztott szín fényerejének összetevője.

Megjegyzések

CMFCColorPickerCtrl::GetSaturation

A felhasználó által kiválasztott szín telítettségi értékét kéri le.

double GetSaturation() const;

Visszaadott érték

A kijelölt szín telítettségi összetevője.

Megjegyzések

CMFCColorPickerCtrl::SelectCellHexagon

Az aktuális színt a megadott RGB-színösszetevők vagy a megadott cella hatszöge által meghatározott színre állítja.

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

BOOL SelectCellHexagon(
    int x,
    int y);

Paraméterek

R
[in] A piros színösszetevő.

G
[in] A zöld színösszetevő.

B
[in] A kék színösszetevő.

x
[in] A kurzor x koordinátája, amely egy cella hatszögére mutat.

y
[in] A kurzor y koordinátája, amely egy cella hatszögére mutat.

Visszaadott érték

A metódus második túlterhelése mindig HAMIS értéket ad vissza.

Megjegyzések

A metódus első túlterhelése az aktuális színt a színkijelölés vezérlőelem megadott piros, zöld és kék színösszetevőinek megfelelő színre állítja.

A metódus második túlterhelése az aktuális színt a cella hatszögének színére állítja, amelyet a kurzor megadott helye mutat.

CMFCColorPickerCtrl::SetColor

Az aktuális színt a megadott RGB színértékre állítja.

void SetColor(COLORREF Color);

Paraméterek

Color
[in] RGB-színérték.

Megjegyzések

CMFCColorPickerCtrl::SetHLS

Az aktuális színt a megadott HLS-színértékre állítja.

void SetHLS(
    double hue,
    double luminance,
    double saturation,
    BOOL bInvalidate=TRUE);

Paraméterek

hue
[in] Egy árnyalat értéke.

luminance
[in] Fényességérték.

saturation
[in] Telítettségi érték.

bInvalidate
[in] TRUE az ablak azonnali frissítésének kényszerítése az új színre; egyéb esetben. FALSE Az alapértelmezett érték a TRUE.

Megjegyzések

CMFCColorPickerCtrl::SetHue

Módosítja az aktuálisan kijelölt szín árnyalatát.

void SetHue(double Hue);

Paraméterek

Hue
[in] Egy árnyalat értéke.

Megjegyzések

CMFCColorPickerCtrl::SetLuminance

Módosítja az aktuálisan kijelölt szín fényerejét.

void SetLuminance(double Luminance);

Paraméterek

Luminance
[in] Fényességérték.

Megjegyzések

CMFCColorPickerCtrl::SetLuminanceBarWidth

Beállítja a fényerősáv szélességét a színválasztó vezérlőelemben.

void SetLuminanceBarWidth(int w);

Paraméterek

w
[in] A fényerősáv képpontban mért szélessége.

Megjegyzések

Ezzel a módszerrel átméretezheti a fényerősávot, amely a színválasztó vezérlőelem Egyéni lapján található. A w paraméter a fényerősáv új szélességét adja meg. A szélességi érték figyelmen kívül lesz hagyva, ha meghaladja az ügyfélterület szélességének háromnegyedét.

CMFCColorPickerCtrl::SetOriginalColor

Beállítja a kezdeti kijelölt színt.

void SetOriginalColor(COLORREF ref);

Paraméterek

ref
[in] RGB-színérték.

Megjegyzések

A színválasztó vezérlőelem inicializálásakor hívja meg ezt a metódust.

CMFCColorPickerCtrl::SetPalette

Beállítja az aktuális színpalettát.

void SetPalette(CPalette* pPalette);

Paraméterek

pPalette
[in] Mutató egy színpalettára.

Megjegyzések

A színpaletta a színválasztó vezérlőelemben megjelenő színek tömbjét határozza meg.

CMFCColorPickerCtrl::SetSaturation

Módosítja az aktuálisan kijelölt szín telítettségét.

void SetSaturation(double Saturation);

Paraméterek

Saturation
[in] Telítettségi érték.

Megjegyzések

CMFCColorPickerCtrl::SetType

Beállítja a színválasztó vezérlő megjelenítésének típusát.

void SetType(COLORTYPE colorType);

Paraméterek

colorType
[in] Színválasztó vezérlőtípus.

A típusokat az CMFCColorPickerCtrl::COLORTYPE enumerálás határozza meg. A lehetséges típusok a következőkLUMINANCE: és HEX_GREYSCALEPICKERHEX . Az alapértelmezett típus a következő PICKER: .

Megjegyzések

A színválasztó vezérlőelem típusának megadásához hívja meg ezt a metódust a Windows-vezérlő létrehozása előtt.

Lásd még

hierarchiadiagram
osztályok
CMFCColorDialog osztály