TouchNotifyApi.h文件参考

Touch API. 更多...

组合类型
struct	_TOUCH_FINGER_DATA
struct	_TOUCH_RAW_DATA
struct	_WNDMSG
struct	_WNDMSGEX
宏定义
#define	TCH_EVENT_RAWDATA_CHANGE   6
#define	TCH_EVENT_ZOOM_END   5
#define	TCH_EVENT_ZOOM_IN   3
#define	TCH_EVENT_ZOOM_OUT   4
#define	TCH_NOTIFY_FLAG_GESTURE   (1U<<0)
#define	TCH_NOTIFY_FLAG_RAWDATA   (1U<<1)
#define	TOUCH_CAPS_CALIBRATE   (1U<<0)
#define	TOUCH_CAPS_SENSITIVITY   (1U<<1)
类型定义
typedef struct _WNDMSG *	PTCHNOTIFYMSG
typedef struct _WNDMSGEX *	PTCHNOTIFYMSGEX
typedef struct _TOUCH_FINGER_DATA *	PTOUCH_FINGER_DATA
typedef struct _TOUCH_RAW_DATA *	PTOUCH_RAW_DATA
typedef struct _WNDMSG	TCHNOTIFYMSG
typedef struct _WNDMSGEX	TCHNOTIFYMSGEX
typedef struct _TOUCH_FINGER_DATA	TOUCH_FINGER_DATA
typedef struct _TOUCH_RAW_DATA	TOUCH_RAW_DATA
函数
DWORD	GetTouchCaps (void)
	用于获得触摸屏的一些特性，例如是否支持灵敏度调整，是否支持校准等等 目前支持的特性：TOUCH_CAPS_SENSITIVITY - 代表是否支持调整灵敏度 TOUCH_CAPS_CALIBRATE - 代表是否支持校准命令
BOOL	GetTouchRawData (PTOUCH_RAW_DATA pRawData)
	用于获得触摸屏的当前数据, 通常，为了降低应用程序的开销，只有当应用程序收到通知消息的事件类型是 TCH_EVENT_RAWDATA_CHANGE时才要调用该函数.
DWORD	GetTouchSensitivity (void)
	用于获得触摸屏的当前灵敏度，使用该API前需要用GetTouchCaps()来判断触摸屏是否支持修改灵敏度
BOOL	RegisterTouchNotify (HWND hWnd, INT iNotifyMsg)
	向触摸屏驱动注册一个窗口通知消息，当驱动程序需要报告事件的时候，会向该窗口发送这个消息，wParam 和lParam包含该次通知的信息
BOOL	RegisterTouchNotifyEx (HWND hWnd, INT iNotifyMsg, DWORD dwFlag)
	向触摸屏驱动注册一个窗口通知消息，当驱动程序需要报告事件的时候，会向该窗口发送该消息，wParam 和lParam包含该次通知的信息
BOOL	SetTouchSensitivity (DWORD dwLevel)
	用于设置触摸屏的当前灵敏度，使用该API前需要用GetTouchCaps()来判断触摸屏是否支持修改灵敏度
BOOL	TouchPanelCalibrate (void)
	用于重新校准触摸屏,调用该函数时,UI需要提示用户不能把手放在触摸屏上,调用该函数后返回成功时,只是表示 校准指令成功地发送给了触摸屏,返回后请延时0.5秒以上的时间 使用该API前需要用GetTouchCaps()来判断触摸屏是否支持校准
BOOL	UnRegisterTouchNotify (HWND hWnd, INT iNotifyMsg)
	通知触摸屏驱动程序释放之前用RegisterTouchNotify/RegisterTouchNotifyEx注册的通知消息 当应用程序不再需要通知消息时，应该调用该函数.

---

详细描述

Touch API.

---

宏定义文档

#define TCH_EVENT_RAWDATA_CHANGE   6

#define TCH_EVENT_ZOOM_END   5

#define TCH_EVENT_ZOOM_IN   3

#define TCH_EVENT_ZOOM_OUT   4

#define TCH_NOTIFY_FLAG_GESTURE   (1U<<0)

#define TCH_NOTIFY_FLAG_RAWDATA   (1U<<1)

#define TOUCH_CAPS_CALIBRATE   (1U<<0)

#define TOUCH_CAPS_SENSITIVITY   (1U<<1)

---

类型定义文档

typedef struct _WNDMSG* PTCHNOTIFYMSG

typedef struct _WNDMSGEX* PTCHNOTIFYMSGEX

typedef struct _TOUCH_FINGER_DATA* PTOUCH_FINGER_DATA

typedef struct _TOUCH_RAW_DATA* PTOUCH_RAW_DATA

typedef struct _WNDMSG TCHNOTIFYMSG

typedef struct _WNDMSGEX TCHNOTIFYMSGEX

typedef struct _TOUCH_FINGER_DATA TOUCH_FINGER_DATA

typedef struct _TOUCH_RAW_DATA TOUCH_RAW_DATA

---

函数文档

DWORD GetTouchCaps

(

void

)

用于获得触摸屏的一些特性，例如是否支持灵敏度调整，是否支持校准等等
目前支持的特性：TOUCH_CAPS_SENSITIVITY - 代表是否支持调整灵敏度 TOUCH_CAPS_CALIBRATE - 代表是否支持校准命令

参数:

无

返回:

返回特性值，每一个bit代表某一个特性

参见:

GetTouchSensitivity SetTouchSensitivity TouchPanelCalibrate

BOOL GetTouchRawData

(

PTOUCH_RAW_DATA

pRawData

)

用于获得触摸屏的当前数据, 通常，为了降低应用程序的开销，只有当应用程序收到通知消息的事件类型是
TCH_EVENT_RAWDATA_CHANGE时才要调用该函数.

参数:

pRawData

[OUT] 驱动程序会向该结构中填入当前的坐标数据.

返回:

0 - 失败, 1 - 成功

DWORD GetTouchSensitivity

(

void

)

用于获得触摸屏的当前灵敏度，使用该API前需要用GetTouchCaps()来判断触摸屏是否支持修改灵敏度

参数:

无

返回:

0 - 较低, 1 - 中等, 2 - 较高

参见:

GetTouchCaps

BOOL RegisterTouchNotify	(	HWND	hWnd,
		INT	iNotifyMsg
	)

向触摸屏驱动注册一个窗口通知消息，当驱动程序需要报告事件的时候，会向该窗口发送这个消息，wParam
和lParam包含该次通知的信息

通知消息的格式 : wParam - 通知事件的类型(TCH_EVENT_ZOOM_IN/TCH_EVENT_ZOOM_OUT/TCH_EVENT_ZOOM_END/TCH_EVENT_RAWDATA_CHANGE) HIWORD(lParam) - X 坐标
LOWORD(lParam) - Y 坐标

参数:

	hWnd	[IN] 接收通知消息的窗口句柄.
	iNotifyMsg	[IN] 触摸屏驱动程序会发送该消息至hWnd所属的窗口中

返回:

0 - 失败, 1 - 成功

BOOL RegisterTouchNotifyEx	(	HWND	hWnd,
		INT	iNotifyMsg,
		DWORD	dwFlag
	)

向触摸屏驱动注册一个窗口通知消息，当驱动程序需要报告事件的时候，会向该窗口发送该消息，wParam
和lParam包含该次通知的信息

通知消息的格式 : wParam - 通知事件的类型(TCH_EVENT_ZOOM_IN/TCH_EVENT_ZOOM_OUT/TCH_EVENT_ZOOM_END/TCH_EVENT_RAWDATA_CHANGE) HIWORD(lParam) - X 坐标
LOWORD(lParam) - Y 坐标

参数:

	hWnd	[IN] 接收通知消息的窗口句柄.
	iNotifyMsg	[IN] 触摸屏驱动程序会发送该消息至hWnd所属的窗口中
	dwFlag	[IN] TCH_NOTIFY_FLAG_GESTURE 或 TCH_NOTIFY_FLAG_RAWDATA，或者二者的组合（位或运算） 如果应用程序只需要放大/缩小(ZoomIn/ZoomOut)通知, 设置dwFlag为TCH_NOTIFY_FLAG_GESTURE, 如果应用程序需要多点触摸的数据, 设置dwFlag为TCH_NOTIFY_FLAG_RAWDATA，当收到通知消息的事件类型(wParam)为 TCH_EVENT_RAWDATA_CHANGE时，应用程序可以调用GetTouchRawData()来获得多点坐标的数据.

返回:

0 - 失败, 1 - 成功

BOOL SetTouchSensitivity

(

DWORD

dwLevel

)

用于设置触摸屏的当前灵敏度，使用该API前需要用GetTouchCaps()来判断触摸屏是否支持修改灵敏度

参数:

dwLevel

: 0 - 较低, 1 - 中等, 2 - 较高

返回:

0 - 失败, 1 - 成功

参见:

GetTouchCaps

BOOL TouchPanelCalibrate

(

void

)

用于重新校准触摸屏,调用该函数时,UI需要提示用户不能把手放在触摸屏上,调用该函数后返回成功时,只是表示
校准指令成功地发送给了触摸屏,返回后请延时0.5秒以上的时间
使用该API前需要用GetTouchCaps()来判断触摸屏是否支持校准

返回:

0 - 失败, 1 - 成功

参见:

GetTouchCaps

BOOL UnRegisterTouchNotify	(	HWND	hWnd,
		INT	iNotifyMsg
	)

通知触摸屏驱动程序释放之前用RegisterTouchNotify/RegisterTouchNotifyEx注册的通知消息
当应用程序不再需要通知消息时，应该调用该函数.

参数:

	hWnd	[IN] 之前用来注册通知消息的窗口句柄.
	iNotifyMsg	[IN] 未使用

返回:

0 - 失败, 1 - 成功