Udostępnij za pośrednictwem


Klasa CMFCColorDialog

Klasa CMFCColorDialog reprezentuje okno dialogowe wyboru kolorów.

Składnia

class CMFCColorDialog : public CDialogEx

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CMFCColorDialog::CMFCColorDialog CMFCColorDialog Tworzy obiekt.
CMFCColorDialog::~CMFCColorDialog Destruktor.

Metody publiczne

Nazwa/nazwisko opis
CMFCColorDialog::GetColor Zwraca bieżący wybrany kolor.
CMFCColorDialog::GetPalette Zwraca paletę kolorów.
CMFCColorDialog::PreTranslateMessage Tłumaczy komunikaty okien przed ich wysłaniem do funkcji TranslateMessage i DispatchMessage systemu Windows. Aby uzyskać składnię i więcej informacji, zobacz CWnd::P reTranslateMessage. (Przesłania CDialogEx::PreTranslateMessage).
CMFCColorDialog::RebuildPalette Wyprowadza paletę z palety systemowej.
CMFCColorDialog::SetCurrentColor Ustawia bieżący wybrany kolor.
CMFCColorDialog::SetNewColor Ustawia kolor najbardziej odpowiadający określonej wartości RGB.
CMFCColorDialog::SetPageOne Wybiera wartość RGB dla pierwszej strony właściwości.
CMFCColorDialog::SetPageTwo Wybiera wartość RGB dla drugiej strony właściwości.

Chronione składowe danych

Nazwa/nazwisko opis
m_bIsMyPalette WARTOŚĆ TRUE, jeśli okno dialogowe wyboru kolorów używa własnej palety kolorów lub FALSE, jeśli w oknie dialogowym jest używana paleta określona w konstruktorze CMFCColorDialog .
m_bPickerMode WARTOŚĆ TRUE, gdy użytkownik wybiera kolor z okna dialogowego wyboru; w przeciwnym razie, FAŁSZ.
m_btnColorSelect Przycisk koloru wybrany przez użytkownika.
m_CurrentColor Aktualnie wybrany kolor.
m_hcurPicker Kursor używany do wybierania koloru.
m_NewColor Potencjalny wybrany kolor, który można trwale wybrać lub przywrócić oryginalny kolor.
m_pColourSheetOne Wskaźnik do pierwszej strony właściwości arkusza właściwości wyboru koloru.
m_pColourSheetTwo Wskaźnik do drugiej strony właściwości arkusza właściwości wyboru koloru.
m_pPalette Bieżąca paleta logiczna.
m_pPropSheet Wskaźnik do arkusza właściwości okna dialogowego wyboru kolorów.
m_wndColors Obiekt kontrolki selektora kolorów.
m_wndStaticPlaceHolder Statyczna kontrolka, która jest symbolem zastępczym arkusza właściwości selektora kolorów.

Uwagi

Okno dialogowe wyboru kolorów jest wyświetlane jako arkusz właściwości z dwiema stronami. Na pierwszej stronie wybierz standardowy kolor z palety systemowej; na drugiej stronie wybierz kolor niestandardowy.

Możesz skonstruować CMFCColorDialog obiekt na stosie, a następnie wywołać DoModalmetodę , przekazując początkowy kolor jako parametr do konstruktora CMFCColorDialog . Następnie okno dialogowe wyboru kolorów tworzy kilka obiektów klasy CMFCColorPickerCtrl do obsługi każdej palety kolorów.

Hierarchia dziedziczenia

Obiekt CObject

CCmdTarget

CWnd

CDialog

CDialogEx

CMFCColorDialog

Przykład

W poniższym przykładzie pokazano, jak skonfigurować okno dialogowe koloru przy użyciu różnych metod w CMFCColorDialog klasie. W przykładzie pokazano, jak ustawić bieżące i nowe kolory okna dialogowego oraz jak ustawić czerwone, zielone i niebieskie składniki wybranego koloru na dwóch stronach właściwości okna dialogowego koloru. Ten przykład jest częścią przykładu Nowe kontrolki.

// 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);

Wymagania

Nagłówek: afxcolordialog.h

CMFCColorDialog::CMFCColorDialog

CMFCColorDialog Tworzy obiekt.

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

Parametry

clrInit
[in] Domyślny wybór koloru. Jeśli nie określono żadnej wartości, wartość domyślna to RGB(0,0,0) ().

dwFlags
[in] Zastrzeżony.

pParentWnd
[in] Wskaźnik do okna nadrzędnego lub okna właściciela okna dialogowego.

hPal
[in] Uchwyt do palety kolorów.

Wartość zwracana

Uwagi

CMFCColorDialog::GetColor

Pobiera kolor wybierany przez użytkownika w oknie dialogowym kolorów.

COLORREF GetColor() const;

Wartość zwracana

Wartość COLORREF zawierająca informacje RGB dla koloru wybranego w oknie dialogowym kolor.

Uwagi

Wywołaj tę funkcję po wywołaniu DoModal metody .

CMFCColorDialog::GetPalette

Pobiera paletę kolorów dostępną w bieżącym oknie dialogowym kolorów.

CPalette* GetPalette() const;

Wartość zwracana

Wskaźnik do CPalette obiektu, który został określony w konstruktorze CMFCColorDialog .

Uwagi

Paleta kolorów określa kolory, które użytkownik może wybrać.

CMFCColorDialog::RebuildPalette

Wyprowadza paletę z palety systemowej.

void RebuildPalette();

CMFCColorDialog::SetCurrentColor

Ustawia bieżący kolor okna dialogowego.

void SetCurrentColor(COLORREF rgb);

Parametry

Rgb
[in] Wartość koloru RGB

Uwagi

CMFCColorDialog::SetNewColor

Ustawia bieżący kolor na kolor w bieżącej palecie, która jest najbardziej podobna.

void SetNewColor(COLORREF rgb);

Parametry

Rgb
[in] Element COLORREF określający kolor RGB.

Uwagi

CMFCColorDialog::SetPageOne

Jawnie określa czerwone, zielone i niebieskie składniki wybranego koloru na pierwszej stronie właściwości okna dialogowego koloru.

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

Parametry

R
[in] Określa czerwony składnik wartości RGB.

G
[in] Określa zielony składnik wartości RGB.

B
[in] Określa niebieski składnik wartości RGB.

Uwagi

CMFCColorDialog::SetPageTwo

Jawnie określa czerwone, zielone i niebieskie składniki wybranego koloru na drugiej stronie właściwości okna dialogowego koloru.

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

Parametry

R
[in] Określa czerwony składnik wartości RGB

G
[in] Określa zielony składnik wartości RGB

B
[in] Określa niebieski składnik wartości RGB

Uwagi

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCColorPickerCtrl