Metodo InkPicture.GetGestureStatus

Articolo
10/29/2008

Aggiornamento: novembre 2007

Restituisce un valore che indica se il controllo InkPicture 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 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

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 InkPicture ha espresso o meno un interesse per un particolare movimento dell'applicazione.

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

Note

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

Per impostare un interesse del controllo InkPicture per un particolare movimento, chiamare il metodo InkPicture.SetGestureStatus.

Nota

Per impostazione predefinita, il controllo InkPicture 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 controllo InkPicture, theInkPicture ha espresso un interesse.

[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 questo esempio di Microsoft® Visual Basic® .NET viene creato un oggetto ArrayList contenente tutti i movimenti dell'applicazione per i quali un controllo InkPicture, theInkPicture, ha espresso un interesse.

[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

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.