InkDrawingAttributesPencilProperties 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
提供一組靜態 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
- 繼承
- 屬性
Windows 需求
裝置系列 |
Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
|
API contract |
Windows.Foundation.UniversalApiContract (已於 v3.0 引進)
|
範例
此範例示範如何使用鉛筆屬性來轉譯筆墨筆劃。
首先,我們會在 XAML 中宣告 InkCanvas 。
在程式碼後置中,我們會定義函 SetPencilInkStyle()
式來指定鉛筆筆劃屬性。
- 透過CreateForPencil方法建立特製化的InkDrawingAttributes物件。
- 設定一些一般筆劃屬性,例如 Color 和 Size。
- 如果 InkDrawingAttributesKind 是 鉛筆,請設定 Opacity 屬性。
- 呼叫UpdateDefaultDrawingAttributes,在InkCanvas控制項上呈現新的InkStroke時,設定InkPresenter所使用的InkDrawingAttributes。
<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上呈現鉛筆筆劃的透明度層級。 不透明度是 InkDrawingAttributes的靜態屬性。 呼叫 InkDrawingAttributes.CreateForPencil 並存取 InkDrawingAttributes.PencilProperties,以取得此類別的實例。 |