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_edizione Standard RIAL. 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à
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; FAL edizione Standard 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 uiIDche 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; altrimenti FAL edizione Standard.
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; altrimenti FAL edizione Standard.
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 FAL edizione Standard, il sottomenu non verrà aperto.
L'implementazione predefinita restituisce FAL edizione Standard. 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; altrimenti FAL edizione Standard.
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 FAL edizione Standard. 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, FAL edizione Standard.
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; altrimenti FAL edizione Standard.
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. Quando m_bAlwaysCallOwnerDraw è FAL edizione Standard, il pulsante 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
FAL edizione Standard se il framework deve continuare l'elaborazione della voce di menu predefinita; in caso contrario, TRUE. L'implementazione predefinita restituisce sempre FAL edizione Standard.
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, FAL edizione Standard.
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, FAL edizione Standard per visualizzare questo pulsante come pulsante di divisione quando ha sia un ID 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
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per