InkDrawingAttributes Klasse

Definition

Namespace:

Windows.UI.Input.Inking

Stellt Eigenschaften bereit, die der Zeichnung einer InkStroke zugeordnet sind.

public ref class InkDrawingAttributes sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class InkDrawingAttributes final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class InkDrawingAttributes

function InkDrawingAttributes()

Public NotInheritable Class InkDrawingAttributes

Vererbung

Object Platform::Object IInspectable InkDrawingAttributes

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein Standardzeichnungsattribut für alle Striche festgelegt wird, die von einem InkManager-Objekt (inkManager) verwaltet werden.

// Create the InkManager instance.
Windows.UI.Input.Inking.InkManager inkManager = 
  new Windows.UI.Input.Inking.InkManager();
Windows.UI.Input.Inking.InkDrawingAttributes drawingAttributes = 
  new Windows.UI.Input.Inking.InkDrawingAttributes();
// True is the Default value for fitToCurve.
drawingAttributes.FitToCurve = false;
// Set color to red (default is black).
drawingAttributes.Color = Windows.UI.Colors.CornflowerBlue;
inkManager.SetDefaultDrawingAttributes(drawingAttributes);

Im folgenden Beispiel wird veranschaulicht, wie ein Zeichnungsattribut für einen bestimmten Strich festgelegt wird.

Hinweis

Sie können die DrawingAttributes-Eigenschaft des Strichs nicht direkt festlegen. Sie müssen eine Kopie der InkDrawingAttributes des Strichs erstellen, die gewünschten Werte für dieses InkDrawingAttributes-Objekt festlegen und dann die neuen InkDrawingAttributes den DrawingAttributes der Striche zuweisen, wie hier gezeigt.

// Get the InkStroke objects.
IReadOnlyList<InkStroke> inkStrokes = inkManager.GetStrokes();
Windows.UI.Input.Inking.InkStroke cloneStroke = 
  inkStrokes.GetAt(index).Clone();
Windows.UI.Input.Inking.InkDrawingAttributes drawingAttributes = 
  cloneStroke.DrawingAttributes;
drawingAttributes.PenTip = Windows.UI.Input.Inking.PenTipShape.Rectangle;
cloneStroke.DrawingAttributes = drawingAttributes;

Hinweise

InkDrawingAttributes kann global über die SetDefaultDrawingAttributes-Methode eines InkManager-Objekts oder eines InkStrokeBuilder-Objekts festgelegt werden. Sie können auch für ein einzelnes InkStroke-Objekt über die DrawingAttributes-Eigenschaft festgelegt werden.

Versionsverlauf

Windows-Version	SDK-Version	Wertschöpfung
1607	14393	CreateForPencil
1607	14393	Variante
1607	14393	PencilProperties
1703	15063	IgnoreTilt
1803	17134	ModelerAttributes

Konstruktoren

InkDrawingAttributes()

Erstellt ein neues InkDrawingAttributes-Objekt , das zum Angeben von InkStroke-Attributen verwendet wird.

Eigenschaften

Color	Ruft einen Wert ab, der die Farbe einer InkStroke angibt, oder legt diesen fest.
DrawAsHighlighter	Ruft einen Wert ab, der angibt, ob die InkStroke als Textmarkerüberlagerung gerendert wird, oder legt diesen fest. Der Strich ist in der Regel auf eine helle Farbe festgelegt, z. B. Gelb.
FitToCurve	Ruft einen Wert ab, der angibt, ob eine Bézier-Kurve oder eine Auflistung gerader Liniensegmente zum Zeichnen einer InkStroke verwendet wird, oder legt diesen fest.
IgnorePressure	Ruft einen Wert ab, der angibt, ob der Druck des Kontakts auf der Digitizeroberfläche ignoriert wird, wenn Sie eine InkStroke zeichnen, oder legt diesen fest.
IgnoreTilt	Ruft einen Wert ab, der angibt, ob die Neigung (tiltx, tilty) des Kontakts auf der Digitizeroberfläche ignoriert wird, wenn Sie eine InkStroke zeichnen, oder legt diesen fest.
Kind	Ruft die InkDrawingAttributes ab, die die Merkmale eines bestimmten Typs von InkStroke beschreiben.
ModelerAttributes	Ruft eine instance eines ModelerAttributes-Objekts für den Zugriff auf Modellierereigenschaften einer Freihandstriche ab.
PencilProperties	Ruft eine instance eines InkDrawingAttributesPencilProperties-Objekts zum Festlegen der Eigenschaften für einen Stiftstrich ab.
PenTip	Ruft einen Wert ab, der die Form der Stiftspitze angibt, wenn Sie eine InkStroke zeichnen, oder legt diesen fest.
PenTipTransform	Ruft eine affine Transformationsmatrix ab, die auf die penTipShape angewendet wird, die für eine InkStroke verwendet wird, oder legt diese fest.
Size	Ruft einen Wert ab, der die Dimensionen der Stiftspitze (PenTip) angibt, die zum Zeichnen einer InkStroke verwendet wird, oder legt diesen fest.

Methoden

CreateForPencil()

Erstellt ein InkDrawingAttributes-Objekt zum Rendern eines Freihandstrichs mit Stifteigenschaften.

Weitere Informationen

• SetDefaultDrawingAttributes(InkDrawingAttributes)
• DrawingAttributes
• InkDrawingAttributes
• Zeichen- und Eingabestiftinteraktionen
• Erste Schritte: Unterstützung von Freihand in Ihrer UWP-App
• Freihandanalysebeispiel (basic) (C#)
• Beispiel für die Freihandschrifterkennung (C#)
• Speichern und Laden von Freihandstrichen aus einer ISF-Datei (Ink Serialized Format)
• Speichern und Laden von Freihandstrichen aus der Zwischenablage
• Beispiel für Position und Ausrichtung der Freihandsymbolleiste (Basic)
• Beispiel für Position und Ausrichtung der Freihandsymbolleiste (dynamisch)
• Malbuchbeispiel
• Familiennotizbeispiel
• Freihandbeispiel (JavaScript)
• Einfaches Freihandbeispiel (C#/C++)
• Beispiel für komplexe Freihandeingaben (C++)
• Freihandanalysebeispiel