DrawingAttributes クラス

定義

Stroke の外観を指定します。Specifies the appearance of a 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 ます。The following example demonstrates how to use two DrawingAttributes objects to simulate using a pen and a highlighter on the same InkCanvas. この例では、XAML ファイルのルート要素がという名前であることを前提としてい DockPanel root ます。The example assumes the root element in the XAML file is a DockPanel called root. また、が呼び出され、 Button switchHighlighter Click この例で定義されているイベントハンドラーにイベントが接続されていることを前提としています。It also assumes that there is a Button called switchHighlighter and that the Click event is connected to the event handler defined in this example.

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 ます。Use the DrawingAttributes property to specify settings such as color, width, transparency, and the shape of the stylus tip for a Stroke.

DefaultDrawingAttributesに追加するストロークの描画属性を指定するには、プロパティを使用し InkCanvas ます。Use the DefaultDrawingAttributes property to specify the drawing attributes for the strokes added to an InkCanvas. 変更後に追加されたストロークのみが、 DefaultDrawingAttributes 更新された属性を表示します。Only strokes that are added after the DefaultDrawingAttributes undergo change show the updated attributes. に既に存在するストロークの外観は InkCanvas 変わりません。The appearance of the strokes that are already on the InkCanvas does not change.

DrawingAttributes クラスのインスタンスの初期プロパティ値一覧については、DrawingAttributes コンストラクターに関するトピックを参照してください。For a list of initial property values for an instance of the DrawingAttributes class, see the DrawingAttributes constructor.

XAML テキストの使用XAML Text Usage

このクラスは、通常、XAML では使用されません。This class is not typically used in XAML.

コンストラクター

DrawingAttributes()

DrawingAttributes クラスの新しいインスタンスを初期化します。Initializes a new instance of the DrawingAttributes class.

フィールド

MaxHeight

Height プロパティに許可される最大値を指定します。Specifies the largest value allowed for the Height property.

MaxWidth

Width プロパティに許可される最大値を指定します。Specifies the largest value allowed for the Width property.

MinHeight

Height プロパティに許可される最小値を指定します。Specifies the smallest value allowed for the Height property.

MinWidth

Width プロパティに許可される最小値を指定します。Specifies the smallest value allowed for the Width property.

プロパティ

Color

Stroke の色を取得または設定します。Gets or sets the color of a Stroke.

FitToCurve

Stroke のレンダリングにベジエ スムージングが使用されるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether Bezier smoothing is used to render the Stroke.

Height

Stroke の描画に使用されるスタイラスの高さを取得または設定します。Gets or sets the height of the stylus used to draw the Stroke.

IgnorePressure

レンダリングされた Stroke の太さが、加わる圧力の大きさに応じて変更されるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the thickness of a rendered Stroke changes according the amount of pressure applied.

IsHighlighter

Stroke が蛍光ペンのような外観であるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the Stroke looks like a highlighter.

StylusTip

Stroke の描画に使用されるスタイラスの形状を取得または設定します。Gets or sets the shape of the stylus used to draw the Stroke.

StylusTipTransform

スタイラスの先端で実行する変換を指定する Matrix を取得または設定します。Gets or sets the Matrix that specifies the transformation to perform on the stylus' tip.

Width

Stroke の描画に使用されるスタイラスの幅を取得または設定します。Gets or sets the width of the stylus used to draw the Stroke.

メソッド

AddPropertyData(Guid, Object)

DrawingAttributes オブジェクトにカスタム プロパティを追加します。Adds a custom property to the DrawingAttributes object.

Clone()

DrawingAttributes オブジェクトをコピーします。Copies the DrawingAttributes object.

ContainsPropertyData(Guid)

指定したプロパティ データ識別子が DrawingAttributes オブジェクト内にあるかどうかを示す値を返します。Returns a value that indicates whether the specified property data identifier is in the DrawingAttributes object.

Equals(Object)

指定した DrawingAttributes オブジェクトが、現在の DrawingAttributes オブジェクトと等しいかどうかを判断します。Determines whether the specified DrawingAttributes object is equal to the current DrawingAttributes object.

GetHashCode()

特定の型についてハッシュ関数として機能します。Serves as a hash function for a particular type.

GetPropertyData(Guid)

指定した Guid に関連付けられたカスタム プロパティの値を取得します。Gets the value of the custom property associated with the specified Guid.

GetPropertyDataIds()

StrokeCollection に関連付けられているカスタム プロパティの GUID を返します。Returns the GUIDs of any custom properties associated with the StrokeCollection.

GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
OnAttributeChanged(PropertyDataChangedEventArgs)

AttributeChanged イベントを発生させます。Raises the AttributeChanged event.

OnPropertyChanged(PropertyChangedEventArgs)

DrawingAttributes プロパティが変更されたときに発生します。Occurs when any DrawingAttributes property changes.

OnPropertyDataChanged(PropertyDataChangedEventArgs)

PropertyDataChanged イベントを発生させます。Raises the PropertyDataChanged event.

RemovePropertyData(Guid)

指定した Guid に関連付けられたカスタム プロパティを削除します。Removes the custom property associated with the specified Guid.

ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(継承元 Object)

演算子

Equality(DrawingAttributes, DrawingAttributes)

指定した DrawingAttributes オブジェクトが等しいかどうかを判断します。Determines whether the specified DrawingAttributes objects are equal.

Inequality(DrawingAttributes, DrawingAttributes)

指定した DrawingAttributes オブジェクトが等しくないかどうかを判断します。Determines whether the specified DrawingAttributes objects are not equal.

イベント

AttributeChanged

DrawingAttributes オブジェクト内のプロパティが変更されると発生します。Occurs when a property in the DrawingAttributes object changes.

PropertyDataChanged

StrokeCollection に対するプロパティ データの追加または削除を行うときに発生します。Occurs when property data is added or removed from the StrokeCollection.

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

INotifyPropertyChanged.PropertyChanged

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

任意の DrawingAttributes プロパティの値が変更されると発生します。Occurs when the value of any DrawingAttributes property has changed.

適用対象