InkDrawingAttributesPencilProperties Classe

Definição

Namespace:

Windows.UI.Input.Inking

Fornece um conjunto de propriedades estáticas inkDrawingAttributes para renderizar um traço de lápis em um InkCanvas.

Obtenha uma instância dessa classe chamando InkDrawingAttributes.CreateForPencil e acessando InkDrawingAttributes.PencilProperties.

public ref class InkDrawingAttributesPencilProperties sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class InkDrawingAttributesPencilProperties final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class InkDrawingAttributesPencilProperties

Public NotInheritable Class InkDrawingAttributesPencilProperties

Herança

Object Platform::Object IInspectable InkDrawingAttributesPencilProperties

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v3.0)

Exemplos

Este exemplo demonstra como renderizar um traço de tinta usando atributos de lápis.

Primeiro, declaramos o InkCanvas em XAML.

No code-behind, definimos uma SetPencilInkStyle() função para especificar os atributos de traço de lápis.

• Crie um objeto InkDrawingAttributes especializado por meio do método CreateForPencil .
• Defina alguns atributos gerais de traço, como Cor e Tamanho.
• Se InkDrawingAttributesKind for Pencil, defina o atributo Opacity .
• Chame UpdateDefaultDrawingAttributes para definir os InkDrawingAttributes usados pelo InkPresenter ao renderizar um novo InkStroke em um controle InkCanvas .

<InkCanvas x:Name="inkCanvas"/>

public sealed partial class Sample : Page
{
  public SetPencilInkStyle()
  {
    // Initialize the pencil stroke attributes.
    InkDrawingAttributes pencilAttributes = InkDrawingAttributes.CreateForPencil();
    pencilAttributes.Color = Windows.UI.Colors.Red;
    pencilAttributes.Size = new Windows.Foundation.Size(3, 3);
    Debug.Assert(attributes.Kind == InkDrawingAttributesKind.Pencil);
    pencilAttributes.PencilProperties.Opacity = 0.5f;
    // Update InkPresenter with the pencil attributes.
    inkCanvas.InkPresenter.UpdateDefaultDrawingAttributes(pencilAttributes);
  }
}

struct MainPage : MainPageT<MainPage>
{
    void SetPencilInkStyle()
    {
        // Initialize the pencil stroke attributes.
        auto pencilAttributes{ Windows::UI::Input::Inking::InkDrawingAttributes::CreateForPencil() };
        pencilAttributes.Color(Windows::UI::Colors::Red());
        pencilAttributes.Size({ 3, 3 });
        WINRT_ASSERT(pencilAttributes.Kind() == Windows::UI::Input::Inking::InkDrawingAttributesKind::Pencil);
        pencilAttributes.PencilProperties().Opacity(.5f);
        // Update the InkPresenter with the pencil attributes.
        m_inkCanvas.InkPresenter().UpdateDefaultDrawingAttributes(pencilAttributes);
    }
}

public sealed partial class Sample : Page
{
  public SetPencilInkStyle()
  {
    // Initialize the pencil stroke attributes.
    InkDrawingAttributes^ pencilAttributes = InkDrawingAttributes::CreateForPencil();
    pencilAttributes->Color = Windows::UI::Colors::Red;
    pencilAttributes->Size = Windows::Foundation::Size(3, 3);
    assert(pencilAttributes->Kind == InkDrawingAttributesKind::Pencil);
    pencilAttributes->PencilProperties->Opacity = 0.5f;
    // Update the InkPresenter with the pencil attributes.
    inkCanvas->InkPresenter->UpdateDefaultDrawingAttributes(pencilAttributes);
  }
}

Comentários

Por padrão, um lápis desenha um traço de bordas macias, texturizados e semitransparentes (útil para efeitos de sombreamento em camadas) com uma Dica de Caneta Circular. A cor do traço (escuridão) depende da pressão da caneta detectada.

Propriedades

Opacity

Obtém ou define o nível de transparência usado para renderizar um traço de lápis em um InkCanvas. Opacidade é uma propriedade estática de InkDrawingAttributes. Obtenha uma instância dessa classe chamando InkDrawingAttributes.CreateForPencil e acessando InkDrawingAttributes.PencilProperties.

Confira também

• InkToolbar
• InkToolbarPencilButton
• Interações por caneta
• Introdução: oferecer suporte à tinta em seu aplicativo UWP
• Exemplo de análise de tinta (básico) (C#)
• Exemplo de reconhecimento de manuscrito à tinta (C#)
• Salvar e carregar traços de tinta de um arquivo ISF (Ink Serialized Format)
• Salvar e carregar traços de tinta da área de transferência
• Exemplo de localização e orientação da barra de ferramentas de tinta (básico)
• Exemplo de localização e orientação da barra de ferramentas de tinta (dinâmico)
• Exemplo de livro de colorir
• Exemplo de anotações da família
• Exemplo de escrita à tinta (JavaScript)
• Exemplo de escrita à tinta simples (C#/C++)
• Exemplo de escrita à tinta complexa (C++)
• Exemplo de análise de tinta