DynamicRenderer DynamicRenderer DynamicRenderer DynamicRenderer Class

Definition

Zeichnet Freihandeingaben auf einer Oberfläche, während der Benutzer den Tablettstift verschiebt.Draws ink on a surface as the user moves the tablet pen.

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
DynamicRendererDynamicRendererDynamicRendererDynamicRenderer

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein DynamicRenderer an einen InkPresenterangefügt wird.The following example demonstrates how to attach a DynamicRenderer to an InkPresenter. Informationen zum Erstellen eines Steuer Elements, das frei Hand Eingaben dynamisch rendert, finden Sie unter Creating an Ink Input ControlTo create a control that dynamically renders ink, see Creating an Ink Input Control.

// 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 das Rendern von frei Hand Eingaben auf einer Oberfläche, wenn der Benutzer den Mauszeiger mit einem Tablettstift oder einem anderen Zeigegerät verschiebt.The DynamicRenderer class inherits from the StylusPlugIn class, and allows ink to be rendered to a surface as the user moves the mouse pointer with a tablet pen or other pointing device. Sie können das DynamicRenderer verwenden, um frei Hand Eingaben auf einem benutzerdefinierten Steuer InkCanvasElement zu DynamicRenderer rendern, oder von erben, um ein benutzerdefiniertes Rendering in Echtzeit für ein frei Hand fähiges Element, wie z. b. auszuführen.You can use the DynamicRenderer to dynamically render ink on a custom control, or inherit from DynamicRenderer to perform custom rendering in real time on an ink-enabled element, such as the InkCanvas.

Das dynamische Rendering erfolgt in einem Thread, der vom Benutzeroberflächen Thread der Anwendung getrennt ist, wenn der Benutzer frei Hand Eingaben mit einem Tablettstift eingibt.Dynamic rendering is done on a thread separate from the application's user interface thread when the user inputs ink with a tablet pen. Wenn eine Maus verwendet wird, erfolgt das dynamische Rendering im UI-Thread.When a mouse is used, dynamic rendering is done on the UI thread.

Hinweis

Um auf diese Klasse als XAMLXAML -Element zu verweisen, müssen Sie den System.Windows.Input.StylusPlugIns CLR-Namespace einem Präfix zuordnen und dieses Präfix verwenden, um DynamicRenderer das Element zu qualifizieren.In order to reference this class as a XAMLXAML element, you must map the System.Windows.Input.StylusPlugIns CLR namespace to a prefix, and use that prefix to qualify the DynamicRenderer element. Weitere Informationen finden Sie unter XAML-Namespaces und Namespace Zuordnung für WPF-XAML.For details, see XAML Namespaces and Namespace Mapping for WPF XAML.

Verwendung von XAML-TextXAML Text Usage

Diese Klasse wird in der Regel nicht in XAML verwendet.This class is not typically used in XAML.

Konstruktoren

DynamicRenderer() DynamicRenderer() DynamicRenderer() DynamicRenderer()

Initialisiert eine neue Instanz der DynamicRenderer-Klasse.Initializes a new instance of the DynamicRenderer class.

Eigenschaften

DrawingAttributes DrawingAttributes DrawingAttributes DrawingAttributes

Ruft die DrawingAttributes ab, die die Darstellung des Freihandrenderings angeben, oder legt diese fest.Gets or sets the DrawingAttributes that specifies the appearance of the rendered ink.

Element Element Element Element

Ruft das UIElement ab, an das das StylusPlugIn angefügt ist.Gets the UIElement to which the StylusPlugIn is attached.

(Inherited from StylusPlugIn)
ElementBounds ElementBounds ElementBounds ElementBounds

Ruft die zwischengespeicherten Grenzen des Elements ab.Gets the cached bounds of the element.

(Inherited from StylusPlugIn)
Enabled Enabled Enabled Enabled

Ruft ab oder legt fest, ob das StylusPlugIn aktiv ist.Gets or sets whether the StylusPlugIn is active.

(Inherited from StylusPlugIn)
IsActiveForInput IsActiveForInput IsActiveForInput IsActiveForInput

Ruft ab, ob das StylusPlugIn Eingaben akzeptieren kann.Gets whether the StylusPlugIn is able to accept input.

(Inherited from StylusPlugIn)
RootVisual RootVisual RootVisual RootVisual

Ruft das visuelle Stammelement für den DynamicRenderer ab.Gets the root visual for the DynamicRenderer.

Methoden

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetDispatcher() GetDispatcher() GetDispatcher() GetDispatcher()

Gibt einen Dispatcher für den Rendering-Thread zurück.Returns a Dispatcher for the rendering thread.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnAdded() OnAdded() OnAdded() OnAdded()

Tritt auf, wenn der DynamicRenderer einem Element hinzugefügt wird.Occurs when the DynamicRenderer is added to an element.

OnDraw(DrawingContext, StylusPointCollection, Geometry, Brush) OnDraw(DrawingContext, StylusPointCollection, Geometry, Brush) OnDraw(DrawingContext, StylusPointCollection, Geometry, Brush) OnDraw(DrawingContext, StylusPointCollection, Geometry, Brush)

Zeichnet die Freihandeingabe in Echtzeit, sodass diese scheinbar aus dem Tablettstift oder einem anderen Zeigegerät "fließt".Draws the ink in real-time so it appears to "flow" from the tablet pen or other pointing device.

OnDrawingAttributesReplaced() OnDrawingAttributesReplaced() OnDrawingAttributesReplaced() OnDrawingAttributesReplaced()

Tritt ein, wenn sich die DrawingAttributes-Eigenschaft ändert.Occurs when the DrawingAttributes property changes.

OnEnabledChanged() OnEnabledChanged() OnEnabledChanged() OnEnabledChanged()

Tritt ein, wenn sich die Enabled-Eigenschaft ändert.Occurs when the Enabled property changes.

OnIsActiveForInputChanged() OnIsActiveForInputChanged() OnIsActiveForInputChanged() OnIsActiveForInputChanged()

Tritt ein, wenn sich die IsActiveForInput-Eigenschaft ändert.Occurs when the IsActiveForInput property changes.

OnRemoved() OnRemoved() OnRemoved() OnRemoved()

Tritt ein, wenn das StylusPlugIn aus einem Element entfernt wird.Occurs when the StylusPlugIn is removed from an element.

OnStylusDown(RawStylusInput) OnStylusDown(RawStylusInput) OnStylusDown(RawStylusInput) OnStylusDown(RawStylusInput)

Tritt in einem Thread im Stiftthreadpool auf, wenn der Tablettstift den Digitizer berührt.Occurs on a thread in the pen thread pool when the tablet pen touches the digitizer.

OnStylusDownProcessed(Object, Boolean) OnStylusDownProcessed(Object, Boolean) OnStylusDownProcessed(Object, Boolean) OnStylusDownProcessed(Object, Boolean)

Tritt im UI-Thread (User Interface, Benutzeroberfläche) der Anwendung auf, wenn der Tablettstift den Digitizer berührt.Occurs on the application UI (user interface) thread when the tablet pen touches the digitizer.

OnStylusEnter(RawStylusInput, Boolean) OnStylusEnter(RawStylusInput, Boolean) OnStylusEnter(RawStylusInput, Boolean) OnStylusEnter(RawStylusInput, Boolean)

Tritt in einem Stiftthread auf, wenn der Cursor in die Grenzen eines Elements eintritt.Occurs on a pen thread when the cursor enters the bounds of an element.

OnStylusLeave(RawStylusInput, Boolean) OnStylusLeave(RawStylusInput, Boolean) OnStylusLeave(RawStylusInput, Boolean) OnStylusLeave(RawStylusInput, Boolean)

Tritt in einem Stiftthread auf, wenn der Cursor die Grenzen eines Elements verlässt.Occurs on a pen thread when the cursor leaves the bounds of an element.

OnStylusMove(RawStylusInput) OnStylusMove(RawStylusInput) OnStylusMove(RawStylusInput) OnStylusMove(RawStylusInput)

Tritt in einem Stiftthread auf, wenn der Tablettstift auf dem Digitizer bewegt wird.Occurs on a pen thread when the tablet pen moves on the digitizer.

OnStylusMoveProcessed(Object, Boolean) OnStylusMoveProcessed(Object, Boolean) OnStylusMoveProcessed(Object, Boolean) OnStylusMoveProcessed(Object, Boolean)

Tritt im UI-Thread (User Interface, Benutzeroberfläche) der Anwendung auf, wenn der Tablettstift auf dem Digitizer bewegt wird.Occurs on the application UI (user interface) thread when the tablet pen moves on the digitizer.

(Inherited from StylusPlugIn)
OnStylusUp(RawStylusInput) OnStylusUp(RawStylusInput) OnStylusUp(RawStylusInput) OnStylusUp(RawStylusInput)

Tritt in einem Stiftthread auf, wenn der Benutzer den Tablettstift vom Digitizer abhebt.Occurs on a pen thread when the user lifts the tablet pen from the digitizer.

OnStylusUpProcessed(Object, Boolean) OnStylusUpProcessed(Object, Boolean) OnStylusUpProcessed(Object, Boolean) OnStylusUpProcessed(Object, Boolean)

Tritt im UI-Thread (User Interface, Benutzeroberfläche) der Anwendung auf, wenn der Benutzer den Tablettstift vom Digitizer abhebt.Occurs on the application UI (user interface) thread when the user lifts the tablet pen from the digitizer.

Reset(StylusDevice, StylusPointCollection) Reset(StylusDevice, StylusPointCollection) Reset(StylusDevice, StylusPointCollection) Reset(StylusDevice, StylusPointCollection)

Löscht das Rendering des aktuellen Strichs und zeichnet diesen neu.Clears rendering on the current stroke and redraws it.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für: