CUserTool-Klasse

Artikel
02/26/2013

Ein Benutzertool ist ein Menüelement, das eine externe Anwendung ausführt.Die Registerkarte Tools des Dialogfelds Anpassen (CMFCToolBarsCustomizeDialog-Klasse) ermöglicht es dem Benutzer, um Benutzertools hinzuzufügen, und den Namen, den Befehl, die Argumente und das Initialenverzeichnis für jedes Benutzertool anzugeben.

class CUserTool : public CObject

Mitglieder

Öffentliche Methoden

Name	Description
CUserTool::CopyIconToClipboard
CUserTool::DrawToolIcon	Zeichnet das Benutzertoolsymbol in einem angegebenen Rechteck.
CUserTool::GetCommand	Gibt eine Zeichenfolge zurück, die den Text des Befehls enthält, der mit dem Benutzertool zugeordnet ist.
CUserTool::GetCommandId	Gibt die Befehls-ID des Menüelements des Benutzertools zurück.
CUserTool::Invoke	Führt den Befehl aus, der der Benutzertool zugeordnet ist.
CUserTool::Serialize	Liest oder Schreiben dieses Objekt von oder einem Archiv.(Überschreibungen CObject::Serialize.)
CUserTool::SetCommand	Legt den Befehl fest, der mit dem Benutzertool zugeordnet ist.
CUserTool::SetToolIcon	Lädt das Symbol für das Benutzertool von der Anwendung, die mit dem Tool zugeordnet ist.

Geschützte Methoden

Name	Description
CUserTool::LoadDefaultIcon	Lädt das Standardsymbol für ein Benutzertool.

Datenmember

Name	Description
CUserTool::m_strArguments	Die Befehlszeilenargumente für das Benutzertool.
CUserTool::m_strInitialDirectory	Das Ausgangsverzeichnis für das Benutzertool.
CUserTool::m_strLabel	Der Toolname, der im Menüelement für das Tool angezeigt wird.

Hinweise

Weitere Informationen dazu, wie Sie Benutzertools in der Anwendung, finden Sie unter CUserToolsManager-Klasse aktiviert.

Beispiel

Das folgende Beispiel zeigt, wie ein Tool aus einem CUserToolsManager-Objekt erstellt wird, dann die m_strLabel-Membervariablen fest und für die Anwendung fest, die das Benutzertool ausführt.Dieser Codeausschnitt ist Teil Visual Studio-Demobeispiel.

        // CUserToolsManager* pUserToolsManager
        CUserTool* pTool1 = pUserToolsManager->CreateNewTool();
        pTool1->m_strLabel = _T("&Notepad");
        pTool1->SetCommand(_T("notepad.exe"));