InkDrawingAttributesPencilProperties Classe

Référence

Définition

Espace de noms:: Windows.UI.Input.Inking

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Fournit un ensemble de propriétés InkDrawingAttributes statiques pour le rendu d’un trait de crayon sur un InkCanvas.

Obtenez un instance de cette classe en appelant InkDrawingAttributes.CreateForPencil et en accédant à 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

Héritage: Object Platform::Object IInspectable InkDrawingAttributesPencilProperties

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 Anniversary Edition (introduit dans 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v3.0)

Exemples

Cet exemple montre comment afficher un trait d’encre à l’aide d’attributs de crayon.

Tout d’abord, nous déclarons inkCanvas en XAML.

Dans le code-behind, nous définissons une SetPencilInkStyle() fonction pour spécifier les attributs de trait de crayon.

Créez un objet InkDrawingAttributes spécialisé via la méthode CreateForPencil .
Définissez certains attributs de trait généraux, tels que Color et Size.
Si InkDrawingAttributesKind a la valeur Pencil, définissez l’attribut Opacity .
Appelez UpdateDefaultDrawingAttributes pour définir les attributs InkDrawingAttributes utilisés par InkPresenter lors du rendu d’un nouvel InkStroke sur un contrôle 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);
  }
}

Remarques

Par défaut, un crayon dessine un trait doux, texturé et semi-transparent (utile pour les effets d’ombrage en couches) avec un stylet Circle. La couleur du trait dépend de la pression du stylet détectée.

Propriétés

Opacity

Obtient ou définit le niveau de transparence utilisé pour le rendu d’un trait de crayon sur un InkCanvas.

Opacity est une propriété statique de InkDrawingAttributes.

Obtenez un instance de cette classe en appelant InkDrawingAttributes.CreateForPencil et en accédant à InkDrawingAttributes.PencilProperties.

S’applique à

Partager via