Classe di CMFCColorBar

Articolo
03/26/2013

La classe CMFCColorBar rappresenta una barra di controllo di ancoraggio che può selezionare i colori in un documento o in un'applicazione.

class CMFCColorBar : public CMFCPopupMenuBar

Membri

Costruttori protetti

Nome	Descrizione
CMFCColorBar::CMFCColorBar	Costruisce un oggetto CMFCColorBar.

Metodi pubblici

Nome	Descrizione
CMFCColorBar::ContextToSize	Calcola i margini verticali e orizzontali necessari per contenere i pulsanti del controllo barra dei colori quindi modificare la posizione dei pulsanti.
CMFCColorBar::CreateControl	Crea una finestra di controllo barra dei colori, la aggiunge all'oggetto CMFCColorBar e ridimensiona il controllo per contenere la tavolozza dei colori specificata.
CMFCColorBar::Create	Crea una finestra di controllo barra dei colori e allegarlo all'oggetto CMFCColorBar.
CMFCColorBar::EnableAutomaticButton	Mostra o nasconde il pulsante automatico.
CMFCColorBar::EnableOtherButton	Abilita o disabilita la visualizzazione di una finestra di dialogo che consente di selezionare più colori.
CMFCColorBar::GetColor	Recupera il colore selezionato.
CMFCColorBar::GetCommandID	Recupera l'id di comando del controllo corrente della barra dei colori.
CMFCColorBar::GetHighlightedColor	Recupera il colore che indica un pulsante di colore ha lo stato attivo; ovvero il pulsante è necessario.
CMFCColorBar::GetHorzMargin	Recupera il margine orizzontale, che rappresenta lo spazio tra la cella sinistra o a destra di colore e il limite di area client.
CMFCColorBar::GetVertMargin	Recupera il margine verticale, che rappresenta lo spazio tra la parte superiore o la cella colore del bordo inferiore e il limite di area client.
CMFCColorBar::IsTearOff	Indica se la barra di colore corrente è ancorabile.
CMFCColorBar::SetColor	Imposta il colore attualmente selezionato.
CMFCColorBar::SetColorName	Imposta un nuovo nome per un colore specificato.
CMFCColorBar::SetCommandID	Imposta un nuovo ID di comando per un controllo barra dei colori.
CMFCColorBar::SetDocumentColors	Imposta l'elenco dei colori utilizzati nel documento corrente.
CMFCColorBar::SetHorzMargin	Imposta il margine orizzontale, che rappresenta lo spazio tra la cella sinistra o a destra di colore e il limite di area client.
CMFCColorBar::SetVertMargin	Imposta il margine verticale, che rappresenta lo spazio tra la parte superiore o la cella colore del bordo inferiore e il limite di area client.

Metodi protetti

Nome	Descrizione
CMFCColorBar::AdjustLocations	Regola le posizioni dei pulsanti di colore sul controllo barra dei colori.
CMFCColorBar::AllowChangeTextLabels	Indica se l'etichetta di testo i pulsanti di colore può cambiare.
CMFCColorBar::AllowShowOnList	Indica se l'oggetto controllo barra dei colori può essere visualizzate in un elenco della barra degli strumenti durante il processo di personalizzazione.
CMFCColorBar::CalcSize	Chiamato dal framework durante il processo di calcolo del layout.
CMFCColorBar::CreatePalette	Initalizes una tavolozza dei colori in una matrice specificata dei colori.
CMFCColorBar::GetColorGridSize	Calcola il numero di righe e colonne nella griglia di un controllo barra dei colori.
CMFCColorBar::GetExtraHeight	Calcola l'altezza aggiuntiva che la barra di colore corrente richiede per visualizzare i vari elementi dell'interfaccia utente come pulsante Altri colori, documenti, e così via.
CMFCColorBar::InitColors	Inizializza una matrice di colori con colori in una tavolozza specificata o nella tavolozza predefinito di sistema.
CMFCColorBar::OnKey	Chiamato dal framework quando un utente preme un pulsante della tastiera.
CMFCColorBar::OnSendCommand	Chiamato dal framework per chiudere una gerarchia di controlli popup.
CMFCColorBar::OnUpdateCmdUI	Chiamato dal framework per abilitare o disabilitare un elemento dell'interfaccia utente di un controllo barra dei colori prima dell'elemento visualizzato.
CMFCColorBar::OpenColorDialog	Aprire una finestra di dialogo dei colori.
CMFCColorBar::Rebuild	Completamente ridisegna il controllo barra dei colori.
CMFCColorBar::SelectPalette	Imposta la tavolozza logica del contesto di dispositivo specificato alla tavolozza del pulsante padre del controllo corrente della barra dei colori.
CMFCColorBar::SetPropList	Imposta il membro dati protetto m_pWndPropList al puntatore specificato in un controllo griglia delle proprietà.
CMFCColorBar::ShowCommandMessageString	Richiede la finestra cornice proprietario del controllo barra dei colori per aggiornare la riga del messaggio nella barra di stato.

Membri di dati protetti

Nome	Descrizione
m_bInternal	Un campo booleano che determina se gli eventi vengono elaborati.In genere, gli eventi vengono elaborati quando questo campo è TRUE e modalità di personalizzazione è FALSE.
m_bIsEnabled	Un valore booleano che indica se un controllo è abilitato.
m_bIsTearOff	Un valore booleano che indica se il controllo barra dei colori supporta l'ancoraggio.
m_BoxSize	Un oggetto CSize che specifica la dimensione di una cella in una griglia della barra dei colori.
m_bShowDocColorsWhenDocked	Un valore booleano che indica se visualizzare i colori documenti quando la barra di colore è ancorata.Per ulteriori informazioni, vedere CMFCColorBar::SetDocumentColors.
m_bStdColorDlg	Un valore booleano che indica se visualizzare la finestra di dialogo standard di colore di sistema o la finestra di dialogo CMFCColorDialog.Per ulteriori informazioni, vedere CMFCColorBar::EnableOtherButton.
m_ColorAutomatic	COLORREF che memorizza il colore automatico corrente.Per ulteriori informazioni, vedere CMFCColorBar::EnableOtherButton.
m_ColorNames	Un oggetto CMap che associa un set di colori RGB con i nomi.
m_colors	CArray dei valori COLORREF che contiene colori visualizzati nel controllo barra dei colori.
m_ColorSelected	Un valore COLORREF che è il colore che l'utente ha attualmente selezionato dal controllo barra dei colori.
m_lstDocColors	CList dei valori COLORREF che contiene colori correntemente in uso in un documento.
m_nCommandID	Intero senza segno che rappresenta l'id di comando di un pulsante di colore.
m_nHorzMargin	Intero che rappresenta il margine orizzontale tra il colore i pulsanti in una griglia di colori.
m_nHorzOffset	Intero che rappresenta l'offset orizzontale al centro del pulsante di colore.Questo valore è significativo nelle visualizzazioni del pulsante testo o di un'immagine oltre al colore.
m_nNumColumns	Intero che rappresenta il numero di colonne in una griglia di controllo barra dei colori dei colori.
m_nNumColumnsVert	Intero che rappresenta il numero di colonne in una griglia verticalmente orientata dei colori.
m_nNumRowsHorz	Intero che rappresenta il numero di colonne in una griglia orientata orizzontalmente dei colori.
m_nRowHeight	Intero che corrisponde all'altezza di una riga di colore i pulsanti in una griglia di colori.
m_nVertMargin	Intero che rappresenta il margine verticale tra il colore i pulsanti in una griglia di colori.
m_nVertOffset	Intero che rappresenta l'offset verticale al centro del pulsante di colore.Questo valore è significativo nelle visualizzazioni del pulsante testo o di un'immagine oltre al colore.
m_Palette	CPalette dei colori utilizzati nel controllo barra dei colori.
m_pParentBtn	Un puntatore a un oggetto CMFCColorButton che è il padre del pulsante corrente.Questo valore è significativo se il pulsante di colore è in una gerarchia di controlli della barra degli strumenti o in un controllo griglia delle proprietà di colore.
m_pParentRibbonBtn	Un puntatore a un oggetto CMFCRibbonColorButton che si trova sulla barra multifunzione e è il pulsante padre del pulsante corrente.Questo valore è significativo se il pulsante di colore è in una gerarchia di controlli della barra degli strumenti o in un controllo griglia delle proprietà di colore.
m_pWndPropList	Un puntatore a un oggetto CMFCPropertyGridCtrl.
m_strAutoColor	CString che è il testo visualizzato sul pulsante Automatico.Per ulteriori informazioni, vedere CMFCColorBar::EnableAutomaticButton.
m_strDocColors	CString che è il testo visualizzato sul pulsante di colori documenti.Per ulteriori informazioni, vedere CMFCColorBar::SetDocumentColors.
m_strOtherColor	CString che è il testo visualizzato nell'altro pulsante.Per ulteriori informazioni, vedere CMFCColorBar::EnableOtherButton.

Note

In genere, creare direttamente un oggetto CMFCColorBar.Invece, Classe di CMFCColorMenuButton (utilizzato nei menu e barre degli strumenti) o Classe di CMFCColorButton crea l'oggetto CMFCColorBar.

La classe CMFCColorBar fornisce le funzionalità seguenti:

Regola automaticamente l'elenco dei documenti.
Salva e ripristina lo stato, insieme al documento.
Gestisce il pulsante "automatico".
Utilizza il controllo Classe di CMFCColorPickerCtrl per selezionare un colore personalizzato.
Supporta "sradicano" lo stato (se viene creato utilizzando Classe di CMFCColorMenuButton).

Per includere funzionalità CMFCColorBar nell'applicazione:

Creare un pulsante standard di menu e assegnarle un ID, ad esempio ID_CHAR_COLOR.
Nella classe della finestra cornice, eseguire l'override del metodo CFrameWndEx::OnShowPopupMenu e sostituire il pulsante standard di menu a un oggetto Classe di CMFCColorMenuButton chiamando CMFCToolBar::ReplaceButton).
Impostare gli stili e abilitare o disabilitare le funzionalità dell'oggetto CMFCColorBar durante la creazione Classe di CMFCColorMenuButton.l'oggetto CMFCColorMenuButton crea dinamicamente l'oggetto CMFCColorBar dopo che il framework chiama il metodo CreatePopupMenu.

Quando l'utente fa clic su un pulsante del controllo barra dei colori, il framework utilizza la macro ON_COMMAND per notificare al padre del controllo barra dei colori.Nella macro, il parametro di ID di comando è il valore che è stato assegnato il pulsante del controllo barra dei colori nel passaggio 1 (ID_CHAR_COLOR in questo esempio).Per ulteriori informazioni, vedere le classi Classe di CMFCColorMenuButton, Classe di CMFCColorButton, Classe di CMFCColorPickerCtrl, Classe di CFrameWndExe Classe di CMFCToolBar.

Esempio

Nell'esempio seguente viene illustrato come configurare una barra dei colori utilizzando i diversi metodi nella classe CMFCColorBar.I metodi specifici in orizzontale e i margini verticali, consentono all'altro pulsante, viene creata una finestra di controllo barra dei colori e imposta il colore selezionato.Questo esempio fa parte Nuovo esempio di controlli.

    CMFCColorBar m_wndColorBar;


...


    // set the margins
    m_wndColorBar.SetHorzMargin(0);
    m_wndColorBar.SetVertMargin(0);
    // enable the display of a dialog box that 
    // lets the user select more colors
    m_wndColorBar.EnableOtherButton(_T("Other..."));
    // create a color bar control window
    m_wndColorBar.CreateControl(this, rectColorBar, IDC_COLORBAR, 5 /* columns */);
    // set the currently selected color
    m_wndColorBar.SetColor(RGB(255, 0, 0));