DynamicRenderer Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Zeichnet Freihandeingaben auf einer Oberfläche, während der Benutzer den Tablettstift verschiebt.
public ref class DynamicRenderer : System::Windows::Input::StylusPlugIns::StylusPlugIn
public class DynamicRenderer : System.Windows.Input.StylusPlugIns.StylusPlugIn
type DynamicRenderer = class
inherit StylusPlugIn
Public Class DynamicRenderer
Inherits StylusPlugIn
- Vererbung
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie eine DynamicRenderer Anfügen an ein InkPresenter. Informationen zum Erstellen eines Steuerelements, das Freihandhand dynamisch rendert, finden Sie unter Erstellen eines Freihandeingabesteuerelements.
// Create a DrawingAttributes to use for the
// DynamicRenderer.
DrawingAttributes inkDA = new DrawingAttributes();
inkDA.Width = 5;
inkDA.Height = 5;
inkDA.Color = Colors.Purple;
// Add a dynamic renderer plugin that
// draws ink as it "flows" from the stylus
DynamicRenderer dynamicRenderer1 = new DynamicRenderer();
dynamicRenderer1.DrawingAttributes = inkDA;
this.StylusPlugIns.Add(dynamicRenderer1);
inkPresenter1.AttachVisuals(dynamicRenderer1.RootVisual,
dynamicRenderer1.DrawingAttributes);
' Create a DrawingAttributes to use for the
' DynamicRenderer.
Dim inkDA As New DrawingAttributes()
inkDA.Width = 5
inkDA.Height = 5
inkDA.Color = Colors.Purple
' Add a dynamic renderer plugin that
' draws ink as it "flows" from the stylus
Dim dynamicRenderer1 As New DynamicRenderer()
dynamicRenderer1.DrawingAttributes = inkDA
Me.StylusPlugIns.Add(dynamicRenderer1)
inkPresenter1.AttachVisuals(dynamicRenderer1.RootVisual, dynamicRenderer1.DrawingAttributes)
Hinweise
Die DynamicRenderer Klasse erbt von der StylusPlugIn Klasse, und ermöglicht es Freihand, auf eine Oberfläche zu gerendert werden, da der Benutzer den Mauszeiger mit einem Tablet-Stift oder einem anderen Zeigergerät bewegt. Sie können das DynamicRenderer dynamische Rendern von Freihand auf einem benutzerdefinierten Steuerelement verwenden oder von diesem erben DynamicRenderer , um benutzerdefiniertes Rendering in Echtzeit auf einem freihandfähigen Element auszuführen, z. B. das InkCanvas.
Dynamisches Rendering erfolgt auf einem Thread, der vom Benutzeroberflächenthread der Anwendung getrennt ist, wenn der Benutzer Freihandeingaben mit einem Tablet-Stift eingibt. Wenn eine Maus verwendet wird, wird das dynamische Rendering im UI-Thread ausgeführt.
Hinweis
Um auf diese Klasse als XAML-Element zu verweisen, müssen Sie den System.Windows.Input.StylusPlugIns CLR-Namespace einem Präfix zuordnen und dieses Präfix verwenden, um das DynamicRenderer Element zu qualifizieren. Ausführliche Informationen finden Sie unter XAML-Namespaces und Namespacezuordnung für WPF XAML.
XAML-Textverwendung
Diese Klasse wird in XAML in der Regel nicht verwendet.
Konstruktoren
DynamicRenderer() |
Initialisiert eine neue Instanz der DynamicRenderer-Klasse. |
Eigenschaften
DrawingAttributes |
Ruft die DrawingAttributes ab, die die Darstellung des Freihandrenderings angeben, oder legt diese fest. |
Element |
Ruft das UIElement ab, an das das StylusPlugIn angefügt ist. (Geerbt von StylusPlugIn) |
ElementBounds |
Ruft die zwischengespeicherten Grenzen des Elements ab. (Geerbt von StylusPlugIn) |
Enabled |
Ruft ab oder legt fest, ob das StylusPlugIn aktiv ist. (Geerbt von StylusPlugIn) |
IsActiveForInput |
Ruft ab, ob das StylusPlugIn Eingaben akzeptieren kann. (Geerbt von StylusPlugIn) |
RootVisual |
Ruft das visuelle Stammelement für den DynamicRenderer ab. |
Methoden
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
GetDispatcher() |
Gibt einen Dispatcher für den Rendering-Thread zurück. |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
OnAdded() |
Tritt auf, wenn der DynamicRenderer einem Element hinzugefügt wird. |
OnDraw(DrawingContext, StylusPointCollection, Geometry, Brush) |
Zeichnet die Freihandeingabe in Echtzeit, sodass diese scheinbar aus dem Tablettstift oder einem anderen Zeigegerät "fließt". |
OnDrawingAttributesReplaced() |
Tritt ein, wenn sich die DrawingAttributes-Eigenschaft ändert. |
OnEnabledChanged() |
Tritt ein, wenn sich die Enabled-Eigenschaft ändert. |
OnIsActiveForInputChanged() |
Tritt ein, wenn sich die IsActiveForInput-Eigenschaft ändert. |
OnRemoved() |
Tritt ein, wenn das StylusPlugIn aus einem Element entfernt wird. |
OnStylusDown(RawStylusInput) |
Tritt in einem Thread im Stiftthreadpool auf, wenn der Tablettstift den Digitizer berührt. |
OnStylusDownProcessed(Object, Boolean) |
Tritt im UI-Thread (User Interface, Benutzeroberfläche) der Anwendung auf, wenn der Tablettstift den Digitizer berührt. |
OnStylusEnter(RawStylusInput, Boolean) |
Tritt in einem Stiftthread auf, wenn der Cursor in die Grenzen eines Elements eintritt. |
OnStylusLeave(RawStylusInput, Boolean) |
Tritt in einem Stiftthread auf, wenn der Cursor die Grenzen eines Elements verlässt. |
OnStylusMove(RawStylusInput) |
Tritt in einem Stiftthread auf, wenn der Tablettstift auf dem Digitizer bewegt wird. |
OnStylusMoveProcessed(Object, Boolean) |
Tritt im UI-Thread (User Interface, Benutzeroberfläche) der Anwendung auf, wenn der Tablettstift auf dem Digitizer bewegt wird. (Geerbt von StylusPlugIn) |
OnStylusUp(RawStylusInput) |
Tritt in einem Stiftthread auf, wenn der Benutzer den Tablettstift vom Digitizer abhebt. |
OnStylusUpProcessed(Object, Boolean) |
Tritt im UI-Thread (User Interface, Benutzeroberfläche) der Anwendung auf, wenn der Benutzer den Tablettstift vom Digitizer abhebt. |
Reset(StylusDevice, StylusPointCollection) |
Löscht das Rendering des aktuellen Strichs und zeichnet diesen neu. |
ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |