InkDrawingAttributesPencilProperties Clase

Definición

Espacio de nombres:

Windows.UI.Input.Inking

Proporciona un conjunto de propiedades InkDrawingAttributes estáticas para representar un trazo de lápiz en inkCanvas.

Obtenga una instancia de esta clase llamando a InkDrawingAttributes.CreateForPencil y accediendo a 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

Herencia

Object Platform::Object IInspectable InkDrawingAttributesPencilProperties

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)

Ejemplos

En este ejemplo se muestra cómo representar un trazo de lápiz mediante atributos de lápiz.

En primer lugar, declaramos InkCanvas en XAML.

En el código subyacente, definimos una SetPencilInkStyle() función para especificar los atributos de trazo de lápiz.

• Cree un objeto InkDrawingAttributes especializado a través del método CreateForPencil .
• Establezca algunos atributos de trazo generales, como Color y Tamaño.
• Si InkDrawingAttributesKind es Pencil, establezca el atributo Opacity .
• Llame a UpdateDefaultDrawingAttributes para establecer los inkDrawingAttributes usados por InkPresenter al representar un nuevo InkStroke en un control 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);
  }
}

Comentarios

De forma predeterminada, un lápiz dibuja un trazo de borde suave, texturado y semitransparente (útil para efectos de sombreado superpuestas) con una información sobre círculos. El color del trazo (oscuridad) depende de la presión del lápiz que se detecte.

Propiedades

Opacity

Obtiene o establece el nivel de transparencia utilizado para representar un trazo de lápiz en un inkCanvas. Opacity es una propiedad estática de InkDrawingAttributes. Obtenga una instancia de esta clase llamando a InkDrawingAttributes.CreateForPencil y accediendo a InkDrawingAttributes.PencilProperties.

Consulte también

• InkToolbar
• InkToolbarPencilButton
• Interacciones de pluma y lápiz
• Introducción: Compatibilidad con la entrada de lápiz en la aplicación para UWP
• Ejemplo de análisis de entrada de lápiz (básico) (C#)
• Ejemplo de reconocimiento de escritura a mano de lápiz (C#)
• Guardar y cargar trazos de lápiz desde un archivo de formato serializado de entrada de lápiz (ISF)
• Guardar y cargar trazos de lápiz desde el Portapapeles
• Ejemplo de orientación y ubicación de la barra de herramientas de entrada de lápiz (básico)
• Ejemplo de orientación y ubicación de la barra de herramientas de entrada de lápiz (dinámica)
• Muestra de libro para colorear
• Muestra de notas familiares
• Ejemplo de entrada manuscrita (JavaScript)
• Ejemplo de entrada manuscrita simple (C#/C++)
• Ejemplo de entrada manuscrita compleja (C++)
• Ejemplo de análisis de entrada de lápiz