Klasa CColorDialog

Artykuł
02/27/2013

Umożliwia włączenie okno dialogowe wybór kolorów do aplikacji.

class CColorDialog : public CCommonDialog

Członkowie

Publiczne konstruktory

Nazwa	Opis
CColorDialog::CColorDialog	Konstrukcje CColorDialog obiektu.

Metody publiczne

Nazwa	Opis
CColorDialog::DoModal	Wyświetla okno dialogowe Kolor i umożliwia użytkownikowi zaznaczanie jest niepotrzebne.
CColorDialog::GetColor	Zwraca COLORREF struktury zawierającej wartości kolorów.
CColorDialog::GetSavedCustomColors	Pobiera kolory niestandardowe utworzone przez użytkownika.
CColorDialog::SetCurrentColor	Wymusza bieżącego zaznaczenia koloru określonego koloru.

Metody chronione

Nazwa	Opis
CColorDialog::OnColorOK	Zastąp kolor weszła w oknie dialogowym potwierdzenie.

Publiczne danych członków

Nazwa	Opis
CColorDialog::m_cc	Struktura umożliwia dostosowywanie ustawień w oknie dialogowym.

Uwagi

A CColorDialog obiekt jest okno dialogowe z listą kolorów, które są zdefiniowane dla systemu wyświetlania.Użytkownika można wybrać lub utworzyć określonego koloru z listy, która jest następnie zgłoszone wróć do aplikacji, kiedy okno dialogowe.

Aby skonstruować CColorDialog obiekt, użyj konstruktora, dostarczone lub nową klasę i używać własnego niestandardowego konstruktora.

Po oknie dialogowym została skonstruowana, można ustawić lub zmodyfikować wartości wm_cc struktury zainicjować wartości formantów w oknie dialogowym.m_cc Struktury jest typu CHOOSECOLOR.

Po inicjowanie formantów w oknie dialogowym, call DoModal Członkowskich funkcji, aby wyświetlić okno dialogowe i użytkownikowi wybrać kolor.DoModalZwraca wartość OK w oknie dialogowym Wybór użytkownika albo (IDOK) lub przycisk Anuluj (IDCANCEL) przycisk.

Jeśli DoModal zwraca IDOK, można użyć jednej z CColorDialogw funkcji elementów członkowskich do pobierania informacji wprowadzania przez użytkownika.

Można użyć systemu Windows CommDlgExtendedError funkcji, aby ustalić, czy wystąpił błąd podczas inicjowania okna dialogowego i Dowiedz się więcej o błędzie.

CColorDialogkorzysta z pliku COMMDLG.Plik DLL, dostarczany z systemem Windows w wersji 3.1 lub nowszej.

Aby dostosować okno dialogowe, czerpią klasy z CColorDialog, zapewniają szablonu niestandardowe okna dialogowe i dodać mapę wiadomości do przetwarzania wiadomości powiadomień z rozszerzonych formantów.Komunikaty nieprzetworzonych powinien zostać przekazany do klasy podstawowej.

Dostosowywanie funkcji haka nie jest wymagane.

[!UWAGA]

Na niektórych instalacji CColorDialog obiekt nie zostanie wyświetlony z szarym tle użycie ramach dokonać innych CDialog szarości obiektów.

Aby uzyskać więcej informacji na temat używania CColorDialog, zobacz Klasy wspólne okno dialogowe