Classe di CMFCColorBar

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

Bb983134.collapse_all(it-it,VS.110).gifCostruttori protetti

Nome

Descrizione

CMFCColorBar::CMFCColorBar

Costruisce un oggetto CMFCColorBar.

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

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

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

  1. Creare un pulsante standard di menu e assegnarle un ID, ad esempio ID_CHAR_COLOR.

  2. 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).

  3. 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));

Gerarchia di ereditarietà

CObject

   CCmdTarget

      CWnd

         CBasePane

            CPane

               CMFCBaseToolBar

                  CMFCToolBar

                     CMFCPopupMenuBar

                        CMFCColorBar

Requisiti

intestazione: afxcolorbar.h

Vedere anche

Riferimenti

Grafico della gerarchia

Altre risorse

Classi MFC