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
Costruttori protetti
Nome |
Descrizione |
---|---|
Costruisce un oggetto CMFCColorBar. |
Metodi pubblici
Nome |
Descrizione |
---|---|
Calcola i margini verticali e orizzontali necessari per contenere i pulsanti del controllo barra dei colori quindi modificare la posizione dei pulsanti. |
|
Crea una finestra di controllo barra dei colori, la aggiunge all'oggetto CMFCColorBar e ridimensiona il controllo per contenere la tavolozza dei colori specificata. |
|
Crea una finestra di controllo barra dei colori e allegarlo all'oggetto CMFCColorBar. |
|
Mostra o nasconde il pulsante automatico. |
|
Abilita o disabilita la visualizzazione di una finestra di dialogo che consente di selezionare più colori. |
|
Recupera il colore selezionato. |
|
Recupera l'id di comando del controllo corrente della barra dei colori. |
|
Recupera il colore che indica un pulsante di colore ha lo stato attivo; ovvero il pulsante è necessario. |
|
Recupera il margine orizzontale, che rappresenta lo spazio tra la cella sinistra o a destra di colore e il limite di area client. |
|
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. |
|
Indica se la barra di colore corrente è ancorabile. |
|
Imposta il colore attualmente selezionato. |
|
Imposta un nuovo nome per un colore specificato. |
|
Imposta un nuovo ID di comando per un controllo barra dei colori. |
|
Imposta l'elenco dei colori utilizzati nel documento corrente. |
|
Imposta il margine orizzontale, che rappresenta lo spazio tra la cella sinistra o a destra di colore e il limite di area client. |
|
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 |
---|---|
Regola le posizioni dei pulsanti di colore sul controllo barra dei colori. |
|
Indica se l'etichetta di testo i pulsanti di colore può cambiare. |
|
Indica se l'oggetto controllo barra dei colori può essere visualizzate in un elenco della barra degli strumenti durante il processo di personalizzazione. |
|
Chiamato dal framework durante il processo di calcolo del layout. |
|
Initalizes una tavolozza dei colori in una matrice specificata dei colori. |
|
Calcola il numero di righe e colonne nella griglia di un controllo barra dei colori. |
|
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. |
|
Inizializza una matrice di colori con colori in una tavolozza specificata o nella tavolozza predefinito di sistema. |
|
Chiamato dal framework quando un utente preme un pulsante della tastiera. |
|
Chiamato dal framework per chiudere una gerarchia di controlli popup. |
|
Chiamato dal framework per abilitare o disabilitare un elemento dell'interfaccia utente di un controllo barra dei colori prima dell'elemento visualizzato. |
|
Aprire una finestra di dialogo dei colori. |
|
Completamente ridisegna il controllo barra dei colori. |
|
Imposta la tavolozza logica del contesto di dispositivo specificato alla tavolozza del pulsante padre del controllo corrente della barra dei colori. |
|
Imposta il membro dati protetto m_pWndPropList al puntatore specificato in un controllo griglia delle proprietà. |
|
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));
Gerarchia di ereditarietà
Requisiti
intestazione: afxcolorbar.h