|
|
 Flash
MX ActionScript字典 |
|
|
FCheckBox (组件)
CheckBox组件为制作动画提供了一个在Flash管理环境下采用简单拖放的方式来创建复选框，它也提供了一个使用者设置参数的接口。FcheckBox组件的方法允许在动画运行时控制复选框。可以创建一个复选框，在管理时控制复选框，同时设置更新参数，也可以设置运行时的额外选项。使用者不需要使用一个结构体去和组件交换数据。此组件在Flash
6或更高的播放器中可用。
组件的方法并不对类型匹配问题进行检查，这点和其他原有的脚本对象和命令是相同的。因此只有当确认参数有效时才传递给方法。
对于使用组件的信息，管理时使用的参数，改变组件的外形和颜色，参看使用组件一章的用户自定制组件颜色和文本，和定制组件皮肤。
下面是此对象使用相应方法的列表
|
属性
|
描述
|
|
FCheckBox.getEnabled
|
如果复选框有效返回true，如果无效返回false
|
|
FCheckBox.getLabel
|
返回复选框的卷标的字符串
|
|
FCheckBox.getValue
|
如果复选框被选中返回true，如果复选框未被选中返回false
|
|
FCheckBox.registerSkinElement
|
给一个属性注册一个皮肤元素
|
|
FCheckBox.setChangeHandler
|
当复选框的内容改变时设置一个函数调用句柄
|
|
FCheckBox.setEnabled
|
确定复选框是否可用
|
|
FCheckBox.setLabel
|
给复选框赋予卷标字符串
|
|
FCheckBox.setLabelPlacement
|
设置卷标出现在复选框的左边还是右边
|
|
FCheckBox.setSize
|
设定复选框的宽度，像素为单位，此时重画复选框
|
|
FCheckBox.setStyleProperty
|
为复选框设定一个显示风格
|
|
FCheckBox.setValue
|
选择或者重新选择复选框的触发函数句柄
|
FCheckBox.getEnabled
|
语法
|
MyCheckBox.getEnabled()
|
|
参数
|
返回一个逻辑值，确定复选框是否可用
|
|
说明
|
方法
。确定复选框是否可用
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
下边的例子返回checkBox1可用的状态并将状态显示在屏幕上
trace(checkBox1.getEnabled());
|
|
参看
|
FcheckBox.setValue
|
FCheckBox.getLabel
|
语法
|
MyCheckBox.getLabel()
|
|
参数
|
返回一个字符串
|
|
说明
|
方法
。返回复选框的卷标
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
下边的例子返回checkBox1的卷标
checkBox1.getLabel();
|
|
参看
|
FcheckBox.setLabel
|
FCheckBox.getValue
|
语法
|
MyCheckBox.getValue()
|
|
参数
|
返回一个逻辑值，确定复选框是否被选中
|
|
说明
|
方法
。 确定复选框是否被选中
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
下边的例子返回被选中的KowalczykBox的状态，显示到屏幕
trace(KowalczykBox.getValue());
|
|
参看
|
FcheckBox.setValue
|
FCheckBox.registerSkinElement
|
语法
|
MyCheckBox.registerSkinElement(element,
styleProperty)
|
|
参数
|
Element
:电影片断;
StyleProperty:一个FStyleFormat属性的名字
|
|
说明
|
方法
。为style属性注册一个皮肤元素，皮肤元素在每一个皮肤库的ReadMe层的第一帧被注册。组件是由皮肤构成的，每个皮肤由一些皮肤元素组成，每一个元素都可以注册到FStyleFormat对象的属性中。这些属性被设置给组件的style格式分配值。默认情况所有的统一组件被设置globalStyleFormat对象，这些对象是FStyleFormat对象的实例。使用这些方法给统一组件或者是用户定义的组件皮肤注册用户自己的皮肤元素和属性时，要编辑皮肤库中的ReadMe层的第一帧的代码。一旦已经把组件加到了Flash文档中，FcheckBox组件就可以使用FcheckBox
Skins文件夹中的皮肤。更多信息请参看使用组件中的用户自定义组件皮肤。
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
下边的例子首先注册用户皮肤元素customChk_mc到复选框属性，注册语句在库中的FcheckBox Skins文件夹中的fcb_check皮肤的Read Me层的第一帧。
check1.registerSkinElement(customChk_mc,
"check");
|
|
参看
|
无
|
FCheckBox.setChangeHandler
|
语法
|
MyCheckBox.setChangeHandler(functionName,
[location])
|
|
参数
|
FunctionName：
确定当复选框的值改变时的要执行的函数的句柄的名字的字符串，如果location参数没有设置，此函数此函数必须在组件的相同的时间线上。
Location
: data对象，电影片断或者是时间线的参考路径，这些对象包含着指定函数，这个参数为可选项，默认情况为组件的父时间线。
|
|
说明
|
方法。
当复选框值改变时确定一个改变后调用函数的句柄。可以为多于一个的组件确定相同的改变句柄。函数总能接受作为参数改变的组件的实例名。在管理环境下调用这个方法来改变Change Handler参数值，更多信息请参看使用组件中的Writing change handler函数。
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
下边的例子当复选框checkBox1的值改变时确定myHandler被函数调用。由于location参数没有设置，myHandler必须是在相同的组件的时间线上。MyHandler中的组件参数是用组件实例的名称自动填充的（已经作为使用者输入改变结果的组件和已经确定myHandler作为改变的句柄）。当使用者选中一个复选框时myHandler中的脚本定义了组件的名字，"
被选中 "输出到屏幕。CheckBox1.setChangeHandler("myHandler");
function
myHandler(component){
trace(component._name
+ " 被选中 ");
}
如果在下面的例子中myHandler在当前上三层的时间线上，下面是第一行的代码：
check1.setChangeHandler("myHandler",
_parent._parent._parent);
下面的代码在myObject定义了函数句柄，然后确定myHandler作为check1的响应函数。
MyObject
= new Object();
MyObject.myHandler
= function(component){
Trace(component._name
+ " 被选中 ");
}
check1.setChangeHandler("myHandler",
myObject);
|
|
参看
|
无
|
FCheckBox.setEnabled
|
语法
|
MyCheckBox.setEnabled(enable)
|
|
参数
|
Enable
：确定当前复选框是否可用的逻辑值
|
|
说明
|
方法。确定付选框是否有效，如果复选框无效，它不能接受用户的键盘或鼠标事件。如果忽略这个参数，方法默认为真。
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
下边的例子使复选框无效。
CheckBox1.setEnabled(false);
|
|
参看
|
无
|
FCheckBox.setLabel
|
语法
|
MyCheckBox.setLabel(label)
|
|
参数
|
Label
：确定当前复选框卷标的字符串
|
|
说明
|
方法
。设置当前复选框卷标的字符串，默认情况卷标出现在复选框的右边。是用此方法重新设置label参数
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
下边的例子设置复选框CHECKBOX1的卷标为Send
more information。
CheckBox1.setLabel("Send
more information");
|
|
参看
|
FCheckBox.getLabel, FcheckBox.setLabelPlacement
|
FCheckBox.setLabelPlacement
|
语法
|
MyCheckBox.setLabelPlacement(labelPosition)
|
|
参数
|
LabelPosition
：一个文本字符串，"left"（左）或 "right"（右）。
|
|
说明
|
方法。确定复选框卷标出现在复选框的左边还是右边。使用此方法确定label placement参数。
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
下边的例子设置复选框CHECKBOX1的卷标出现左边
checkBox1.setLabelPlacement("left");
|
|
参看
|
FCheckBox.setLabel
|
FCheckBox.setSize
|
语法
|
MyCheckBox.setSize(width)
|
|
参数
|
width
：整数值，单位为像素，表示复选框的宽度。
|
|
说明
|
方法。确定复选框的宽度，并重画。不能设置高度。是用此方法设置复选框的宽度
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
下边的例子设置复选框CHECKBOX1的宽度为200像素
checkBox1.setSize(200);
|
|
参看
|
无
|
FCheckBox.setStyleProperty
|
语法
|
myCheckBox.setStyleProperty(styleProperty,
value)
|
|
参数
|
styleProperty
: 确定FStyleFormat对象属性的字符串
value
: 设定给属性的值
|
|
说明
|
方法。为独立的复选框实例设定一个FStyleFormat属性。是用此方法重新设定一个在style format中设定过的属性的值。给删除了所有的styles属性的的属性赋予undefinited这个值。为了给多个组件设置FStyleFormat属性，创建了custom
style format。更多信息请参看使用组件中的用户自定义组件颜色和文本。
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
下边的例子设置复选框CHECKBOX1的shadow属性（阴影色）为0x000000
checkBox1.setStyleProperty("shadow",
0x000000);
|
|
参看
|
FStyleFormat (对象)
|
FCheckBox.setValue
|
语法
|
MyCheckBox.setValue(select)
|
|
参数
|
select
:确定符选框是否被选中的逻辑值
|
|
说明
|
方法。选择或者重新选择复选框的触发句柄函数，默认值为真。虽然是用此方法时改写Initial Value参数值，由于它也会触发相关的变化函数，所以不要使用此方法实现这项功能。为了在运行时设置一个复选框Initial
Value参数，使用FcheckBox.setStyleProperty
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
下边的例子代码选择了checkBox1复选框然后触发被change
handler确定的函数。
CheckBox1.setValue(true);
|
|
参看
|
FcheckBox.getValue
|
FComboBox (组件)
FComboBox组件为制作动画提供了一个在Flash管理环境下采用简单拖放的方式来创建功能组件，此组件可以增加滚动的单选下拉选项，它也提供了一个使用者设置参数的接口。FComboBox组件的方法允许在影片播放时控制组合框。可以创建一个组合框，在管理时控制组合框，同时设置更新参数，也可以设置运行时的额外选项。使用者不需要使用一个结构体去和组件交换数据。ComboBox组件可以创建静态组合组件和可编辑的组合组件。一个静态组件是一个可滚动的下拉列表，使用者可以选择选项。可编辑的组合列表是一个有可滚动的下拉列表，在顶部有文本域的组合组件。可以让使用者在文本域键入文本来定位到想要的位置，或者使用文本域在运行时来隐藏组件。两种组件都从顶到底使用了从零开始的索引系统。如果下拉列表的所用空间大于下面的空间时下拉列表显示在上方。此组件在Flash 6或更高的播放器中可用。
组件的方法并不对类型匹配问题进行检查，这点和其他原有的脚本对象和命令是相同的。因此只有当确认参数有效时才传递给方法。
对于使用组合组件的信息，管理时使用的参数，改变组件的外形和颜色，参看使用组件一章的用户自定制组件颜色和文本，和定制组件皮肤。
下面是此对象使用相应方法的列表
|
属性
|
描述
|
|
FComboBox.addItem
|
在组合框的末尾添加一个选项
|
|
FComboBox.addItemAt
|
在索引指定的位置添加一个选项
|
|
FComboBox.getEnabled
|
如果组合框有效返回true，如果组合框无效返回false
|
|
FComboBox.getItemAt
|
在指定索引的选项，作为对象返回包含的卷表属性和数据
|
|
FComboBox.getLength
|
返回在组合框中选项的数目
|
|
FComboBox.getRowCount
|
返回组合框中可见行的数目
|
|
FComboBox.getScrollPosition
|
返回组合框中在顶部选项的索引
|
|
FComboBox.getSelectedIndex
|
返回当前所选项的索引
|
|
FComboBox.getSelectedItem
|
返回当前索引的选项，作为对象返回包含的卷表属性和数据，
|
|
FComboBox.getValue
|
对于可编辑组合框返回输入域的文本；对于静态文本返回被选中选项的卷标和数据
|
|
FComboBox.registerSkinElement
|
给一个属性注册一个皮肤元素
|
|
FComboBox.removeAll
|
删除组合框中的所有选项
|
|
FComboBox.removeItemAt
|
删除索引指定的选项
|
|
FComboBox.replaceItemAt
|
替换索引指定的选项的卷标和数据
|
|
FComboBox.setChangeHandler
|
当用户在文本域键入文本或有个选项被选中时设置一个调用函数
|
|
FComboBox.setDataProvider
|
注册一个为组件提供数据的外围对象
|
|
FComboBox.setEditable
|
确定组合框是否可以编辑
|
|
FComboBox.setEnabled
|
确定组合框是否有效
|
|
FComboBox.setItemSymbol
|
为组合框中显示的选项注册一个链接的id
|
|
FComboBox.setRowCount
|
没有滚动条时被显示的选项的数目
|
|
FComboBox.setSelectedIndex
|
选择指定索引的选项
|
|
FComboBox.setSize
|
设定组合框的宽度，像素为单位
|
|
FComboBox.setStyleProperty
|
为组合框设定一个显示风格
|
|
FComboBox.setValue
|
确定在可编辑组合框中显示的文本
|
|
FComboBox.sortItemsBy
|
按选相中的卷标或数据的字母顺序或数字顺序排列列表框中的选项
|
FComboBox.addItem
|
语法
|
myComboBox.addItem(label
[,data])
|
|
参数
|
label
: 组合框中一个选项的文字
data
: 和列表选项相关联的值为可选项
|
|
说明
|
方法
。 为组合框在末尾添加一个选项，及其相关联的数据，数据可以是对象，字符串，逻辑值，整数值，Flash对象或电影片断。为了做到更好的效果，不要在一帧上添加多于400的选项。此项适用于将选项添加到一个或多个组合框。
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
下边的例子将kenny及其关联值keen添加到teacherlist末尾
teacherList.addItem("Kenny",
Keen);
下边的代码确定comboBox1的最大添加选项数目为400
for
(i=0; i<400; i++) {
comboBox1.addItem(i);
}
下边的代码确定两个组合框comboBox1和comboBox2添加选项的数目和最大为400
for (i=0; i<200; i++) {
listBox1.addItem(i);
comboBox2.addItem(i);
}
|
|
参看
|
FcomboBox.addItemAt, FComboBox.getItemAt,
FComboBox.replaceItemAt, FComboBox.setDataProvider,
FComboBox.sortItemsBy
|
FComboBox.addItemAt
|
语法
|
myComboBox.addItemAt(index,
label [,data])
|
|
参数
|
index
: 确定选项插入位置的索引
label
：确定插入选项的字符串
data
：和插入选项相关联的值，可选项
|
|
说明
|
方法。
为组合框在index指定的位置加一个选项，及其相关联的数据，数据可以是对象，字符串，逻辑值，整数值，Flash对象或电影片断。每添加一个选项组合框就会自动调整大小。ComboBox组件使用从零开始的索引系统，顶部选项为0。为了做到更好的效果，不要在一帧上添加多于400的选项。此项适用于将选项添加到一个或多个组合框。
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
下边的例子将Justin及其关联值Ace作为第15个选项添加到Favorites。
Favorites.addItemAt(4,
"Justin", Ace);
如果想加载大数目的选项参看FcomboBox.addItem
|
|
参看
|
FComboBox.getItemAt,
FComboBox.removeItemAt, FComboBox.replaceItemAt,
FComboBox.setDataProvider, FComboBox.sortItemsBy
|
FComboBox.getEnabled
|
语法
|
MyComboBox.getEnabled()
|
|
参数
|
返回一个逻辑值，确定组合框是否可用
|
|
说明
|
方法。
确定组合框是否可用
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
下边的例子使用getEnabled确定comboBox1可用的状态并将状态显示在屏幕上
trace(comboBox1.getEnabled());
|
|
参看
|
FComboBox.setEnabled
|
FComboBox.getItemAt
|
语法
|
MyComboBox.getItemAt(index)
|
|
参数
|
index
：确定组合框中选项位置的整数值，返回一个对象
|
|
说明
|
方法。
返回指定索引的选项，作为一个对象包含卷表属性和数据
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
下边的例子返回一个字符串，包含索引4处的卷标和选项
trace(comboBox1.getItemAt(4).label);
|
|
下边的例子comboBox2中索引4处的选项及其关联的数据，返回值依赖于数据的类型，可能为对象，字符串，电影片断说明，或其他类型
trace(comboBox2.getItemAt(4).data);
|
|
下边的例子返回一个对象，此对象包含comboBox3中索引4处的卷标及其关联的数据
trace(comboBox3.getItemAt(4));
|
|
参看
|
FComboBox.getSelectedItem
|
FComboBox.getLength
|
语法
|
myComboBox.getLength()
|
|
参数
|
返回一个整数
|
|
说明
|
方法。
返回组合框中选项的个数
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
var
len = listMain.getLength();
|
|
参看
|
FComboBox.addItem, FComboBox.addItemAt
|
FComboBox.getRowCount
|
语法
|
myComboBox.getRowCount()
|
|
参数
|
返回一个整数
|
|
说明
|
方法。
返回组合框中可见行的行数
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
var
rowCount = toyList.getRowCount();
|
|
参看
|
FComboBox.setRowCount
|
FComboBox.getScrollPosition
|
语法
|
MyComboBox.getScrollPosition()
|
|
参数
|
返回一个整数
|
|
说明
|
方法。
返回组合框中在顶部选项的索引，索引从0开始，顶部所因为0
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
var
scrollPos = toyList.getScrollPosition();
|
|
参看
|
FcomboBox.setSelectedIndex
|
FComboBox.getSelectedIndex
|
语法
|
MyComboBox.getSelectedIndex()
|
|
参数
|
返回一个整数或undedined
|
|
说明
|
方法。
返回组合框中当前被选中的选项的索引，如果没有选中选项返回undefined，被列选项从顶到底使用从0开始的索引
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
var
selIndex = toyList.getSelectedIndex();
|
|
参看
|
FcomboBox.setSelectedIndex
|
FComboBox.getSelectedItem
|
语法
|
MyComboBox.getSelectedItem()
|
|
参数
|
返回一个对象或undedined
|
|
说明
|
方法
。返回组合框中当前被选中的选项的索引，作为对象返回包含的卷表属性和数据，如果没有选中选项返回undefined
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
下边的例子返回当前被选中的选项的卷标和数据
trace(comboBox1.getSelectedItem());
下边的例子返回当前被选中的选项的卷标
trace(comboBox2.getSelectedItem().label);
下边的例子返回当前被选中的选项的代码
trace(comboBox3.getSelectedItem().data);
|
|
参看
|
FcomboBox.setSelectedIndex
|
FComboBox.getValue
|
语法
|
myComboBox.getValue()
|
|
参数
|
返回一个字符串
|
|
说明
|
方法。
如果为可编辑的组合框返回顶部选项中的文本，如果为静态组合框，返回与被选中的选项的数据或没有关联数据时返回卷标
|
|
播放器
|
Flash
6或更新版本
|
|
示例
|
trace(menuMain.getValue())
|
|
参看
|
FComboBox.setValue
|
FComboBox.registerSkinElement
|
语法
|
myComboBox.registerSkinElement(element,
styleProperty)
|
|
参数
|
Element
：一个电影片断实例
styleProperty
：一个 FStyleFormat 属性的名字
|
|
说明
|
方法。
为style属性注册一个皮肤元素，皮肤元素在每一个皮肤库的ReadMe层的第一帧被注册。组件是由皮肤构成的，每个皮肤由一些皮肤元素组成，每一个元素都可以注册到FStyleFormat对象的属性中。这些属性被组件的style格式分配值。默认情况所有的统一组件被设置globalStyleFormat对象，这些对象是FStyleFormat对象的实例。使用这些方法给统一组件或者是用户定义的组件皮肤注册用户自己的皮肤元素和属性时，要编辑皮肤库中的ReadMe层的第一帧的代码。一旦已经把组件加到了Flash文档中，FcomboBox组件就可以使用FcomboBox
Skins文件夹中的皮肤。更多信息请参看使用组件中的用户自定义组件皮肤。
|
|
播放器
|
| | | |
