Classe di CUserToolsManager
Mantiene la raccolta di oggetti Classe di 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 |
---|---|
Costruisce un oggetto CUserToolsManager. |
Metodi pubblici
Nome |
Descrizione |
---|---|
Crea un nuovo strumento utente. |
|
Restituisce il puntatore all'oggetto CMFCUserTool associato a un ID di comando |
|
Restituisce l'id della risorsa associato al menu argomenti nella scheda Strumenti la finestra di dialogo Personalizza. |
|
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. |
|
Restituisce il filtro di file nella finestra di dialogo Apri file (Classe di CFileDialog) utilizza nel campo Comando nella scheda Strumenti la finestra di dialogo Personalizza. |
|
Restituisce l'id della risorsa associato al menu directory iniziale nella scheda Strumenti la finestra di dialogo Personalizza. |
|
Restituisce il numero massimo degli strumenti dell'utente che possono essere allocati nell'applicazione. |
|
Restituisce l'id di comando segnaposto della voce di menu per gli strumenti dell'utente. |
|
Restituisce un riferimento all'elenco degli strumenti dell'utente. |
|
Esegue un'applicazione associata allo strumento dell'utente con un ID di comando |
|
Determina se un ID di comando associato a uno strumento dell'utente. |
|
Carica le informazioni sugli strumenti dell'utente da Windows Registro di sistema. |
|
Sposta lo strumento specificato dell'utente nell'elenco degli strumenti dell'utente. |
|
Sposta lo strumento utente specificato nell'elenco degli strumenti dell'utente. |
|
Rimuove lo strumento utente specificato dall'applicazione. |
|
Archivia le informazioni sugli strumenti dell'utente in Windows Registro di sistema. |
|
Specifica l'estensione predefinita che la finestra di dialogo Apri file (Classe di CFileDialog) utilizza nel campo Comando nella scheda Strumenti la finestra di dialogo Personalizza. |
|
Specifica il filtro di file nella finestra di dialogo Apri file (Classe di 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"));
}
Gerarchia di ereditarietà
Requisiti
intestazione: afxusertoolsmanager.h