IInkPicture::SetGestureStatus メソッド (msinkaut.h)

既知のジェスチャでオブジェクトまたはコントロールの関心を変更します。

構文

HRESULT SetGestureStatus(
  [in] InkApplicationGesture Gesture,
  [in] VARIANT_BOOL          Listen
);

[in] Gesture

状態を設定するジェスチャ。

[in] Listen

ジェスチャが使用されていることを示すVARIANT_TRUE。ジェスチャが無視されていることを示すVARIANT_FALSE。

このメソッドは、これらの値のいずれかを返すことができます。

リターンコード	説明
S_OK	正常終了しました。
E_POINTER	パラメーターに無効なポインターが含まれていました。
E_INK_INVALID_MODE	InkCollector コレクションモードはジェスチャモードである必要があります。
E_INK_EXCEPTION	例外が発生しました。
TPC_S_TRUNCATED	サポートされていないジェスチャ。
E_INVALIDARG	フラグが無効です。
E_OUTOFMEMORY	メモリ操作を割り当てることができません。

既知のジェスチャでオブジェクトまたはコントロールの関心を取得するには、 GetGestureStatus メソッドを呼び出します。

IAG_AllGestures ジェスチャ ID は InkEdit コントロールではサポートされておらず、エラーを返します。無効なジェスチャ ID を渡しても InkEdit のエラーは返されませんが、 InkCollector、 InkOverlay、 InkPicture では失敗します。

InkEdit コントロールの場合、このメソッドは Status プロパティがIES_Idleを返す場合にのみ呼び出す必要があります。


サポートされている最小のクライアント	Windows XP Tablet PC Edition [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	msinkaut.h
Library	InkObj.dll