InkPicture.GetGestureStatus, méthode

Article
11/05/2008

Mise à jour : November 2007

Retourne une valeur qui indique si le contrôle InkPicture a un intérêt dans un mouvement d'application spécifique.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Function GetGestureStatus ( _
    gesture As ApplicationGesture _
) As Boolean
'Utilisation
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

Paramètres

gesture
Type : Microsoft.Ink.ApplicationGesture
Membre de l'énumération ApplicationGesture qui représente le mouvement à interroger.

Valeur de retour

Type : System.Boolean
Si le contrôle InkPicture a un intérêt dans un mouvement d'application particulier.

Valeur	Signification
true	Le contrôle InkPicture a un intérêt dans le mouvement. L'événement Gesture se déclenche lorsque le mouvement est reconnu.
false	Le contrôle InkPicture n'a aucun intérêt dans le mouvement.

Notes

Cette méthode lève une exception si le paramètre gesture a la valeur AllGestures

Pour définir l'intérêt du contrôle InkPicture pour un mouvement particulier, appelez la méthode InkPicture.SetGestureStatus.

Remarque :
Par défaut, le contrôle InkPicture n'a d'intérêt dans aucun mouvement d'application

Exemples

Cet exemple C# crée un ArrayList (page pouvant être en anglais) qui contient tous les mouvements d'application pour lesquels un contrôle InkPicture, theInkPicture, a de l'intérêt.

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

Cet exemple Microsoft® Visual Basic® .NET crée un ArrayList (page pouvant être en anglais) qui contient tous les mouvements d'application pour lesquels un contrôle InkPicturetheInkPicture, a de l'intérêt.

[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

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.