十六.信息呈现类

信息呈现类主要是指从CIndicater类继承下来，用于显示文本，图像等信息的UC控件。这些控件可以被创建，也可以保存到文件或从文件中读取， 也可以被克隆， 然后进行显示。动态类控件还有一个需要一个函数进行显示类型的切换，这个函数是Beat。

16.1函数

公共函数

Create

声明：virtual BOOL Create(CDelegate* pDelegate=NULL, const char* strName = NULL, UINT id =-1, int style = RV_UC_DEFAULT_STYLE ) ;

描述： 创建具体的UC对象。

参数：1、CDelegate* pDelegate – 窗口代理

2、const char* strName – 名称

3、UINT id- ID

4、int style - 显示样式

返回值：TRUE或FALSE

备注

Destroy

声明：virtual void Destroy(BOOL bEraseStroke=FALSE) ;

描述：销毁具体的UC对象。

参数：BOOL bEraseStroke – 是否删除相应的笔画句柄

返回值：无

备注：删除相应的笔画句柄的时候一定要在窗口代理清除之前进行，否则会发生不可预料的错误。

Serialize

声明：virtual BOOL Serialize(HANDLE device, BOOL bIn ) ;

描述：从文件中读取或将UC控件的属性数据保存到文件。

参数：1、HANDLE device – 文件句柄或其他支持序列化输入输出的句柄。

2、BOOL bIn – 是否为读取

返回值：TRUE或FALSE

备注：如果文件数据保存或读取成功将返回TRUE。

Clone

声明：virtual CUCObj* Clone( CUCObj* twin) ;

描述：从输入的UC控件中拷贝各种参数属性。

参数：CUCObj* twin – UC控件。

返回值：UC控件

备注：如果输入的UC控件为NULL,将创建一个新的UC控件，这个控件的属性与实例本身相同。否则，将输入的UC控件的属性拷贝给实例本身，并返回输入控件。

Show

声明：virtual void Show(BOOL bForce);

描述：显示UC控件。

参数：BOOL bForce – 是否强制重画

返回值：TRUE或FALSE

备注：如果Delegete或HGDC进行了清除处理，bForce必须为TRUE。否则会出现不可预料的错误

Beat

声明：Beat();

描述：该控件的动态显示部分进行刷新。

参数：无

返回值：无

备注：这个函数主要用于动态控件的显示内容刷新，对静态空间如CLabel 是没有意义的。使用该函数的时候，通常是在外部周期性进行刷新的函数或过程进行调用。

CLabel

标签用于显示文本信息。

SetAlignment

声明：void SetAlignment(int val)；

描述：设置文本显示的对齐方式。

参数：int val – 对齐方式

返回值： 无

备注

GetAlignment

声明：int GetAlignment() ；

描述：获取文本显示的对齐方式。

参数：无

返回值：对齐方式

备注

GetTextColor

声明：GRgb& GetTextColor() ;

描述：获得文本颜色。

参数：无

返回值：颜色

备注

SetTextColor

声明：void SetTextColor(GRgb& val)

描述：设置文本颜色。

参数：GRgb& val– 颜色

返回值：无

备注

GetBackColor

声明：GRgb& GetBackColor() ;

描述：获取背景颜色。

参数：无

返回值：颜色

备注

SetBackColor

声明：void SetBackColor(GRgb& val)；

描述：设置背景颜色。

参数：GRgb& val – 颜色

返回值： 无

备注

GetFontStyle

声明：int GetFontStyle();

描述：获取文本字体样式。

参数：无

返回值： 无

备注

SetFontStyle

声明：void SetFontStyle(int style) ;

描述：设置文本字体样式。

参数：int style –字体样式

返回值： 无

备注

GetFontSize

声明：int GetFontSize();

描述：获取文本字体大小。

参数：无

返回值：字体大小

备注

SetFontSize

声明：void SetFontSize(int size);

描述：设置文本字体大小。

参数：int size – 字体大小

返回值： 无

备注

GetFontName

声明：const char* GetFontName();

描述：获取文本字体名称

参数：无

返回值：字体名称

备注

SetFontName

声明：void SetFontName(const char* strName);

描述：设置文本字体名称。

参数：const char* strName – 名称

返回值： 无

备注

GetCaption

声明：const char* GetCaption() ;

描述：获取文本显示的文本内容。

参数：无

返回值：文本内容

备注

SetCaption

声明：void SetCaption(const char* strCaption);

描述：设置文本显示的内容。

参数：const char* strCaption – 文本内容

返回值：无

备注

CShape

显示一个椭圆或矩形

常数

形状类型

名字	说明
ST_RECT	矩形
ST_ROUND	倒角矩形
ST_ELLIPSE	椭圆形

GetShapeType

声明：int GetShapeType()

描述：获得形状类型。

参数：无

返回值： 类型

备注

SetShapeType

声明：void SetShapeType(CShape::SHAPE_TYPE type);

描述：设置形状类型。

参数：CShape::SHAPE_TYPE type – 形状类型

返回值：类型

备注

IsFilledShape

声明：BOOL IsFilledShape() ;

描述：判断是否为填充了的形状。

参数：无

返回值：TRUE或FALSE

备注

SetFillState

声明：void SetFillState(BOOL flag);

描述：设置形状填充状态。

参数：BOOL flag – TRUE或FALSE

返回值：无

备注

16.4 CMark

显示标记，这个标记可以根据内外形状的不同，形成多种形状。

常量

名字	说明
OS_NONE	忽略外部形状
OS_FOCUS	焦点
OS_BOX	方盒
OS_DISK	圆碟
OS_RULER	刻度
OS_CUST	自定义

名字	说明
IS_NONE	忽略内部形状
IS_SPOT	点
IS_CROSS	十字
IS_EXPRESS	X 字
IS_CROSS_EX	扩展十字
IS_LINE_H	水平线
IS_LINE_V	垂直线
IS_IMAGE	图像

GetOuterStyle

声明：int GetOuterStyle();

描述：获得外部形状。

参数：无

返回值：形状

备注

SetOuterStyle

声明：void SetOuterStyle(int style);

描述：设置外部形状。

参数：int style – 外部形状

返回值： 无

备注

GetInnerStyle

声明：int GetInnerStyle();

描述：获得内部形状

参数：无

返回值： 形状

备注

SetInnerStyle

声明：void SetInnerStyle(int style);

描述：设置内部形状。

参数：int style – 形状

返回值：无

备注

SetOuterSize

声明：void SetOuterSize(GSize size);

描述：设置外部形状大小。

参数：GSize size - 外部尺寸

返回值： 无

备注

GetOuterSize

声明：GSize GetOuterSize()

描述：获取外部形状大小。

参数：无

返回值： 形状大小

备注

SetInnerSize

声明：void SetInnerSize(GSize size);

描述：设置内部形状大小。

参数：GSize size - 内部尺寸

返回值：无

备注

GetInnerSize

声明：GSize GetInnerSize()

描述：获取内部形状大小。

参数：无

返回值：形状大小

备注

SetPos

声明：void SetPos(GPoint pos);

描述：设置标记的位置。

参数：GPoint pos – 位置

返回值：无

备注

GetPos

声明：GPoint GetPos()

描述：获取标记的位置。

参数：无

返回值：位置

备注

SetCursorImage

声明：void SetCursorImage(const RvImage image);

描述：设置标记游标图。

参数：const RvImage image – 图像

返回值：无

备注

MoveTo

声明：void MoveTo(int x, int y);

描述：将标记移动到某个位置。

参数：1、int x – x坐标

2、int y – y坐标

返回值： 无

备注

GetCommentType

声明：int GetCommentType();

描述：获得评论的类型。

参数：无

返回值：类型

备注

SetCommentType

声明：void SetCommentType(CComment::COMMENT_TYPE type);

描述：设置评论类型。

参数：CComment::COMMENT_TYPE type – 类型

返回值：无

备注

SetApperanceType

声明：void SetApperanceType(int type)

描述：设置外观类型。

参数：int type – 外观类型

返回值：无

备注

GetApperanceType

声明：int GetApperanceType()

描述：获取外观类型。

参数：无

返回值： 外观类型

备注

SetImage

声明：void SetImage(const RvImage image);

描述：设置当前图像。

参数：const RvImage image – 数字图像

返回值： 无

备注

SetImageEx

声明：BOOL SetImageEx(const char* strPathName);

描述：从文件中装载图像。

参数：const char* strPathName – 文件路径

返回值：TRUE或FALSE

备注

16.7 CRunningLabel

常量

名字	说明
RL_MS_SLOW	慢速
RL_MS_MEDIUM	中等速度
RL_MS_HIGH	快速

SetRunVertical

声明：void SetRunVertical(BOOL val);

描述：设置是否垂直方向移动

参数：BOOL val – TRUE或FALSE

返回值：无

备注

IsFilledShape

声明：BOOL IsFilledShape() ；

描述：判断是否填充。

参数：无

返回值： TRUE或FALSE

备注

SetFillState

声明：void SetFillState(BOOL flag);

描述：设置填充状态。

参数：BOOL flag–TRUE或FALSE

返回值：TRUE或FALSE

备注

16.8 CTimeLabel

常量

名字	说明
TT_WATCH	表
TT_COUNTER	计时器
TT_COUNTER_EX	增强型计时器

名字	说明
TF_MM_SS_C	分，秒，百分 "mm:ss.cs"
TF_HH_MM	时，分 "hh:mm"
TF_MM_SS	分，秒 "mm:ss"
TF_HH_MM_SS	时，分，秒 "hh:mm:ss"
TF_FULL_TIME	年，月，日，星期，时，分，秒 "YY-MM-DD WK hh:mm:ss"
TF_DATE_TIME	年，月，日 "YY-MM-DD hh:mm:ss"

Start

声明：void Start(BOOL bReset);

描述：启动。

参数：BOOL bReset – 是否重置

返回值： 无

备注： 只有启动以后，应用程序调用Beat才能进行内容刷新

Stop

声明：void Stop();

描述：停止。

参数：无

返回值： 无

备注

SetFormat

声明：void SetFormat(TIME_FORMAT format);

描述：设置显示格式。

参数：TIME_FORMAT format– 显示格式

返回值： 无

备注

SetType

声明：void SetType(TIME_TYPE type);

描述：设置时钟类型。

参数：TIME_TYPE type – 时钟类型

返回值：无

备注

GetFormat

声明：TIME_FORMAT GetFormat()

描述：获取显示格式。

参数：无

返回值：显示格式

备注

GetType

声明：TIME_TYPE GetType( ) ;

描述： 获取时钟类型。

参数：无

返回值：时钟类型

备注

16.9 CAnimator

Load

声明：void Load(const char* strFilePath);

描述：装载动画文件。

参数：const char* strFilePath – 文件路径

返回值：无

备注