Classe di CColorDialog

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

class CColorDialog : public CCommonDialog

Membri

6w6cd538.collapse_all(it-it,VS.110).gifCostruttori pubblici

Nome

Descrizione

CColorDialog::CColorDialog

Costruisce un oggetto CColorDialog.

6w6cd538.collapse_all(it-it,VS.110).gifMetodi 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.

6w6cd538.collapse_all(it-it,VS.110).gifMetodi protetti

Nome

Descrizione

CColorDialog::OnColorOK

Override per convalidare il colore inserito nella finestra di dialogo.

6w6cd538.collapse_all(it-it,VS.110).gifMembri 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

Gerarchia di ereditarietà

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

CColorDialog

Requisiti

Header: afxdlgs.h

Vedere anche

Riferimenti

Classe di CCommonDialog

Grafico della gerarchia

Concetti

MFC esempi MDI

L'esempio DRAWCLI MFC