Metodo InkOverlay.GetGestureStatus

Articolo
10/29/2008

Aggiornamento: novembre 2007

Restituisce un valore che indica se l'oggetto InkOverlay ha espresso un interesse in un particolare movimento dell'applicazione.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Function GetGestureStatus ( _
    gesture As ApplicationGesture _
) As Boolean
'Utilizzo
Dim instance As InkOverlay
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

Parametri

gesture
Tipo: Microsoft.Ink.ApplicationGesture
Membro dell'enumerazione ApplicationGesture che rappresenta il movimento per cui eseguire la query.

Valore restituito

Tipo: System.Boolean
Se l'oggetto InkOverlay ha espresso un interesse in un particolare movimento dell'applicazione.

Valore	Significato
true	L'oggetto InkOverlay ha espresso un interesse nel movimento. L'evento Gesture viene generato quando il movimento viene riconosciuto.
false	L'oggetto InkOverlay non ha espresso alcun interesse nel movimento.

Note

Questo metodo genera un'eccezione se il parametro gesture è impostato su AllGestures.

Per impostare l'interesse dell'oggetto InkOverlay in un particolare movimento, chiamare il metodo SetGestureStatus.

Nota

Per impostazione predefinita, l'oggetto InkOverlay non ha espresso alcun interesse in nessun movimento dell'applicazione.

Esempi

In questo esempio di C# viene creato un oggetto ArrayList contenente tutti i movimenti dell'applicazione per i quali un oggetto InkOverlay, theInkOverlay, ha espresso un interesse.

using Microsoft.Ink;
// . . .
// Return an array of all of the ApplicationGestures that
// have their status set to true on the InkOverlay object.
private ApplicationGesture [] GetSetAppGestures(InkOverlay theInkOverlay)
{
    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 && 
            theInkOverlay.GetGestureStatus(theGesture))
        {
            result.Add(theGesture);
        }
    }
    return (ApplicationGesture[])result.ToArray(typeof(ApplicationGesture));
}

In questo esempio di Microsoft Visual Basic .NET viene creato un oggetto ArrayList contenente tutti i movimenti dell'applicazione per i quali un oggetto InkOverlay, theInkOverlay, ha espresso un interesse.

Imports Microsoft.Ink
' . . .
' Return an array of all of the ApplicationGestures that
' have their status set to true on the InkOverlay object.
Private Function GetSetAppGestures(ByVal theInkOverlay As InkOverlay) 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 _
            theInkOverlay.GetGestureStatus(theGesture) Then
            result.Add(theGesture)
        End If
    Next
    Return CType(result.ToArray(test.GetType()), ApplicationGesture())
End Function

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.