Metodo InkEdit.GetGestureStatus

Articolo
10/29/2008

Aggiornamento: novembre 2007

Restituisce un valore che indica se l'oggetto InkEdit ha espresso un interesse per 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 InkEdit
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 il controllo InkEdit ha espresso un interesse per un particolare movimento dell'applicazione.

Valore	Significato
true	Il controllo InkEdit ha espresso un interesse per il movimento. L'evento Gesture viene generato quando il movimento viene riconosciuto.
false	Il controllo InkEdit non ha espresso un interesse per il movimento.

Note

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

Per impostare l'interesse del controllo InkEdit per un particolare movimento, chiamare il metodo SetGestureStatus.

Nota

Per impostazione predefinita, il controllo InkEdit ha espresso un interesse per i seguenti movimenti dell'applicazione:

Esempi

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

using Microsoft.Ink;
// . . .
// Return an array of all of the ApplicationGestures that
// have their status set to true on the InkEdit control.
private ApplicationGesture [] GetSetAppGestures(InkEdit theInkEdit)
{
    ArrayList result = new ArrayList();
    ApplicationGesture test = ApplicationGesture.NoGesture;
    Array gestureArray = System.Enum.GetValues(test.GetType());
    foreach (ApplicationGesture theGesture in gestureArray)
    {
        // ApplicationGesture.AllGestures is not a meaningful 
        // gesture to pass to GetGestureStatus()
        if (theGesture != ApplicationGesture.AllGestures && 
            theInkEdit.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 controllo InkEdit, theInkEdit, ha espresso un interesse.

Imports Microsoft.Ink
' . . .
' Return an array of all of the ApplicationGestures that
' have their status set to true on the InkEdit control.
Private Function GetSetAppGestures(ByVal theInkEdit As InkEdit) _
    As ApplicationGesture()
    Dim result As New ArrayList()
    Dim test As ApplicationGesture = ApplicationGesture.NoGesture
    Dim theGestures As Array = System.Enum.GetValues(test.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 _
            theInkCollector.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.