Classe di CColorDialog

Articolo
03/05/2013

Consente di incorporare una finestra di dialogo di selezione corrispondente nell'applicazione.

class CColorDialog : public CCommonDialog

Membri

Costruttori pubblici

Nome	Descrizione
CColorDialog::CColorDialog	Costruisce un oggetto CColorDialog.

Metodi pubblici

Nome	Descrizione
CColorDialog::DoModal	Visualizza una finestra di dialogo dei colori e sarà all'utente di effettuare una selezione.
CColorDialog::GetColor	Restituisce una struttura COLORREF contenente i valori del colore selezionato.
CColorDialog::GetSavedCustomColors	Recupera i colori personalizzati creati dall'utente.
CColorDialog::SetCurrentColor	Forza la selezione di colori corrente nel colore specificato.

Metodi protetti

Nome	Descrizione
CColorDialog::OnColorOK	Override per convalidare il colore inserito nella finestra di dialogo.

Membri dati pubblici

Nome	Descrizione
CColorDialog::m_cc	Una struttura utilizzata per personalizzare le impostazioni della finestra di dialogo.

Note

Un oggetto CColorDialog è una finestra di dialogo con un elenco di colori definite per il sistema di visualizzazione.L'utente può selezionare o creare un colore specifico dall'elenco, che viene presentato un rapportoapplicazione quando la finestra di dialogo chiude.

Per creare un oggetto CColorDialog, utilizzare il costruttore fornito o derivare una nuova classe e utilizzare il proprio costruttore personalizzato.

Una volta che la finestra di dialogo è stata creata, è possibile impostare o modificare i valori nella struttura dim_cc per inizializzare i valori dei controlli della finestra di dialogo.La struttura m_cc è di tipo CHOOSECOLOR.

Dopo aver inizializzato i controlli finestra di dialogo, chiamare la funzione membro DoModal per visualizzare la finestra di dialogo e per consentire di selezionare un colore.DoModal restituisce la selezione utente della finestra di dialogo OK (IDOK) o sul pulsante di annullamento (IDCANCEL).

Se DoModal restituisce IDOK, è possibile utilizzare una delle funzioni membro di CColorDialog per recuperare l'input di informazioni dall'utente.

È possibile utilizzare la funzione di Windows CommDlgExtendedError per determinare se si è verificato un errore durante l'inizializzazione della finestra di dialogo e per ulteriori informazioni sull'errore.

CColorDialog si basa sul file di COMMDLG.DLL fornito con le versioni di Windows 3,1 e successive.

Per personalizzare la finestra di dialogo, derivare una classe da CColorDialog, fornire un modello personalizzato di una finestra di dialogo e aggiungere una mappa messaggi per elaborare i messaggi di notifica dai controlli estesi.Tutti i messaggi non elaborati devono essere passati alla classe di base.

Personalizzare la funzione hook non è obbligatorio.

[!NOTA]

In alcune installazioni l'oggetto CColorDialog non viene visualizzato con uno sfondo grigio quando viene utilizzato il framework per rendere altri oggetti CDialog grigi.

Per ulteriori informazioni su l CColorDialog, vedere Classi comuni della finestra di dialogo