Classe CContextMenuManager

Articolo
06/10/2015

L'oggetto CContextMenuManager gestisce i menu di scelta rapida, anche noti come i menu di scelta rapida.

class CContextMenuManager : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
CContextMenuManager::CContextMenuManager	Costruisce un oggetto CContextMenuManager.
CContextMenuManager::~CContextMenuManager	Distruttore

Metodi pubblici

Nome	Descrizione
CContextMenuManager::AddMenu	Aggiunge un nuovo menu di scelta rapida.
CContextMenuManager::GetMenuById	Restituisce un handle al menu associato all'ID delle risorse
CContextMenuManager::GetMenuByName	Restituisce un handle al menu che corrisponde al nome del menu fornito.
CContextMenuManager::GetMenuNames	Restituisce un elenco di nomi di menu.
CContextMenuManager::LoadState	Carica i menu di scelta rapida archiviati in Windows Registro di sistema.
CContextMenuManager::ResetState	Rimuove i menu di scelta rapida dal menu di scelta rapida.
CContextMenuManager::SaveState	Salva i menu di scelta rapida a Windows Registro di sistema.
CContextMenuManager::SetDontCloseActiveMenu	Controlla se CContextMenuManager chiude il menu di scelta rapida attivo quando viene illustrato un nuovo menu di scelta rapida.
CContextMenuManager::ShowPopupMenu	Visualizzare il menu di scelta rapida specificato.
CContextMenuManager::TrackPopupMenu	Visualizzare il menu di scelta rapida specificato. Restituisce l'indice del comando di menu.

Note

CContextMenuManager gestisce i menu di scelta rapida e verificare che abbia un aspetto coerente.

Non è necessario creare un oggetto CContextMenuManager manualmente. Il framework dell'applicazione crea l'oggetto CContextMenuManager. Tuttavia, è necessario chiamare CWinAppEx::InitContextMenuManager quando l'applicazione viene inizializzata. Dopo aver inizializzato l'amministratore di contesto, utilizzare il metodo CWinAppEx::GetContextMenuManager per ottenere un puntatore all'amministratore di contesto per l'applicazione.

È possibile creare menu di scelta rapida in runtime chiamando AddMenu. Se si desidera visualizzare il menu senza prima ricevere l'input dell'utente, chiamare ShowPopupMenu. TrackPopupMenu viene utilizzato quando si desidera creare un menu e attendere input. TrackPopupMenu restituisce l'indice del comando o di 0 selezionato se l'utente rilasciato senza selezionato alcun elemento.

CContextMenuManager è possibile salvare e caricare lo stato su Windows Registro di sistema.

Esempio

Il seguente esempio viene illustrato come aggiungere un menu a un oggetto CContextMenuManager e quanto non chiudere il menu di scelta rapida attivo quando l'oggetto CContextMenuManager visualizzato un nuovo menu di scelta rapida. Questo frammento di codice fa parte Esempio personalizzato delle pagine.

   // The GetContextMenuManager method is inherited from the CWinAppEx class.
    GetContextMenuManager()->AddMenu (_T("My menu"), IDR_CONTEXT_MENU);
    GetContextMenuManager()->SetDontCloseActiveMenu(true);