InkPicture.GetGestureStatus メソッド

[アーティクル]
10/28/2008

特定のアプリケーションジェスチャ内で InkPicture コントロールが対象を持つかどうかを示す値を返します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public Function GetGestureStatus ( _
    gesture As ApplicationGesture _
) As Boolean
'使用
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

パラメータ

gesture
型 : Microsoft.Ink.ApplicationGesture
照会するジェスチャを表す ApplicationGesture 列挙体のメンバ。

戻り値

型 : System.Boolean
InkPicture コントロールが特定のアプリケーションジェスチャ内に対象を持つかどうか。

値	説明
true	InkPicture コントロールはジェスチャに対象を持ちます。Gesture イベントは、ジェスチャが認識されたときに発生します。
false	InkPicture コントロールはジェスチャに対象を持ちません。

解説

このメソッドは、gesture パラメータが AllGestures に設定されている場合、例外をスローします。

特定のジェスチャに対して InkPicture コントロールの対象を設定するには、InkPicture.SetGestureStatus メソッドを呼び出します。

メモ :
既定では、InkPicture コントロールはアプリケーションジェスチャ内で対象を持ちません。

例

この C# の例では、InkPicture コントロール theInkPicture が対象を持つアプリケーションジェスチャすべてを含む ArrayList を作成します。

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

この Microsoft® Visual Basic® .NET の例では、InkPicture コントロール theInkPicture が対象を持つアプリケーションジェスチャすべてを含む ArrayList を作成します。

[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