CUserToolsManager-Klasse

Artikel
06/10/2015

Behält die Auflistung von CUserTool-Klasse-Objekten in einer Anwendung zu. Ein Benutzertool ist ein Menüelement, das eine externe Anwendung ausführt. Das Objekt CUserToolsManager können Benutzer oder den Entwickler, um neue Benutzertools der Anwendung hinzuzufügen. Sie unterstützt die Ausführung der Befehle, die mit Benutzertools zugeordnet werden, und es werden außerdem Informationen über Benutzertools in der Windows-Registrierung.

class CUserToolsManager : public CObject

Mitglieder

Öffentliche Konstruktoren

Name	Description
CUserToolsManager::CUserToolsManager	Erstellt einen CUserToolsManager.

Öffentliche Methoden

Name	Description
CUserToolsManager::CreateNewTool	Stellt ein neues Benutzertool erstellt.
CUserToolsManager::FindTool	Gibt den Zeiger auf das CMFCUserTool-Objekt zurück, das einer angegebenen Befehl ID zugeordnet ist
CUserToolsManager::GetArgumentsMenuID	Gibt die ID der Ressource zurück, das mit dem Menü Argumente auf der Registerkarte des Dialogfelds ToolsAnpassen zugeordnet ist.
CUserToolsManager::GetDefExt	Gibt die standardmäßige Erweiterung zurück, die das Datei öffnen (Dialogfeld CFileDialog::CFileDialog) auf dem Feld Befehl auf der Registerkarte des Dialogfelds ToolsAnpassen verwendet.
CUserToolsManager::GetFilter	Gibt den Dateifilter zurück, den das Datei öffnen (Dialogfeld CFileDialog-Klasse) auf dem Feld Befehl auf der Registerkarte des Dialogfelds ToolsAnpassen verwendet.
CUserToolsManager::GetInitialDirMenuID	Gibt die ID der Ressource zurück, das mit dem Menü Ausgangsverzeichnis auf der Registerkarte des Dialogfelds ToolsAnpassen zugeordnet ist.
CUserToolsManager::GetMaxTools	Gibt die maximale Anzahl von Benutzertools zurück, die in der Anwendung zugeordnet werden können.
CUserToolsManager::GetToolsEntryCmd	Gibt die Befehls-ID des Menüelementplatzhalters für Benutzertools zurück.
CUserToolsManager::GetUserTools	Gibt einen Verweis auf die Liste der Benutzertools zurück.
CUserToolsManager::InvokeTool	Führt eine Anwendung aus, die dem Benutzertool zugeordnet, das eine angegebene Befehl ID besitzt
CUserToolsManager::IsUserToolCmd	Bestimmt, ob eine Befehls-ID mit einem Benutzertool zugeordnet ist.
CUserToolsManager::LoadState	Lädt Informationen über Benutzertools aus der Windows-Registrierung.
CUserToolsManager::MoveToolDown	Verschiebt das angegebene Benutzertool unten in der Liste der Benutzertools.
CUserToolsManager::MoveToolUp	Verschiebt das angegebene Benutzertool oben in der Liste der Benutzertools.
CUserToolsManager::RemoveTool	Entfernt das angegebene Benutzertool von der Anwendung.
CUserToolsManager::SaveState	Speichert Informationen über Benutzertools in der Windows-Registrierung.
CUserToolsManager::SetDefExt	Gibt die standardmäßige Erweiterung an, die das Datei öffnen (Dialogfeld CFileDialog-Klasse) auf dem Feld Befehl auf der Registerkarte des Dialogfelds ToolsAnpassen verwendet.
CUserToolsManager::SetFilter	Gibt den Dateifilter an, den das Datei öffnen (Dialogfeld CFileDialog-Klasse) auf dem Feld Befehl auf der Registerkarte des Dialogfelds ToolsAnpassen verwendet.

Hinweise

So Benutzertools in eine Anwendung integrieren, müssen Sie:

1. Reservieren Sie ein Menüelement und eine zugeordnete Befehls-ID für einen Benutzertool-Menüeintrag.

2. Reservieren Sie eine sequenzielle Befehls-ID für jedes Benutzertool, das der Benutzer in der Anwendung definieren kann.

3. Rufen Sie die CWinAppEx::EnableUserTools-Methode auf und geben Sie die folgenden Parameter: Menübefehl ID, Benutzertoolbefehls-id erste und letzte Benutzertoolbefehl ID

Es sollte nur ein globales Objekt CUserToolsManager pro Anwendung geben.

Ein Beispiel für die Benutzertools, finden Sie das VisualStudioDemo-Beispiel zu projizieren.

Beispiel

Das folgende Beispiel zeigt, wie ein Verweis auf ein CUserToolsManager-Objekt abgerufen wird und wie neue Benutzertools erstellt wird. Dieser Codeausschnitt ist Teil Visual Studio-Demobeispiel.

   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"));
    }