十四.CRealView类

CRealView类从CWindowDelegate类继承，该类可以使用其CWindowDelegate类所有的功能函数。 CRealView类创建一个窗口，在不同的工作模式下，响应必须的鼠标和键盘程序。 另外，CRealView还增加了用户鼠标和像素信息显示功能。

14.1常量

名字	说明
UC_IGNORE	忽略，系统鼠标
UC_PENTIP	笔尖
UC_TAR_S	方形目标
UC_TAR_R	圆形目标
UC_CROSS	十字线
UC_RULER_H	水平刻度
UC_RULER_V	垂直刻度
UC_RULER_HV	水平和垂直刻度
UC_IMAGE	用户图象

14.2函数

Create

声明：virtual BOOL Create(HWND hParentWnd, const char* strWindowName, int sightWidth, int sightHeight, GRect& rect);

描述： 创建RealView。

参数：1、HWND hParentWnd – 父窗口句柄

2、const char* strWindowName – 窗口名称

3、int sightWidth – 视场宽度（画布宽度）

4、int sightHeight – 视场高度（画布高度）

5、GRect& rect- - 窗口显示区

返回值： TRUE 或FALSE

备注：

Destroy

声明：virtual void Destroy();

描述：销毁RealView。

参数：无

返回值：无

备注：

SetUserCursorType

声明：void SetUserCursorType(USER_CURSOR cursorType, BOOL bRefresh=FALSE);

描述：设置用户鼠标类型。

参数：1、USER_CURSOR cursorType – 鼠标类型

2、 BOOL bRefresh – 是否进行刷新

返回值：无

备注：

GetUserCursorType

声明：int GetUserCursorType();

描述：获得用户鼠标类型。

参数：无

返回值： 鼠标类型

备注：

SetUserCursorSize

声明：void SetUserCursorSize(GSize size, BOOL bRefresh=FALSE);

描述：设置用户鼠标大小。

参数：1、GSize size – 鼠标大小

2、BOOL bRefresh – 是否进行刷新

返回值：无

备注：

GetUserCursorSize

声明：GSize GetUserCursorSize();

描述：获取用户鼠标大小。

参数：无

返回值：鼠标大小

备注：

SetUserCursorTransparence

声明：void SetUserCursorTransparence(int ratio, BOOL bRefresh=FALSE);

描述：设置用户鼠标透明度。

参数：1、int ratio – 透明度。范围0-100，数字越大越透明

2、 BOOL bRefresh – 是否进行刷新

返回值：无

备注：

GetUserCursorTransparence

声明：int GetUserCursorTransparence();

描述：获取用户鼠标透明度。

参数：无

返回值：透明度

备注：

SetUserCursorColor

声明：void SetUserCursorColor(GRgb color, BOOL bRefresh=FALSE);

描述：设置用户鼠标颜色。

参数：1、GRgb color – 鼠标颜色

2、 BOOL bRefresh – 是否进行刷新

返回值： 无

备注：鼠标颜色对用户图像类鼠标无效

GetUserCursorColor

声明：GRgb GetUserCursorColor();

描述：获取用户鼠标颜色。

参数： 无

返回值：鼠标颜色

备注：

SetUserCursorImage

声明：void SetUserCursorImage(const RvImage image, BOOL bRefresh );

描述：设置用户鼠标自定义图像。

参数：1、const RvImage image – 自定义图像

2、BOOL bRefresh – 是否进行刷新

返回值：无

备注：鼠标类型为UC_IMAGE时，有效。

SetPixelBarFontSize

声明：void SetPixelBarFontSize(int size, BOOL bRefresh=FALSE);

描述：设置像素信息栏的字体大小。

参数：1、int size – 字体大小

2、BOOL bRefresh – 是否进行刷新

返回值： 无

备注：鼠标类型为UC_IMAGE时，有效。

GetPixelBarLabelFontSize

声明：int GetPixelBarLabelFontSize();

描述：获取像素信息栏的字体大小。

参数：无

返回值：字体大小

SetPixelBarTransparence

声明：void SetPixelBarTransparence(int ratio, BOOL bRefresh=FALSE);

描述：设置像素信息栏透明度。

参数：1、int ratio – 透明度。范围0-100，数字越大越透明

2、 BOOL bRefresh – 是否进行刷新

返回值： 无

备注：

GetPixelBarTransparence

声明：int GetPixelBarTransparence();

描述：获取像素信息栏透明度。

参数：无

返回值：无

备注：

SetPixelBarColor

声明：void SetPixelBarColor(GRgb color, BOOL bRefresh=FALSE);

描述：设置像素信息栏颜色。

参数：1、GRgb color – 颜色

2、 BOOL bRefresh – 是否进行刷新

返回值：无

备注：

GetPixelBarColor

声明：GRgb GetPixelBarColor();

描述：获取像素信息栏颜色。

参数：无

返回值： 颜色

备注：

SetPixelBarVisible

声明：void SetPixelBarVisible(BOOL flag, BOOL bRefresh );

描述：设置像素信息栏是否可见。

参数：1、BOOL flag– TRUE 或FALSE

2、BOOL bRefresh – 是否进行刷新

返回值：无

备注：

IsPixelBarVisible

声明：BOOL IsPixelBarVisible();

描述：判断像素信息栏是否可见。

参数：无

返回值：无

备注：

ProcRuntimeMsg

声明：BOOL ProcRuntimeMsg(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam, LRESULT* pResult);

描述：内部处理运行态WINDOWS消息。

参数：1、HWND hWnd – 窗口句柄

2、UINT uMsg – 消息

3、 WPARAM wParam – 高字节参数

4、LPARAM lParam – 低字节参数

5、 LRESULT* pResult – 结果。（返回消息处理结果）

返回值：TRUE或FALSE

备注： 如果消息没有被处理，返回FALSE. 如果已经处理，不希望操作系统进一不处理，返回TRUE.

ProcDesignMsg

声明：BOOL ProcDesignMsg(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam, LRESULT* pResult);

描述：内部处理设计态WINDOWS消息。

参数：1、HWND hWnd – 窗口句柄

2、UINT uMsg – 消息

3、WPARAM wParam – 高字节参数

4、LPARAM lParam – 低字节参数

5、 LRESULT* pResult – 结果。（返回消息处理结果）

返回值：TRUE或FALSE

备注： 如果消息没有被处理，返回FALSE. 如果已经处理，不希望操作系统进一不处理，返回TRUE。

MsgProc

声明：virtual BOOL MsgProc( HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam , LRESULT* pResult);

描述： 内部处理WINDOWS消息,根据当前的工作模式，分别调用设计态消息处理函数或运行态处理函数。

参数：1、HWND hWnd – 窗口句柄

2、UINT uMsg – 消息

3、WPARAM wParam – 高字节参数

4、LPARAM lParam – 低字节参数

5、LRESULT* pResult – 结果。（返回消息处理结果）

返回值：TRUE或FALSE

备注：该函数可以被重载，增强应用程序对消息的相应能力。