博客园-Windows Mobile Space

该段介绍触摸手势，你可以用手指或光笔队按照某种手势对屏幕上的控件或对象做短距离有向运动。大多数手势是单独的点击，它相当于一次手指按下(WM_LBUTTONDOWN)和一次手指抬起(WM_LBUTTONUP)事件对。双击是个例外，它相当于连续两次手指按下和手指抬起事件对。手势的识别根据：手指按下和抬起事件加上方向、位置和由手势识别器计算出的速度。Windows Mobile支持5种手势：

手势	描述
Tap	代表一次鼠标左键点击。当手机按下和抬起事件发生在一个已定义的时间段和距离内时，程序只接收一次GID_SELECT 手势消息。在WM_LBUTTONDOWN 事件后和GID_SELECT 消息前可能会有几次WM_MOUSEMOVE消息。
Double Tap	代表2次鼠标左键点击。当手指抬起事件发生在一个已定义的时间段和距离内时，程序接收一次GID_DOUBLESELECT 手势消息。
Hold	用户按下并一直按住屏幕代表鼠标右键点击。当手指按下并一直按住超过了一个预定义的时间段，而且这段时间内按下的点都在一个指定的距离范围内时，程序会只接收一次GID_HOLD消息。一旦手指抬起或在按住时间临界值后，程序会接收到一个GID_END 消息然后紧接着收到一个GID_HOLD 消息。
Flick	用户移动手指划过屏幕来启动每个像素移动。如果移动足够快，滚动在手指抬起后仍会继续。当手指移动结束抬起后，程序会接收一次GID_SCROLL 手势消息。 Flick经常发生在Pan之后（即一个或多个GID_PAN 手势消息，紧接着是GID_SCROLL ，然后是GID_END 消息）。
Pan	用户按下并按住屏幕，然后在任意方向拖动手指来代表鼠标移动事件。位置发生改变时程序接收一个或多个GID_PAN 手势消息，当手指抬起时接收一个GID_END 消息。鼠标消息和手势消息交错出现。

更多关于GID_*手势的消息参见：GESTUREINFO。

手势识别引擎的系统构架由一个手势识别状态机和现有的触摸事件发送程序构成。触摸事件由触摸屏驱动(Touch Screen Drivers)发送到状态机。当手势被识别后，一个手势窗口消息将被发送到目标进程消息队列。

注意调用SetCapture将会为手势改变目标窗口。

手势事件通常总是在手指抬起前发送以便接收者能够调用TKGetGestureInfo处理手势消息并通过鼠标抬起事件来取消任何动作。

Window Auto Gestures：

自动手势使窗口内的控件和程序能够自动地处理Flick和Pan手势。可以通过 TKSetWindowAutoGesture 和 TKGetWindowAutoGesture 函数来控制手势处理。自动手势使动画消息被发送到窗口过程来管理和Flicks和Pans相关的动画。可以调用TKGetAnimateMessageInfo函数来取到那些消息。

Gesture Reference (DTK)

窗口自动手势能够使窗口中的内容自动响应Flick和Pan手势滚动。

本部分包括：

Gesture Functions (DTK)：提供触摸手势相关函数的概述。

Gesture Structures (DTK)：提供触摸手势相关结构体的概述

Gesture Macros (DTK)：提供触摸手势相关宏的概述

Gesture Constants (DTK)：提供触摸手势相关常量的概述

Gesture Messages (DTK)：提供触摸手势相关消息的概述

Gesture Constants (DTK)

下面的常量为在 GESTUREINFO 结构体中使用的命令。

名称	值	描述
GID_BEGIN	1	包含标记每个手势开始点的坐标。当触摸屏幕时发送。
GID_END	2	包含标记每个手势结束点的坐标。当手指或光笔从屏幕抬起后发送。当接收该命令后，GESTUREINFO 的 ullArguments 字段总是被设置为0。
GID_PAN	4	an在当用户在窗口上按下而且在任意方向移动（该过程手指保持和屏幕一直接触）时发生。识别引擎发送GID_PAN消息，该消息包含手势的开始点和当前点。在手指或光笔从窗口屏幕抬起前，会为每次窗口移动消息发送一次GID_PAN消息。GID_END 用来标记Pan移动的结束。程序根据连续两次Pan手势间的差异计算移动增量。如果设置GF_INERTIA标志，GESTUREINFO 的 ullArguments 值和GID_SCROLL 时一样。
GID_SCROLL	8	用户按下窗口(或者也可能在窗口上Pan)，然后手指或光标在任意方向迅速移动，当移动结束抬起手指或光笔前发生Scroll。识别引擎在Flick手势后发送GID_SCROLL消息。GID_SCROLL会被发送到接收当前触摸过程第一个手势消息的窗口，可能是一个Pan消息或一个Hold消息。GESTUREINFO 的ullArguments 字段包含关于角度、方向和Flick速度的信息。主要的方向常量值如下： ARG_SCROLL_NONE ARG_SCROLL_RIGHT ARG_SCROLL_UP ARG_SCROLL_LEFT ARG_SCROLL_DOWN 当设备旋转时，手势自动调整匹配旋转。 Flick的角度值以从0至65535范围值计量。可以使用下面的宏从GID_SCROLL手势消息的ullArguments 字段来提取出角度、方向和速度。 GID_SCROLL_ANGLE GID_SCROLL_DIRECTION GID_SCROLL_VELOCITY 可以使用下面的宏在角度和弧度间相互转换。 GID_ROTATE_ANGLE_TO_ARGUMENT GID_ROTATE_ANGLE_FROM_ARGUMENT
GID_HOLD	9	用户按下窗口并保持手指或光笔按住超过指定的超时时间，此时发生Hold。识别引擎发送一个GID_HOLD消息，然后当手指或光笔抬起时发送一个GID_END 消息。 Hold 手势后可能会跟着Pan移动(移动过程会生成许多GID_PAN消息)，但是，在生成GID_PAN消息后绝不会再生成GID_HOLD消息
GID_SELECT	10	当用户用手指或光笔敲击屏幕，敲击过程时间小于系统指定的SELECT超时时间，此时发生Select。GESTUREINFO 的ullArguments 字段不会在该命令中使用。
GID_DOUBLESELECT	11	当用户用手指或光笔敲击两次屏幕，两次敲击过程时间小于系统指定的DOUBLESELECT超时时间，此时发生Double Select。DOUBLESELECT超时时间是指连续两次鼠标抬起事件发生的间隔时间。 GESTUREINFO 的ullArguments 字段不会在该命令中使用。

Gesture Functions (DTK)

下表显示支持手势的函数及其用途。

函数	描述
TKGetAnimateMessageInfo	该函数取回由窗口自动手势发送的所有动画消息的移动信息。
TKGetGestureExtraArguments	该函数用来获得手势消息配备的额外信息。
TKGetGestureInfo	该函数使用传递到WM_GESTURE消息的触摸手势的内容填充GESTUREINFO结构。
TKGetGestureMetrics	用来给指定手势取回触摸手势识别的尺寸(比如，触摸手势引擎使用的距离和时间公差)。
TKGetWindowAutoGesture	为指定窗口句柄取回当前自动手势配置设置。
TKSetWindowAutoGesture	为指定窗口指定自动手势配置设置。

TKGetAnimateMessageInfo

该函数取回由窗口自动手势发送的所有动画消息的移动信息。该特性使窗口中的内容响应Flick和Pan手势自动滚动。要自动处理手势滚动，目标窗口一定要包含WS_VSCROLL 或 WS_HSCROLL(或者两者都包含)类型并且设置正确的范围。

该函数在WindowAutoGesture.h头文件中。

程序调用TKSetWindowAutoGesture并指定WAGIF_OWNERANIMATE 标志后，当内容动起来时，消息被发送至窗口过程。程序应该为每个动画消息调用该函数来取回正确的值。

声明：

BOOL TKGetAnimateMessageInfo(

                             HWND hWnd, 

                             WPARAM wParam, 

                             LPARAM lParam, 

                             LPANIMATEMESSAGEINFO pAnimateMessageInfo

                             );

参数：

hWnd：目标窗口句柄。

wParam、lParam：动画消息参数。

pAnimateMessageInfo：指向 ANIMATEMESSAGEINFO 结构指针，该结构由移动信息组成。

返回值：

成功返回TRUE；失败返回FALSE。调用GetLastError获取扩展错误信息。

备注：

必须调用TKSetWindowAutoGesture函数并且在目标窗口收到任何动画消息前为窗口设置WAGIF_OWNERANIMATE 标志。

TKGetGestureExtraArguments

该函数用来获得手势消息配备的额外信息，在Gesture.h头文件中。

声明：

BOOL TKGetGestureExtraArguments 

    HGESTUREINFO hGestureInfo,

    UINT cbExtraArguments,

    PBYTE pExtraArguments

);

参数：

hGestureInfo：[in]手势信息句柄，HGESTUREINFO，从 WM_GESTURE 窗口消息的lparam 参数获得。

cbExtraArguments: [in]客户端传递的缓冲大小，用来取回手势详细内容，从GESTUREINFO的cbExtraArguments 值获得。

pExtraArguments：[out]指向大小为cbExtraArguments 的BYTE数组的指针，用来接收而外信息。

返回值：

成功返回TRUE；失败返回FALSE。调用GetLastError取回更多信息。下表显示GetLastError可能获取的返回值。

值	描述
ERROR_NO_DATA	没有数据返回。也可能是由于没有足够缓冲造成。
ERROR_INVALID_PARAMETER	如果pExtraArguments为空或hGestureInfo 无效。

备注：

客户端程序检测GESTUREINFO 的cbExtraArguments 值来决定是否需要调用TKGetGestureExtraArguments。

程序通常先检查cbExtraArguments 值，如果值为非0，将填充BYTES数组。客户端程序需要按照文档描述那样为某个手势消息解析该内存缓冲。

TKGetGestureInfo

该函数使用传递到WM_GESTURE消息的触摸手势的内容填充GESTUREINFO结构，该函数在Gesture.h头文件中。

声明：

BOOL TKGetGestureInfo(

                      HGESTUREINFO hGestureInfo,

                      PGESTUREINFO pGestureInfo

                      );

参数：

hGestureInfo：GESTUREINFO结构句柄。

pGestureInfo：指向GESTUREINFO结构的指针，该结构由传递到WM_GESTURE消息的触摸手势的内容填充。结构的cbSize值必须在调用函数前正确地初始化。

备注：

根据手势ID，程序直接翻译 WM_GESTURE 消息的参数，或者传递参数给GetGestureInfo，如下代码：

GESTUREINFO gi;

memset(&gi, 0, sizeof(gi));

gi.cbSize = sizeof(GESTUREINFO);

if (TKGetGestureInfo((HGESTUREINFO)lParam, &gi))

{

    // Handle gesture indicated by wParam

}

else

{

    // Error handling.

}

TKGetGestureMetrics

用来给指定手势取回触摸手势识别的尺寸(比如，触摸手势引擎使用的距离和时间公差)。该函数在Gesture.h头文件中。

声明：

BOOL TKGetGestureMetrics(

                         LPGESTUREMETRICS lpGestureMetricsInfo

                         );

参数：

lpGestureMetricsInfo：[in/out]GESTUREMETRICS结构指针。该值不能为NULL。调用者必须设置dwID 值为下面的一个：

GID_PAN

GID_ SCROLL

GID_HOLD

GID_SELECT

GID_DOUBLESELECT

所有其他的字段会按照需要根据dwID的值重写。

调用该函数时cbSize字段需要被设置正确的值。

返回值：

成功返回TRUE；失败返回FALSE。调用GetLastError获取扩展错误信息。

成功返回TRUE；失败返回FALSE。

TKGetWindowAutoGesture

为指定窗口句柄取回当前自动手势配置设置。窗口自动手势能够使窗口中的内容自动响应Flick和Pan手势滚动。

要自动处理手势滚动，目标窗口一定要包含WS_VSCROLL 或 WS_HSCROLL(或者两者都包含)类型并且设置正确的范围。

该函数包含在WindowAutoGesture.h头文件中。

声明：

BOOL TKGetWindowAutoGesture(

                            HWND hWnd, 

                            LPWAGINFO lpAutoGestureInfo

                            );

参数：

hWnd：[in]目标窗口句柄。

lpAutoGestureInfo：[out] 指向WAGINFO结构的指针。

返回值：

成功返回TRUE；失败返回FALSE。调用GetLastError获取扩展错误信息。

备注：

在使用 TKSetWindowAutoGesture 或 TKGetWindowAutoGesture函数前必须要设置目标窗口的滚动类型。

TKSetWindowAutoGesture

为指定窗口指定自动手势配置设置。窗口自动手势能够使窗口中的内容自动响应Flick和Pan手势滚动。

要自动处理手势滚动，目标窗口一定要包含WS_VSCROLL 或 WS_HSCROLL(或者两者都包含)类型并且设置正确的范围。

该函数包含在WindowAutoGesture.h头文件中。

声明：

BOOL TKSetWindowAutoGesture(

                            HWND hWnd, 

                            LPWAGINFO lpAutoGestureInfo

                            );

参数：

hWnd：[in]目标窗口句柄。

lpAutoGestureInfo：[in]指向WAGINFO结构的指针。

返回值：

成功返回TRUE；失败返回FALSE。调用GetLastError获取扩展错误信息。

备注：

在使用 TKSetWindowAutoGesture 或 TKGetWindowAutoGesture函数前必须要设置目标窗口的滚动类型。

必须在lpAutoGestureInfo的dwflags成员中包含WAGIF_OWNERANIMATE 标志。

SDK提供的例子：

void ConfigureWAG(HWND hWnd)

{

    WAGINFO wagInfo = {sizeof(WAGINFO)};

    wagInfo.dwFlags = WAGIF_OWNERANIMATE | 

        (g_fHScrollable ? WAGIF_HSCROLLABLE : 0) | 

        (g_fVScrollable ? WAGIF_VSCROLLABLE : 0) | 

        (g_fAllowPAN    ? 0 : WAGIF_IGNOREPAN) |

        (g_fAllowSCROLL ? 0 : WAGIF_IGNORESCROLL) |

        (g_fLockAxis    ? WAGIF_LOCKAXES : 0);

    wagInfo.nOwnerAnimateMessage = (g_fUseWMSCroll ? 0 : WM_PRIVATEANIMATEMSG);

    wagInfo.nItemHeight = g_nVertItemSize;

    wagInfo.nItemWidth = g_nHorizItemSize;

    wagInfo.bHorizontalExtent = (BYTE)g_nHorizExtent;

    wagInfo.bVerticalExtent = (BYTE)g_nVertExtent;

    if (!TKSetWindowAutoGesture(hWnd, &wagInfo))

    {

        MessageBox( hWnd,

            TEXT("Failure from SetWindowAutoGesture()"),

            TEXT("Error"), 

            MB_OK);

    }

    // Make sure the item sizes are at least 1 for now - i.e. calculated size is 1 pixel

    g_nHorizItemSize = max(1,g_nHorizItemSize);

    g_nVertItemSize = max(1,g_nVertItemSize);

}

Gesture Macros (DTK)

下表显示支持手势的宏和用途。

名称	描述
GID_ROTATE_ANGLE_TO_ARGUMENT	从原始角度转换为弧度。
GID_ROTATE_ANGLE_FROM_ARGUMENT	从弧度转换为原始角度。
GID_SCROLL_ANGLE	从ullArguments 字段提取Flick手势角度。
GID_SCROLL_DIRECTION	从ullArguments 字段提取Flick手势方向。
GID_SCROLL_VELOCITY	从ullArguments 字段提取Flick手势速度。

GID_ROTATE_ANGLE_FROM_ARGUMENT

GID_ROTATE_ANGLE_TO_ARGUMENT

使用下面的宏在原始角度和弧度之间转换。该宏在Gesture.h头文件中。

声明：

GID_ROTATE_ANGLE_FROM_ARGUMENT(Arg)

GID_ROTATE_ANGLE_TO_ARGUMENT(Arg)

Arg为要转换参数。

在头文件定义为：

/*

* Gesture argument helpers

*   - Angle should be a double in the range of -2pi to +2pi

*   - Argument should be an unsigned 16-bit value

*/

#define GID_ROTATE_ANGLE_TO_ARGUMENT(_arg_)     ((USHORT)((((_arg_) + 2.0 * 3.14159265) / (4.0 * 3.14159265)) * 65536.0))

#define GID_ROTATE_ANGLE_FROM_ARGUMENT(_arg_)   ((((double)(_arg_) / 65536.0) * 4.0 * 3.14159265) - 2.0 * 3.14159265)

备注：

To convert the raw angle to radians, divide the raw angle by 32768, then multiply that value by 360/32768. 32768 units represent one full circle.

(要转换原始角度到弧度，原始角度除以32768，然后再乘以(360/32768)。32768 代表一个整圆。)

原始角度和当前系统方向有关(设备是横向还是纵向并不可知)。当系统旋转，手势方向和角度自动调整匹配旋转。

GID_SCROLL_ANGLE

GID_SCROLL_DIRECTION

GID_SCROLL_VELOCITY

这些宏分别从ullArguments 字段提取Flick手势的角度、方向和速度。该宏在Gesture.h头文件中。

声明：

GID_SCROLL_ANGLE(Arg)

GID_SCROLL_DIRECTION(Arg)

GID_SCROLL_VELOCITY(Arg)

Arg为要转换的原始角度。

在头文件定义为：

// Macros to extract scroll angles directions and direction

#define GID_SCROLL_ANGLE(x)              ((LONG)(HIWORD(((ULONGLONG)(x)) >> 32) & 0xFFF0))

#define GID_SCROLL_DIRECTION(x)          ((LONG)(HIWORD(((ULONGLONG)(x)) >> 32) & 0x000F))

#define GID_SCROLL_VELOCITY(x)           ((LONG)((short)(LOWORD(((ULONGLONG)(x)) >> 32))))

备注：

原始角度和当前系统方向有关(设备是横向还是纵向并不可知)。当系统旋转，手势方向和角度自动调整匹配旋转。

Gesture Messages (DTK)

下表显示支持手势的消息和用途。

名称	说明
WM_GESTURE	WM_GESTURE消息被发送至某个窗口过程代表一个手势已经发送或正在发送中。

WM_GESTURE

WM_GESTURE消息被发送至某个窗口过程代表一个手势已经发送或在Pan情况下，代表正在发送中。

WM_GESTURE消息可以从WndProc使用SendMessage(), SendMessageTimeout() 或 SendNotifyMessage() APIs同步发送。

注意WM_GESTURE消息不能从WndProc 使用PostMessage or PostThreadMessage异步发送。

窗口过程可以调用TKGetGestureInfo来检测手势的状态。

窗口通过WndProc 函数来接收消息。

语法：

WM_GESTURE

    WPARAM wParam

    LPARAM lParam

参数：

wParam：包含手势命令ID。

lParam：包含手势命令的HGESTUREINFO 句柄。

返回值:

如果程序处理了手势，它返回一个非0值。如果程序没有处理手势，应该把它传递给DefWindowProc ，返回值为DefWindowProc 的返回值。

备注：

根据手势ID，你要决定程序是否自己处理该手势或着是否传递该手势到DefWindowProc。GID_BEGIN 和 GID_END应该总被传给DefWindowProc。如果程序处理手势，那么它就不能把消息传递给默认窗口过程。

下面的代码显示如何根据手势ID来处理该手势。

GESTUREINFO gi;

memset(&gi, 0, sizeof(gi));

gi.cbSize = sizeof(GESTUREINFO);

if (GetGestureInfo((HGESTUREINFO)lParam, &gi))

{

    // Handle gesture indicated by wParam or gi.dwID

}

else

{

    // Error handling

}

HGESTUREINFO 句柄在WndProc调用前被创建，窗口过程返回时销毁。记住，程序不能为以后使用该句柄而保存HGESTUREINFO句柄。WM_GESTURE的lParam值在窗口过程外毫无意义，因为HGESTUREINFO 句柄直到DispatchMessage发送消息到窗口过程时才有效。因此，下面的代码不会正常工作：

while (GetMessage(&msg, NULL, 0, 0))

{

    if (msg.msg == WM_GESTURE)

    {

        GetGestureInfo(msg.lParam,...)

    }

}

一个传送到DefWindowProc的未处理的WM_GESTURE消息将被传送至父窗口。当在窗口键传送手势消息时，避免从父窗口发送消息至子窗口以避免在发生错误时关闭循环。

Gesture Structures (DTK)

下表显示支持手势的结构体及其用途。窗口自动手势能够使窗口中的控件和程序自动处理Flick和Pan手势。

名称	说明
ANIMATEMESSAGEINFO	该结构描述和窗口自动手势相关的动画数据。
GESTUREINFO	调用TKGetGestureInfo填充该结构，并且提供手势的全部详细信息。
GESTUREMETRICS	该结构包含有关时间和距离极限值的信息，这些值在触摸手势引擎识别某种手势类型时使用。该结构在TKGetGestureMetrics中使用。
WAGINFO	该结构为某个窗口描述其窗口自动手势配置。

ANIMATEMESSAGEINFO

该结构描述和窗口自动手势相关的动画。该特性能够使窗口中的控件和程序自动处理Flick和Pan手势。

在 TKGetAnimateMessageInfo 函数中使用该结构体。

声明：

typedef struct tagANIMATEMESSAGEINFO {

    size_t cbSize;

    DWORD dwAnimationID;

    int nVPixelPosition;

    int nHPixelPosition;

} ANIMATEMESSAGEINFO

参数：

cbSize：结构体的大小。必须要指定。

dwAnimationID：引起移动的动画类型。dwAnimationID必须设置为AMI_ANIMATION_TYPE_MOVE。

nVPixelPosition：垂直高度位置，按像素计算。

nHPixelPosition：水平宽度位置，按像素计算。

备注：

移动中的动画由Pan和Flick手势引起。

GESTUREINFO

调用TKGetGestureInfo填充该结构，并且提供手势的全部详细信息。

声明：

typedef struct tagGESTUREINFO {

    UINT cbSize;

    DWORD dwFlags;

    DWORD dwID;

    HWND hwndTarget;

    POINTS ptsLocation;

    DWORD dwInstanceID;

    DWORD dwSequenceID;

    ULONGLONG ullArguments;

    UINT cbExtraArguments;

} GESTUREINFO, *PGESTUREINFO;

参数：

cbSize：结构体大小。必须在调用TKGetGestureInfo前初始化为sizeof(GESTUREINFO)。

dwFlags：包含手势标志，可能为这些值值：GF_BEGIN 、GF_END 、GF_END | GF_INERTIA 。

dwID：手势命令。更多的手势定义，参见下面的备注。

hwndTarget：接收手势消息的目标窗口句柄。

ptsLocation：POINTS结构，包含和手势相关的屏幕坐标信息。

dwInstanceID：不使用。

dwSequenceID：手势时间戳。程序可以使用该值表示手势间的潜在时间(尤其在Flick和Pan之间)。

ullArguments：和命令相关的信息。封装到该字段的参数值依赖于手势命令。

cbExtraArguments：GetGestureExtraArguments函数返回的额外信息的大小。

备注：

下面的手势可以通过手势引擎识别。

GID_BEGIN

包含标记每个手势开始点的坐标。当触摸屏幕时发送。

GID_END

包含标记每个手势结束点的坐标。当手指或光笔从屏幕抬起后发送。当接收该命令后，GESTUREINFO 的 ullArguments 字段总是被设置为0。

GID_PAN

Pan在当用户在窗口上按下而且在任意方向移动（该过程手指保持和屏幕一直接触）时发生。识别引擎发送GID_PAN消息，该消息包含手势的开始点和当前点。在手指或光笔从窗口屏幕抬起前，会为每次窗口移动消息发送一次GID_PAN消息。GID_END 用来标记Pan移动的结束。

程序根据连续两次Pan手势间的差异计算移动增量。

如果设置GF_INERTIA标志，GESTUREINFO 的 ullArguments 值和GID_SCROLL 时一样。

GID_SCROLL

用户按下窗口(或者也可能在窗口上Pan)，然后手指或光标在任意方向迅速移动，当移动结束抬起手指或光笔前发生Scroll。

识别引擎在Flick手势后发送GID_SCROLL消息。GID_SCROLL会发送到接收当前触摸过程第一个手势消息的窗口，第一个手势消息可能是一个Pan消息或一个Hold消息。GESTUREINFO 的 ullArguments 字段包含关于角度、方向和Flick速度的信息。

主要的方向常量值如下：

   ARG_SCROLL_NONE

   ARG_SCROLL_RIGHT

   ARG_SCROLL_UP

   ARG_SCROLL_LEFT

   ARG_SCROLL_DOWN

当设备旋转时，手势自动调整匹配旋转。

Flick的角度值以从0至65535范围值计量。

可以使用下面的宏从GID_SCROLL手势消息的ullArguments 字段来提取出角度、方向和速度。

   GID_SCROLL_ANGLE

   GID_SCROLL_DIRECTION

   GID_SCROLL_VELOCITY

可以使用下面的宏在角度和弧度间相互转换。

   GID_ROTATE_ANGLE_TO_ARGUMENT

   GID_ROTATE_ANGLE_FROM_ARGUMENT

To convert the raw angle to radians, divide the raw angle by 32768, then multiply that value by 360/32768. 32768 units represent one full circle.

(要转换原始角度到弧度，原始角度除以32768，然后再乘以(360/32768)。32768 代表一个整圆。)

原始角度和当前系统方向有关(设备是横向还是纵向并不可知)。当系统旋转，手势方向和角度自动调整匹配旋转。

GID_SCROLL会被发送到接收当前触摸过程第一个手势消息的窗口，可能是一个Pan消息或一个Hold消息。

GID_HOLD

用户按下窗口并保持手指或光笔按住超过指定的超时时间，此时发生Hold。

识别引擎发送一个GID_HOLD消息，然后当手指或光笔抬起时发送一个GID_END 消息。

Hold 手势后可能会跟着Pan移动(移动过程会生成许多GID_PAN消息)，但是，在生成GID_PAN消息后绝不会再生成GID_HOLD消息。

ullArguments 字段不会在该命令中使用。

GID_SELECT

当用户用手指或光笔敲击屏幕，敲击过程时间小于系统指定的SELECT超时时间，此时发生Select。GESTUREINFO 的ullArguments 字段不会在该命令中使用。

GID_DOUBLESELECT

当用户用手指或光笔敲击两次屏幕，两次敲击过程时间小于系统指定的DOUBLESELECT超时时间，此时发生Double Select。

DOUBLESELECT超时时间是指连续两次鼠标抬起事件发生的间隔时间。

GESTUREINFO 的ullArguments 字段不会在该命令中使用。

GESTUREMETRICS

该结构包含有关时间和距离极限值的信息，这些值在触摸手势引擎识别某种手势类型时使用。该结构在TKGetGestureMetrics中使用。该结构包含在Gesture.h头文件中。

声明：

typedef struct tagGESTUREMETRICS {

    UINT   cbSize; 

    DWORD  dwID;

    DWORD  dwTimeout; 

    DWORD  dwDistanceTolerance; 

    DWORD  dwAngularTolerance;

    DWORD  dwExtraInfo;

} GESTUREMETRICS, *LPGESTUREMETRICS;

参数：

cbSize：结构体大小，按字节计算。必须设置该值。

dwID：包含手势识别ID，dwID 必须被设置为下面的一种：

GID_PAN

GID_ SCROLL

GID_HOLD

GID_SELECT

GID_DOUBLESELECT

所有其他的字段会按照需要根据dwID的值重写。

dwTimeout：毫秒值。按照下面的方式，根据dwID中的值翻译该值。

GID_SCROLL 从触摸屏幕到维持该接触到Scroll手势被识别的最大时间。该值为250。

GID_HOLD 从触摸屏幕某点后到Hold手势识别经过的时间。该值为250。

GID_SELECT 从触摸开始到离开屏幕，直到Select手势被识别的最大时间。该值为901。

GID_DOUBLESELECT 连续两次Select手势能够被Double Select识别的最大间隔时间。如果连续两次Select手势的间隔时间大于Double select手势的超时时间，那么第二次手势会被识别为Select手势。该值为350。

GID_PAN 该值不被使用。

dwDistanceTolerance：一英尺的1/1000。按照下面的方式，根据dwID中的值翻译该值。

GID_SCROLL：如果一个Scroll手势被识别，触摸接触移动的最小距离。该值为198。

GID_HOLD：触摸接触在屏幕上移动能够被识别为Hold手势的最大距离公差(手指接触点的边界半径)。该值为197。

GID_SELECT：触摸接触在屏幕上移动能够被识别为Select手势的最大距离公差(手指接触点的边界半径)。该值为197。

GID_DOUBLESELECT：识别为Double Select手势的连续两个Select手势的最大距离公差(从第一个接触点到第二个接触点)。如果距离超过，第二个手势被识别为Select手势。该值为197。

GID_PAN：一个触摸接触能够被识别为Pan手势必须移动的最小距离公差(从第一个接触点到第二个接触点)。返回值为198。

dwAngularTolerance：弧度值。按照下面的方式，根据dwID中的值翻译该值。

GID_SCROLL：

The maximum amount of angular tolerance that a touch contact can diverge within for a scroll gesture to be recognized. The return value is 0.34586 (in radians).

(Scroll手势被识别时，触摸接触分向(diverge)被识别的最大角度公差。该值为0.34586，按弧度值计算。)

GID_HOLD 、GID_SELECT 、GID_DOUBLESELECT 、GID_PAN 不被使用。

dwExtraInfo：指定手势依赖的值。按照下面的方式，根据dwID中的值翻译该值。

GID_SCROLL：水平或垂直轴上角度分向的最大允许值。一个有效的滚动手势根据该值被分为四个主要的预定义方向：上、下、左、右。该参数被称为是滚动手势方向公差。该值为0.50000，按弧度值计算。

GID_HOLD 、GID_SELECT 、GID_DOUBLESELECT 、GID_PAN 不被使用。

WAGINFO

该结构为某个窗口描述其窗口自动手势配置。窗口自动手势能够使窗口中的内容自动响应Flick和Pan手势滚动。该结构在TKSetWindowAutoGesture 和TKGetWindowAutoGesture结构中使用。

声明：

typedef struct tagWAGI {

    size_t cbSize;

    DWORD dwFlags;

    UINT nOwnerAnimateMessage;

    UINT nAnimateStatusMessage;

    HBRUSH hExtentBrush;

    UINT nItemHeight;

    UINT nItemWidth;

    BYTE bHorizontalExtent;

    BYTE bVerticalExtent;

} WAGINFO

参数：

cbSize：结构体大小，按字节计算。

dwFlags：位掩码，有下列属性组成：

WAGIF_OWNERANIMATE	该标志是必需的。它表示由nOwnerAnimateMessage识别的动画消息被发送到窗口过程。当设置该标志时，窗口过程负责管理滚动条位置并绘制控件内容。
WAGIF_VSCROLLABLE	使垂直滚动支持Pan和Flick。如果未设置，Pan和Flick的垂直分量将被取消。该标志和WAGIF_HSCROLLABLE 组合为全向滚动。
WAGIF_HSCROLLABLE	使水平滚动支持Pan和Flick。如果未设置，Pan和Flick的水平分量将被取消。该标志和WAGIF_VSCROLLABLE 组合为全向滚动。
WAGIF_LOCKAXES	除非WAGIF_VSCROLLABLE和WAGIF_HSCROLLABLE都被设置，否则取消该标志。设置该标志意味着退出启动任意方向滚动。相反，滚动将沿着水平或垂直轴发生。记住，对Windows Mobile 6.5，该标志仅适用于Flick消息。Pan消息处理不受影响，除非设置WAGIF_IGNOREPAN标志。
WAGIF_IGNOREPAN	关闭Pan消息自动手势处理。
WAGIF_IGNORESCROLL	关闭Flick消息自动手势处理。

nOwnerAnimateMessage：动画消息ID。该消息在一个触摸交互后被发送至窗口过程来重绘窗口内容。消息ID必须为WM_USER或更大值。关于该消息内容的更多信息，参见TKGetAnimateMessageInfo。

或者，设置该值为0来取回WM_HSCROLL 或 WM_VSCROLL(或者全部)消息，代替取回WAG动画消息。

当nOwnerAnimateMessage设置为0，HorizontalExtent和bVerticalExtent被取消。

nAnimateStatusMessage：消息被发送至窗口过程来表示动画的一个状态改变，比如开始或结束。该消息必须为 WM_USER或更大值。

该值为0代表没有动画状态消息要被发送。

lParam 值包含标识动画状态的信息，可能为如下值：

WAG_STATUS_ANIMATION_START

WAG_STATUS_ANIMATION_END

WAG_STATUS_ANIMATION_CHANGE

WAG_STATUS_ANIMATION_CHANGE 表示滚动输入模式发生了改变。

wParam 值包含更多关于lParam 值的信息。

如果lParam值是WAG_STATUS_ANIMATION_START 或 WAG_STATUS_ANIMATION_CHANGE，有效的wParam值是WAG_STATUS_ANIMATION_CONTINUOUS(表示持续的输入或Pan)或WAG_STATUS_ANIMATION_DISCRETE(一个单独的输入事件，比如Flick)。
如果lParam值是WAG_STATUS_ANIMATION_END，那么wParam值是WAG_STATUS_ANIMATION_ FINISHED(动画终止，没有任何中断)或 WAG_STATUS_ANIMATION_INTERRUPTED(动画被中断，比如点击由上次Flick引起的正在滚动的列表)。

nItemHeight：滚动范围内每项的高度，按像素计算。滚动范围指的是支持滚动的区域。如果该值为0，项高度使用下面的公式自动计算：

nItemHeight = / .

当该值为0，如果窗口大小发生改变，高度被重新计算。

nItemWidth：滚动范围内每项的宽度，按像素计算。滚动范围指的是支持滚动的区域。如果该值为0，项高度使用下面的公式自动计算：

nItemWidth = / .

当该值为0，如果窗口大小发生改变，宽度被重新计算。

bHorizontalExtent：The percentage of the viewable window height that can be extended beyond the scroll range in the horizontal axis, from 0 to 100. The default bHorizontalExtent value is 0.

一旦达到扩展极限值，将不会再处理Pan消息。

如果nOwnerAnimateMessage设置为0，bHorizontalExtent 和 bVerticalExtent 都被取消。

bVerticalExtent：The percentage of the viewable window width that can be extended beyond the scroll range in the vertical axis, from 0 to 100. The default bVerticalExtent value is 0.

一旦达到扩展极限值，将不会再处理Pan消息。

如果nOwnerAnimateMessage设置为0，bHorizontalExtent 和 bVerticalExtent 都被取消。

备注：

如果dwFlags标志不包含WAGIF_OWNERANIMATE标志，那么TKSetWindowAutoGesture 将会调用失败！

Physics Engine Overview

物理引擎给触摸手势计算好明确的动画点。因为动画在中央引擎中计算，因此手势动画能够始终如一的贯穿系统。该引擎仅仅为和二维滚动相关的手势计算动画。

当给定动画信息，比如动画初始速度和角度以及有关动画应该如何处理边界条件，物理引擎会生成一连串动画点。在动画生命周期的任何时间内都可以请求获得动画点。

如果想预先构造一个动画,需要给引擎提供一组时间戳然后接收和这些时间戳对应的一组动画点集合。也可以使用该方法进行你的动画测试。

当使用物理引擎时，必须分别为每组动画点集合创建一个独立的物理引擎对象实例。

边界和可见区域：

物理引擎基于边界和可见区域概念。边界是一个逻辑矩形，代表整个控件。可见区域是控件的一部分，它是在任何时间都可见的部分。

动画有速度和方向，它们决定可见区域如何做移动，这需要考虑边界。动画会引起可见区域移动至边界极限。当移动至边界极限时，如何指定，将发生边界动画。边界动画可能为下面一种类型：

橡皮筋。可见区域临时移除边界，然后迅速返回至边界，就好像是橡皮筋效果一样。
什么都没有。可见区域在到达边界边缘时立即停止。

动画停止点：

在动画结束后，有可能出现摸个控件内的项出现被截断的现象，这依赖于动画在哪里停止。

如果控件内的所有项都是固定大小，你可以在创建物理引擎的时候指定每项的大小。物理引擎将根据每项的固定大小计算动画的停止点，以便在动画结束时可见区域能够对准每项的边界。

Physics Engine Reference (DTK)

该部分包含对支持手势物理引擎的编程元素的描述。包括：

Physics Engine Functions (DTK)：提供使用手指或光笔控制设备交互的可用函数的概述。

Physics Engine Structures：提供使用手指或光笔控制设备交互的可用结构体的概述。

Physics Engine Constants：提供使用手指或光笔控制设备交互的可用消息的概述。

Physics Engine Functions (DTK)

下表显示支持物理引擎的函数及其用途：

名称	说明
TKCreatePhysicsEngine	创建物理引擎
TKDestroyPhysicsEngine	销毁物理引擎
TKSetPhysicsEngineUserTime	该函数可以手动为物理引擎设置时间。
TKQueryPhysicsEngine	该函数取回物理引擎的当前状态。

TKCreatePhysicsEngine

创建物理引擎并返回新物理引擎的句柄。必须创建一个PHYSICSENGINEINIT结构来指定物理引擎的参数并传递给该函数。

该函数包含在GesturePhysicsEngine.h头文件中。

声明：

HRESULT TKCreatePhysicsEngine(

                              __in const PHYSICSENGINEINIT* pEngineInit,

                              __out HPHYSICSENGINE* phResult

                              );

参数：

pEngineInit：指向PHYSICSENGINEINIT结构的指针。该结构指定物理引擎的配置参数。

phResult：指向HPHYSICSENGINE类型变量的的指针，用来接收新创建的物理引擎的句柄。

返回值：

返回值可能为下面的值，它也可能返回其他值，应该使用SUCCEEDED和FAILED宏来测试。

S_OK：表示物理引擎创建成功。

E_INVALIDARG：表示参数无效。

E_OUTOFMEMORY：表示系统没有足够的内存来创建物理引擎。

TKDestroyPhysicsEngine

销毁物理引擎。该函数包含在GesturePhysicsEngine.h头文件中。

声明：

HRESULT TKDestroyPhysicsEngine(

                               HPHYSICSENGINE hEngine

                               );

参数：

hEngine：物理引擎对象句柄。

返回值：

S_OK：表示物理引擎销毁成功。

Indicates that the physics engine is successfully destroyed.

E_INVALIDARG：传入的hEngine句柄无效。

TKQueryPhysicsEngine

取回物理引擎的状态。如果引擎模式是默认模式，引擎状态基于当前系统时钟的时间。如果系统模式为PHYSICSENGINE_FLAG_USERTIME，那么引擎状态将基于最近调用的TKSetPhysicsEngineUserTime函数中指定的时间。.

该函数包含在GesturePhysicsEngine.h头文件中。

声明：

HRESULT TKQueryPhysicsEngine(

                             HPHYSICSENGINE hEngine,

                             __out PHYSICSENGINESTATE* pState

                             );

参数：

hEngine：物理引擎对象句柄。

pState：指向PHYSICSENGINESTATE结构的指针，该结构指示物理引擎的状态。

返回值：

返回值可能为下面的值，它也可能返回其他值，应该使用SUCCEEDED和FAILED宏来测试。

S_OK：表示获取物理引擎状态成功。

E_INVALIDARG：表示某个参数无效。

E_UNEXPECTED：表示物理引擎对象没有被初始化。

TKSetPhysicsEngineUserTime

在动画开始时，设置物理引擎对象的当前时间戳。可以使用该函数模拟限时的有序步骤，例如，检测动画过程或重现指定的测试情形。

使用该函数，物理引擎必须是创建在PHYSICSENGINE_FLAG_USERTIME 模式下。

该函数包含在GesturePhysicsEngine.h头文件中。

声明：

HRESULT TKSetPhysicsEngineUserTime(

                                   HPHYSICSENGINE hEngine,

                                   DWORD dwTime

                                   );

参数：

hEngine：物理引擎对象句柄。

dwTime：和动画开始相关的时间戳，按毫秒计算。

返回值：

返回值可能为下面的值，它也可能返回其他值，应该使用SUCCEEDED和FAILED宏来测试。

S_OK：表示物理引擎时间设置成功。

E_INVALIDARG：物理引擎句柄无效。

E_UNEXPECTED：物理引擎不是PHYSICSENGINE_FLAG_USERTIME 模式。

备注：

当物理引擎在PHYSICSENGINE_FLAG_USERTIME 模式下创建，时间设置为0。

必须调用TKSetPhysicsEngineUserTime函数并指定比物理引擎当前时间戳值大的时间戳，否则，物理引擎可能会为动画计算错误的停止点。

Physics Engine Constants

下表的常量被用于物理引擎API:

名称	值	说明
PHYSICSENGINE_BOUNDARY_MODE_NONE	0	表示当手势动画到达边界时，没有指定的动画发生。
PHYSICSENGINE_BOUNDARY_MODE_RUBBERBAND	1	表示当手势动画到达边界时，会产生橡皮筋动画。

PHYSICSENGINE_MOVEMENT_MODE_DECELERATE	0	表示动画速度随着时间减慢。
PHYSICSENGINE_FLAG_USERTIME	1	表示引擎时间由用户指定。

备注：

可以使用这些常量构造PHYSICSENGINEINIT结构来配置物理引擎。

Physics Engine Structures

下面显示支持物理引擎的结构体及其用途：

PHYSICSENGINEINIT：该结构体定义了用于创建物理引擎的初始化参数。

PHYSICSENGINESTATE：该结构体描述了在当前引擎时间戳下物理引擎的状态。

PHYSICSENGINEINIT

描述初始化物理引擎对象的参数。要创建物理引擎，必须给TKCreatePhysicsEngine传递指向该结构体的指针。

该结构体在GesturePhysicsEngine.h头文件中。

声明：

typedef struct tagPHYSICSENGINEINIT {

    DWORD cbSize;

    DWORD dwEngineType;

    DWORD dwFlags;

    LONG lInitialVelocity; 

    DWORD dwInitialAngle;

    BYTE bXAxisMovementMode;

    BYTE bXAxisBoundaryMode;

    BYTE bYAxisMovementMode;

    BYTE bYAxisBoundaryMode;

    RECT rcBoundary;

    SIZE sizeView;

    POINT ptInitialPosition;

    SIZE sizeItem;

} PHYSICSENGINEINIT;

成员：

cbSize：指定结构体大小，按字节计算。必须设置为sizeof(PHYSICSENGINEINIT)。

dwEngineType：保留，设置为0。

dwFlags：指定控制引擎行为的标志，可用值有：

0 ：默认模式。
PHYSICSENGINE_FLAG_USERTIME：用户指定的时间模式。

默认模式下，物理引擎从系统时钟读取时间。

用户指定时间模式下，必须调用TKSetPhysicsEngineUserTime设置时间

lInitialVelocity：指定触摸手势动画的初始化速度，单位为“像素每秒(in pixels per second)”。

dwInitialAngle：动画的初始化角度。该值的范围是：0至65536。0代表-2pi弧度，指向东部；65536代表+2pi。角度按照逆时针方向增加。

bXAxisMovementMode：指定X轴移动模式。必须设置为PHYSICSENGINE_MOVEMENT_MODE_DECELERATE。

bXAxisBoundaryMode：指定当边界到达X轴时的动画行为。有效值有：

PHYSICSENGINE_BOUNDARY_MODE_NONE：没有动画

PHYSICSENGINE_BOUNDARY_MODE_RUBBERBAND：橡皮筋动画

bYAxisMovementMode：指定Y轴移动模式。必须设置为PHYSICSENGINE_MOVEMENT_MODE_DECELERATE。

bYAxisBoundaryMode：指定当边界到达Y轴时的动画行为。有效值有：

PHYSICSENGINE_BOUNDARY_MODE_NONE：没有动画

PHYSICSENGINE_BOUNDARY_MODE_RUBBERBAND：橡皮筋动画

rcBoundary：指定定义内容边界的矩形。边界包含所有内容，包括整个用户控件。

sizeView：指定可见区域的尺寸。

ptInitialPosition：指定可见区域左上角的初始位置。

sizeItem：指定每项大小，主要用于动画突然停止时。二维方向中小于1的项都被当成1。物理引擎只在项边界停止动画。如果项的大小为1，物理引擎可以在任一点停止。

备注：

如果该结构任何成员包含无效数据， TKCreatePhysicsEngine都将返回E_INVALIDARG。

PHYSICSENGINESTATE

该结构描述在当前引擎时间下的物理引擎状态。该结构在调用TKQueryPhysicsEngine函数时生成。

该结构体在GesturePhysicsEngine.h头文件中。

声明:

typedef struct tagPHYSICSENGINESTATE {

    DWORD cbSize; 

    DWORD dwTime;

    POINT ptPosition;

    LONG lVelocityX;

    LONG lVelocityY;

    BOOL fComplete;

} PHYSICSENGINESTATE;

成员：

cbSize：指定该结构体的大小，按字节计算。必须设置为sizeof(PHYSICSENGINESTATE)。

dwTime：指定当前引擎时间，按毫秒计算。

ptPosition：指定当前动画位置，按像素计算。

lVelocityX：指定X轴方向的速度，单位为“像素每秒”(in pixels per second)。

lVelocityY：指定Y轴方向的速度，单位为“像素每秒”(in pixels per second)。

fComplete：指定动画是否完成。

备注：

如果cbSize 没有设置为sizeof(PHYSICSENGINESTATE)，TKQueryPhysicsEngine将返回E_INVALIDARG。

评论: 0　查看评论　发表评论

最新新闻：
· 美调查公司称苹果iPad配件成本最低219美元(2010-02-10 17:20)
· 摩尔庄园：儿童生意密码(2010-02-10 17:15)
· Facebook与美国在线合作整合AIM动态功能(2010-02-10 16:41)
· NDepend 3.0已与Visual Studio集成(2010-02-10 16:17)
· Ruby in Steel 1.5发布，去除IronRuby支持(2010-02-10 16:14)

编辑推荐：Google Buzz相关新闻

网站导航：博客园首页个人主页新闻闪存小组博问社区知识库

Windows Mobile Gesture 开发学习 - 持续更新

李森 - listen — Fri, 29 Jan 2010 07:27:00 GMT

阅读: 104 评论: 0 作者: 李森 - listen 发表于 2010-01-29 15:27 原文链接

下面是学习Windows Mobile Gesture 手势开发的一些不错的文章，在此做下记载，供大家一起学习。当然你可以完全不使用Windows mobile本身的Gesture，自己写一套也不是什么困难的事情，主要就是数值精确性调整。除非你能保证写的比它好，否则，既然有了，何乐而不为呢？但是在WM6.5前，你就不得不自己写了。

 最权威资料: MSDN 
Using Gestures in Windows Mobile 6.5 

 在 Alex Yakhnin's Blog 的 Managed wrapper of the Gesture APIs 一文介绍了托管版本的Gesture API 开发，并有托管版本代码下载，下载链接为：Windows Mobile Managed Gestures Sample。同时，在MSDN Webcast上提供了学习视频，如下：
MSDN Webcast: Developing for Windows Mobile 6.5 Devices: Using the Gesture APIs (Part 1 of 2) (Level 400)
MSDN Webcast: Developing for Windows Mobile 6.5 Devices: Using the Gesture APIs (Part 2 of 2) (Level 400) 

  Marcus Perryman 的
Let’s Talk About Touch (Part1)
Let’s Talk About Touch (Part2)

  To be continued ...

评论: 0　查看评论　发表评论

编辑推荐：Google Buzz相关新闻

网站导航：博客园首页个人主页新闻闪存小组博问社区知识库

定时器潜在的6ms延迟 - ~6ms latency in the timer

李森 - listen — Fri, 29 Jan 2010 06:45:00 GMT

阅读: 72 评论: 3 作者: 李森 - listen 发表于 2010-01-29 14:45 原文链接

如果你做过Windows mobile Gesture开发，就会在 GesturePhysicsEngine.h 头文件发现如下一段定义说明：

/// 

/// Defines a common value for a normal frame delay rate expected to be used when displaying 

/// output from the physics engine. We are aiming at 25fps and also allow ~6ms latency in the timer 

/// 

#define GESTURE_ANIMATION_FRAME_DELAY_MS  34

该文件在 “..\Windows Mobile 6 SDK\PocketPC\Include\Armv4i\” 目录下。注释的大概意思为：

“为普通帧延迟率定义一个公共值，该值在从物理引擎显示输出时使用。目标是25fps并且允许定时器中潜在的6ms延迟。”

从上面的注释我们可以知道：在每帧刷新后可能有6秒延迟，设置的延迟为34ms，所以实际的每帧需要的时间为40ms。

上面的定义也说明了这点：

#define GESTURE_ANIMATION_FRAME_DELAY_MS 34

1000 / 34 ≈ 29;

如果考虑到6ms的延迟，那么：

1000 / (34 + 6) = 25;

刚好和注释中的25fps吻合，这也就证明了我们的观点。

评论: 3　查看评论　发表评论

编辑推荐：Google Buzz相关新闻

网站导航：博客园首页个人主页新闻闪存小组博问社区知识库

Windows mobile Today Screen 基础

李森 - listen — Tue, 26 Jan 2010 12:35:00 GMT

阅读: 126 评论: 6 作者: 李森 - listen 发表于 2010-01-26 20:35 原文链接

原文为：MSDN的 Today Screen

前引

在Windows Mobile 6 Professional 和 Windows Mobile 6 Classic，今日屏幕是用户可以启动他们大多数程序的地方。今日屏幕提供以下优势：

用户自己定制开始点
对今日插件的一致访问
移动运营商可以提供其品牌信息

今日屏幕给用户提供一个集中的地方来方便的查看Windows Mobile 6 Professional 和 Windows Mobile 6 Classic设备中的主要信息和高优先级信息。开发人员可以为他们的程序创建一个定制的今日屏幕插件来提供关键信息。例如，一个销售自动化程序能够给销售人员提供当天将要拜访的顾客的重要信息。设备也可以自动超时并在一个用户配置的终止时间段后返回到今日屏幕，默认时间为4小时。(也就是如果屏幕在4小时内没有任何事件响应，将自动进入今日屏幕)。

注意：默认，Windows Mobile 6 Professional 和 Windows Mobile 6 Classic包含Messaging, Calendar, Tasks, 和Owner Information等今日屏幕程序。用户可以选择在今日屏幕中是否显示或按照什么顺序显示这些程序。

编写今日插件项 (Writing a Custom Today Screen Item)

一个定制的今日屏幕插件简单的说就是个DLL，它实现指定的接口然后以今日屏幕能够查找的方式注册。每个DLL必须按照指定序号导出一个要求的函数和一个可选函数。InitializeCustomItem(序号为240)创建子窗口来显示数据，这是所有今日屏幕插件必须要求的函数。如果今日屏幕插件支持选择对话框来允许用户做出改变，比如显示什么内容或怎么显示，那么该DLL必须导出CustomItemOptionsDlgProc(序号为241)。为该DLL指定.def文件，内容如下：

EXPORTS

InitializeCustomItem @ 240 NONAME

CustomItemOptionsDlgProc @ 241 

NONAME

窗口创建后，今日屏幕每2秒钟发送一次WM_TODAYCUSTOM_QUERYREFRESHCACHE消息给子窗口来检查显示数据是否发生改变并需要重绘。要想最少次数的重绘今日屏幕，每个插件必须仅在数据需要重绘时才返回TRUE，这也是唯一需要更新窗口高度的时候。如果窗口高度设置为0，今日屏幕不再发送WM_PAINT到子窗口。当今日屏幕程序必须强制所有组件刷新他们的数据时，将发送WM_TODAYCUSTOM_CLEARCACHE消息和TODAYLISTITEM结构类型的wParam参数到今日插件。如果你的组件缓存了数据（由TODAYLISTITEM结构的prgbCachedData成员指向），那么应该在收到该消息时释放内存。对于没有缓存任何数据的今日插件项，WM_TODAYCUSTOM_CLEARCACHE消息句柄可以返回0。

用户可以和今日屏幕插件进行交互，一般通过切换到其他程序，然后在该程序中显示呈现在今日屏幕插件项中的数据。用户随后可以编辑或操作这些数据。为了更方便进行这些交互，今日屏幕程序应该检查WM_LBUTTONUP消息并做出相应的动作。

在Pocket PC 2002 软件，随后是主题，都是图像和颜色选择的组合，他们都可以应用到今日屏幕，因此今日屏幕程序应该包括是背景显示透明的代码。你可以使用TODAYDRAWWATERMARKINFO结构来完成这个效果。

备注：

Windows Mobile 6 Professional SDK有一个叫做“Memory Watcher”的代码例子。它描述了怎样创建一个今日屏幕插件。默认，一般在 C:\Program Files\Windows Mobile 6 SDK\Samples\PocketPC\CPP\win32\memwatcher\memwatcher.sln 位置下可以找到。

怎样装载和注册一个定制的今日屏幕插件 (How to: Install and Register a Custom Today Screen Item)

要装载一个定制的今日插件，需要为今日组件拷贝该DLL然后注册该组件。

要注册一个在Sample.dll中实现的“My Today Item”组件：

在HKEY_LOCAL_MACHINE\Software\Microsoft\Today\Items 下创建一个叫做 “My Today Item”的新键。
在HKEY_LOCAL_MACHINE\Software\Microsoft\Today\Items\My Today Item 下添加在下表中显示的值。

值名	类型	数据	说明：
Type	DWORD	4	所有定制的插件都为4
Enabled	DWORD	1	0或1。标识该插件是否在今日屏幕中显示。如果Enabled=0，用户可以在Setting页面今日程序中的Items标签列表下选中单选框来显示该插件。
Options	DWORD	1	0或1。标识插件是否有Options对话框
DLL	String	"\Windows\Sample.DLL"	DLL的全路径或名称
Selectability	DWORD	1	0，1或2。0代表不支持可选；1代表插件支持可选，shell将会处理Up/Down消息；2代表插件支持可选，并且自己处理Up/Down消息。

你最有可能使用CabWiz 创建一个.cab文件来装载今日插件，下面的例子显示了.inf文件中将会显示的注册信息。

[Reg.All]
HKLM,Software\\cf3 Microsoft\\cf3 Today\\cf3 Items\\cf3 My Today Item,Type,0x00010001,4
HKLM,Software\\cf3 Microsoft\\cf3 Today\\cf3 Items\\cf3 My Today Item,Enabled,0x00010001,1
HKLM,Software\\cf3 Microsoft\\cf3 Today\\cf3 Items\\cf3 My Today Item,Options,0x00010001,1
HKLM,Software\\cf3 Microsoft\\cf3 Today\\cf3 Items\\cf3 My Today Item,Selectability,0x00010001,2
HKLM,Software\\cf3 Microsoft\\cf3 Today\\cf3 Items\\cf3 My Today Item,DLL,0x00000000,"\Windows\Sample.DLL" 

附：

如果DLL值指向的位置不在Windows 目录，插件那么将不会运行。

对于DLL值，有如下几点发现：

不一定需要完全路径。如果没完全路径，默认为 "\Windows" 目录
如果指定了路径，它只能是 "\Windows\..."。将路径设置到其他目录(比如"\Program Files\MyAppDir\...") 将导致不能正常加载和显示你的今日插件项。

导航今日屏幕插件中的Icons (Navigating Icons in Today Screen Plug-in)

今日屏幕插件中的icons支持硬件导航。可以使用导航键、键盘或光笔来导航icons。一旦接收聚焦，最左边的icon将高亮显示。

使用导航键导航icons下表显示用来导航icons的导航键

键	动作
Left	移动焦点至左侧icon。如果当前icon已经是最左边，释放焦点至前一个插件。
Right	移动焦点至右侧icon。如果当前icon已经是最右边，释放焦点至下一个插件。
Down	释放焦点至下一个插件
Up	释放焦点至上一个插件
Action	该键就象是点击屏幕上的icon一样，可以模拟成发送一个点击消息(位于icon的中心)到拥有该icon的程序。
[Other]	什么也不做.

使用键盘导航icons

下表显示用来导航icons的键盘键

键	动作
Left	和导航键一样
Right	和导航键一样
Down	和导航键一样
Up	和导航键一样
Enter	和导航键一样
[Other]	什么也不做.

使用光笔导航icons

用户点击icon来触发相应事件。

异常

如果用户在选择icon时旋转设备屏幕，选择将被取消

如果icon被选择并且拥有icon的进程已经从今日屏幕中移除，选择将被取消

选择今日屏幕插件(Today Screen Plug-in Selection)

The Windows Mobile 6 Professional and Windows Mobile 6 Classic 今日屏幕可以不使用光笔单手操作。正因为该特点，今日屏幕所有项接收选择通知消息。这些消息和WM_SETFOCUS和WM_KILLFOCUS消息类似，都是由Windows Mobile软件发送到子窗体控件。该部分描述怎样通知今日屏幕插件消息通知。

Windows Mobile软件自动处理还没有更新的今日屏幕插件的选择来支持选择焦点通知。如果插件的响应依赖屏幕点击，则必须更新插件以支持选择焦点通知。

注意：该部分定义的所有消息都在todaycmn.h 头文件中包含。

该部分包含：

Receiving the Selection Focus：描述WM_TODAYCUSTOM_RECEIVEDSELECTION 和 TODAYM_DRAWWATERMARK消息。
Taking the Selection Focus：描述TODAYM_TOOKSELECTION消息。
Receiving Keypad Presses：描述action和导航消息。
Losing the Selection Focus：描述WM_TODAYCUSTOM_LOSTSELECTION消息。
Drawing the Today Screen Watermark：描述TODAYM_DRAWWATERMARK消息。

接收选择焦点(Receiving the Selection Focus)

当用户使用键盘导航今日屏幕项时，插件接收一个WM_TODAYCUSTOM_RECEIVEDSELECTION消息。而且，不管Selectability的值为多少，它都接收一个WM_ERASEBKGND消息和一个WM_PAINT消息以便重画它的内容。

给父窗口发送TODAYM_DRAWWATERMARK消息将总是绘制一个未选的背景(除非今日屏幕项背选中并且Selectability值为1，此时高亮背景被绘制)。当Selectability值为1，并不需要修改代码来绘制正确的背景，但是如果值为2，插件必须绘制它自己的背景。应该使用TODAYCOLOR_HIGHLIGHT(0x10000022)色作为他的背景色，TODAYCOLOR_HIGHLIGHTEDTEXT(0x10000023)色作为它的前景色——全部可以通过TODAYM_GETCOLOR消息得到。

WM_TODAYCUSTOM_RECEIVEDSELECTION定义为 (WM_USER + 244)，wParam 参数将设置为虚键码来导航该项(比如，VK_DOWN 或 VK_UP)；lParam 参数不被设置。如果插件接受选择改变，它应该返回TRUE，否则，今日屏幕将选择传递到下一项。下面的代码例子显示了今日屏幕将选择传递到下一项。

case WM_TODAYCUSTOM_RECEIVEDSELECTION:
    g_bSelected = TRUE;
    return TRUE;

处理选择焦点(Taking the Selection Focus)

今日屏幕插件也能请求选择焦点，比如响应一个用户点击。要做到这点，插件必须发送TODAYM_TOOKSELECTION消息到它的父窗口。

TODAYM_TOOKSELECTION定义为(WM_USER + 102)。wParam 参数为插件窗口句柄。lParam 参数不被使用，可以设置为0。

case WM_LBUTTONDOWN:
    PostMessage(GetParent(hwndPlugin), TODAYM_TOOKSELECTION, (WPARAM)hwndPlugin, 0);
    break;

接收键盘按下(Receiving Keypad Presses)

一旦今日屏幕插件有选择焦点，每次键盘按钮按下都会使其接收一个WM_TODAYCUSTOM_USERNAVIGATION 消息。如果插件在内部处理键盘按下，它应该返回TRUE来响应该消息。另外，如果上下键被按下，今日屏幕传递选择到下一项，可以使用此来导航一系列子项。

WM_TODAYCUSTOM_USERNAVIGATION 定义为(WM_USER + 246)。wParam 参数设置为虚键码（比如VK_UP, VK_LEFT等）；不使用lParam参数。

action 按键使用不同的方式处理。如果action 按键被按下，插件接收一个WM_TODAYCUSTOM_ACTION 消息，除非Selectability 值为1，此时它在(1,1)坐标接收一个WM_LBUTTONDOWN消息和一个WM_LBUTTONUP消息来模拟用户点击。

WM_TODAYCUSTOM_ACTION 定义为(WM_USER + 247)。wParam 参数等于action键的虚键值(比如，VK_RETURN)；不使用lParam 参数。取消消息的返回值。看下面的例子：

case WM_TODAYCUSTOM_USERNAVIGATION:
    InvalidateRect(hwnd, NULL, FALSE);

    if (wParam == VK_UP)   g_nSelectedItem--;
    if (wParam == VK_DOWN) g_nSelectedItem++;

    if (g_nSelectedItem < 0 || g_nSelectedItem >= MAX_ITEMS)
    {
        return FALSE; // go to the next plug-in
    }
    else
    {
        return TRUE;  // stay in this plug-in
    }

case WM_TODAYCUSTOM_ACTION:
    OnAction();
    break;

失去选择焦点(Losing the Selection Focus)

当插件时区焦点，它会收到一个WM_TODAYCUSTOM_LOSTSELECTION消息。不管Selectability 注册值为多少，插件都会接收WM_ERASEBKGND 和 WM_PAINT 消息以便能够重绘它的内容。

注意：当插件接收到WM_TODAYCUSTOM_LOSTSELECTION 消息后必须调用 InvalidateRect来确保当滚动时被正确的刷新。

WM_TODAYCUSTOM_LOSTSELECTION定义为(WM_USER + 245)。wParam 和 lParam都不使用，返回值也取消。如下例：

case WM_TODAYCUSTOM_LOSTSELECTION:
    g_bSelected = FALSE;
    break;

绘制今日屏幕水印图案(Drawing the Today Screen Watermark)

当今日屏幕插件发送TODAYM_DRAWWATERMARK消息到它的父窗口(今日屏幕)时，今日屏幕将绘制相应的水印。消息的lParam 参数是一个指向TODAYDRAWWATERMARKINFO 结构的指针，该结构在todaycmn.h头文件中可以找到。

在插件中，该消息可以在WndProc 中通过一个消息来处理：

case WM_ERASEBKGND:
    {
        TODAYDRAWWATERMARKINFO twm;
        twm.hdc = (HDC)wParam;
        twm.hwnd = hWnd;

        GetClientRect(hWnd, &(twm.rc));
        SendMessage(GetParent(hWnd), TODAYM_DRAWWATERMARK, 0, (LPARAM)&twm);
    }
    break;

今日屏幕插件注册设置(Today Screen Plug-in Registry Settings)

HKEY_LOCAL_MACHINE\Software\Microsoft\Today\Items 注册键控制今日屏幕插件的特性。下表显了HKEY_LOCAL_MACHINE\Software\Microsoft\Today\Items 注册键下的命名值：

值：类型	描述
Enabled : DWORD	该值控制用户是否在今日屏幕中开启或禁用插件项。如果Enabled=0，插件不会在今日屏幕中显示，用户可以在今日控制面板中开启。如果Enabled=1，显示插件，同样可以今日控制面板中禁用它。
Order : DWORD	该值控制插件在今日屏幕中的次序。如果Order=0，插件将在最上端显示。
Selectability : DWORD	该值开启选择焦点通知(enables the selection focus notifications)。如果该值为0或不存在，插件不可选并且不会接受任何通知。如果值为1，今日屏幕自动管理插件项的选择，并且不会给插件发送任何通知消息。如果值为2，今日屏幕使用今日屏幕选择APIs(Today Screen selection APIs)来跟踪当前的选择项。
Type : DWORD	该值标识插件类型。如果值为0，标识一个保留的插件被添加到今日屏幕，该插件显示设备机主信息。如果值为1，标识一个保留的插件被添加到今日屏幕，该插件显示Appointments信息。如果值为2，标识一个保留的插件被添加到今日屏幕，该插件显示Mail信息。如果值为3，标识一个保留的插件被添加到今日屏幕，该插件显示Tasks信息。如果该值为4，一个定制的插件被添加到今日屏幕。
Options : DWORD	标识插件是否有Options对话框，在今日屏幕控制面板中点击选中"Options"按钮会显示该对话框。如果值为0，禁用"Options"按钮；如果值为1，开启"Options"按钮

下面的代码例子显示了今日屏幕中的一个插件的注册入口：

[HKEY_LOCAL_MACHINE\\cf3 Software\\cf3 Microsoft\\cf3 Today\\cf3 Items\<Your Custom Item Name>]
"Enabled"=dword:1
"Order"=dword:3
"Selectability"=dword:2
"Type"=dword:1
"Options"=dword:0

评论: 6　查看评论　发表评论

编辑推荐：Google Buzz相关新闻

网站导航：博客园首页个人主页新闻闪存小组博问社区知识库

Windows Mobile 如何处理低内存情况！

李森 - listen — Mon, 25 Jan 2010 02:52:00 GMT

阅读: 117 评论: 0 作者: 李森 - listen 发表于 2010-01-25 10:52 原文链接

最近一直在从事Windows Mobile Shell的工作，其中就会考虑在低内存下运行的情况，在wmshell 和 windowsmobile Blog 里都发现了这篇文章《 HOW THE WINDOWS MOBILE 5.0 SHELL HANDLES LOW MEMORY SITUATIONS 》，提供了很好的系统级处理方式。

文章对在Hibernate, Kernel-Check, Critical, Execute, Kernel-Critical下的各种模式做了阐述，并提供了一小端代码，可以参考，如下。详细参见原文。

#define MIN_MEMORY_TO_RUN 2*1024*1024

MEMORYSTATUS mst;

mst.dwLength= sizeof(MEMORYSTATUS);

GlobalMemoryStatus(&mst);

If (mst.dwAvailPhys < MIN_MEMORY_TO_RUN)

{

    // Try to free memory by asking Shell to shutdown apps

    if (!SHCloseApps(MIN_MEMORY_TO_RUN))

    {

        // Handle the case where memory could not be freed

        ...

评论: 0　查看评论　发表评论

编辑推荐：Google Buzz相关新闻

网站导航：博客园首页个人主页新闻闪存小组博问社区知识库

GetDC、GetDCEx、GetWindowDC - [Daily APIs]

李森 - listen — Fri, 22 Jan 2010 10:23:00 GMT

阅读: 103 评论: 2 作者: 李森 - listen 发表于 2010-01-22 18:23 原文链接

GetDC

该函数为指定窗口的客户区域取回显示DC的句柄。随后的GDI函数中可以使用显示DC在窗口客户区域绘图。

原型：

HDC GetDC( HWND hWnd);

参数：

hWnd：将要取回DC的窗口句柄。如果该值为NULL，GetDC取回整个屏幕的DC。

返回值：

成功，获得指定窗口客户区域的DC句柄；失败返回NULL。调用GetLastError获取扩展错误信息。

备注：

根据为指定窗口指定的类类型来决定取回一个公共、类或私有DC(a common, class, or private device context )。

每次取回公共DC时，GetDC函数给它赋值默认属性。

取回类或私有DC时，GetDC函数保持之前赋值的属性不变。

在使用公共DC绘图后，必须调用ReleaseDC来释放DC。

类和私有DC不必释放。

可用内存数决定DC的数量。

GetDCEx

该函数为指定窗口的客户区域或整个屏幕取回显示DC的句柄。随后的GDI函数中可以该句柄在窗口客户区域绘图。

GetDCEx 是GetDC的扩展，对如何剪裁客户区域或是否剪裁客户区域提供给程序更多的控制。

原型：

HDC GetDCEx( 

    HWND hWnd, 

    HRGN hrgnClip, 

    DWORD flags);

参数：

hWnd：将要取回DC的窗口句柄。如果该值为NULL，GetDCEx取回整个屏幕的DC。

hrgnClip：指定可能和DC的可见区域合并的剪切区域。

flags：指定DC的创建方式。可能为下表中的值的组合：

值	描述
DCX_WINDOW	返回于窗口矩形而不是客户端矩形对应的DC。
DCX_CACHE	从缓存中取回DC，而不是OWNDC 或 CLASSDC 窗口。实际上重写了CS_OWNDC 和 CS_CLASSDC 了。
DCX_PARENTCLIP	使用父窗口的可见区域。取消父窗口的WS_CLIPCHILDREN 和 CS_PARENTDC 标志位。DC的起始坐标设置为由hWnd标识的窗口的左上角。
DCX_CLIPSIBLINGS	排除由hWnd标识的窗口的所有同级窗口的可见区域。
DCX_CLIPCHILDREN	排除由hWnd标识的窗口的所有子窗口的可见区域。
DCX_NORESETATTRS	当该DC释放时，不用设置该DC的属性为默认值。
DCX_EXCLUDERGN	从返回的DC的可见区域里去除hrgnClip标识的剪切区域。
DCX_EXCLUDEUPDATE	返回一个区域，该区域去除了窗口更新的区域。
DCX_INTERSECTRGN	hrgnClip表示的剪切区域和返回DC的可见区域取交集。
DCX_INTERSECTUPDATE	返回一个区域，该区域包含窗口更新的区域。
DCX_VALIDATE	当指定DCX_INTERSECTUPDATE，引起DC完全有效(causes the device context to be completely validated.)。在该函数中使用DCX_INTERSECTUPDATE 和 DCX_VALIDATE 等价于使用BeginPaint函数。

返回值：

成功，返回指定窗口DC句柄。失败返回NULL。如果传入的hWnd为无效值，返回失败。调用GetLastError获取扩展错误信息。

备注：

flags支持这些值：DCX_WINDOW, DCX_CACHE, DCX_CLIPCHILDREN, DCX_CLIPSIBLINGS, DCX_EXCLUDERGN, DCX_INTERSECTRGN, DCX_EXCLUDEUPDATE 和 DCX_INTERSECTUPDATE。

和GetDC返回的DC不同，GetDCEx返回的DC不会和相关窗口保持同步。

如果窗口移动或改变大小，可能会产生异常错误。如果程序获取DC、绘图然后再释放DC，错误的机会将会减少。

除非显示DC属于窗口类，否则在绘图后必须调用ReleaseDC来释放DC。

因为一次只能有5个公共DC可用，如果释放DC失败，将可能导致其他程序访问DC失败。

如果CS_CLASSDC, CS_OWNDC 或 CS_PARENTDC被指定为WNDCLASS结构中的一个类型，当该窗口类被注册时，函数将返回属于窗口类的DC。

GetWindowDC

函数取回整个窗口DC，包括标题栏、菜单和滚动栏。

原型：

HDC GetWindowDC(HWND hWnd);

参数：

hWnd：要取回DC的窗口句柄。如果该值为NULL，取回整个屏幕的DC。

返回值：

成功，返回指定窗口DC的句柄。NULL表示失败或传入的hWnd为无效参数。调用GetLastError获取扩展错误信息。

备注：

GetWindowDC专为在窗口非客户区域绘图而设计。不推荐在任何窗口的非客户区域绘图。

使用GetSystemMetrics函数获取象标题栏、菜单和滚动栏等非客户区域的尺寸大小。

GetDC用来取回整个屏幕的DC。

在绘图完成后，必须调用ReleaseDC来释放DC。如果不释放窗口DC，应用程序的绘图请求将会产生不良影响。

评论: 2　查看评论　发表评论

编辑推荐：Google Buzz相关新闻

网站导航：博客园首页个人主页新闻闪存小组博问社区知识库

CreateDIBSection、BITMAPINFO、BITMAPINFOHEADER、RGBQUAD - [Daliy APIs]

李森 - listen — Thu, 21 Jan 2010 12:25:00 GMT

阅读: 74 评论: 0 作者: 李森 - listen 发表于 2010-01-21 20:25 原文链接

CreateDIBSection

该函数创建应用程序可以直接写入的、与设备无关的位图（DIB）。该函数返回一个位图句柄。

原型：

HBITMAP CreateDIBSection(

        HDC                  hdc,

        CONST BITMAPINFO *   pbmi,

        UINT                 iUsage,

        VOID *               ppvBits,

        HANDLE               hSection,

        DWORD                dwOffset);

参数:

hdc：设备环境句柄。如果iUsage的值是DIB_PAL_COLORS，那么函数使用该设备环境的逻辑调色板对与设备无关位图的颜色进行初始化。

pbmi：指向BITMAPINFO结构的指针，该结构指定了设备无关位图的各种属性，其中包括位图的尺寸和颜色。

iUsage：指定由pbmi参数指定的BITMAPINFO结构中的成员bmiColors数组包含的数据类型（要么是逻辑调色板索引值，要么是原文的RGB值）。下列值是系统定义的，其含义为：

值	描述
DIB_RGB_COLORS	根据BITMAPINFOHEADER 的biCompression 成员决定BITMAPINFO 结构包含位掩码还是调色板数组，在呈现位图时使用该数组值。DIB_RGB_COLORS 可以在任何位数的位图上使用。
DIB_PAL_COLORS	BITMAPINFO.bmiColors 数组被取消，在呈现位图时使用目标调色板。DIB_PAL_COLORS只能在8bpp位图中指定。

ppvBits：指向一个变量的指针，该变量接收一个指向DIB位数据值的指针。

hSection：该参数设置为NULL。

dwOffset：参数取消。

返回值：

成功，返回值是一个指向刚刚创建的设备无关位图的句柄，并且*ppvBits指向该位图的位数据值；失败，那么返回值为NULL，并且*ppvBit也为NULL，若想获得更多错误信息，请调用GetLastError函数。

备注：

系统为设备独立位图分配内存。如果在之后调用DeleteObject来删除设备独立位图，系统自动关闭内句柄。

在Windows CE 2.0及其以后版本，如果图像是调色板模式（通常是1，2，4和8格式）的，BITMAPINFO 结构中必须包含一个颜色表。对于16bpp或32bpp非调色板图像，颜色表必须是3个入口的长度，这3个入口必须指定红、绿、蓝色掩码。而且，BITMAPINFOHEADER 结构的biCompression 成员应该被设置为BI_BITFIELDS。这些位深不支持BI_RGB。 GDI取消24bpp图像的颜色表，他们的像素必须被存储为蓝-绿-红 (BGR)格式。

Windows CE 不支持332位阈设备。

在Windows CE 1.0 和 1.01版本，pbmi指向的BITMAPINFO结构必须指定每个像素点为1或2位。

BITMAPINFO

该结构定义了基于Windows的设备独立位图(DIB)的尺寸大小和颜色信息

原型：

typedef struct tagBITMAPINFO { 

    BITMAPINFOHEADER  bmiHeader; 

    RGBQUAD           bmiColors[1]; 

} BITMAPINFO;

成员：

bmiHeader：位图信息头结构，该结构包含了位图的尺寸和颜色格式。

bmiColors：包含下面中的一种。

RGBQUAD 数组。数组元素填充颜色表。
16位无符号整形数组，该数组指定索引到当前已实现的逻辑调色板。

允许在使用DIB的函数中使用bmiColors 。当bmiColors 包含已实现的逻辑调色板的索引时，必须也要调用CreateDIBPatternBrushPt 和CreateDIBSection 。CreateDIBSection 的iUsage 成员必须被设置为DIB_PAL_COLORS 。

BITMAPINFOHEADER 结构的biBitCount 和 biClrUsed 成员的值决定数组的大小。

bmiColors 表中的颜色根据重要性排序。更多信息，参见备注。

如果bmiHeader.biCompression 被设置为BI_RGB ，可以设置bmiColors 数组大小为0.

备注：

设备独立位图由2部分组成：用于描述位图的尺寸大小和颜色的BITMAPINFO 结构和定义位图像素的字节数组。字节数组中的所有位封装在一起，但每行扫描必须在行尾补0以确保行尾为LONG数据类型边界(each scan line must be padded with zeroes to end on a LONG data-type boundary.)。

如果位图高度为正数，则位图为从下到上(bottom-up)DIB，它的起点为左下角坐标。如果高度为负数，则位图为从上到下(top-down) DIB，它的起点为左上角。

封装位图时，位图字节数组紧跟在BITMAPINFO 头后面。封装的位图被一个单独指针引用。

对于封装的位图，当使用DIB_PAL_COLORS模式时，BITMAPINFOHEADER 结构的ClrUsed 成员必须设置为偶数，因此，DIB位图数组以DWORD边界开始。

如果位图被存储至文件或传送到其他应用程序，bmiColors 成员不应包含调色板索引。

除非程序独占使用和控制位图，否则位图颜色表应该包含明确的RGB值。

安全提示：一个常见的错误类型包括在内容中发现无效的格式描述。比如，一个BITMAPINFOHEADER 结构后跟着一个颜色表。

BITMAPINFO 结构被定义为一个BITMAPINFOHEADER 结构后跟着一个填充颜色表RGBQUAD 数组。RGBQUAD 数组大小由BITMAPINFOHEADER 中的biClrUsed值决定。

在拷贝颜色表到BITMAPINFO前一定要检查为BITMAPINFO结构分配的缓冲大小，否则决不能那么做。

BITMAPINFOHEADER

该结构包含设备独立位图的尺寸大小和颜色格式信息。

原型：

typedef struct tagBITMAPINFOHEADER { 

    DWORD       biSize; 

    LONG        biWidth; 

    LONG        biHeight; 

    WORD        biPlanes; 

    WORD        biBitCount 

    DWORD       biCompression; 

    DWORD       biSizeImage; 

    LONG        biXPelsPerMeter; 

    LONG        biYPelsPerMeter; 

    DWORD       biClrUsed; 

    DWORD       biClrImportant; 

} BITMAPINFOHEADER;

成员：

biSize：指定结构体大小，按字节计算，不包括biClrUsed 成员提及的颜色表或掩码的大小。参见备注。

biWidth：位图的宽度，按像素计算。

biHeight：位图的高度，按像素计算。

如果biHeight为正数，位图为从下而上(bottom-up) DIB ，起点为左下角。

如果biHeight为负数，位图为从上而下(top-down) DIB ，起点为左上角，

如果biHeight为负数，标识一个从上而下(top-down) DIB，biCompression 必须为BI_RGB 或 BI_BITFIELDS。从上而下(top-down) DIB不能被压缩。

biPlanes：指定目标设备的planes的数量。必须设定为 1 。

biBitCount：指定每个像素的位数。

该成员决定位图中定义每个像素的位数和最大颜色数量。该成员必须为下面值中的一个：

值	描述
1	位图为黑白色，bmiColors 成员包含两个入口。位图数组中的每位代表一个像素。如果该位被清除，像素被显示为bmiColors 表的第一个入口的颜色。如果颜色被设置了，像素拥有bmiColors 表第二个入口的颜色。
2	位图有4个可能的颜色值。
4	位图有最大16位色，bmiColors 成员最多包含16个入口。颜色表按照4位索引呈现位图中每个像素。例如，如果位图中的第一个字节是Ox1F，该字节代表2个像素。第一个像素包含第二个表入口的颜色，第二个像素包含第16个表入口的颜色。
8	位图最多有256中颜色，bmiColors 成员包含最多256个入口。这种情况下，数组中的每个字节代表单独一个像素。
16	位图最多有2^16 种颜色。如果BITMAPINFOHEADER 的biCompression 成员值为BI_RGB ， bmiColors 为NULL。位图数组中的每个字(WORD)代表单独一个像素。红、绿、蓝的相对强度分别以5位呈现。蓝色值为最低有效5位，接着5位是绿，然后是红。最高有效位不被使用。bmiColors 颜色表用来优化使用在基于调色板的设备上的颜色，而且必须包含BITMAPINFOHEADER的biClrUsed 成员指定的入口数量。
24	位图最多有2^24种颜色。bmiColors 为NULL。位图数组中每个3字节三元组分别代表每个像素的蓝、绿、红色的相对强度。bmiColors 颜色表用来优化使用在基于调色板的设备上的颜色，而且必须包含BITMAPINFOHEADER的biClrUsed 成员指定的入口数量。
32	位图最多有2^32种颜色。如果BITMAPINFOHEADER 的biCompression 成员是BI_RGB ， bmiColors 为NULL。位图数组中的每个双字(DWORD)分别代表每个像素的蓝、绿、红色的相对强度。每个双字的高字节不使用。bmiColors 颜色表用来优化使用在基于调色板的设备上的颜色，而且必须包含BITMAPINFOHEADER的biClrUsed 成员指定的入口数量。如果BITMAPINFOHEADER 的biCompression 的值为BI_BITFIELDS，bmiColors 成员包含3个双字颜色掩码来分别指定组成每个像素的红、绿、蓝色。位图数组中的每个双字代表一个像素。

biCompression：为压缩的bottom-up位图指定压缩类型，而top-down DIBs 不能被压缩。该成员值可能为下表中的一个：

值	描述
BI_RGB	未压缩的格式
BI_BITFIELDS	用来说明位图没有被压缩并且颜色表由3个双字颜色掩码组成（3个双字颜色掩码来分别指定组成每个像素的红、绿、蓝值）。当使用16bpp和32bpp位图时该标志可用。该值在Windows CE 2.0 及其以后版本可用。
BI_ALPHABITFIELDS	用来说明位图没有被压缩并且颜色表由4个双字颜色掩码组成（4个双字颜色掩码来分别指定组成每个像素的红、绿、蓝和alpha值）。当使用16bpp和32bpp位图时该标志可用。该值在Windows CE 4.0 及其以后版本可用。

对于Windows CE 5.0 及其以后版本，可有使用上表的任意值与BI_SRCPREROTATE 进行布尔OR 运算来标明源DIB和目的DIB有相同的旋转角度。

biSizeImage：指定图像的大小，按字节计算。当为BI_RGB 时，该值可以设置为0。

biXPelsPerMeter：为位图指定目标设备水平分辨率，按每公尺像素数计算(in pixels per meter)。程序使用该值从资源组中选择最符合当前设备特性的位图。

biYPelsPerMeter：为位图指定目标设备垂直分辨率按每公尺像素数计算(in pixels per meter)。

biClrUsed：指定实际在位图中使用的颜色表中的颜色索引的数量。

   如果该值为0，位图为biCompression 指定的压缩模式使用biBitCount 值对应的最大颜色数量。
   如果biClrUsed 非0，并且biBitCount 小于16，biClrUsed 指定图形引擎或设备驱动访问的实际颜色数量。
   如果biBitCount 大于等于16，biClrUsed 指定颜色表的数量，用来优化系统颜色调色板性能。
   如果biBitCount 等于16或32，最佳颜色调色板紧跟在3个双字掩码之后开始(the optimal color palette starts immediately following the three DWORD masks.)。
   如果位图被封装了(位图数组紧接着BITMAPINFO头，并被一个单独指针引用)，biClrUsed 必须要么为0，要么为颜色表的实际大小。

biClrImportant：显示位图时指的定颜色索引的数量。如果该值为0，要求使用所有颜色。

备注：

BITMAPINFO 结构合并BITMAPINFOHEADER和一个颜色表来提供对一个DIB的尺寸大小和颜色的完全定义。程序应该使用存储在biSize 中的信息来定位BITMAPINFO 结构中的颜色表，如下，

pColor = ((LPSTR)pBitmapInfo + (WORD)(pBitmapInfo->bmiHeader.biSize));

对于Windows CE 1.0 和1.01版本，biBitCount 必须为1或2.

RGBQUAD

该结构用于描述一种颜色的红、绿、蓝的相对强度。

原型：

typedef struct tagRGBQUAD { 

    BYTE   rgbBlue;

    BYTE   rgbGreen;

    BYTE   rgbRed;

    BYTE   rgbReserved;

} RGBQUAD;

成员：

rgbBlue、rgbGreen、rgbRed：分别指定蓝、绿、红色的强度。rgbReserved是保留值，设置为0。

备注:

Windows CE 不支持rgbReserved，应该初始化为0。BITMAPINFO结构的bmiColors 成员由RGBQUAD 结构数组组成。

参考：

互动百科: CreateDIBSection

MSDN: CreateDIBSection

评论: 0　查看评论　发表评论

编辑推荐：Google Buzz相关新闻

网站导航：博客园首页个人主页新闻闪存小组博问社区知识库

PatBlt - [Daliy APIs]

李森 - listen — Thu, 21 Jan 2010 07:52:00 GMT

阅读: 14 评论: 0 作者: 李森 - listen 发表于 2010-01-21 15:52 原文链接

PatBlt

该函数使用当前选入指定设备环境中的刷子绘制给定的矩形区域。通过使用给出的光栅操作来对该刷子的像素和表面像素进行组合。

原型：

BOOL PatBlt(

HDC hdc,

int nXLeft, int nYLeft, int nWidth, int nHeight,

DWORD dwRop)；

参数：

hdc：设备环境句柄。

nXLeft、nYLeft：指定要填充的矩形左上角的X、Y轴坐标，坐标按逻辑单位表示。

nWidth、nHeight：指定矩形的宽度和高度，按逻辑单位表示。

dwRop：指定光栅操作码。该操作码可以取下列值，这些值的含义如下：

值	描述
PATCOPY	将指定的模式拷贝到目标位图中。
PATINVERT	使用布尔OR（或）操作符将指定模式的颜色与目标矩形的颜色进行组合。
DSTINVERT	将目标矩形反向。
BLACKNESS	使用物理调色板中与索引0相关的颜色填充目标矩形。（对于缺省的物理调色板而言，该颜色为黑色）。
WHITENESS	使用物理调色板中与索引1有关的颜色来填充目标矩形。（对于缺省的物理调色板而言，该颜色为白色）。

返回值：

成功，则返回值为非零；失败，则返回值为0。获得更多错误信息，请调用GetLastError函数。

说明：

该函数的参数dwRop取值限定为全部256个三元光栅操作有限子集。特别地，涉及源矩形的操作码不能使用。

并非所有设备都支持PalBlt函数。有关更多的信息，请参考函数GetDeviceCaps中有关RC_BITBLT特性的描述。

如果hdc指定镜像DC，水平坐标将从右到左增加，而不是从左到右。

更多关于从右到左向位块传输显示信息（For information about blitting to displays with right-to-left orientations），参见 Creating Bitmaps。

参考：

互动百科: PatBlt

MSDN: PatBlt

评论: 0　查看评论　发表评论

编辑推荐：Google Buzz相关新闻

网站导航：博客园首页个人主页新闻闪存小组博问社区知识库

MaskBlt - [Daliy APIs]

李森 - listen — Thu, 21 Jan 2010 07:44:00 GMT

阅读: 58 评论: 0 作者: 李森 - listen 发表于 2010-01-21 15:44 原文链接

MaskBlt

该函数使用特定的掩码和光栅操作来对源和目标位图的颜色数据进行组合。

原型：

BOOL MaskBlt(

HDC hdcDest,

int nXDest, int nYDest, int nWidth, int nHeight,

HDC hdcSrc,

int nXSrc, int nYSrc,

HBITMAP hbmMask,

int xMask, int yMask,

DWORD dwRop)；

参数：

hdcDest：指向目标设备环境的句柄。

nXDest、nYDest：指定目标矩形左上角的逻辑X、Y坐标。

nWidth、nHeight：指定目标矩形和源位图的宽度、高度，按逻辑单位。

hdcSrc：指向源位图所在的设备环境，如果dwRop参数规定的光栅操作不包括源位图，那么该参数必须为0。

nXSrc、nYSrc：指定源位图左上角的逻辑X、Y坐标。

nbmMask：指向单色掩码位图的句柄，该位图与源设备环境中的彩色位图进行组合。

xMask、yMask：指定由参数hbmMask指向的掩码位图的水平、垂直像素偏移量。

dwRop：指定前景和背景光栅操作码，函数使用这些操作码为控制源和目标数据的组合。背景光栅操作码存储在该参数值的高位字中的高位字节中，而前景光栅操作代码雄在该参数值的高位字中的低位字节中，而低位字则忽略，并且应该为0。宏MAKEROP4创建前景和背景光栅操作码这样的组合。

有关该函数场景中的前景和背景方面的讨论，可参考下面的备注说明。

至于有关公用的光栅操作码清单，可参考BitBlt函数。

Windows CE 1.0 and 1.01 只支持 SRCCOPY and SRCINVERT 光栅操作。

返回值：

如果函数执行成功，那么返回值为非零，如果函数失败，那么返回值为0。获得更多错误信息，请调用GetLastError函数。

备注：

在由hbmMask指定的掩码中，数值1表示在那个位置应使用dwRop指定的前景光栅操作码。数值0表示应使用dwRop指定的背景光栅操作码。

如果光栅操作需要源对象，那么掩码矩形必须覆盖源矩形。如果没有覆盖，那么函数会执行失败。如果光栅操作没有要求源对象，那么掩码矩形必须覆盖目标矩形，如果没有覆盖，那么函数会失败。

如果在调用函数时，源设备环境中实行旋转或剪切变换，那么会出现错误。然而，允许有其他类型的变换。

如果源位图的颜色格式、模式和目标位图不一样，那么该函数对模式或源位图格式，或者两者进行转换，以与目标格式匹配。

如果掩码位图不是单色位图，则会出现错误。

当正在记录的是增强型图元文件时，如果源设备环境标识为增强型图元文件设备环境，那么会出现错误（该函数返回FALSE）。

不是所有设备都支持MaskBlt函数，应用程序应调用GETDeviceCaps函数来确定设备是否支持该函数。

如果没有提供掩码位图，那么该函数非常类似BitBlt，它使用前景光栅操作码。

参考：

互动百科: MaskBlt

MSDN: MaskBlt

评论: 0　查看评论　发表评论

编辑推荐：Google Buzz相关新闻

网站导航：博客园首页个人主页新闻闪存小组博问社区知识库

TransparentImage、TransparentBlt - [Daliy APIs]

李森 - listen — Thu, 21 Jan 2010 06:10:00 GMT

阅读: 19 评论: 0 作者: 李森 - listen 发表于 2010-01-21 14:10 原文链接

TransparentImage

该函数传送一张位图，但是位图中指定颜色会被忽略。

原型：

BOOL TransparentImage(

HDC hdcDest,

LONG DstX, LONG DstY, LONG DstCx, LONG DstCy,

HANDLE hSrc,

LONG SrcX, LONG SrcY, LONG SrcCx, LONG SrcCy,

COLORREF TransparentColor

);

参数：

hdcDest：目标DC句柄

DstX、DstY：目标矩形左上角X、Y坐标，按逻辑单位表示。

DstCx、DstCy：目标矩形的宽度和高度，按逻辑单位表示。

hSrc：目标DC句柄

SrcX、SrcY：源矩形左上角X、Y坐标，按逻辑单位表示。

SrcCx、SrcCy：源矩形的宽度和高度，按逻辑单位表示。

TransparentColor：位图中呈现为透明的颜色。

返回值：

非0表示成功，0表示失败。调用GetLastError获取扩展错误信息。

说明：

如果hSrc是HBITMAP，那么该位图必须在调用TransparentImage 前被选入DC。

TransparentImage支持所有源位图格式。然而，对于32bpp位图，它只是拷贝alpha值到其上。

如果源矩形和目标矩形大小不同，源矩形将缩放大小以匹配目标矩形。

如果源矩形或目标矩形中的宽或高为负数，TransparentImage不会对位图产生镜像。

TransparentBlt

该函数执行位块传送，将指定源DC内的所有矩形像素对应的颜色数据传送到目标DC。

原型：

BOOL TransparentBlt(

HDC hdcDest,

int nXOriginDest, int nYOriginDest, int nWidthDest, int hHeightDest,

HDC hdcSrc,

int nXOriginSrc, int nYOriginSrc, int nWidthSrc, int nHeightSrc,

UINT crTransparent

);

参数：

hdcDest：目标DC句柄

nXOriginDest、int nYOriginDest：目标矩形左上角X、Y坐标，按逻辑单位表示。

nWidthDest、hHeightDest：目标矩形的宽度和高度，按逻辑单位表示。

hdcSrc：目标DC句柄

nXOriginSrc、nYOriginSrc：源矩形左上角X、Y坐标，按逻辑单位表示。

nWidthSrc、nHeightSrc：源矩形的宽度和高度，按逻辑单位表示。

crTransparent：源位图被当做透明的RGB颜色

返回值：

成功返回TRUE,失败返回FALSE。调用GetLastError获取扩展错误信息。

说明：

TransparentBlt 函数是 TransparentImage 函数的封装。

参考：
MSDN: TransparentImage TransparentBlt

评论: 0　查看评论　发表评论

编辑推荐：Google Buzz相关新闻

网站导航：博客园首页个人主页新闻闪存小组博问社区知识库