Share via


Tool-Klasse

Stellt ein Tool dar, das den Modus des Designers bestimmt.

Vererbungshierarchie

System.Object
  Microsoft.Windows.Design.ContextItem
    Microsoft.Windows.Design.Interaction.Tool
      Microsoft.Windows.Design.Interaction.CreationTool
      Microsoft.Windows.Design.Interaction.SelectionTool

Namespace:  Microsoft.Windows.Design.Interaction
Assembly:  Microsoft.Windows.Design.Interaction (in Microsoft.Windows.Design.Interaction.dll)

Syntax

'Declaration
Public Class Tool _
    Inherits ContextItem
public class Tool : ContextItem
public ref class Tool : public ContextItem
type Tool =  
    class
        inherit ContextItem
    end
public class Tool extends ContextItem

Der Tool-Typ macht die folgenden Member verfügbar.

Konstruktoren

  Name Beschreibung
Öffentliche Methode Tool Initialisiert eine neue Instanz der Tool-Klasse.

Zum Seitenanfang

Eigenschaften

  Name Beschreibung
Geschützte Eigenschaft Context Ruft den Bearbeitungskontext für Code innerhalb des Tools ab.
Öffentliche Eigenschaft Cursor Ruft den Standardcursor für die Maus ab oder legt ihn fest.
Öffentliche Eigenschaft FocusedTask Ruft die gerade fokussierte Aufgabe ab (sofern vorhanden).
Öffentliche Eigenschaft ItemType Ruft den Typ des Tools ab. (Überschreibt ContextItem.ItemType.)
Öffentliche Eigenschaft Tasks Ruft den Satz von Aufgaben ab, den dieses Tool bereitstellt.

Zum Seitenanfang

Methoden

  Name Beschreibung
Öffentliche Methode Equals Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte Methode Finalize Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche Methode GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte Methode MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte Methode OnActivate Wird aufgerufen, wenn ein Tool aktiviert wird.
Geschützte Methode OnDeactivate Wird aufgerufen, wenn ein Tool deaktiviert wird.
Geschützte Methode OnItemChanged Fügt der Tool-Klasse Aktivierungs- und Deaktivierungssemantik hinzu. (Überschreibt ContextItem.OnItemChanged(EditingContext, ContextItem).)
Öffentliche Methode ToString Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Hinweise

Alle Benutzereingaben fließen durch das gerade aktive Tool. Um ein Tool zu aktivieren, legen Sie es in der ContextItemManager-Klasse des Bearbeitungskontexts fest. Sie können auch Änderungsbenachrichtigungen im ContextItemManager verarbeiten, um zu wissen, wenn sich das aktive Tool ändert. Wenn die Benutzereingabe die Designeransicht erreicht, sucht die Designeransicht das aktive Tool im Bearbeitungskontext und fordert die Auflösung der Benutzereingabe in eine Befehlsbindung an. Anschließend wird die resultierende Befehlsbindung aufgerufen.

Ein Tool besteht aus einer Auflistung von Aufgaben, die durch die Task-Klasse dargestellt werden. Jede Aufgabe enthält eine Auflistung von Befehlen, die aufgerufen werden können, und eine Auflistung von Eingabebindungen, die diese Befehle aktivieren. Tools verwenden möglicherweise auch Treffertestlogik, um von Adornern angebotene Aufgaben zu ermitteln.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

Microsoft.Windows.Design.Interaction-Namespace

Weitere Ressourcen

Toolarchitektur

Erweiterbare Architektur des WPF-Designers