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