Freigeben über


InkDrawingAttributes Klasse

Definition

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

public ref class InkDrawingAttributes sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class InkDrawingAttributes final
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class InkDrawingAttributes
[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

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.

Gilt für:

Weitere Informationen