1、非经本公司2015。保留一切权利。市海思半导体，任何和个人不得擅自摘抄、本文档内容的部分或全部，并不得以任何形式。商标、海思和其他海思商标均为市海思半导体的商标。本文档提及的其他所有商标或商标，由各自的所有人拥有。注意您的产品、服务或特性等应受海思公司商业合同和条款的约束，本文档中描述的全部或部分产品、服务或特性可能不在您的或使用范围之内。除非合同另有约定，海思公司对本文档内容不做任何明示或默示的或保证。由于产品版本升级或其他原因，本文档内容会不定期进行更新。除非另有约定，本文档仅作为使用指导，本文档中的所有陈述、信息和建议不任何明示或暗示的担保。市海思半导体市龙岗区坂田：518129地址：总
3、ComboBox22TrackBar24IpEdit25Calendar25TimeBar27MsgBox29MultiEdit32ScrollView33其他说明35Skin35Font36前2.3DataM.37海思专有和信息iii市海思半导体2.4Language38参考资料413iv1.1View表1-1View的属性view作为界面描述xml文件的识别ID，不会生成控件实例，不具有界面数据的实际意义。1.2控件公共属性表1-2控件公共属性海思专有和信息1市海思半导体属性名称属性含义取值范围必须设置默认值说明id控件的唯一标识字符串Y-控件句柄top控件相对父的左
4、上角垂直方向偏移零和正整数Y0：像素left控件相对父的左上角水平方向偏移零和正整数Y0属性名称属性含义取值范围必须设置默认值说明id视图标识字符串Y-必须与视图主window相同，作为HI_GV_PARSER_LoadViewByID的输入参数。onload视图加载前处理函数-N-为兼容其他语言保留，C语言版本不需要unload视图卸载后处理函数-N-为兼容其他语言保留，C语言版本不需要海思专有和信息2市海思半导体属性名称属性含义取值范围必须设置默认值说明width控件宽度正整数Y-height控件高度正整数Y-transparent透明风格选项yes：透明no：不透明Nno为
5、透明时不会绘制控件皮肤，如果控件有父容器，会通知其父容器绘制透明区域皮肤isrelease隐藏时是否资源yes：no：不Nno-isnofocus是否不允许获取焦点yes：不允许获得焦点no：允许获得焦点Nno仅对默认可以获取焦点的控件有效islanchange切换语言环境时是否响应语言切换消息事件函数yes：响应no：不响应NnoHIGV_MSG_LAN_CHANGE消息事件iswodel是否模态windowyes：模态no：非模态Nno显示并获得焦点的模态window在隐藏之前无法将焦点移至非模态window，多用于鼠标控制的弹出框场景isskinforcedraw非透
6、明风格是否需要强制刷新父背景yes：需要no：不需要Nno当控件重绘时先重绘刷新区域的父容器背景，多用于使用透明或半透明并且transparent属性为no的控件，该属性对window无效ishilightallchildGroup时是否所有子控件yes/noNno-normalskinnormal状态皮肤有效皮肤IDY-Normal状态时控件的外观皮肤disableskindisable状态皮肤有效皮肤IDN-Disable状态时控件的外观皮肤highlightskinhighlight状态皮肤有效皮肤IDN-Highlight状态时控件的外观皮肤ac
7、tiveskinactive状态皮肤有效皮肤IDN-Active状态时控件的外观皮肤mousedownskinmousedown状态皮肤有效皮肤IDN-鼠标按下状态时控件的外观皮肤leftorderobj左兄弟控件有效兄弟控件IDN-同一父容器中，通过方向按键表1-3控件公共事件函数3处理函数触发事件必须设置说明onkeydown按键按下N-onkeyup按键弹起N-属性名称属性含义取值范围必须设置默认值说明rightorderobj右兄弟控件有效兄弟控件IDN-可以完成焦点切换的控件uporderobj上兄弟控件有效兄弟控件IDN-downorderobj下兄弟控件有效兄
8、弟控件IDN-widgetmirror切换到反向书写语言时控件坐标位置是否镜像yes：需要no：不需要NnoRTL和LTR语言互相切换时发生镜像widgeteriormirror切换到反向书写语言时控件内容是否镜像yes：需要no：不需要NnoRTL和LTR语言互相切换时发生镜像font文本使用字体有效字体IDN-text文本内容多语言字串IDN-对包含文本内容的控件有效alignment内容对齐方式水平方向选择：left、right、hcenter、forceleft、forceright垂直方向选择：top、bottom、vcenter自动换行选择：wr
9、ap省略号选择：wordellipsisNhcenter|vcenter四种类型的对齐方式通过或(|)进行设置，如：left|top|wrap|wordellipsis;hcenter|vcenter最多可使用三个或(|)符号force表示不受语言环境切换影响，强制对齐focusmode焦点模式auto/manualNautoauto可直接操作或编辑控件,manual需按ENTER进入/退出操作状态1.3Window表1-4Window私有属性4属性名称属性含义取值范围必须设置默认值说明opacitywindow透明度0255N255数值越小越透明，仅适用于非共享模
10、式winlevelwindow的Z序015N0window叠加时，Z序高的window覆盖Z序低的windowcolorkeywindow色键颜色值N-整个window的色键，包括window中的控件，覆盖色键的区域会透过图层layerwindow所属图层有效图层N缺省图层为多图层模块提供，（多图层使用请参考HiGV开发指南）如果设置了多个图层会在相应图层进行克隆，例子：layer=LAYER_0;LAYER_1;LAYER_2注意：通过设置window的layer是该window所在的图层，如果设置了全局图层处理函数触发事件必须设置说明ontimer
11、定时器触发N-ongetfocus控件获取焦点N-onlostfocus控件失去焦点N-onmousein鼠标进入N-onmousedown鼠标按下N-onmouseout鼠标移出N-onmouseup鼠标抬起N-onmousemove鼠标移动N-onmousewheel鼠标滚轮N-onmousedbclick鼠标双击N-onfocuseditexit手动焦点模式退出操作N焦点模式处于手动模式时有效,该函数返回HIGV_PROC_STOP会继续处于操作编辑态,HIGV_PROC_GOON退出操作编辑态，处于焦点切换状态onlanchange语言环境切换N-表1-5Window私有事件函
12、数1.4Button表1-6Button私有属性5属性名称属性含义取值范围必须设置默认值说明style按钮风格Check：复选框Radio：单选框Normal：普通按钮Switch：开关按钮Toggle：纽扣开关按钮Nnormalcheck和radio风格有选中或非选中形态，switch和toggle有打开或关闭形态处理函数触发事件必须设置说明onevent用户自定义事件HIGV_MSG_EVENTN-onshowwindow开始显示前N-onrefreshwindow绘制完成后N-onhidewindow隐藏后N-属性名称属性含义取值范围必须设置默认值说明而w
13、indow的图层没有设置则按照全局图层进行设置或克隆.全局图层是通过xml2bin工具的选项进行设置，例子：xml2bin-LLAYER_0;LAYER_1;LAYER_2目前最多支持3个图层pixelformatwindow的像素格式像素格式类型N缺省则取图层的像素格式支持的像素格式类型：clut8,clut1,clut4,argb4444,argb0444,argb1555,argb0555,rgb565,argb8565,argb8888,argb0888isnotclone强制不克隆该windowyes/noNno对不需要进行克隆的windo
15、形态时的鼠标按下状态皮肤leftmargin左边距零和正整数N0文字的绘制区域与控件边界的距离：像素rightmargin右边距零和正整数N0topmargin顶边距零和正整数N0bottommargin底边距零和正整数N0texton打开形态文本多语言字串IDN-switch、toggle风格按钮有效textoff关闭形态文本多语言字串IDN-switch、toggle风格按钮有效switchlayout开关布局off:on,on:offNoff:onswitch风格按钮有效toggleoncolor打开形态的指示条颜色颜色值N-toggle风格按钮有效，不设置则不绘制t
16、oggleoffcolor关闭形态的指示条颜色颜色值N-toggle风格按钮有效，不设置则不绘制表1-7Button私有事件函数1.5Label暂无，该控件没有独立特殊属性。1.6ProgressBar表1-8ProgressBar私有属性表1-9ProgressBar私有事件函数7处理函数触发事件必须设置说明onselect进度改变N-属性名称属性含义取值范围必须设置默认值说明step步进长度rangemax-rangeminN1-rangemax最大取值正整数Y-rangemin最小取值零和正整数Y-fillskin进度显示的皮肤有效皮肤IDN-isvertica
17、l是否是垂直方向Yes：垂直No：水平方向Nno-处理函数触发事件必须设置说明onclick点击并弹起N-onsuschangecheck形态切换N-1.7Edit表1-10Edit私有属性8属性名称属性含义取值范围必须设置默认值说明maskchar掩码内容字符串N-ismask为yes时必须设置掩码格式如#.#MHZ，其中#为允许输入字符位置maxlength最大字符长度正整数N-ismask为no时有效beforecipherchar输入前显示字符字符N0ispassword为yes时有效-aftercipherchar输入后显示字符字符N*cursor初
18、始光标位置零和正整数N0-isdigit是否仅限输入数字yes/noNno数字风格编辑字符达到输入上限时末尾没有光标位ispassword是否框yes/noNno-iscursorcycle光标是否循环yes/noNno光标到达边界后继续移动是否能跳转到另一头ismask是否掩码格式yes/noNno-isreadonly是否只读yes/noNno-isdel是否支持HIGV_KEY_LEFT删除已输入字符yes/noNno-inputmethodtype支持输入法类型支持的输入法类型pinyin（拼音）symbol（符号）english（字母）cnglish（大写字母）numbe
19、r（数字）standard_a(标准A)standard_b(标准B)N默认支持所有类型例子：Inputmethodtype=“pinyin|symbol|number”表示该控件支持拼音、符号、数字输入法输入该属性设置是针对该控件的局部输入法控制，全局输入法类型控制可调用接口进行设置表1-11Edit私有事件函数1.8Spin表1-12Spin私有属性海思专有和信息9市海思半导体属性名称属性含义取值范围必须设置默认值说明type控件类型digital：数字型string：枚举型binddb：绑定数据库型NdigitalSpin类型不同设置取值范围的方式也不同：digit
20、al型：需要设置rangeminstepitemnumstring型：需要设置arrayvaluebinddb型：需要设置datamdatam绑定的数据模型ID有效数据模型IDN-rangemin数字型最小值零和正整数N0type为digital时有效，取值范围从rangemin开始每次递增step的itemnum个数据step步长正整数N1itemnum数据项个数正整数N0arrayvaluespin的取值范围多语言字符串IDN-type为string型时有效，使用”;”将字串ID分开。如value1;value2;value3的数据项即为
23、nimg下箭头鼠标进入状态资源N-downarrowpressimg下箭头按下状态图片资源N-表1-15Clock私有事件函数1.10ListBox表1-16ListBox私有属性11属性名称属性含义取值范围必须设置默认值说明rownum显示行数正整数Y-colnum列数正整数Y-datam绑定的数据模型ID有效数据模型IDN-rowselectskin控件激活状态时列表焦点的皮肤有效皮肤IDY-rownormalskin控件未激活时列表焦点的皮肤有效皮肤IDN-scrollbar绑定的滚动条有效滚动条IDN-hlineheight网格水平线高度零和正整数N0-hl
26、no：画Nno-iscellactive是否单焦点模式yes：单焦点no：条目焦点Nno-cyc焦点是否可循环yes：循环no：不循环Nyes焦点移至边缘后，收到方向键是否可跳转至另一端getwidthcb单焦点模式用户设置单宽度函数0-100N-iscellactive为yes时有效，回调函数的返回值为单宽度占控件总宽度的百分比autoswitchcell单焦点模式是否自动切换选中单yes：自动no：用户通过接口切换选中单元格Nnoiscellactive为yes时有效scrollcol条目焦点模式文本可滚动列列索引Nnoiscellactive为no时有效表
28、iconN-colbinddb为yes时需指定coldonv数据转换函数string表示的函数N-用于将原始数据转换为需要显示的格式colalignment列内容对齐方式四种类型的对齐方式通过或(|)进行设置，水平方向选择：left、right、hcenter垂直方向选择：tottom、vcenter自动换行选择：wrap省略号选择：wordellipsis如：left|top|wrap|wordellipsis最多可使用三个或(|)符号Nhcenter|vcenter-colimage内容有效资源N-当type为image时有效fgidx列文字颜色颜色值N-焦点
29、皮肤前景色优先级高于列字体颜色1.11ScrollBar表1-19ScrollBar私有属性1.12Image表1-20Image私有属性1.13ImageEx表1-21ImageEx私有属性14属性名称属性含义取值范围必须设置默认值说明image有效资源Y-资源=相对路径+文件名erval帧切换间隔正整数N0显示动态gif时有效：毫秒属性名称属性含义取值范围必须设置默认值说明image有效资源Y-资源=相对路径+文件名属性名称属性含义取值范围必须设置默认值说明slidres滑块皮肤有效皮肤IDY-滑块的偏移依赖于皮肤左上角ltox的高度sliddircet滚动
30、方向horizon：水平vertical：垂直Nvertical-uparrownormal上箭头正常状态图片资源有效资源N-资源=相对路径+文件名，horizon滚动条为左右箭头downarrownormal下箭头正常状态图片资源N-uparrowpress上箭头鼠标按下状态资源N-downarrowpress下箭头鼠标按下状态资源N-1.14TimeTrack表1-22TimeTrack私有属性15属性名称属性含义取值范围必须设置默认值说明normalthumbfile正常状态滑块资源有效资源Y-资源=相对路径+文件名activethumbfile活动状态滑块资
34、置默认值说明rownum行数正整数Y-colnum列数正整数Y-datam绑定的数据模型ID有效数据模型IDN-focuiveskin控件激活状态时焦点的皮肤有效皮肤IDY-focusnormskin控件非激活状态时焦点的皮肤有效皮肤IDN-leftmargin内容边距零和正整数N0-处理函数触发事件必须设置说明onetimeover滚动完一个周期N-属性名称属性含义取值范围必须设置默认值说明sus初始滚动状态yes：初始状态为滚动no：初始状态为停止Nno-image滚动资源有效资源N-资源=相对路径+文件名imagetop滚动在控件中位置零和正整数N0：像素imagele
37、Grid私有事件函数表1-28ScrollCol私有属性海思专有和信息19市海思半导体属性名称属性含义取值范围必须设置默认值说明colindex列零和正整数Y-取值要小于单(CELL)的列数coltype列类型textimageNtext-coltop文本或相对单位置零和正整数N-如果未设置内容位置则居中显示，：像素colleft零和正整数N-colwidth列宽零和正整数Y-为0时表示隐藏列，所有列colleft+colwidth不能大于单(CELL)宽度colheight列高零和正整数Y-为0时表示隐藏列，所有列coltop+colheight不能大于单(CEL
38、L)高度处理函数触发事件必须设置说明onfocusmove焦点框切换N-oncellcolselect单的属性列选中N-onfocusreachtop焦点移动到上边缘N-onfocusreachbtm焦点移动到下边缘N-onfocusreachleft焦点移动到左边缘N-onfocusreachright焦点移动到右边缘N-ondhange数据更新N-ondecimgstart动态开始N-ondecimgfinish动态结束N-1.17ScrollBox表1-29ScrollBox私有属性20属性名称属性含义取值范围必须设置默认值说明focusdispmode焦点框显示模式normal
41、teps滚动步长正整数N0：像素texttop非焦点框文本相对位置零和正整数N0缩放模式无效，：像素textleft零和正整数N0textwidth非焦点框文本框文大小零和正整数N0为0时隐藏，：像素textheight零和正整数N0imgtop非焦点框相对位置零和正整数N0：像素imgleft零和正整数N0imgwidth非焦点框大小零和正整数N0为0时隐藏，：像素imgheight零和正整数N0focusrectskin焦点框皮肤有效资源N-资源=相对路径+文件名focustexttop焦点框文本相对位置零和正整数N0异质模式有效，为0时隐藏，单位：像素focustex
42、tleft零和正整数N0focustextwidth焦点框文大小零和正整数N0focustextheight零和正整数N0focusimgtop焦点框图片相对位置零和正整数N0focusimgleft零和正整数N0focusimgwidth焦点框图片大小零和正整数N0focusimgheight零和正整数N0focusrectwidth焦点框大小零和正整数N0为0时与正常框大小相同,同质模式无效，：像素focusrectheight零和正整数N0leftmargin边距零和正整数N0：像素rightmargin零和正整数N0：像素表1-30ScrollBox私有事
43、件函数1.18ComboBox表1-31ComboBox私有属性22属性名称属性含义取值范围必须设置默认值说明datam绑定的数据模型ID有效数据模型IDN-dbindex绑定的数据模型的序列号零和正整数N0-type控件类型string：枚举型binddb：绑定数据库型Nbinddb-arrayvalue枚举取值以;分隔的多语言字串IDN=type为string时有效scrollbarwidth弹出框中scrollbar宽度零和正整数N0：像素poxheight弹出框高度正整数Y-：像素row弹出框显示行数零和正整数N-缺省或为0时自动计算处理函数触发事件必须设置
44、说明onfocuect焦点框切换N-onfocusclick焦点框确认N-属性名称属性含义取值范围必须设置默认值说明topmargin零和正整数N0：像素bottommargin零和正整数N0：像素space元素间距零和正整数N0：像素23属性名称属性含义取值范围必须设置默认值说明listalignlist内容对齐方式“ListBox的对齐方式”Nhcenter|vcenter-poxskin弹出框ListBox皮肤有效皮肤IDN-scrollbarskin弹出框ScrollBar皮肤有效皮肤IDN-slideskin弹出框ScrollBar滑块皮肤有效皮肤IDN-li
45、strowselectskinList处于焦点状态时的选中行皮肤有效皮肤IDY-listrownormalskinList处于非焦点状态时的选中行皮肤有效皮肤IDN-sbuparrownormalScrollBar上箭头正常状态图片资源有效资源N-资源=相对路径+文件名sbdownarrownormalScrollBar下箭头正常状态图片资源N-sbuparrowpressScrollBar上箭头按下状态图片资源N-sbdownarrowpressScrollBar下箭头按下状态图片资源N-arrownormalimg下拉箭头正常状态N-表1-32ComboBox私
46、有事件函数1.19TrackBar表1-33TrackBar私有属性24属性名称属性含义取值范围必须设置默认值说明normaltrack正常状态滑块有效资源N-资源=相对路径+文件名activetrack激活状态滑块N-mousedowntrack鼠标按下状态滑块N-slider滑杆背景Y-leftmargin滑杆的边距零和正整数N0：像素rightmargin零和正整数N0：像素topmargin零和正整数N0：像素bottommargin零和正整数N0：像素curvalue当前值零和正整数N0-maxvalue最大值正整数Y0-minvalue最小值零和正整数Y0-处理函
47、数触发事件必须设置说明onitemselect条目选中N-属性名称属性含义取值范围必须设置默认值说明arrowmouseonimg下拉箭头鼠标状态N-arrowpressimg下拉箭头按下状态N-表1-34TrackBar私有事件函数1.20IpEdit表1-35IpEdit私有属性1.21Calendar表1-36Calendar私有属性25属性名称属性含义取值范围必须设置默认值说明uparrownormalimg上箭头正常状态图片有效资源N-资源=相对路径+文件名uparrowmouseonimg上箭头鼠标进入状态N-uparrowpressimg上箭头按下N
48、-downarrownormalimg下箭头正常状态图片N-downarrowmouseonimg下箭头鼠标进入状态N-属性名称属性含义取值范围必须设置默认值说明ipaddrIP地址值正整数N00xFF=55IPv4处理函数触发事件必须设置说明onvaluechange刻度变化N-属性名称属性含义取值范围必须设置默认值说明step步长正整数Y0-style滑块的风格vertical：垂直风格horizon：水平风格Nhorizon-表1-37Calendar私有事件函数26处理函数触发事件必须设置说明onselect日期变化N-属性名称属性含义取值范围必须设置默认值说明do
49、wnarrowpressimg下箭头按下N-insidenormalskin子控件正常状态皮肤有效皮肤IDN-insideactiveskin子控件激活状态皮肤N-insidehighlightskin子控件状态皮肤N-highlightyear日期年正整数Y-highlightmonth日期月正整数Y-highlightday日期日正整数Y-highlightcolor日期色彩颜色值N-satcolor周六色彩颜色值N-suncolor周日色彩颜色值N-kstartday开始的设置正整数Y-kstr多语言字符串多语言字符串IDY-多语言字符串，用分号隔开,例子：STR_M
50、ONDAY;STR_TUSDAY;monthstr月份多语言字符串多语言字符串IDY-月份多语言字符串，用分号隔开1.22TimeBar表1-38TimeBar私有属性27属性名称属性含义取值范围必须设置默认值说明marginleft左边距零和正整数N-marginright右边距零和正整数N-displayformat刻度显示格式year,month,day,hour,minute,yearmonth,monthday,hourminute,yearmonthday,hourminutesecond,kNsecond-displayerval刻度显示间隔正整数Y-：毫
53、edownthumbfile开始按下状态滑块资源N-endnormalthumbfile结束正常状态滑块资源N-endactivethumbfile结束激活状态滑块资源N-表1-39TimeBar私有事件函数1.23MsgBox表1-40MsgBox私有属性29属性名称属性含义取值范围必须设置默认值说明opacitywindow透明度0-255N255数值越小越透明，仅适用于非共享模式winlevelwindow所处层级0-15N0window叠加时，级window覆盖低层级windowcolorkeywindow透明色整数N-整个window的透明色，包括
54、window中的控件，覆盖透明色的区域会透过图层处理函数触发事件必须设置说明ondragbegin拖动开始N-ondragend拖动结束N-onselect刻度变化N-属性名称属性含义取值范围必须设置默认值说明endmousedownthumbfile结束按下状态滑块资源N-currentunit当前刻度零和正整数N-beginunit开始刻度零和正整数N-endunit结束刻度正整数N-curflag是否显示当前刻度yes：显示no：不显示Nnobeginflag是否显示开始刻度Nnoendflag是否显示结束刻度Nno30属性名称属性含义取值范围必须设置默认值说明layerwin
56、、abortretryignore、yesnocancel、userdefNnonenone风格没有按钮，userdef为用户自定义风格，其他风格表示按钮顺序titleheight标题栏高度整数N0为0时不生成title，title高度和buttonareaheight高度不能大于控件高度，：像素titletext标题栏文本多语言字串IDN-存在title时生效titlealignment标题栏内容对齐方式水平方向选择：left、right、hcenter、forceleft、forceright垂直方向选择：tottom、vcenter自动换行选择：wr
57、ap省略号选择：wordellipsisNleft|vcenter存在title时生效titlefont字体ID有效字体IDN-存在title时生效titleskin标题栏皮肤有效皮肤IDN-存在title时生效，未设置会选取背景皮肤buttoncount按钮总数零和正整数N-Style为userdef时生效，最大按钮总数为4海思专有和信息31市海思半导体属性名称属性含义取值范围必须设置默认值说明buttontext按钮文本多语言字串IDN-每个按钮的文本ID用分号;隔开，请设置等同于按钮总数的字串IDbuttonfont字体ID有效字体IDN-but
58、tonareaskin按钮区域皮肤有效皮肤IDN-buttonnormalskin按钮正常状态皮肤N-buttonhighlightskin按钮状态皮肤N-buttonactiveskin按钮激活状态皮肤N-buttonmousedownskin按钮鼠标按下状态皮肤N-buttonareaheight按钮区域高度零和正整数N0title高度和buttonareaheight高度不能大于控件高度buttonheight按钮高度零和正整数N0不能大于buttonareaheight高度buttonwidth按钮宽度零和正整数N0所有按钮宽度总和不能大于控件宽度butto
60、有事件函数1.24MultiEdit表1-42MultiEdit私有属性海思专有和信息32市海思半导体属性名称属性含义取值范围必须设置默认值说明charnum最大字符个数零和正整数N0为0时isreadonly是否只读yes/noNno只读风格不绘制光标issingleline是否单行yes/noNno-charspace字符间距零和正整数N0：像素linespace行符间距零和正整数N0：像素selectbgcolor选中文本区域背景颜色值N0xFF0000FF-selectfgcolor选中文本字体颜色颜色值N0xFF-处理函数触发事件必须设置说明onevent用户自定义