Classe CMFCColorBar

  • Articolo

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

Sintassi

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 nel controllo della barra dei colori e quindi regola la posizione di tali pulsanti.
CMFCColorBar::CreateControl Crea una finestra di controllo della barra dei colori, la collega all'oggetto CMFCColorBar e ridimensiona il controllo in modo da contenere la tavolozza dei colori specificata.
CMFCColorBar::Create Crea una finestra di controllo della barra dei colori e la collega 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 all'utente di selezionare più colori.
CMFCColorBar::GetColor Recupera il colore attualmente selezionato.
CMFCColorBar::GetCommandID Recupera l'ID comando del controllo barra dei colori corrente.
CMFCColorBar::GetHighlightedColor Recupera il colore che indica che un pulsante colore ha lo stato attivo; vale a dire, il pulsante è caldo.
CMFCColorBar::GetHorzMargin Recupera il margine orizzontale, ovvero lo spazio tra la cella di colore sinistra o destra e il limite dell'area client.
CMFCColorBar::GetVertMargin Recupera il margine verticale, ovvero lo spazio tra la cella di colore superiore o inferiore e il limite dell'area client.
CMFCColorBar::IsTearOff Indica se la barra dei colori 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 comando per un controllo barra dei colori.
CMFCColorBar::SetDocumentColors Imposta l'elenco dei colori utilizzati nel documento corrente.
CMFCColorBar::SetHorzMargin Imposta il margine orizzontale, ovvero lo spazio tra la cella di colore sinistra o destra e il limite dell'area client.
CMFCColorBar::SetVertMargin Imposta il margine verticale, ovvero lo spazio tra la cella del colore superiore o inferiore e il limite dell'area client.

Metodi protetti

Nome Descrizione
CMFCColorBar::AdjustLocations Regola le posizioni dei pulsanti colore nel controllo barra dei colori.
CMFCColorBar::AllowChangeTextLabels Indica se l'etichetta di testo dei pulsanti colore può cambiare.
CMFCColorBar::AllowShowOnList Indica se l'oggetto controllo barra dei colori può essere visualizzato in un elenco di barre degli strumenti durante il processo di personalizzazione.
CMFCColorBar::CalcSize Chiamato dal framework come parte del processo di calcolo del layout.
CMFCColorBar::CreatePalette Inizializza una tavolozza con i colori in una matrice di colori specificata.
CMFCColorBar::GetColorGridSize Calcola il numero di righe e colonne nella griglia di un controllo barra dei colori.
CMFCColorBar::GetExtraHeight Calcola l'altezza aggiuntiva richiesta dalla barra dei colori corrente per visualizzare elementi dell'interfaccia utente vari, ad esempio il pulsante Altro, i colori del documento e così via.
CMFCColorBar::InitColors Inizializza una matrice di colori con i colori in una tavolozza specificata o nella tavolozza predefinita del sistema.
CMFCColorBar::OnKey Chiamato dal framework quando un utente preme un pulsante di 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 che l'elemento venga visualizzato.
CMFCColorBar::OpenColorDialog Apre una finestra di dialogo colore.
CMFCColorBar::Rebuild Ridisegna completamente il controllo barra dei colori.
CMFCColorBar::SelectPalette Imposta la tavolozza logica del contesto di dispositivo specificato sulla tavolozza del pulsante padre del controllo barra dei colori corrente.
CMFCColorBar::SetPropList Imposta il m_pWndPropList membro dati protetto sul puntatore specificato su un controllo griglia delle proprietà.
CMFCColorBar::ShowCommandMessageString Richiede alla finestra cornice proprietaria del controllo barra dei colori di aggiornare la riga del messaggio nella barra di stato.

Membri dati protetti

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

Osservazioni:

In genere, non si crea direttamente un CMFCColorBar oggetto. La classe CMFCColorMenuButton (utilizzata nei menu e nelle barre degli strumenti) o la classe CMFCColorButton crea l'oggetto CMFCColorBar .

La CMFCColorBar classe fornisce le funzionalità seguenti:

  • Regola automaticamente l'elenco dei colori del documento.

  • Salva e ripristina lo stato, insieme allo stato del documento.

  • Gestisce il pulsante "automatico".

  • Usa il controllo CLASSE CMFCColorPickerCtrl per selezionare un colore personalizzato.

  • Supporta uno stato "tear-off" (se viene creato usando la classe CMFCColorMenuButton).

Per incorporare la CMFCColorBar funzionalità nell'applicazione:

  1. Creare un pulsante di menu normale e assegnargli un ID, ad esempio ID_CHAR_COLOR.

  2. Nella classe della finestra cornice eseguire l'override del metodo CFrameWndEx::OnShowPopupMenu e sostituire il pulsante di menu normale con un oggetto Classe CMFCColorMenuButton (chiamando CMFCToolBar::ReplaceButton).

  3. Impostare tutti gli stili e abilitare o disabilitare le funzionalità dell'oggetto durante la CMFCColorBar creazione della classe CMFCColorMenuButton. L'oggetto CMFCColorMenuButton crea dinamicamente l'oggetto CMFCColorBar dopo che il framework chiama il CreatePopupMenu metodo .

Quando l'utente fa clic su un pulsante di controllo della barra dei colori, il framework usa la ON_COMMAND macro per notificare all'elemento padre del controllo barra dei colori. Nella macro il parametro ID comando è il valore assegnato al pulsante di controllo della barra dei colori nel passaggio 1 (ID_CHAR_COLOR in questo esempio). Per altre informazioni, vedere la classe CMFCColorMenuButton, la classe CMFCColorButton, la classe CMFCColorPickerCtrl, la classe CFrameWndEx e le classi della classe CMFCToolBar.

Esempio

Nell'esempio seguente viene illustrato come configurare una barra dei colori usando vari metodi nella CMFCColorBar classe . I metodi impostano i margini orizzontali e verticali, abilitano l'altro pulsante, creano una finestra di controllo della barra dei colori e impostano il colore attualmente selezionato. Questo esempio fa parte dell'esempio New Controls.This example is part of the New Controls sample.

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

CMFCColorBar::AdjustLocations

Regola le posizioni dei pulsanti colore nel controllo barra dei colori.

virtual void AdjustLocations();

Osservazioni:

Questo metodo viene chiamato dal framework durante l'elaborazione dei messaggi WM_SIZE.

CMFCColorBar::AllowChangeTextLabels

Indica se l'etichetta di testo dei pulsanti colore può cambiare.

virtual BOOL AllowChangeTextLabels() const;

Valore restituito

Sempre FALSE.

Osservazioni:

Per impostazione predefinita, questo metodo restituisce sempre FALSE, il che significa che le etichette di testo non possono essere modificate. Eseguire l'override di questo metodo per abilitare la modifica delle etichette di testo.

CMFCColorBar::AllowShowOnList

Indica se l'oggetto controllo barra dei colori può essere visualizzato in un elenco di barre degli strumenti durante il processo di personalizzazione.

virtual BOOL AllowShowOnList() const;

Valore restituito

Sempre TRUE.

Osservazioni:

Per impostazione predefinita, questo metodo restituisce sempre TRUE, il che significa che il framework può visualizzare il controllo della barra dei colori durante il processo di personalizzazione. Eseguire l'override di questo metodo per implementare un comportamento diverso.

CMFCColorBar::CalcSize

Chiamato dal framework come parte del processo di calcolo del layout.

virtual CSize CalcSize(BOOL bVertDock);

Parametri

bVertDock
[in] TRUE per specificare che il controllo barra dei colori è ancorato verticalmente; FALSE per specificare che il controllo barra dei colori è ancorato orizzontalmente.

Valore restituito

Dimensione della matrice di pulsanti colore in un controllo barra dei colori.

CMFCColorBar::CMFCColorBar

Costruisce un oggetto CMFCColorBar.

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    int nRowsDockHorz,
    int nColDockVert,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCColorButton* pParentBtn);

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCRibbonColorButton* pParentRibbonBtn);

CMFCColorBar(
    CMFCColorBar& src,
    UINT uiCommandID);

Parametri

Colori
[in] Matrice di colori visualizzata dal framework nel controllo barra dei colori.

color
[in] Colore selezionato inizialmente.

lpszAutoColor
[in] Etichetta di testo del pulsante di colore automatico (impostazione predefinita) o NULL.

L'etichetta standard per il pulsante automatico è Automatica.

lpszOtherColor
[in] Etichetta di testo dell'altro pulsante, che visualizza più scelte di colore o NULL.

L'etichetta standard per l'altro pulsante è More Colors....

lpszDocColors
[in] Etichetta di testo del pulsante colori documento. La tavolozza dei colori del documento elenca tutti i colori attualmente utilizzati dal documento.

lstDocColors
[in] Elenco di colori attualmente utilizzati dal documento.

nColumns
[in] Numero di colonne di cui dispone la matrice di colori.

nRowsDockHorz
[in] Numero di righe che la barra dei colori ha quando è ancorata orizzontalmente.

nColDockVert
[in] Numero di colonne che la barra dei colori ha quando è ancorata verticalmente.

colorAutomatic
[in] Colore predefinito applicato dal framework quando si fa clic sul pulsante automatico.

nCommandID
[in] ID comando del controllo della barra dei colori.

pParentBtn
[in] Puntatore a un pulsante padre.

src
[in] Oggetto esistente CMFCColorBar da copiare nel nuovo CMFCColorBar oggetto.

uiCommandID
[in] ID comando.

CMFCColorBar::ContextToSize

Calcola i margini verticali e orizzontali necessari per contenere i pulsanti nel controllo della barra dei colori e regola la posizione di tali pulsanti.

void ContextToSize(
    BOOL bSquareButtons = TRUE,
    BOOL bCenterButtons = TRUE);

Parametri

bSquareButtons
[in] TRUE per specificare che la forma dei pulsanti in un controllo barra dei colori è quadrata; in caso contrario, FALSE. Il valore predefinito è TRUE.

bCenterButtons
[in] TRUE per specificare che il contenuto sul viso di un pulsante di controllo della barra dei colori è centrato; in caso contrario, FALSE. Il valore predefinito è TRUE.

Osservazioni:

CMFCColorBar::Create

Crea una finestra di controllo della barra dei colori e la collega all'oggetto CMFCColorBar .

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle,
    UINT nID,
    CPalette* pPalette=NULL,
    int nColumns=0,
    int nRowsDockHorz=0,
    int nColDockVert=0);

Parametri

pParentWnd
[in] Puntatore alla finestra padre.

dwStyle
[in] Combinazione bit per bit (OR) degli stili di finestra.

nID
[in] ID comando.

pPalette
[in] Puntatore a una tavolozza di colori. Il valore predefinito è NULL.

nColumns
[in] Numero di colonne nel controllo barra dei colori. Il valore predefinito è 0.

nRowsDockHorz
[in] Numero di righe nel controllo barra dei colori quando è ancorato orizzontalmente. Il valore predefinito è 0.

nColDockVert
[in] Numero di colonne nel controllo barra dei colori quando è ancorato verticalmente. Il valore predefinito è 0.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario, FALSE.

Osservazioni:

Per costruire un CMFCColorBar oggetto, chiamare il costruttore della classe e quindi questo metodo. Il Create metodo crea il controllo Windows e inizializza un elenco di colori.

CMFCColorBar::CreateControl

Crea una finestra di controllo della barra dei colori, la collega all'oggetto CMFCColorBar e ridimensiona la finestra di controllo in modo da contenere la tavolozza dei colori specificata.

virtual BOOL CreateControl(
    CWnd* pParentWnd,
    const CRect& rect,
    UINT nID,
    int nColumns=-1,
    CPalette* pPalette=NULL);

Parametri

pParentWnd
[in] Puntatore alla finestra padre. Non può essere NULL.

rect
[in] Rettangolo di delimitazione che specifica dove disegnare il controllo barra dei colori.

nID
[in] ID del controllo.

nColumns
[in] Numero ideale di colonne nel controllo barra dei colori. Questo metodo modifica tale numero per adattarsi alla tavolozza dei colori specificata. Il valore predefinito è -1, il che significa che questo parametro non è specificato.

pPalette
[in] Puntatore a una tavolozza di colori o NULL. Se questo parametro è NULL, questo metodo calcola le dimensioni del controllo barra dei colori come se fossero stati specificati 20 colori. Il valore predefinito è NULL.

Valore restituito

TRUE se il metodo ha esito positivo; in caso contrario FALSE.

Osservazioni:

Questo metodo usa i parametri rect, nColumns e pPalette per calcolare il numero o le righe e le colonne appropriati nel controllo barra dei colori e quindi chiama il metodo CMFCColorBar::Create .

CMFCColorBar::CreatePalette

Inizializza una tavolozza con i colori in una matrice di colori specificata.

static BOOL CreatePalette(
    const CArray<COLORREF, COLORREF>& arColors,
    CPalette& palette);

Parametri

arColors
[in] Matrice di colori.

tavolozza
[in] Tavolozza dei colori.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario, FALSE.

CMFCColorBar::EnableAutomaticButton

Mostra o nasconde il pulsante automatico.

void EnableAutomaticButton(
    LPCTSTR lpszLabel,
    COLORREF colorAutomatic,
    BOOL bEnable=TRUE);

Parametri

lpszLabel
[in] Etichetta di testo del pulsante di colore automatico (impostazione predefinita) o NULL.

L'etichetta standard per il pulsante automatico è Automatica.

colorAutomatic
[in] Colore predefinito applicato dal framework quando si fa clic sul pulsante automatico.

bEnable
[in] TRUE per abilitare il pulsante automatico; FALSE per disabilitare il pulsante automatico. Il valore predefinito è TRUE.

Osservazioni:

L'etichetta di testo del pulsante automatico viene eliminata se il parametro lpszLabel è NULL o il parametro bEnable è FALSE.

CMFCColorBar::EnableOtherButton

Abilita o disabilita la visualizzazione di una finestra di dialogo che consente all'utente di selezionare più colori.

void EnableOtherButton(
    LPCTSTR lpszLabel,
    BOOL bAltColorDlg=TRUE,
    BOOL bEnable=TRUE);

Parametri

lpszLabel
[in] Etichetta di testo dell'altro pulsante, che visualizza più scelte di colore o NULL.

L'etichetta standard per questo pulsante è More Colors....

bAltColorDlg
[in] TRUE per visualizzare la finestra di dialogo CMFCColorDialog ; FALSE per visualizzare la finestra di dialogo standard CColorDialog . Il valore predefinito è TRUE.

bEnable
[in] TRUE per abilitare il pulsante; FALSE per disabilitare il pulsante. Il valore predefinito è TRUE.

CMFCColorBar::GetColor

Recupera il colore attualmente selezionato.

COLORREF GetColor() const;

Valore restituito

Colore attualmente selezionato.

CMFCColorBar::GetColorGridSize

Calcola il numero di righe e colonne nella griglia di un controllo barra dei colori.

CSize GetColorGridSize(BOOL bVertDock) const;

Parametri

bVertDock
[in] TRUE per eseguire il calcolo per un controllo barra dei colori ancorato verticalmente; in caso contrario, eseguire il calcolo per un controllo ancorato orizzontalmente.

Valore restituito

Oggetto CSize il cui cx componente contiene il numero di colonne e il cui cy componente contiene il numero di righe.

CMFCColorBar::GetCommandID

Recupera l'ID comando del controllo barra dei colori corrente.

UINT GetCommandID() const;

Valore restituito

ID comando.

Osservazioni:

Quando l'utente seleziona un nuovo colore, il framework invia l'ID comando in un messaggio di WM_COMMAND per notificare all'elemento padre dell'oggetto CMFCColorBar .

CMFCColorBar::GetExtraHeight

Calcola l'altezza aggiuntiva richiesta dalla barra dei colori corrente per visualizzare elementi dell'interfaccia utente vari, ad esempio il pulsante Altro o i colori del documento.

int GetExtraHeight(int nNumColumns) const;

Parametri

nNumColumns
[in] Se il controllo barra dei colori contiene colori documento, il numero di colonne da visualizzare nella griglia dei colori del documento. In caso contrario, questo valore non viene utilizzato.

Valore restituito

Altezza aggiuntiva calcolata necessaria.

CMFCColorBar::GetHighlightedColor

Recupera il colore che indica che un pulsante colore ha lo stato attivo; vale a dire, il pulsante è caldo.

COLORREF GetHighlightedColor() const;

Valore restituito

Valore RGB.

Osservazioni:

CMFCColorBar::GetHorzMargin

Recupera il margine orizzontale, ovvero lo spazio tra la cella di colore sinistra o destra e il limite dell'area client.

int GetHorzMargin();

Valore restituito

Margine orizzontale.

CMFCColorBar::GetVertMargin

Recupera il margine verticale, ovvero lo spazio tra la cella di colore superiore o inferiore e il limite dell'area client.

int GetVertMargin() const;

Valore restituito

Margine verticale.

CMFCColorBar::InitColors

Inizializza una matrice di colori con i colori in una tavolozza specificata o con la tavolozza predefinita del sistema.

static int InitColors(
    CPalette* pPalette,
    CArray<COLORREF, COLORREF>& arColors);

Parametri

pPalette
[in] Puntatore a un oggetto tavolozza o NULL. Se questo parametro è NULL, questo metodo usa la tavolozza predefinita del sistema operativo.

arColors
[in] Matrice di colori.

Valore restituito

Numero di elementi nella matrice di colori.

CMFCColorBar::IsTearOff

Indica se la barra dei colori corrente è ancorabile.

BOOL IsTearOff() const;

Valore restituito

TRUE se il controllo barra dei colori corrente è ancorabile; in caso contrario, FALSE.

Osservazioni:

Se il controllo barra dei colori è ancorabile, può essere strappato da una barra di controllo e ancorato in un'altra posizione.

CMFCColorBar::OnKey

Chiamato dal framework quando un utente preme un pulsante di tastiera.

virtual BOOL OnKey(UINT nChar);

Parametri

nChar
[in] Codice della chiave virtuale per il tasto premuto dall'utente.

Valore restituito

TRUE se questo metodo elabora la chiave specificata; in caso contrario, FALSE.

CMFCColorBar::OnSendCommand

Chiamato dal framework per chiudere una gerarchia di controlli popup.

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

Parametri

pButton
[in] Puntatore a un controllo che si trova su una barra degli strumenti.

Valore restituito

TRUE se questo metodo ha esito positivo; in caso contrario, FALSE.

CMFCColorBar::OnUpdateCmdUI

Chiamato dal framework per abilitare o disabilitare un elemento dell'interfaccia utente di un controllo barra dei colori prima che l'elemento venga visualizzato.

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

Parametri

pTarget
[in] Puntatore a una finestra contenente un elemento dell'interfaccia utente da aggiornare.

bDisableIfNoHndler
[in] TRUE per disabilitare l'elemento dell'interfaccia utente se non è definito alcun gestore in una mappa dei messaggi; in caso contrario, FALSE.

Osservazioni:

Quando un utente dell'applicazione fa clic su un elemento dell'interfaccia utente, l'elemento deve sapere se deve essere visualizzato come abilitato o disabilitato. La destinazione del messaggio di comando fornisce queste informazioni implementando un gestore di comandi ON_UPDATE_COMMAND_UI. Usare questo metodo per elaborare il comando. Per altre informazioni, vedere Classe CCmdUI.

CMFCColorBar::OpenColorDialog

Apre una finestra di dialogo colore.

virtual BOOL OpenColorDialog(
    const COLORREF colorDefault,
    COLORREF& colorRes);

Parametri

colorDefault
[in] Colore selezionato per impostazione predefinita quando si apre la finestra di dialogo colore.

colorRes
[out] Colore selezionato da un utente.

Valore restituito

TRUE se l'utente ha selezionato un colore; FALSE se l'utente ha annullato la finestra di dialogo colore.

Osservazioni:

CMFCColorBar::Rebuild

Ridisegna completamente il controllo barra dei colori.

virtual void Rebuild();

CMFCColorBar::SelectPalette

Imposta la tavolozza logica del contesto di dispositivo specificato sulla tavolozza del pulsante padre del controllo barra dei colori corrente.

CPalette* SelectPalette(CDC* pDC);

Parametri

pDC
[in] Puntatore al contesto del dispositivo del pulsante padre del controllo barra dei colori corrente.

Valore restituito

Puntatore alla tavolozza sostituita dalla tavolozza del pulsante padre del controllo barra dei colori corrente.

CMFCColorBar::SetColor

Imposta il colore attualmente selezionato.

void SetColor(COLORREF color);

Parametri

color
[in] Valore di colore RGB.

CMFCColorBar::SetColorName

Imposta un nuovo nome per un colore specificato.

static void SetColorName(
    COLORREF color,
    const CString& strName);

Parametri

color
[in] Valore RGB di un colore.

strName
[in] Nuovo nome per il colore specificato.

Osservazioni:

Questo metodo modifica il nome del colore specificato in tutti gli CMFCColorBar oggetti dell'applicazione.

CMFCColorBar::SetCommandID

Imposta un nuovo ID comando per un controllo barra dei colori.

void SetCommandID(UINT nCommandID);

Parametri

nCommandID
[in] ID comando.

Osservazioni:

Chiamare questo metodo per modificare l'ID comando di un controllo barra dei colori e per notificare alla finestra padre del controllo che l'ID è stato modificato.

CMFCColorBar::SetDocumentColors

Imposta l'elenco dei colori utilizzati nel documento corrente.

void SetDocumentColors(
    LPCTSTR lpszCaption,
    CList<COLORREF,COLORREF>& lstDocColors,
    BOOL bShowWhenDocked=FALSE);

Parametri

lpszCaption
[in] Didascalia visualizzata quando il controllo barra dei colori non è ancorato.

lstDocColors
[in] Elenco di colori che sostituisce i colori correnti del documento.

bShowWhenDocked
[in] TRUE per mostrare i colori del documento quando il controllo barra dei colori è ancorato; in caso contrario, FALSE. Il valore predefinito è FALSE.

Osservazioni:

I colori del documento sono i colori attualmente utilizzati in un documento. Il framework gestisce automaticamente un elenco di colori del documento, ma è possibile usare questo metodo per modificare l'elenco.

CMFCColorBar::SetHorzMargin

Imposta il margine orizzontale, ovvero lo spazio tra la cella di colore sinistra o destra e il limite dell'area client.

void SetHorzMargin(int nHorzMargin);

Parametri

nHorzMargin
[in] Margine orizzontale, in pixel.

Osservazioni:

Per impostazione predefinita, il costruttore CMFCColorBar::CMFCColorBar imposta il margine orizzontale su 4 pixel.

CMFCColorBar::SetPropList

Imposta il m_pWndPropList membro dati protetto sul puntatore specificato su un controllo griglia delle proprietà.

void SetPropList(CMFCPropertyGridCtrl* pWndList);

Parametri

pWndList
[in] Puntatore all'oggetto controllo griglia delle proprietà.

CMFCColorBar::SetVertMargin

Imposta il margine verticale, ovvero lo spazio tra la cella del colore superiore o inferiore e il limite dell'area client.

void SetVertMargin(int nVertMargin);

Parametri

nVertMargin
[in] Margine verticale, in pixel.

Osservazioni:

Per impostazione predefinita, il costruttore CMFCColorBar::CMFCColorBar imposta il margine verticale su 4 pixel.

CMFCColorBar::ShowCommandMessageString

Richiede alla finestra cornice proprietaria del controllo barra dei colori di aggiornare la riga del messaggio nella barra di stato.

virtual void ShowCommandMessageString(UINT uiCmdId);

Parametri

uiCmdId
[in] ID comando. Questo parametro viene ignorato.

Osservazioni:

Questo metodo invia il messaggio di WM_SETMESSAGESTRING al proprietario del controllo barra dei colori.

Vedi anche

Grafico della gerarchia
Classi