InkDrawingAttributesPencilProperties Класс

Определение

Пространство имен:

Windows.UI.Input.Inking

Предоставляет набор статических свойств InkDrawingAttributes для отрисовки росчерка карандаша в InkCanvas.

Получите экземпляр этого класса, вызвав InkDrawingAttributes.CreateForPencil и перейдя к 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

Наследование

Object Platform::Object IInspectable InkDrawingAttributesPencilProperties

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v3.0)

Примеры

В этом примере показано, как отобразить росчерк пера с помощью атрибутов карандаша.

Сначала мы объявляем InkCanvas в XAML.

В коде программной части мы определяем функцию SetPencilInkStyle() для указания атрибутов росчерка карандаша.

• Создайте специализированный объект InkDrawingAttributes с помощью метода CreateForPencil .
• Задайте некоторые общие атрибуты росчерка, такие как Цвет и Размер.
• Если inkDrawingAttributesKind имеет значение Pencil, задайте атрибут Opacity .
• Вызовите UpdateDefaultDrawingAttributes , чтобы задать атрибуты InkDrawingAttributes , используемые InkPresenter при отрисовке нового объекта InkStroke в элементе управления 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);
  }
}

Комментарии

По умолчанию карандаш рисует штрих с мягкими краями, текстурированный и полупрозрачный штрих (полезен для эффектов заливки слоями) с помощью круговой подсказки. Цвет росчерка (интенсивность) зависит от давления на перо.

Свойства

Opacity

Возвращает или задает уровень прозрачности, используемый для отрисовки росчерка карандаша в InkCanvas. Opacity — это статическое свойство InkDrawingAttributes. Получите экземпляр этого класса, вызвав InkDrawingAttributes.CreateForPencil и перейдя к InkDrawingAttributes.PencilProperties.

См. также раздел

• InkToolbar
• InkToolbarPencilButton
• Взаимодействие с помощью пера
• Начало работы: поддержка рукописного ввода в приложении UWP
• Пример анализа рукописного ввода (базовый) (C#)
• Пример распознавания рукописного ввода (C#)
• Сохранение и загрузка росчерков пера из файла Ink Serialized Format (ISF)
• Сохранение и загрузка росчерков пера из буфера обмена
• Пример расположения и ориентации панели инструментов рукописного ввода (базовый)
• Пример расположения и ориентации панели инструментов рукописного ввода (динамичный)
• Пример раскраски
• Пример семейных заметок
• Пример рукописного ввода (JavaScript)
• Пример простого рукописного ввода (C#/C++)
• Пример сложного рукописного ввода (C++)
• Пример анализа рукописного ввода