Cursor.DrawingAttributes プロパティ

[アーティクル]
10/28/2008

インクの描画に適用される描画属性を取得または設定します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public Property DrawingAttributes As DrawingAttributes
'使用
Dim instance As Cursor
Dim value As DrawingAttributes

value = instance.DrawingAttributes

instance.DrawingAttributes = value

public DrawingAttributes DrawingAttributes { get; set; }

public:
property DrawingAttributes^ DrawingAttributes {
    DrawingAttributes^ get ();
    void set (DrawingAttributes^ value);
}

/** @property */
public DrawingAttributes get_DrawingAttributes()
/** @property */
public  void set_DrawingAttributes(DrawingAttributes value)

public function get DrawingAttributes () : DrawingAttributes
public function set DrawingAttributes (value : DrawingAttributes)

プロパティ値

型 : Microsoft.Ink.DrawingAttributes
描画されるとおりにインクに適用する DrawingAttributes オブジェクト。このオブジェクトが nullnull 参照 (Visual Basic では Nothing) (Microsoft Visual Basic .NET では Nothing) の場合、カーソルはインクコレクタオブジェクトの既定の描画属性を使用します。

解説

描画属性は、ストロークの外観を指定します。たとえば、インクの幅や色を指定できます。

DrawingAttributes プロパティの連続した呼び出しでは、新しいストロークの描画属性のみ変更されます。既に収集されたストロークや、収集中のストロークには適用されません。

メモ :
InkCollector.DefaultDrawingAttributes、InkOverlay.DefaultDrawingAttributes、または InkPicture.DefaultDrawingAttributes には、独自の DrawingAttributes プロパティが設定されていない限り、すべてのカーソルで使用される描画属性が含まれます。たとえば、DrawingAttributes が設定されていない新しい Cursor オブジェクトと、DrawingAttributes が nullnull 参照 (Visual Basic では Nothing) (Visual Basic .NET では Nothing) に設定されている古い Cursor オブジェクトは、どちらも DefaultDrawingAttributes を使用します。

InkCollector.DefaultDrawingAttributes、InkOverlay.DefaultDrawingAttributes、または InkPicture.DefaultDrawingAttributes には、独自の DrawingAttributes プロパティが設定されていない限り、すべてのカーソルで使用される描画属性が含まれます。たとえば、DrawingAttributes が設定されていない新しい Cursor オブジェクトと、DrawingAttributes が nullnull 参照 (Visual Basic では Nothing) (Visual Basic .NET では Nothing) に設定されている古い Cursor オブジェクトは、どちらも DefaultDrawingAttributes を使用します。

カーソルは、接触する各インクコレクタ (InkCollector、InkOverlay、または InkPicture) に対して異なる描画属性を持つことができます。カーソルの描画属性を指定しない場合、カーソルはインクコレクタの既定の描画属性を使用します。これらの既定の属性は、特定のインクコレクタの DefaultDrawingAttributes プロパティ (InkCollector.DefaultDrawingAttributes、InkOverlay.DefaultDrawingAttributes、または [P:Microsoft.Ink.InkPicture. DefaultDrawingAttributes]) で設定されます。

例

この例では、CursorInRange イベントが発生するときに、InkCollector オブジェクトがこの特定の Cursor オブジェクトとやり取りを行ったのがこれが初めてであるかどうかを確認するチェックが行われます。初めてである場合は、DefaultDrawingAttributes プロパティの複製を使用して、DrawingAttributes プロパティが割り当てられます。これにより、以降の DrawingAttributes プロパティへのアクセスで、Null 参照例外がスローされなくなります。

Private Sub mInkObject_CursorInRange(ByVal sender As Object, ByVal e As InkCollectorCursorInRangeEventArgs)
    Const MOUSE_CURSOR_ID As Integer = 1
    If e.NewCursor Then
        ' mInkObject can be InkCollector, InkOverlay, or InkPicture
        e.Cursor.DrawingAttributes = mInkObject.DefaultDrawingAttributes.Clone()
        ' if this cursor is the mouse, we'll set color to red
        If (MOUSE_CURSOR_ID = e.Cursor.Id) Then
            e.Cursor.DrawingAttributes.Color = Color.Red
        End If

    End If
End Sub

private void mInkObject_CursorInRange(object sender, InkCollectorCursorInRangeEventArgs e)
{
    const int MOUSE_CURSOR_ID = 1;

    if (e.NewCursor)
    {
        // mInkObject can be InkCollector, InkOverlay, or InkPicture
        e.Cursor.DrawingAttributes = mInkObject.DefaultDrawingAttributes.Clone();
        // if this cursor is the mouse, we'll set color to red
        if (MOUSE_CURSOR_ID == e.Cursor.Id)
        {
            e.Cursor.DrawingAttributes.Color = Color.Red;
        }
    }
}