InkDrawingAttributesPencilProperties Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Input.Inking

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Fornisce un set di proprietà InkDrawingAttributes statiche per il rendering di un tratto della matita in un controllo InkCanvas.

Ottenere un'istanza di questa classe chiamando InkDrawingAttributes.CreateForPencil e accedendo 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

Ereditarietà: Object Platform::Object IInspectable InkDrawingAttributesPencilProperties

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)

Esempio

In questo esempio viene illustrato come eseguire il rendering di un tratto input penna usando gli attributi della matita.

In primo luogo, dichiariamo InkCanvas in XAML.

Nel code-behind viene definita una SetPencilInkStyle() funzione per specificare gli attributi del tratto della matita.

Creare un oggetto InkDrawingAttributes specializzato tramite il metodo CreateForPencil .
Impostare alcuni attributi generali del tratto, ad esempio Color e Size.
Se InkDrawingAttributesKind è Pencil, impostare l'attributo Opacity .
Chiamare UpdateDefaultDrawingAttributes per impostare InkDrawingAttributes usato da InkPresenter durante il rendering di un nuovo controllo InkStroke in un controllo 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);
  }
}

Commenti

Per impostazione predefinita, una matita disegna un tratto sfumati, con trama e semitrasparente (utile per gli effetti ombreggiatura a più livelli) con un oggetto Circle PenTip. Il colore del tratto (intensità) dipende dalla pressione della penna rilevata.

Proprietà

Opacity

Ottiene o imposta il livello di trasparenza utilizzato per il rendering di un tratto della matita su un controllo InkCanvas.

Opacità è una proprietà statica di InkDrawingAttributes.

Ottenere un'istanza di questa classe chiamando InkDrawingAttributes.CreateForPencil e accedendo a InkDrawingAttributes.PencilProperties.

Si applica a

Condividi tramite