Udostępnij za pośrednictwem

Klasa CMFCColorPickerCtrl

  • Artykuł

Klasa CMFCColorPickerCtrl udostępnia funkcje kontrolki używanej do wybierania kolorów.

Składnia

class CMFCColorPickerCtrl : public CButton

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CMFCColorPickerCtrl::CMFCColorPickerCtrl CMFCColorPickerCtrl Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko opis
CMFCColorPickerCtrl::GetColor Pobiera kolor wybrany przez użytkownika.
CMFCColorPickerCtrl::GetHLS Pobiera wartości odcienia, luminacji i nasycenia koloru wybranego przez użytkownika.
CMFCColorPickerCtrl::GetHue Pobiera składnik odcieni koloru wybranego przez użytkownika.
CMFCColorPickerCtrl::GetLuminance Pobiera składnik luminance koloru wybranego przez użytkownika.
CMFCColorPickerCtrl::GetSaturation Pobiera składnik nasycenia koloru wybranego przez użytkownika.
CMFCColorPickerCtrl::SelectCellHexagon Ustawia bieżący kolor na kolor zdefiniowany przez określone składniki koloru RGB lub określony sześciokąt komórki.
CMFCColorPickerCtrl::SetColor Ustawia bieżący kolor na określoną wartość koloru RGB.
CMFCColorPickerCtrl::SetHLS Ustawia bieżący kolor na określoną wartość koloru HLS.
CMFCColorPickerCtrl::SetHue Zmienia składnik odcieni aktualnie wybranego koloru.
CMFCColorPickerCtrl::SetLuminance Zmienia składnik luminance aktualnie wybranego koloru.
CMFCColorPickerCtrl::SetLuminanceBarWidth Ustawia szerokość paska luminance w kontrolce selektora kolorów.
CMFCColorPickerCtrl::SetOriginalColor Ustawia początkowy wybrany kolor.
CMFCColorPickerCtrl::SetPalette Ustawia bieżącą paletę kolorów.
CMFCColorPickerCtrl::SetSaturation Zmienia składnik nasycenia aktualnie wybranego koloru.
CMFCColorPickerCtrl::SetType Ustawia typ kontrolki selektora kolorów do wyświetlenia.

Metody chronione

Nazwa/nazwisko opis
CMFCColorPickerCtrl::DrawCursor Wywoływana przez strukturę przed wyświetleniem kursora wskazującego wybrany kolor.

Uwagi

Kolory standardowe są wybierane z sześciokątnej palety kolorów, a kolory niestandardowe są wybierane z paska luminance, w którym kolory są określane przy użyciu notacji czerwonej/zielonej/niebieskiej lub odcienia/nasycenia/luminacji.

Poniższa ilustracja przedstawia kilka CMFCColorPickerCtrl obiektów.

CmFCColorPickerCtrl, okno dialogowe.

Element CMFCColorPickerCtrl obsługuje dwie pary stylów. Style HEX i HEX_GREYSCALE są odpowiednie dla standardowego zaznaczenia kolorów. Style PICKER i LUMINANCE są odpowiednie dla niestandardowego zaznaczenia kolorów.

Wykonaj następujące kroki, aby włączyć kontrolkę CMFCColorPickerCtrl do okna dialogowego:

  1. Jeśli używasz klasy ClassWizard, wstaw nową kontrolkę przycisku do szablonu okna dialogowego CButton (ponieważ CMFCColorPickerCtrl klasa jest dziedziczona z klasy).

  2. Wstaw zmienną składową skojarzona z nową kontrolką przycisku do klasy okna dialogowego. Następnie zmień typ zmiennej z CButton na CMFCColorPickerCtrl.

  3. Wstaw procedurę obsługi komunikatów WM_INITDIALOG dla klasy okna dialogowego. W procedurze obsługi ustaw typ, paletę i początkowy wybrany kolor kontrolki CMFCColorPickerCtrl .

Hierarchia dziedziczenia

CObject
CCmdTarget
CWnd
CButton
CMFCColorPickerCtrl

Wymagania

Nagłówek: afxcolorpickerctrl.h

CMFCColorPickerCtrl::CMFCColorPickerCtrl

CMFCColorPickerCtrl Tworzy obiekt.

CMFCColorPickerCtrl();

Wartość zwracana

Uwagi

CMFCColorPickerCtrl::DrawCursor

Wywoływana przez strukturę przed wyświetleniem kursora wskazującego wybrany kolor.

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

Parametry

pDC
[in] Wskaźnik do kontekstu urządzenia.

rect
[in] Określa prostokątny obszar wokół wybranego koloru.

Uwagi

Zastąpij tę metodę, gdy musisz zmienić kształt kursora wskazującego wybrany kolor.

CMFCColorPickerCtrl::GetColor

Pobiera kolor wybrany przez użytkownika.

COLORREF GetColor() const;

Wartość zwracana

Wartość RGB wybranego koloru.

Uwagi

CMFCColorPickerCtrl::GetHLS

Pobiera wartości odcienia, luminacji i nasycenia koloru wybranego przez użytkownika.

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

Parametry

hue
[out] Wskaźnik do zmiennej typu podwójnej, która odbiera informacje o odcieniu.

luminance
[out] Wskaźnik do zmiennej typu podwójnej, która odbiera informacje o luminacji.

saturation
[out] Wskaźnik do zmiennej typu podwójnej, która odbiera informacje o nasyceniu.

Uwagi

CMFCColorPickerCtrl::GetHue

Pobiera składnik odcieni koloru wybranego przez użytkownika.

double GetHue() const;

Wartość zwracana

Składnik odcieni wybranego koloru.

Uwagi

CMFCColorPickerCtrl::GetLuminance

Pobiera składnik luminance koloru wybranego przez użytkownika.

double GetLuminance() const;

Wartość zwracana

Składnik luminacji wybranego koloru.

Uwagi

CMFCColorPickerCtrl::GetSaturation

Pobiera wartość nasycenia koloru wybranego przez użytkownika.

double GetSaturation() const;

Wartość zwracana

Składnik nasycenia wybranego koloru.

Uwagi

CMFCColorPickerCtrl::SelectCellHexagon

Ustawia bieżący kolor na kolor zdefiniowany przez określone składniki koloru RGB lub określony sześciokąt komórki.

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

BOOL SelectCellHexagon(
    int x,
    int y);

Parametry

R
[in] Składnik koloru czerwonego.

G
[in] Składnik koloru zielonego.

B
[in] Składnik koloru niebieskiego.

x
[in] Współrzędna x kursora, która wskazuje na sześciokąt komórki.

y
[in] Współrzędna y kursora, która wskazuje na sześciokąt komórki.

Wartość zwracana

Drugie przeciążenie tej metody zawsze zwraca wartość FALSE.

Uwagi

Pierwsze przeciążenie tej metody powoduje ustawienie bieżącego koloru na kolor odpowiadający określonym składnikom kontrolki wyboru kolorów czerwonej, zielonej i niebieskiej.

Drugie przeciążenie tej metody ustawia bieżący kolor na kolor sześciokąta komórki wskazywany przez określoną lokalizację kursora.

CMFCColorPickerCtrl::SetColor

Ustawia bieżący kolor na określoną wartość koloru RGB.

void SetColor(COLORREF Color);

Parametry

Color
[in] Wartość koloru RGB.

Uwagi

CMFCColorPickerCtrl::SetHLS

Ustawia bieżący kolor na określoną wartość koloru HLS.

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

Parametry

hue
[in] Wartość odcienia.

luminance
[in] Wartość luminacji.

saturation
[in] Wartość nasycenia.

bInvalidate
[in] TRUE aby wymusić natychmiastowe zaktualizowanie okna do nowego koloru; w przeciwnym razie, FALSE. Wartość domyślna to TRUE.

Uwagi

CMFCColorPickerCtrl::SetHue

Zmienia odcienie aktualnie wybranego koloru.

void SetHue(double Hue);

Parametry

Hue
[in] Wartość odcienia.

Uwagi

CMFCColorPickerCtrl::SetLuminance

Zmienia lumincję aktualnie wybranego koloru.

void SetLuminance(double Luminance);

Parametry

Luminance
[in] Wartość luminacji.

Uwagi

CMFCColorPickerCtrl::SetLuminanceBarWidth

Ustawia szerokość paska luminance w kontrolce selektora kolorów.

void SetLuminanceBarWidth(int w);

Parametry

w
[in] Szerokość paska luminacji mierzona w pikselach.

Uwagi

Użyj tej metody, aby zmienić rozmiar paska luminance, który znajduje się na karcie Niestandardowe kontrolki selektora kolorów. Parametr w określa nową szerokość paska luminance. Wartość szerokości jest ignorowana, jeśli przekracza trzy czwarte szerokości obszaru klienta.

CMFCColorPickerCtrl::SetOriginalColor

Ustawia początkowy wybrany kolor.

void SetOriginalColor(COLORREF ref);

Parametry

ref
[in] Wartość koloru RGB.

Uwagi

Wywołaj tę metodę po zainicjowaniu kontrolki selektora kolorów.

CMFCColorPickerCtrl::SetPalette

Ustawia bieżącą paletę kolorów.

void SetPalette(CPalette* pPalette);

Parametry

pPalette
[in] Wskaźnik do palety kolorów.

Uwagi

Paleta kolorów definiuje tablicę kolorów przedstawionych w kontrolce selektora kolorów.

CMFCColorPickerCtrl::SetSaturation

Zmienia nasycenie aktualnie wybranego koloru.

void SetSaturation(double Saturation);

Parametry

Saturation
[in] Wartość nasycenia.

Uwagi

CMFCColorPickerCtrl::SetType

Ustawia typ kontrolki selektora kolorów do wyświetlenia.

void SetType(COLORTYPE colorType);

Parametry

colorType
[in] Typ kontrolki selektora kolorów.

Typy są definiowane przez CMFCColorPickerCtrl::COLORTYPE wyliczenie. Możliwe typy to LUMINANCE, PICKERHEX i HEX_GREYSCALE. Domyślnym typem jest PICKER.

Uwagi

Aby określić typ kontrolki selektora kolorów, wywołaj tę metodę przed utworzeniem kontrolki systemu Windows.

Zobacz też

Wykres hierarchii
Klasy
CMFCColorDialog Klasa