Cursor.DrawingAttributes 속성

아티클
11/04/2008

업데이트: 2007년 11월

잉크를 그릴 때 적용할 그리기 특성을 가져오거나 설정합니다.

네임스페이스: 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 속성을 자체적으로 설정하지 않은 모든 커서에 사용되는 그리기 특성이 들어 있습니다. 예를 들어 새 Cursor 개체의 DrawingAttributes를 설정하지 않거나 이전 Cursor 개체의 DrawingAttributes를 nullNull 참조(Visual Basic의 경우 Nothing)(Visual Basic .NET의 경우 Nothing)로 설정하면 두 경우 모두 DefaultDrawingAttributes가 사용됩니다.

각 잉크 수집기(InkCollector, InkOverlay 또는 InkPicture)와 접촉하는 커서의 그리기 특성이 서로 다를 수 있습니다. 커서의 그리기 특성을 지정하지 않으면 잉크 수집기의 기본 그리기 특성이 사용됩니다. 이러한 기본 특성은 특정 잉크 수집기의 DefaultDrawingAttributes 속성(InkCollector.DefaultDrawingAttributes, InkOverlay.DefaultDrawingAttributes 또는 [P:Microsoft.Ink.InkPicture. DefaultDrawingAttributes])을 통해 설정됩니다.

예제

이 예제에서는 CursorInRange 이벤트가 발생할 때 InkCollector 개체가 해당 Cursor 개체와 처음으로 접촉했는지 확인합니다. 확인에 성공하면 DrawingAttributes 속성에 DefaultDrawingAttributes 속성의 복제본이 할당됩니다. 이렇게 하면 이후에 DrawingAttributes 속성에 액세스할 때 null 참조 예외가 throw되지 않습니다.

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;
        }
    }
}