Classe CMFCColorButton

Articolo
06/10/2015

CMFCColorButton e le classi Classe CMFCColorBar vengono utilizzati insieme per implementare un controllo di selezione colori.

class CMFCColorButton : public CMFCButton

Membri

Costruttori pubblici

Nome	Descrizione
CMFCColorButton::CMFCColorButton	Costruisce un nuovo oggetto CMFCColorButton.

Metodi pubblici

Nome	Descrizione
CMFCColorButton::EnableAutomaticButton	Abilita e disabilita un pulsante "automatico" collocato sui pulsanti standard di colore. (Il pulsante automatico del sistema standard è contrassegnato Automatico).
CMFCColorButton::EnableOtherButton	Abilita e disabilita "un altro" pulsante posto sotto i pulsanti standard di colore. (Il sistema standard "l'altro" pulsante è contrassegnato Altri coloriÉ).
CMFCColorButton::GetAutomaticColor	Recupera il colore automatico corrente.
CMFCColorButton::GetColor	Recupera il colore di un pulsante.
CMFCColorButton::SetColor	Imposta il colore di un pulsante.
CMFCColorButton::SetColorName	Imposta un nome di colore.
CMFCColorButton::SetColumnsNumber	Imposta il numero di colonne nella finestra di dialogo di selezione colori.
CMFCColorButton::SetDocumentColors	Specifica un elenco di colori specifici un documento visualizzato nella finestra di dialogo di selezione colori.
CMFCColorButton::SetPalette	Specifica una tavolozza dei colori di visualizzazione standard.
CMFCColorButton::SizeToContent	Modificare le dimensioni del pulsante, come il testo e le dimensioni delle immagini.

Metodi protetti

Nome	Descrizione
CMFCColorButton::IsDrawXPTheme	Indica se il pulsante corrente di colori visualizzati nello stile di visualizzazione di Windows XP.
CMFCColorButton::OnDraw	Chiamato dal framework per visualizzare un'immagine del pulsante.
CMFCColorButton::OnDrawBorder	Chiamato dal framework per visualizzare il bordo del pulsante.
CMFCColorButton::OnDrawFocusRect	Chiamato dal framework per visualizzare un rettangolo di attivazione quando il pulsante presenta lo stato attivo.
CMFCColorButton::OnShowColorPopup	Chiamato dal framework quando la finestra di dialogo di selezione colori sta per visualizzare.
CMFCColorButton::RebuildPalette	Inizializzare il membro dati protetto m_pPalette la tavolozza specificata o alla tavolozza di sistema predefinito.
CMFCColorButton::UpdateColor	Chiamato dal framework quando l'utente seleziona un colore dalla tavolozza della finestra di dialogo di selezione colori.

Membri di dati

Nome	Descrizione
m_bAltColorDlg	Un valore Boolean. Se TRUE, il framework di visualizzare la finestra di dialogo colore CMFCColorDialog quando l'altro pulsante, o se FALSE, la finestra di dialogo dei colori di sistema. Il valore predefinito è TRUE. Per ulteriori informazioni, vedere CMFCColorButton::EnableOtherButton.
m_bAutoSetFocus	Un valore Boolean. Se TRUE, il framework imposta lo stato attivo sul menu di colore quando viene visualizzato il menu, oppure se FALSE, non modifica lo stato attivo. Il valore predefinito è TRUE.
CMFCColorButton::m_bEnabledInCustomizeMode	Indica se la modalità di personalizzazione è abilitata per il pulsante di colore.
m_Color	Un valore COLORREF. Contiene il colore selezionato.
m_ColorAutomatic	Un valore COLORREF. Contiene il colore predefinito attualmente selezionato.
m_Colors	CArray dei valori COLORREF. Contiene colori disponibili.
m_lstDocColors	CList dei valori COLORREF. Contiene colori documenti correnti.
m_nColumns	Intero. Contiene il numero di colonne da visualizzare nella griglia dei colori in un menu di selezione di colori.
m_pPalette	Un puntatore a CPalette. Contiene colori disponibili nel menu corrente di selezione di colori.
m_pPopup	Un puntatore a un oggetto Classe CMFCColorPopupMenu. Il menu di selezione di colori visualizzati quando si fa clic sul pulsante di colore.
m_strAutoColorText	Stringa. L'etichetta del pulsante "automatico" in un menu di selezione di colori.
m_strDocColorsText	Stringa. L'etichetta del pulsante in un menu di selezione di colori visualizzati i colori documenti.
m_strOtherText	Stringa. L'etichetta "dell'altra" pulsante in un menu di selezione di colori.

Note

Per impostazione predefinita, la classe CMFCColorButton si comporta come pulsante di comando che apre una finestra di dialogo di selezione colori. La finestra di dialogo di selezione colori contiene una matrice di piccoli pulsanti di colore e "di un altro pulsante" che visualizza una selezione colori personalizzata. (Il sistema standard "l'altro" pulsante è contrassegnato Altri coloriÉ). Quando un utente seleziona un nuovo colore, l'oggetto CMFCColorButton riflette la modifica e visualizzare il colore selezionato.

Creare un pulsante di colore direttamente nel codice, oppure utilizzando lo strumento ClassWizard e un modello di finestra di dialogo. Se si crea direttamente un pulsante di colore, aggiungere una variabile CMFCColorButton all'applicazione e quindi chiamare il costruttore e i metodi CreateCMFCColorButton oggetto. Se si utilizza ClassWizard, aggiungere una variabile CButton all'applicazione e modificare il tipo di variabile da CButton a CMFCColorButton.

La finestra di dialogo di selezione colori (Classe CMFCColorBar) visualizzata con il metodo CMFCColorButton::OnShowColorPopup quando il framework chiama il gestore eventi OnLButtonDown. Il metodo CMFCColorButton::OnShowColorPopup può essere sottoposto a override per supportare la selezione di colori personalizzata.

L'oggetto CMFCColorButton notifica relativo padre che un colore sta modificando inviandolo una notifica WM_COMMAND | BN_CLICKED. Il padre viene utilizzato il metodo CMFCColorButton::GetColor per recuperare il colore corrente.

Esempio

Nell'esempio seguente viene illustrato come configurare un pulsante di colore utilizzando i diversi metodi nella classe CMFCColorButton. I metodi di impostare il colore del pulsante di colore e il relativo numero di colonne e utilizzare i pulsanti automatici e altri. Questo esempio fa parte Esempio demo barra di stato.

    CMFCColorButton m_wndTextColor;


...


    m_wndTextColor.EnableAutomaticButton (_T("Default"), afxGlobalData.clrBtnText);
    m_wndTextColor.EnableOtherButton (_T("Other..."));
    m_wndTextColor.SetColor ((COLORREF)-1);
    m_wndTextColor.SetColorName((COLORREF)-1, "Default Color");
    m_wndTextColor.SetColumnsNumber(3);