Classe CUserToolsManager

Articolo
06/10/2015

Mantiene la raccolta di oggetti Classe CUserTool in un'applicazione. Uno strumento dell'utente è una voce di menu che esegue un'applicazione esterna. L'oggetto CUserToolsManager consente all'utente o allo sviluppatore di aggiungere nuovi strumenti dell'applicazione. Supporta l'esecuzione di controlli associati agli strumenti dell'utente e salva le informazioni sugli strumenti dell'utente in Windows Registro di sistema.

class CUserToolsManager : public CObject

Membri

Costruttori pubblici

Nome	Descrizione
CUserToolsManager::CUserToolsManager	Costruisce un oggetto CUserToolsManager.

Metodi pubblici

Nome	Descrizione
CUserToolsManager::CreateNewTool	Crea un nuovo strumento utente.
CUserToolsManager::FindTool	Restituisce il puntatore all'oggetto CMFCUserTool associato a un ID di comando
CUserToolsManager::GetArgumentsMenuID	Restituisce l'id della risorsa associato al menu argomenti nella scheda Strumenti la finestra di dialogo Personalizza.
CUserToolsManager::GetDefExt	Restituisce l'estensione predefinita che la finestra di dialogo Apri file (CFileDialog::CFileDialog) utilizza nel campo Comando nella scheda Strumenti la finestra di dialogo Personalizza.
CUserToolsManager::GetFilter	Restituisce il filtro di file nella finestra di dialogo Apri file (Classe CFileDialog) utilizza nel campo Comando nella scheda Strumenti la finestra di dialogo Personalizza.
CUserToolsManager::GetInitialDirMenuID	Restituisce l'id della risorsa associato al menu directory iniziale nella scheda Strumenti la finestra di dialogo Personalizza.
CUserToolsManager::GetMaxTools	Restituisce il numero massimo degli strumenti dell'utente che possono essere allocati nell'applicazione.
CUserToolsManager::GetToolsEntryCmd	Restituisce l'id di comando segnaposto della voce di menu per gli strumenti dell'utente.
CUserToolsManager::GetUserTools	Restituisce un riferimento all'elenco degli strumenti dell'utente.
CUserToolsManager::InvokeTool	Esegue un'applicazione associata allo strumento dell'utente con un ID di comando
CUserToolsManager::IsUserToolCmd	Determina se un ID di comando associato a uno strumento dell'utente.
CUserToolsManager::LoadState	Carica le informazioni sugli strumenti dell'utente da Windows Registro di sistema.
CUserToolsManager::MoveToolDown	Sposta lo strumento specificato dell'utente nell'elenco degli strumenti dell'utente.
CUserToolsManager::MoveToolUp	Sposta lo strumento utente specificato nell'elenco degli strumenti dell'utente.
CUserToolsManager::RemoveTool	Rimuove lo strumento utente specificato dall'applicazione.
CUserToolsManager::SaveState	Archivia le informazioni sugli strumenti dell'utente in Windows Registro di sistema.
CUserToolsManager::SetDefExt	Specifica l'estensione predefinita che la finestra di dialogo Apri file (Classe CFileDialog) utilizza nel campo Comando nella scheda Strumenti la finestra di dialogo Personalizza.
CUserToolsManager::SetFilter	Specifica il filtro di file nella finestra di dialogo Apri file (Classe CFileDialog) utilizza nel campo Comando nella scheda Strumenti la finestra di dialogo Personalizza.

Note

Per incorporare gli strumenti utente nell'applicazione, è necessario:

1. Riservare una voce di menu e un ID di comando collegato a una voce di menu dello strumento dell'utente.

2. Riservare un ID di comando sequenziale a ogni strumento dell'utente che un utente può definire nell'applicazione.

3. Chiamare il metodo CWinAppEx::EnableUserTools e forniscono i seguenti parametri: comando di menu ID, primo ID di comandi di strumenti dell'utente e ultima ID di comandi di strumenti dell'utente

Deve essere un solo oggetto globale CUserToolsManager per l'applicazione.

Per un esempio degli strumenti dell'utente, vedere progetto di esempio VisualStudioDemo.

Esempio

Nell'esempio seguente viene illustrato come recuperare un riferimento a un oggetto CUserToolsManager e come creare nuovi strumenti dell'utente. Questo frammento di codice fa parte Esempio demo di Visual Studio.

 CUserToolsManager* pUserToolsManager = theApp.GetUserToolsManager();
    if (pUserToolsManager != NULL && pUserToolsManager->GetUserTools().IsEmpty())
    {
        // CUserToolsManager* pUserToolsManager
        CUserTool* pTool1 = pUserToolsManager->CreateNewTool();
        pTool1->m_strLabel = _T("&Notepad");
        pTool1->SetCommand(_T("notepad.exe"));

        CUserTool* pTool2 = pUserToolsManager->CreateNewTool();
        pTool2->m_strLabel = _T("Paint &Brush");
        pTool2->SetCommand(_T("mspaint.exe"));

        CUserTool* pTool3 = pUserToolsManager->CreateNewTool();
        pTool3->m_strLabel = _T("&Windows Explorer");
        pTool3->SetCommand(_T("explorer.exe"));

        CUserTool* pTool4 = pUserToolsManager->CreateNewTool();
        pTool4->m_strLabel = _T("Microsoft On-&Line");
        pTool4->SetCommand(_T("https://www.microsoft.com"));
    }