控件级对象

该控件级是页面所有元素包括页面元素的基本级。

在这种情况下，控件不用于表明特定的屏幕对象而是一个 JavaScript 级。

用JavaScript更改控件属性

如果您想用 JavaScript 更改控件属性，请将控件属性静态优化设为动态。

重要：如果控件属性静态优化未设为动态，对属性的更改将被忽略。

在调用 getWidget 失败时，远程调试器将报告以下错误：

“尝试访问静态优化的控件标签１。停用控件静态优化以从脚本访问控件”。

使用如下编码，该错误将出现：

var wgt;

try {

wgt = page.getWidget('label1');

} catch(err) {

alert("" + err);

}

控件属性

这些属性是所有控件通用的。

objectName

string objectName

获取控件名称，一个唯一的 id。

function btnStd04_onMouseRelease(me) {

var wgt = page.getWidget("rect1");

var name = wgt.objectName;

}

(可在网页上使用)

x

number x

获取或设置控件的ｘ像素位置。

function btnStd1_onMouseRelease(me) {

var wgt = page.getWidget("rect1");

wgt.x = 10;

}

(可在网页上使用)

y

number y

获取或设置控件的ｙ像素位置。

function btnStd1_onMouseRelease(me) {

var wgt = page.getWidget("rect1");

wgt.y = 10;

}

(可在网页上使用)

width

number width

获取或设置控件的控件宽度像素。

function btnStd1_onMouseRelease(me) {

var wgt = page.getWidget("rect1");

wgt.width = 10;

}

(可在网页上使用)

height

number height

获取或设置控件的控件高度像素。

function btnStd1_onMouseRelease(me) {

var wgt = page.getWidget("rect1");

wgt.height = 10;

}

(可在网页上使用)

visible

boolean visible

获取或设置控件可见状态。

function btnStd4_onMouseRelease(me) {

var wgt = page.getWidget("rect1");

wgt.visible = false;

}

function btnStd5_onMouseRelease(me) {

var wgt = page.getWidget("rect1");

wgt.visible = true;

}

value

number value

获取或设置控件值。

function btnStd6_onMouseRelease(me) {

var wgt = page.getWidget("field1");

wgt.value = 100;

}

opacity

number opacity (range from 0 to 1)

获取或设置控件不透明性。值是从 0-1 的十进制的，其中１是 100% 不透明的。

function btnStd8_onMouseRelease(me) {

var wgt = page.getWidget("rect1");

wgt.opacity = 0.5;

}

(可在网页上使用)

rotation

number rotation (in degrees)

为控件获取或设置旋转角度。向右旋转完成要转的度数，从东边的位置开始。

function btnStd9_onMouseRelease(me) {

var wgt = page.getWidget("rect1");

wgt.rotation = 45;

}

(可在网页上使用)

userValue

string userValue

获取或设置用户定义的控件值。该域可以被 JavaScript 功能用来存储额外的控件数据。

function btnStd9_onMouseRelease(me) {

var wgt = page.getWidget("rect1");

wgt.userValue = "Here I can store custom data";

}

每一个控件有一些特定的属性，您可以使用点符号访问。对于最新和详细的属性列表，您可以使用JavaScript调试器控件检查控件函数和属性。

控件函数

一些函数是所有控件通用的。

getProperty

object getProperty( propertyName, [index] )

返回一个属性。

参数	说明
propertyName	包含要获取的属性的名称的字符串
index	要从数组获取的元素索引（默认＝０）

在 JMobile Studio 的属性窗格中显示的几乎所有属性都可使用 getProperty 函数检索。索引值是可选的，仅用于支持数组的控件。

function buttonStd1_onMouseRelease(me, eventInfo) {

var shape = page.getWidget("rect2");

var y_position = shape.getProperty("y");

}

function buttonStd2_onMouseRelease(me, eventInfo) {

var image = page.getWidget("multistate1");

var image3 = image.getProperty("imageList", 2);

//…

}

(可在网页上使用)

setProperty

boolean setProperty( propertyName, value, [index] )

为控件设置属性。

参数

参数	说明
propertyName	包含要设置的属性的名称的字符串
value	包含要设置属性的值的字符串。
index	要在数组中获取的元素索引（默认＝０）

在 JMobile Studio 的属性窗格中显示的几乎所有属性都可使用此函数设置。索引值是可选的，仅用于支持数组的控件（例如，多状态图像控件）。setProperty 函数返回一个 boolean 值（true 或 false），指示此属性是否经过设置。

function buttonStd1_onMouseRelease(me, eventInfo) {

var setting_result = shape.setProperty("y", 128);

if (setting_result)

alert("Shape returned to start position");

}

function buttonStd2_onMouseRelease(me, eventInfo) {

var image = page.getWidget("multistate1");

var result = image.setProperty("imageList", "Fract004.png", 2);

//…

}

(可在网页上使用)