IInkOverlay：：GetGestureStatus 方法 (msinkaut.h)

项目
02/29/2024

检索一个值，该值确定 InkCollector 或 InkOverlay 对象是否对特定应用程序手势感兴趣。

语法

HRESULT GetGestureStatus(
  [in]          InkApplicationGesture Gesture,
  [out, retval] VARIANT_BOOL          *Listening
);

参数

[in] Gesture

想要其状态的手势。

[out, retval] Listening

VARIANT_TRUEInkCollector 控件是否对特定应用程序手势感兴趣;否则， VARIANT_FALSE。

此方法返回一个值，该值指示 InkCollector 或 InkOverlay 对象在已知应用程序手势中的兴趣。如果VARIANT_TRUE，InkCollector 或 InkOverlay 对象对手势感兴趣，并且识别手势时，InkCollector 或 InkOverlay 对象的手势事件将触发。

返回值

此方法可以返回其中一个值。

返回代码	说明
S_OK	成功。
E_POINTER	参数包含无效的指针。
E_INK_INVALID_MODE	收集模式必须处于手势模式。
E_OUTOFMEMORY	无法分配内存来执行操作。
E_INK_EXCEPTION	出现异常情况。
E_INVALIDARG	标志无效。

注解

如果手势参数设置为 IAG_AllGestures，此方法将引发异常。

若要在特定手势中设置 InkCollector 或 InkOverlay 对象的兴趣，请调用 InkCollector 或 InkOverlay 对象的 SetGestureStatus 方法。

注意默认情况下， InkCollector 和 InkOverlay 对象对任何应用程序手势都不感兴趣。

要求

要求	值
最低受支持的客户端	Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	msinkaut.h
Library	InkObj.dll