Compartilhar via

InkDrawingAttributes Classe

  • Referência

Definição

Namespace:
Windows.UI.Input.Inking
Editar

Fornece propriedades associadas ao desenho de um InkStroke.

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
Herança
Object Platform::Object IInspectable InkDrawingAttributes
Atributos
ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O exemplo a seguir demonstra como definir um atributo de desenho padrão para todos os traços gerenciados por um objeto InkManager (inkManager).

// 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);

O exemplo a seguir demonstra como definir um atributo de desenho para um traço específico.

Observação

Não é possível definir diretamente a propriedade DrawingAttributes do traço. Você deve criar uma cópia do InkDrawingAttributes do traço, definir os valores desejados para esse objeto InkDrawingAttributes e atribuir os novos InkDrawingAttributes aos DrawingAttributes do traço, conforme mostrado aqui.

// 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;

Comentários

InkDrawingAttributes pode ser definido globalmente por meio do método SetDefaultDrawingAttributes de um objeto InkManager ou um objeto InkStrokeBuilder . Eles também podem ser definidos em um objeto InkStroke individual por meio da propriedade DrawingAttributes .

Histórico de versão

Versão do Windows Versão do SDK Valor adicionado
1607 14393 CreateForPencil
1607 14393 Tipo
1607 14393 PencilProperties
1703 15063 IgnoreTilt
1803 17134 ModelerAttributes

Construtores

InkDrawingAttributes()

Cria um novo objeto InkDrawingAttributes que é usado para especificar atributos InkStroke .

Propriedades

Color

Obtém ou define um valor que indica a cor de um InkStroke.
DrawAsHighlighter

Obtém ou define um valor que indica se o InkStroke é renderizado como uma sobreposição de realce. O traço normalmente é definido como uma cor brilhante, como amarelo.
FitToCurve

Obtém ou define um valor que indica se uma curva de Bezier ou uma coleção de segmentos de linha reta é usada para desenhar um InkStroke.
IgnorePressure

Obtém ou define um valor que indica se a pressão do contato na superfície do digitalizador é ignorada quando você desenha um InkStroke.
IgnoreTilt

Obtém ou define um valor que indica se a inclinação (inclinação, inclinação) do contato na superfície do digitalizador é ignorada quando você desenha um InkStroke.
Kind

Obtém o InkDrawingAttributes que descrevem as características de um tipo específico de InkStroke.
ModelerAttributes

Obtém uma instância de um objeto ModelerAttributes para acessar as propriedades do modelador de um traço de tinta.
PencilProperties

Obtém uma instância de um objeto InkDrawingAttributesPencilProperties para definir propriedades características de um traço de lápis.
PenTip

Obtém ou define um valor que indica a forma da ponta da caneta quando você desenha um InkStroke.
PenTipTransform

Obtém ou define uma matriz de transformação affine aplicada ao PenTipShape usado para um InkStroke.
Size

Obtém ou define um valor que indica as dimensões da dica de caneta (PenTip) usada para desenhar um InkStroke.

Métodos

CreateForPencil()

Cria um objeto InkDrawingAttributes para renderizar um traço de tinta com características de lápis.

Aplica-se a

Confira também