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 Freihand auf einer Oberfläche, während der Benutzer den Tablet-Stift bewegt.
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 sie eine an eine DynamicRenderer .InkPresenter Informationen zum Erstellen eines Steuerelements, das Freihand 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 das Rendern von Freihand auf eine Oberfläche, während der Benutzer den Mauszeiger mit einem Tablet-Stift oder einem anderen Zeigegerät bewegt. Sie können die DynamicRenderer Freihandeingabe in einem benutzerdefinierten Steuerelement dynamisch rendern oder erben DynamicRenderer , um benutzerdefiniertes Rendering in Echtzeit für ein freihandfähiges Element auszuführen, z. B. das InkCanvas.
Das dynamische 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, erfolgt das dynamische Rendering im UI-Thread.
Note
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 der Regel nicht in XAML verwendet.
Konstruktoren
| Name | Beschreibung |
|---|---|
| DynamicRenderer() |
Initialisiert eine neue Instanz der DynamicRenderer-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| DrawingAttributes |
Dient zum Abrufen oder Festlegen der Eigenschaft, die DrawingAttributes das Erscheinungsbild der gerenderten Freihandeingabe angibt. |
| Element |
Ruft ab UIElement , an den die StylusPlugIn angefügte Datei angefügt ist. (Geerbt von StylusPlugIn) |
| ElementBounds |
Ruft die zwischengespeicherten Grenzen des Elements ab. (Geerbt von StylusPlugIn) |
| Enabled |
Ruft ab oder legt fest, ob die StylusPlugIn Aktiv ist. (Geerbt von StylusPlugIn) |
| IsActiveForInput |
Ruft ab, ob die StylusPlugIn Eingabe akzeptiert werden kann. (Geerbt von StylusPlugIn) |
| RootVisual |
Ruft das Stammvisual für die DynamicRenderer. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetDispatcher() |
Gibt einen Dispatcher Wert für den Renderingthread zurück. |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| OnAdded() |
Tritt auf, wenn das DynamicRenderer Element einem Element hinzugefügt wird. |
| OnDraw(DrawingContext, StylusPointCollection, Geometry, Brush) |
Zeichnet die Freihandfarbe in Echtzeit, sodass sie vom Tablet-Stift oder einem anderen Zeigegerät "fließen" scheint. |
| OnDrawingAttributesReplaced() |
Tritt auf, wenn sich die DrawingAttributes Eigenschaft ändert. |
| OnEnabledChanged() |
Tritt auf, wenn sich die Enabled Eigenschaft ändert. |
| OnIsActiveForInputChanged() |
Tritt auf, wenn sich die IsActiveForInput Eigenschaft ändert. |
| OnRemoved() |
Tritt auf, wenn das StylusPlugIn Element aus einem Element entfernt wird. |
| OnStylusDown(RawStylusInput) |
Tritt auf einem Thread im Stiftthreadpool auf, wenn der Tabletstift den Digitalisierungsgerät berührt. |
| OnStylusDownProcessed(Object, Boolean) |
Tritt auf dem Ui-Thread der Anwendung (Benutzeroberfläche) auf, wenn der Tabletstift den Digitalisierungsgerät berührt. |
| OnStylusEnter(RawStylusInput, Boolean) |
Tritt auf einem Stiftthread auf, wenn der Cursor die Grenzen eines Elements eingibt. |
| OnStylusLeave(RawStylusInput, Boolean) |
Tritt auf einem Stiftthread auf, wenn der Cursor die Grenzen eines Elements verlässt. |
| OnStylusMove(RawStylusInput) |
Tritt auf einem Stiftthread auf, wenn der Tablet-Stift auf dem Digitalisierungsgerät bewegt wird. |
| OnStylusMoveProcessed(Object, Boolean) |
Tritt auf dem Ui-Thread der Anwendung (Benutzeroberfläche) auf, wenn der Tablet-Stift auf dem Digitalisierungsgerät bewegt wird. (Geerbt von StylusPlugIn) |
| OnStylusUp(RawStylusInput) |
Tritt auf einem Stiftthread auf, wenn der Benutzer den Tabletstift vom Digitalisierungsgerät aufhebt. |
| OnStylusUpProcessed(Object, Boolean) |
Tritt auf dem Ui-Thread der Anwendung (Benutzeroberfläche) auf, wenn der Benutzer den Tablet-Stift vom Digitalisierungsgerät aufhebt. |
| Reset(StylusDevice, StylusPointCollection) |
Löscht das Rendern auf dem aktuellen Strich und löscht es neu. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |