InkPicture.GetGestureStatus-Methode

Artikel
11/26/2008

Gibt einen Wert zurück, der angibt, ob das InkPicture-Steuerelement Interesse an einer bestimmten Anwendungsstiftbewegung hat.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Function GetGestureStatus ( _
    gesture As ApplicationGesture _
) As Boolean
'Usage
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

Parameter

gesture
Typ: Microsoft.Ink.ApplicationGesture
Ein Member der ApplicationGesture-Enumeration, der die abzufragende Stiftbewegung darstellt.

Rückgabewert

Typ: System.Boolean
Gibt an, ob das InkPicture-Steuerelement Interesse an einer bestimmten Anwendungsstiftbewegung hat.

Wert	Bedeutung
true	Das InkPicture-Steuerelement hat Interesse an der Stiftbewegung. Das Gesture-Ereignis wird ausgelöst, wenn die Stiftbewegung erkannt wird.
false	Das InkPicture-Steuerelement hat kein Interesse an der Stiftbewegung.

Hinweise

Diese Methode löst eine Ausnahme aus, wenn der gesture-Parameter auf AllGestures festgelegt ist.

Rufen Sie die InkPicture.SetGestureStatus-Methode auf, um das Interesse des InkPicture-Steuerelements für eine bestimmte Stiftbewegung festzulegen.

Hinweis

Standardmäßig hat das InkPicture-Steuerelement kein Interesse an jeglicher Anwendungsstiftbewegung

Beispiele

In diesem C#-Beispiel wird eine ArrayList erstellt, die alle Anwendungsstiftbewegungen enthält, an denen das InkPicture-Steuerelement theInkPicture Interesse hat.

[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));
//...

In diesem Microsoft® Visual Basic® .NET-Beispiel wird eine ArrayList erstellt, die alle Anwendungsstiftbewegungen enthält, an denen das InkPicture-Steuerelement theInkPicture Interesse hat.

[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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.