DrawingAttributes クラス

定義

Stroke の外観を指定します。

public ref class DrawingAttributes : System::ComponentModel::INotifyPropertyChanged
public class DrawingAttributes : System.ComponentModel.INotifyPropertyChanged
type DrawingAttributes = class
    interface INotifyPropertyChanged
Public Class DrawingAttributes
Implements INotifyPropertyChanged
継承
DrawingAttributes
実装

次の例では、2 つの DrawingAttributes オブジェクトを使用して、同じ InkCanvas上でペンと蛍光ペンを使用してシミュレートする方法を示します。 この例では、XAML ファイル内のルート要素が DockPanel と呼ばれる rootと想定しています。 また、 が Button 呼び出 switchHighlighter され、 Click この例で定義されているイベント ハンドラーにイベントが接続されていることを前提としています。

InkCanvas inkCanvas1 = new InkCanvas();
DrawingAttributes inkDA;
DrawingAttributes highlighterDA;
bool useHighlighter = false;

// Add an InkCanvas to the window, and allow the user to 
// switch between using a green pen and a purple highlighter 
// on the InkCanvas.
private void WindowLoaded(object sender, EventArgs e)
{
    inkCanvas1.Background = Brushes.DarkSlateBlue;
    inkCanvas1.DefaultDrawingAttributes.Color = Colors.SpringGreen;

    root.Children.Add(inkCanvas1);

    // Set up the DrawingAttributes for the pen.
    inkDA = new DrawingAttributes();
    inkDA.Color = Colors.SpringGreen;
    inkDA.Height = 5;
    inkDA.Width = 5;
    inkDA.FitToCurve = false;

    // Set up the DrawingAttributes for the highlighter.
    highlighterDA = new DrawingAttributes();
    highlighterDA.Color = Colors.Orchid;
    highlighterDA.IsHighlighter = true;
    highlighterDA.IgnorePressure = true;
    highlighterDA.StylusTip = StylusTip.Rectangle;
    highlighterDA.Height = 30;
    highlighterDA.Width = 10;

    inkCanvas1.DefaultDrawingAttributes = inkDA;
}

// Create a button called switchHighlighter and use 
// SwitchHighlighter_Click to handle the Click event.  
// The useHighlighter variable is a boolean that indicates
// whether the InkCanvas renders ink as a highlighter.

// Switch between using the 'pen' DrawingAttributes and the 
// 'highlighter' DrawingAttributes.
void SwitchHighlighter_Click(Object sender, RoutedEventArgs e)
{
    useHighlighter = !useHighlighter;
    
    if (useHighlighter)
    {
        switchHighlighter.Content = "Use Pen";
        inkCanvas1.DefaultDrawingAttributes = highlighterDA;
    }
    else
    {
        switchHighlighter.Content = "Use Highlighter";
        inkCanvas1.DefaultDrawingAttributes = inkDA;
    }
}
Private WithEvents inkCanvas1 As New InkCanvas()
Private inkDA As DrawingAttributes
Private highlighterDA As DrawingAttributes
Private useHighlighter As Boolean = False

' Add an InkCanvas to the window, and allow the user to 
' switch between using a green pen and a purple highlighter 
' on the InkCanvas.
Private Sub WindowLoaded(ByVal sender As Object, ByVal e As RoutedEventArgs)

    inkCanvas1.Background = Brushes.DarkSlateBlue
    inkCanvas1.DefaultDrawingAttributes.Color = Colors.SpringGreen

    ' Add the InkCanvas to the DockPanel, named root.
    root.Children.Add(inkCanvas1)

    ' Set up the DrawingAttributes for the pen.
    inkDA = New DrawingAttributes()
    With inkDA
        .Color = Colors.SpringGreen
        .Height = 5
        .Width = 5
        .FitToCurve = True
    End With

    ' Set up the DrawingAttributes for the highlighter.
    highlighterDA = New DrawingAttributes()
    With highlighterDA
        .Color = Colors.Orchid
        .IsHighlighter = True
        .IgnorePressure = True
        .StylusTip = StylusTip.Rectangle
        .Height = 30
        .Width = 10
    End With

    inkCanvas1.DefaultDrawingAttributes = inkDA

End Sub


' Create a button called switchHighlighter and use 
' SwitchHighlighter_Click to handle the Click event.  
' The useHighlighter variable is a boolean that indicates
' whether the InkCanvas renders ink as a highlighter.

' Switch between using the 'pen' DrawingAttributes and the 
' 'highlighter' DrawingAttributes when the user clicks on .
Private Sub SwitchHighlighter_Click(ByVal sender As [Object], ByVal e As RoutedEventArgs)

    useHighlighter = Not useHighlighter

    If useHighlighter Then
        switchHighlighter.Content = "Use Pen"
        inkCanvas1.DefaultDrawingAttributes = highlighterDA
    Else

        switchHighlighter.Content = "Use Highlighter"
        inkCanvas1.DefaultDrawingAttributes = inkDA
    End If

End Sub

注釈

プロパティを使用して、 の DrawingAttributes 色、幅、透明度、スタイラス 先端の形状などの設定を Stroke指定します。

プロパティを DefaultDrawingAttributes 使用して、 に追加するストロークの描画属性を InkCanvas指定します。 変更後 DefaultDrawingAttributes に追加されたストロークのみが、更新された属性を表示します。 既 InkCanvas に 上にあるストロークの外観は変わりません。

DrawingAttributes クラスのインスタンスの初期プロパティ値一覧については、DrawingAttributes コンストラクターに関するトピックを参照してください。

XAML テキストの使用法

このクラスは通常、XAML では使用されません。

コンストラクター

DrawingAttributes()

DrawingAttributes クラスの新しいインスタンスを初期化します。

フィールド

MaxHeight

Height プロパティに許可される最大値を指定します。

MaxWidth

Width プロパティに許可される最大値を指定します。

MinHeight

Height プロパティに許可される最小値を指定します。

MinWidth

Width プロパティに許可される最小値を指定します。

プロパティ

Color

Stroke の色を取得または設定します。

FitToCurve

Stroke のレンダリングにベジエ スムージングが使用されるかどうかを示す値を取得または設定します。

Height

Stroke の描画に使用されるスタイラスの高さを取得または設定します。

IgnorePressure

レンダリングされた Stroke の太さが、加わる圧力の大きさに応じて変更されるかどうかを示す値を取得または設定します。

IsHighlighter

Stroke が蛍光ペンのような外観であるかどうかを示す値を取得または設定します。

StylusTip

Stroke の描画に使用されるスタイラスの形状を取得または設定します。

StylusTipTransform

スタイラスの先端で実行する変換を指定する Matrix を取得または設定します。

Width

Stroke の描画に使用されるスタイラスの幅を取得または設定します。

メソッド

AddPropertyData(Guid, Object)

DrawingAttributes オブジェクトにカスタム プロパティを追加します。

Clone()

DrawingAttributes オブジェクトをコピーします。

ContainsPropertyData(Guid)

指定したプロパティ データ識別子が DrawingAttributes オブジェクト内にあるかどうかを示す値を返します。

Equals(Object)

指定した DrawingAttributes オブジェクトが、現在の DrawingAttributes オブジェクトと等しいかどうかを判断します。

GetHashCode()

特定の型についてハッシュ関数として機能します。

GetPropertyData(Guid)

指定した Guid に関連付けられたカスタム プロパティの値を取得します。

GetPropertyDataIds()

StrokeCollection に関連付けられているカスタム プロパティの GUID を返します。

GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
OnAttributeChanged(PropertyDataChangedEventArgs)

AttributeChanged イベントを発生させます。

OnPropertyChanged(PropertyChangedEventArgs)

DrawingAttributes プロパティが変更されたときに発生します。

OnPropertyDataChanged(PropertyDataChangedEventArgs)

PropertyDataChanged イベントを発生させます。

RemovePropertyData(Guid)

指定した Guid に関連付けられたカスタム プロパティを削除します。

ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)

演算子

Equality(DrawingAttributes, DrawingAttributes)

指定した DrawingAttributes オブジェクトが等しいかどうかを判断します。

Inequality(DrawingAttributes, DrawingAttributes)

指定した DrawingAttributes オブジェクトが等しくないかどうかを判断します。

イベント

AttributeChanged

DrawingAttributes オブジェクト内のプロパティが変更されると発生します。

PropertyDataChanged

StrokeCollection に対するプロパティ データの追加または削除を行うときに発生します。

明示的なインターフェイスの実装

INotifyPropertyChanged.PropertyChanged

この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。

任意の DrawingAttributes プロパティの値が変更されると発生します。

適用対象