InkPicture.GetGestureStatus 메서드

업데이트: 2007년 11월

InkPicture 컨트롤에 특정 응용 프로그램 제스처에 대한 관심도가 있는지 여부를 나타내는 값을 반환합니다.

네임스페이스: Microsoft.Ink
어셈블리: Microsoft.Ink(Microsoft.Ink.dll)

구문

‘선언
Public Function GetGestureStatus ( _
    gesture As ApplicationGesture _
) As Boolean
‘사용 방법
Dim instance As InkPicture
Dim gesture As ApplicationGesture
Dim returnValue As Boolean

returnValue = instance.GetGestureStatus(gesture)

public bool GetGestureStatus(
    ApplicationGesture gesture
)

public:
bool GetGestureStatus(
    ApplicationGesture gesture
)

public boolean GetGestureStatus(
    ApplicationGesture gesture
)

public function GetGestureStatus(
    gesture : ApplicationGesture
) : boolean

매개 변수

gesture
형식: Microsoft.Ink.ApplicationGesture
쿼리할 제스처를 나타내는 ApplicationGesture 열거형의 멤버입니다.

반환 값

형식: System.Boolean
InkPicture 컨트롤에 특정 응용 프로그램 제스처에 대한 관심도가 있는지 여부입니다.

값	의미
true	InkPicture 컨트롤에 제스처에 대한 관심도가 있습니다. 제스처가 인식되면 Gesture 이벤트가 발생합니다.
false	InkPicture 컨트롤에 제스처에 대한 관심도가 없습니다.

설명

gesture 매개 변수가 AllGestures로 설정되면 이 메서드는 예외를 throw합니다.

특정 제스처에 대한 InkPicture 컨트롤의 관심도를 설정하려면 InkPicture.SetGestureStatus 메서드를 호출합니다.

참고

기본적으로 InkPicture 컨트롤에는 응용 프로그램 제스처에 대한 관심도가 없습니다.

예제

이 C# 예제에서는 InkPicture 컨트롤인 theInkPicture에 관심도가 지정된 모든 응용 프로그램 제스처가 들어 있는 ArrayList를 만듭니다.

[C#]

using Microsoft.Ink;
// . . .
// Return an array of all of the ApplicationGestures that
// have their status set to true on the InkPicture control.
private ApplicationGesture [] GetSetAppGestures(InkPicture theInkPicture)
{
    ArrayList result = new ArrayList();
    Array gestureArray = System.Enum.GetValues(typeof(ApplicationGesture));
    foreach (ApplicationGesture theGesture in gestureArray)
    {
        // ApplicationGesture.AllGestures is not a meaningful
        // gesture to pass to GetGestureStatus()
        if (theGesture != ApplicationGesture.AllGestures &&
        theInkPicture.GetGestureStatus(theGesture))
        {
            result.Add(theGesture);
        }
    }
    return (ApplicationGesture[])result.ToArray(typeof(ApplicationGesture));
//...

이 Microsoft® Visual Basic® .NET 예제에서는 InkPicture 컨트롤인 theInkPicture에 관심도가 지정된 모든 응용 프로그램 제스처가 들어 있는 ArrayList를 만듭니다.

[Visual Basic]

Imports Microsoft.Ink
' . . .
' Return an array of all of the ApplicationGestures that
' have their status set to true on the InkPicture object.
Private Function GetSetAppGestures(ByVal theInkPicture As InkPicture) As ApplicationGesture()
    Dim result As New ArrayList()
    Dim sampleGesture As ApplicationGesture = ApplicationGesture.NoGesture
    Dim theGestures As Array = System.Enum.GetValues(sampleGesture.GetType())
    Dim theGesture As ApplicationGesture
    For Each theGesture In theGestures
        ' ApplicationGesture.AllGestures is not a meaningful
        ' gesture to pass to GetGestureStatus()
        If (Not theGesture.Equals(ApplicationGesture.AllGestures)) AndAlso _
            theInkPicture.GetGestureStatus(theGesture) Then
            result.Add(theGesture)
        End If
    Next
    Return CType(result.ToArray(sampleGesture.GetType()), ApplicationGesture())
End Function