Classe CMFCToolBarMenuButton

Pulsante della barra degli strumenti contenente un menu di scelta rapida. Per altri dettagli, vedere il codice sorgente che si trova nella cartella VC\atlmfc\src\mfc dell'installazione di Visual Studio.

Sintassi

class CMFCToolBarMenuButton : public CMFCToolBarButton

Membri

Costruttori pubblici

Nome Descrizione
CMFCToolBarMenuButton::CMFCToolBarMenuButton Costruisce un oggetto CMFCToolBarMenuButton.

Metodi pubblici

Nome Descrizione
CMFCToolBarMenuButton::CompareWith Confronta questa istanza con l'oggetto fornito CMFCToolBarButton . (sostituzioni )CMFCToolBarButton::CompareWith.
CMFCToolBarMenuButton::CopyFrom Copia le proprietà di un altro pulsante della barra degli strumenti nel pulsante corrente. (sostituzioni )CMFCToolBarButton::CopyFrom.
CMFCToolBarMenuButton::CreateFromMenu Inizializza il menu della barra degli strumenti da un handle di menu di Windows.
CMFCToolBarMenuButton::CreateMenu Crea un menu di Windows costituito dai comandi nel menu della barra degli strumenti. Restituisce un handle al menu di Windows.
CMFCToolBarMenuButton::CreatePopupMenu Crea un oggetto menu a comparsa ( classe CMFCPopupMenu) per visualizzare il menu della barra degli strumenti.
CMFCToolBarMenuButton::EnableQuickCustomize
CMFCToolBarMenuButton::GetCommands Consente l'accesso in sola lettura all'elenco dei comandi nel menu della barra degli strumenti.
CMFCToolBarMenuButton::GetImageRect Recupera il rettangolo di delimitazione per l'immagine del pulsante.
CMFCToolBarMenuButton::GetPaletteRows Restituisce il numero di righe nel menu a comparsa quando il menu è in modalità tavolozza.
CMFCToolBarMenuButton::GetPopupMenu Restituisce un puntatore all'oggetto menu a comparsa associato al pulsante.
CMFCToolBarMenuButton::HasButton
CMFCToolBarMenuButton::HaveHotBorder Determina se un bordo del pulsante viene visualizzato quando un utente seleziona il pulsante. (sostituzioni )CMFCToolBarButton::HaveHotBorder.
CMFCToolBarMenuButton::IsBorder
CMFCToolBarMenuButton::IsClickedOnMenu
CMFCToolBarMenuButton::IsDroppedDown Determina se viene visualizzato il menu a comparsa.
CMFCToolBarMenuButton::IsEmptyMenuAllowed Chiamato dal framework per determinare se un utente può aprire un sottomenu dalla voce di menu selezionata.
CMFCToolBarMenuButton::IsExclusive Determina se il pulsante è in modalità esclusiva, ovvero se il menu a comparsa rimane aperto anche quando l'utente sposta il puntatore su un'altra barra degli strumenti o pulsante.
CMFCToolBarMenuButton::IsMenuPaletteMode Determina se il menu a comparsa è in modalità tavolozza.
CMFCToolBarMenuButton::IsQuickMode
CMFCToolBarMenuButton::IsTearOffMenu Determina se il menu a comparsa dispone di una barra di disinstallazione.
CMFCToolBarMenuButton::OnAfterCreatePopupMenu
CMFCToolBarMenuButton::OnBeforeDrag Specifica se il pulsante può essere trascinato. (sostituzioni )CMFCToolBarButton::OnBeforeDrag.
CMFCToolBarMenuButton::OnCalculateSize Chiamato dal framework per calcolare le dimensioni del pulsante per il contesto di dispositivo e lo stato di ancoraggio specificati. (sostituzioni )CMFCToolBarButton::OnCalculateSize.
CMFCToolBarMenuButton::OnCancelMode Chiamato dal framework per gestire il messaggio di WM_CANCELMODE . (sostituzioni )CMFCToolBarButton::OnCancelMode.
CMFCToolBarMenuButton::OnChangeParentWnd Chiamato dal framework quando il pulsante viene inserito in una nuova barra degli strumenti. (sostituzioni )CMFCToolBarButton::OnChangeParentWnd.
CMFCToolBarMenuButton::OnClick Chiamato dal framework quando l'utente fa clic sul pulsante del mouse. (sostituzioni )CMFCToolBarButton::OnClick.
CMFCToolBarMenuButton::OnClickMenuItem Chiamato dal framework quando l'utente seleziona un elemento nel menu a comparsa.
CMFCToolBarMenuButton::OnContextHelp Chiamato dal framework quando la barra degli strumenti padre gestisce un messaggio di WM_HELPHITTEST. (sostituzioni )CMFCToolBarButton::OnContextHelp.
CMFCToolBarMenuButton::OnDraw Chiamato dal framework per disegnare il pulsante usando gli stili e le opzioni specificati. (sostituzioni )CMFCToolBarButton::OnDraw.
CMFCToolBarMenuButton::OnDrawOnCustomizeList Chiamato dal framework per disegnare il pulsante nel riquadro Comandi della finestra di dialogo Personalizza . (sostituzioni )CMFCToolBarButton::OnDrawOnCustomizeList.
CMFCToolBarMenuButton::OpenPopupMenu Chiamato dal framework quando l'utente apre il menu a comparsa.
CMFCToolBarMenuButton::ResetImageToDefault Imposta sul valore predefinito l'immagine associata al pulsante. (sostituzioni )CMFCToolBarButton::ResetImageToDefault.
CMFCToolBarMenuButton::SaveBarState Salva lo stato del pulsante della barra degli strumenti. (sostituzioni )CMFCToolBarButton::SaveBarState.
CMFCToolBarMenuButton::Serialize Legge questo oggetto da un archivio o lo scrive in un archivio. (sostituzioni )CMFCToolBarButton::Serialize.
CMFCToolBarMenuButton::SetACCData Popola l'oggetto fornito CAccessibilityData con i dati di accessibilità dal pulsante della barra degli strumenti. (sostituzioni )CMFCToolBarButton::SetACCData.
CMFCToolBarMenuButton::SetMenuOnly Specifica se il pulsante può essere aggiunto a una barra degli strumenti.
CMFCToolBarMenuButton::SetMenuPaletteMode Specifica se il menu a comparsa è in modalità tavolozza.
CMFCToolBarMenuButton::SetMessageWnd
CMFCToolBarMenuButton::SetRadio Forza il pulsante del menu della barra degli strumenti per visualizzare un'icona che indica che è selezionata.
CMFCToolBarMenuButton::SetTearOff Specifica un ID barra di disinstallazione per il menu a comparsa.

Metodi protetti

Nome Descrizione
CMFCToolBarMenuButton::D rawDocumentIcon Disegna un'icona sul pulsante del menu.

Membri dei dati

Nome Descrizione
CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw Se TRUE, il framework chiama sempre CFrameWndEx::OnDrawMenuImage quando viene disegnato un pulsante.

Osservazioni:

Un CMFCToolBarMenuButton oggetto può essere visualizzato come menu, una voce di menu con un sottomenu, un pulsante che esegue un comando o visualizza un menu o un pulsante che visualizza solo un menu. È possibile determinare il comportamento e l'aspetto del pulsante di menu specificando parametri quali l'immagine, il testo, l'handle di menu e l'ID comando associati al pulsante nel costruttore CMFCToolbarMenuButton::CMFCToolbarMenuButton.

Una classe personalizzata derivata dalla CMFCToolbarMenuButton classe deve utilizzare la macro DECLARE_SERIAL . La macro DECLARE_DYNCREATE genera un errore alla chiusura dell'applicazione.

Esempio

Nell'esempio seguente viene illustrato come configurare un CMFCToolBarMenuButton oggetto . Il codice illustra come specificare che il menu a discesa è in modalità tavolozza e specificare l'ID per la barra di rimozione creata quando l'utente trascina il pulsante di menu all'esterno di una barra dei menu. Questo frammento di codice fa parte dell' esempio di Word Pad.

pBorderType->SetMenuPaletteMode(TRUE, 2 /* Rows number */);
pBorderType->SetTearOff(ID_BORDER_TEAROFF);

Gerarchia di ereditarietà

CObject

CMFCToolBarButton

CMFCToolBarMenuButton

Requisiti

Intestazione: afxtoolbarmenubutton.h

CMFCToolBarMenuButton::CMFCToolBarMenuButton

Costruisce un oggetto CMFCToolBarMenuButton.

CMFCToolBarMenuButton();
CMFCToolBarMenuButton(const CMFCToolBarMenuButton& src);

CMFCToolBarMenuButton(
    UINT uiID,
    HMENU hMenu,
    int iImage,
    LPCTSTR lpszText=NULL,
    BOOL bUserButton=FALSE);

Parametri

src
[in] Oggetto esistente CMFCToolBarMenuButton da copiare in questo CMFCToolBarMenuButton oggetto.

uiID
[in] ID del comando da eseguire quando un utente fa clic sul pulsante; o (UINT)-1 per un pulsante di menu che non esegue direttamente un comando.

hMenu
[in] Handle di un menu; o NULL se il pulsante non dispone di un menu.

iImage
[in] Indice dell'immagine per il pulsante; oppure -1 se questo pulsante non ha un'icona o usa l'icona per il comando specificato da uiID. L'indice è lo stesso per ogni CMFCToolBarImages oggetto nell'applicazione.

lpszText
[in] Testo del pulsante del menu della barra degli strumenti.

bUserButton
[in] TRUE se il pulsante visualizza un'immagine definita dall'utente; FALSE se il pulsante visualizza un'immagine predefinita associata al comando specificato da uiID.

Osservazioni:

Se uiID è un ID comando valido, il pulsante esegue tale comando quando l'utente lo fa clic. Se hMenu è un handle di menu valido, il pulsante fornisce un menu a discesa quando viene visualizzato in una barra degli strumenti o in un sottomenu quando viene visualizzato in un menu. Se sia uiID che hMenu sono validi, il pulsante è un pulsante di divisione con una parte che eseguirà il comando quando l'utente fa clic su di esso e una parte con una freccia giù che riporterà a discesa un menu quando l'utente fa clic su di esso. Tuttavia, se hMenu è valido, un utente non sarà in grado di fare clic sul pulsante per eseguire un comando quando il pulsante viene inserito in un menu.

Esempio

Nell'esempio seguente viene illustrato come costruire un oggetto della CMFCToolBarMenuButton classe . Questo frammento di codice fa parte dell' esempio di Word Pad.

CMFCToolBarMenuButton *pBorderType = new CMFCToolBarMenuButton(ID_BORDER_1, pPopup->GetSafeHmenu(),
                                                               GetCmdMgr()->GetCmdImage(ID_BORDER_1, FALSE),
                                                               _T("Borders"));

CMFCToolBarMenuButton::CompareWith

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

Parametri

[in] Altro

Valore restituito

Osservazioni:

CMFCToolBarMenuButton::CopyFrom

virtual void CopyFrom(const CMFCToolBarButton& src);

Parametri

[in] Src

Osservazioni:

CMFCToolBarMenuButton::CreateFromMenu

Inizializza il menu della barra degli strumenti da un handle di menu di Windows.

virtual void CreateFromMenu(HMENU hMenu);

Parametri

hMenu
[in] Handle di un menu.

Osservazioni:

Un pulsante del menu della barra degli strumenti può visualizzare un sottomenu a discesa.

Il framework chiama questo metodo per inizializzare i comandi nel sottomenu da un menu.

CMFCToolBarMenuButton::CreateMenu

Crea un menu costituito dai comandi nel menu della barra degli strumenti. Restituisce un handle al menu.

virtual HMENU CreateMenu() const;

Valore restituito

Handle del menu in caso di esito positivo. NULL se l'elenco dei comandi associati al pulsante di menu della barra degli strumenti è vuoto.

Osservazioni:

È possibile eseguire l'override di questo metodo in una classe derivata per personalizzare la modalità di generazione del menu.

CMFCToolBarMenuButton::CreatePopupMenu

Crea un CMFCPopupMenu oggetto per visualizzare il menu della barra degli strumenti.

virtual CMFCPopupMenu* CreatePopupMenu();

Valore restituito

Puntatore a un CMFCPopupMenu oggetto che visualizza il menu a discesa associato al pulsante di menu della barra degli strumenti.

Osservazioni:

Questo metodo viene chiamato dal framework per preparare la visualizzazione del menu a discesa associato al pulsante.

L'implementazione predefinita costruisce e restituisce un nuovo CMFCPopupMenu oggetto. Eseguire l'override di questo metodo se si desidera utilizzare un tipo derivato della classe CMFCPopupMenu o per eseguire un'inizializzazione aggiuntiva.

CMFCToolBarMenuButton::D rawDocumentIcon

Disegna un'icona del documento sul pulsante di menu.

void DrawDocumentIcon(
    CDC* pDC,
    const CRect& rectImage,
    HICON hIcon);

Parametri

pDC
[in] Puntatore al contesto del dispositivo.

rectImage
[in] Coordinate del rettangolo di delimitazione dell'immagine.

hIcon
[in] Handle per l'icona.

Osservazioni:

Questo metodo accetta un'icona del documento e la disegna sul pulsante del menu, allineata al centro nell'area specificata da rectImage.

CMFCToolBarMenuButton::EnableQuickCustomize

void EnableQuickCustomize();

Osservazioni:

CMFCToolBarMenuButton::HasButton

virtual BOOL HasButton() const;

Valore restituito

Osservazioni:

CMFCToolBarMenuButton::HaveHotBorder

virtual BOOL HaveHotBorder() const;

Valore restituito

Osservazioni:

CMFCToolBarMenuButton::IsBorder

virtual BOOL IsBorder() const;

Valore restituito

Osservazioni:

CMFCToolBarMenuButton::IsClickedOnMenu

BOOL IsClickedOnMenu() const;

Valore restituito

Osservazioni:

CMFCToolBarMenuButton::IsQuickMode

BOOL IsQuickMode();

Valore restituito

Osservazioni:

CMFCToolBarMenuButton::GetCommands

Consente l'accesso in sola lettura all'elenco dei comandi nel menu della barra degli strumenti.

const CObList& GetCommands() const;

Valore restituito

Riferimento const a un oggetto Classe CObList che contiene un insieme di oggetti CMFCToolBarButton Class .

Osservazioni:

Un pulsante di menu della barra degli strumenti può visualizzare un sottomenu. È possibile specificare l'elenco dei comandi nel sottomenu nel costruttore o in CMFCToolBarMenuButton::CreateFromMenu come handle a un menu (HMENU). Il menu viene convertito in un elenco di oggetti derivati dalla classe CMFCToolBarButton e archiviati nell'oggetto interno CObList . È possibile accedere a questo elenco chiamando questo metodo.

CMFCToolBarMenuButton::GetImageRect

Recupera il rettangolo di delimitazione per l'immagine del pulsante.

void GetImageRect(CRect& rectImage);

Parametri

rectImage
[out] Riferimento a un CRect oggetto che riceve le coordinate del rettangolo di delimitazione dell'immagine.

CMFCToolBarMenuButton::GetPaletteRows

Restituisce il numero di righe nel menu a discesa quando il menu è in modalità tavolozza.

int GetPaletteRows() const;

Valore restituito

Numero di righe nella tavolozza.

Osservazioni:

Quando il pulsante di menu è impostato sulla modalità tavolozza, le voci di menu verranno visualizzate in più colonne con solo un numero limitato di righe. Chiamare questo metodo per ottenere il numero di righe. È possibile abilitare o disabilitare la modalità tavolozza e specificare il numero di righe usando CMFCToolBarMenuButton::SetMenuPaletteMode.

CMFCToolBarMenuButton::GetPopupMenu

Restituisce un puntatore all'oggetto Classe CMFCPopupMenu che rappresenta il menu a discesa del pulsante.

CMFCPopupMenu* GetPopupMenu() const;

Valore restituito

Puntatore a un oggetto Classe CMFCPopupMenu creato quando il framework ha disegnato il sottomenu del pulsante di menu della barra degli strumenti; NULL se non viene visualizzato alcun sottomenu.

Osservazioni:

Quando un pulsante del menu della barra degli strumenti visualizza un menu a discesa, il pulsante crea un oggetto Classe CMFCPopupMenu per rappresentare il menu. Chiamare questo metodo per ottenere un puntatore all'oggetto CMFCPopupMenu . Non archiviare il puntatore restituito, perché è temporaneo e diventa non valido quando l'utente chiude il menu a discesa.

CMFCToolBarMenuButton::IsDroppedDown

Indica se il menu a comparsa è attualmente visualizzato.

virtual BOOL IsDroppedDown() const;

Valore restituito

TRUE se il pulsante del menu della barra degli strumenti visualizza il relativo sottomenu; in caso contrario FALSE.

CMFCToolBarMenuButton::IsEmptyMenuAllowed

Specifica se le voci di menu mostrano sottomenu vuoti.

virtual BOOL IsEmptyMenuAllowed() const;

Valore restituito

TRUE se il framework apre un sottomenu dalla voce di menu attualmente selezionata anche quando il sottomenu è vuoto; in caso contrario FALSE.

Osservazioni:

Il framework chiama questo metodo quando un utente tenta di aprire il sottomenu dalla voce di menu attualmente selezionata. Se il sottomenu è vuoto e IsEmptyMenuAllowed restituisce FALSE, il sottomenu non verrà aperto.

L'implementazione predefinita restituisce FALSE. Eseguire l'override di questo metodo per personalizzare questo comportamento.

CMFCToolBarMenuButton::IsExclusive

Indica se il pulsante è in modalità esclusiva.

virtual BOOL IsExclusive() const;

Valore restituito

TRUE se il pulsante funziona in modalità esclusiva; in caso contrario FALSE.

Osservazioni:

Quando un utente apre un menu popup per un pulsante e quindi sposta il puntatore del mouse su un'altra barra degli strumenti o pulsante di menu, il menu popup si chiude a meno che il pulsante non sia in modalità esclusiva.

L'implementazione predefinita restituisce sempre FALSE. Eseguire l'override di questo metodo in una classe derivata se si vuole attivare la modalità esclusiva.

CMFCToolBarMenuButton::IsMenuPaletteMode

Determina se il menu a discesa è in modalità tavolozza.

BOOL IsMenuPaletteMode() const;

Valore restituito

TRUE se la modalità tavolozza è abilitata; in caso contrario, FALSE.

Osservazioni:

Quando il pulsante di menu è impostato sulla modalità tavolozza, le voci di menu vengono visualizzate in più colonne con un numero limitato di righe. Chiamare questo metodo per ottenere il numero di righe. È possibile abilitare o disabilitare la modalità tavolozza chiamando CMFCToolBarMenuButton::SetMenuPaletteMode.

CMFCToolBarMenuButton::IsTearOffMenu

Indica se il menu a discesa ha una barra di rimozione.

virtual BOOL IsTearOffMenu() const;

Valore restituito

TRUE se il pulsante del menu della barra degli strumenti dispone di una barra di disinstallazione; in caso contrario FALSE.

Osservazioni:

Per abilitare la funzionalità di disinstallazione e impostare l'ID barra di disinstallazione, chiamare CMFCToolBarMenuButton::SetTearOff.

CMFCToolBarMenuButton::m_bAlwaysCallOwnerDraw

Specifica se il framework chiama sempre CFrameWndEx::OnDrawMenuImage quando viene disegnato un pulsante.

static BOOL m_bAlwaysCallOwnerDraw;

Osservazioni:

Quando questa variabile membro è impostata su TRUE, il pulsante chiama sempre il metodo CFrameWndEx::OnDrawMenuImage per visualizzare l'immagine sul pulsante. Se m_bAlwaysCallOwnerDraw è FALSE, il pulsante stesso disegna l'immagine se l'immagine è predefinita. In caso contrario, chiama OnDrawMenuImage.

CMFCToolBarMenuButton::OnAfterCreatePopupMenu

virtual void OnAfterCreatePopupMenu();

Osservazioni:

CMFCToolBarMenuButton::OnBeforeDrag

virtual BOOL OnBeforeDrag() const;

Valore restituito

Osservazioni:

CMFCToolBarMenuButton::OnCalculateSize

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Parametri

[in] pDC
[in] sizeDefault
[in] bHorz

Valore restituito

Osservazioni:

CMFCToolBarMenuButton::OnCancelMode

virtual void OnCancelMode();

Osservazioni:

CMFCToolBarMenuButton::OnChangeParentWnd

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parametri

[in] pWndParent

Osservazioni:

CMFCToolBarMenuButton::OnClick

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay = TRUE);

Parametri

[in] pWnd
[in] bDelay

Valore restituito

Osservazioni:

CMFCToolBarMenuButton::OnClickMenuItem

Chiamato dal framework quando l'utente seleziona un elemento nel menu a discesa.

virtual BOOL OnClickMenuItem();

Valore restituito

FALSE se il framework deve continuare l'elaborazione delle voci di menu predefinite; in caso contrario TRUE. L'implementazione predefinita restituisce sempre FALSE.

Osservazioni:

Quando l'utente fa clic su una voce di menu, il framework esegue un comando associato a tale elemento.

Per personalizzare l'elaborazione delle voci di menu, eseguire l'override OnClickMenuItem in una classe derivata dalla CMFCToolBarMenuButton classe . È inoltre necessario eseguire l'override di CFrameWndEx::OnShowPopupMenu e sostituire i pulsanti di menu che richiedono un'elaborazione speciale con istanze della classe derivata.

CMFCToolBarMenuButton::OnContextHelp

virtual BOOL OnContextHelp(CWnd* pWnd);

Parametri

[in] pWnd

Valore restituito

Osservazioni:

CMFCToolBarMenuButton::OnDraw

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz = TRUE,
    BOOL bCustomizeMode = FALSE,
    BOOL bHighlight = FALSE,
    BOOL bDrawBorder = TRUE,
    BOOL bGrayDisabledButtons = TRUE);

Parametri

[in] pDC
[in] rect
[in] pImages
[in] bHorz
[in] bCustomizeMode
[in] bHighlight
[in] bDrawBorder
[in] bGrayDisabledButtons

Osservazioni:

CMFCToolBarMenuButton::OnDrawOnCustomizeList

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Parametri

[in] pDC
[in] rect
[in] bSelected

Valore restituito

Osservazioni:

CMFCToolBarMenuButton::OpenPopupMenu

Chiamato dal framework quando l'utente apre il menu a discesa di un pulsante di menu della barra degli strumenti.

virtual BOOL OpenPopupMenu(CWnd* pWnd=NULL);

Parametri

pWnd
[in] Specifica la finestra che riceve i comandi di menu a discesa. Può essere NULL solo se il pulsante del menu della barra degli strumenti ha una finestra padre.

Valore restituito

TRUE quando un oggetto classe CMFCPopupMenu è stato creato e aperto correttamente; in caso contrario, FALSE.

Osservazioni:

Questa funzione viene chiamata dal framework quando l'utente apre un menu a discesa da un pulsante di menu della barra degli strumenti.

CMFCToolBarMenuButton::ResetImageToDefault

virtual void ResetImageToDefault();

Osservazioni:

CMFCToolBarMenuButton::SaveBarState

virtual void SaveBarState();

Osservazioni:

Il framework chiama questo metodo quando crea un pulsante della barra degli strumenti come risultato di un'operazione di trascinamento della selezione. Questo metodo chiama il metodo CMFCPopupMenu::SaveState del menu a comparsa di primo livello, che determina la ricreazione del menu a comparsa del pulsante padre del menu a comparsa.

CMFCToolBarMenuButton::Serialize

virtual void Serialize(CArchive& ar);

Parametri

[in] ar

Osservazioni:

CMFCToolBarMenuButton::SetACCData

Imposta i dati di accessibilità per l'elemento della barra multifunzione.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parametri

pParent
Finestra padre per l'elemento della barra multifunzione.

data
Dati di accessibilità per l'elemento della barra multifunzione.

Valore restituito

Restituisce sempre TRUE.

Osservazioni:

Per impostazione predefinita, questo metodo imposta i dati di accessibilità per l'elemento della barra multifunzione e restituisce sempre TRUE. Eseguire l'override di questo metodo per impostare i dati di accessibilità e restituire un valore che indica l'esito positivo o negativo.

CMFCToolBarMenuButton::SetMenuOnly

Specifica se il pulsante viene disegnato come pulsante di menu o un pulsante di divisione quando ha sia un ID di comando valido che un sottomenu.

void SetMenuOnly(BOOL bMenuOnly);

Parametri

bMenuOnly
[in] TRUE per visualizzare questo pulsante come pulsante di menu quando ha sia un ID comando valido che un sottomenu, FALSE per visualizzare questo pulsante come pulsante di divisione quando ha sia un ID di comando valido che un sottomenu.

Osservazioni:

In genere, quando un pulsante del menu della barra degli strumenti ha sia un sottomenu che un ID comando, il menu sembra essere un pulsante di divisione con un pulsante principale e un pulsante freccia giù associato. Se si chiama questo metodo e bMenuOnly è TRUE, il pulsante sembra invece essere un singolo pulsante di menu con una freccia giù nel pulsante. Quando l'utente fa clic sulla freccia in entrambe le modalità, viene aperto il sottomenu e quando l'utente fa clic sulla parte non freccia del pulsante in entrambe le modalità, il framework esegue il comando .

CMFCToolBarMenuButton::SetMenuPaletteMode

Specifica se il menu a discesa è in modalità tavolozza.

void SetMenuPaletteMode(
    BOOL bMenuPaletteMode=TRUE,
    int nPaletteRows=1);

Parametri

bMenuPaletteMode
[in] Specifica se il menu a discesa è in modalità tavolozza.

nPaletteRows
[in] Numero di righe nella tavolozza.

Osservazioni:

Nella modalità tavolozza, tutte le voci di menu vengono visualizzate come tavolozza a più colonne. Specificare il numero di righe usando nPaletteRows.

CMFCToolBarMenuButton::SetMessageWnd

void SetMessageWnd(CWnd* pWndMessage);

Parametri

[in] pWndMessage

Osservazioni:

CMFCToolBarMenuButton::SetRadio

Imposta il pulsante di menu della barra degli strumenti per visualizzare un'icona di stile del pulsante di opzione quando è selezionata.

virtual void SetRadio();

Osservazioni:

Quando il pulsante di menu viene disegnato mentre è selezionato, chiama CMFCVisualManager::OnDrawMenuCheck per disegnare un'icona del segno di spunta. Per impostazione predefinita, OnDrawMenuCheck richiede che il gestore visivo corrente disegni un segno di spunta stile casella di controllo sul pulsante di menu. Dopo aver chiamato questo metodo, il gestore visivo corrente disegna invece un segno di spunta dello stile del pulsante di opzione sul pulsante di menu. Questa modifica non può essere annullata.

Quando si chiama questo metodo e il pulsante di menu è attualmente visualizzato, verrà aggiornato.

CMFCToolBarMenuButton::SetTearOff

Specifica l'ID della barra di rimozione per il menu a discesa.

virtual void SetTearOff(UINT uiBarID);

Parametri

uiBarID
[in] Specifica un nuovo ID barra di disinstallazione.

Osservazioni:

Chiamare questo metodo per specificare l'ID per la barra di disinstallazione creata quando l'utente trascina il pulsante di menu dalla barra dei menu. Se il parametro uiBarID è 0, l'utente non può rimuovere il pulsante di menu.

Chiama CWinAppEx::EnableTearOffMenus per abilitare la funzionalità di menu di disinstallazione nell'applicazione.

Vedi anche

Grafico della gerarchia
Classi
Classe CMFCToolBarButton
Classe CMFCToolBar
Classe CMFCPopupMenu