InkOverlay.GetGestureStatus Method
Returns a value that indicates whether the InkOverlay object has interest in a particular application gesture.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in microsoft.ink.dll)
Syntax
'Declaration
Public Function GetGestureStatus ( _
gesture As ApplicationGesture _
) As Boolean
'Usage
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
Not applicable.
Parameters
- gesture
A member of the ApplicationGesture enumeration that represents the gesture to query about.
Return Value
Whether the InkOverlay object has interest in a particular application gesture.
Value |
Meaning |
---|---|
true |
The InkOverlay object has interest in the gesture. The Gesture event is raised when the gesture is recognized. |
false |
The InkOverlay object has no interest in the gesture. |
Remarks
This method throws an exception if the gesture parameter is set to AllGestures.
To set the interest of the InkOverlay object in a particular gesture, call the SetGestureStatus method.
Note
By default, the InkOverlay object does not have interest in any application gesture.
Example
This C# example creates an ArrayList containing all application gestures for which an InkOverlay object, theInkOverlay
, has interest.
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));
}
This Microsoft Visual Basic .NET example creates an ArrayList containing all application gestures for which an InkOverlay object, theInkOverlay
, has interest.
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
Platforms
Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.
Version Information
.NET Framework
Supported in: 3.0
See Also
Reference
InkOverlay Class
InkOverlay Members
Microsoft.Ink Namespace
ApplicationGesture
InkOverlay.Gesture
InkOverlay.SetGestureStatus