ColorPicker控件为用户提供了一种从样本列表中选择颜色的方法。组件的默认模式是在方形按钮中显示单一样本。当用户单击该样本按钮时,将会出现样本面板并显示整个样本列表。
属性详细信息
colorField 属性
colorField:String
dataProvider Array 的对象中的字段名称,该字段用于指定样本面板显示的十六进制颜色值。
如果 dataProvider 对象不包含颜色字段,则将
colorField
属性设置为使用正确的字段名称。如果 dataProvider 是十六进制颜色值的 Array,则即使此属性可用,也不会有任何意义。
默认值为
"color"
.
此属性可用作数据绑定的源。
labelField 属性
labelField:String
[]
dataProvider Array 的对象中的字段名称,该字段中包含要在 SwatchPanel 对象文本框中作为标签显示的文本。
如果 dataProvider 对象不包含标签字段,则将
labelField
属性设置为使用正确的字段名称。如果 dataProvider 是十六进制颜色值的 Array,则即使此属性可用,也不会有任何意义。
默认值为
"label"
.
此属性可用作数据绑定的源。
selectedColor 属性
selectedColor:uint
[]
SwatchPanel 对象中当前所选颜色的值。只可在 <mx:ColorPicker> 标签中将此属性设置为标准字符串颜色名称,如“blue”。如果 dataProvider 包含黑色 (0x000000) 条目,则默认值为 0;否则,默认值为数据提供程序中索引为 0 处的项目颜色。
此属性可用作数据绑定的源。
实现
public function get selectedColor():uint
public function set selectedColor(value:uint):void
selectedIndex 属性
selectedIndex:int
[]
SwatchPanel 对象中选定项目的 dataProvider 中的索引。通过此属性可以将选定颜色设置为与索引对应的颜色,并可将下拉样本中的选定索引设置为
selectedIndex
属性值,还可在文本框中显示相关联的标签。默认值为与黑色 (0x000000)(如果存在)对应的索引;否则,将为 0。
此属性可用作数据绑定的源。
实现
public function set selectedIndex(value:int):void
showTextField 属性
showTextField:Boolean
[]
指定是否显示用于显示颜色标签或十六进制颜色值的文本框。
默认值为
true
.
实现
public function get showTextField():Boolean
public function set showTextField(value:Boolean):void
swatchStyleFilters 属性
swatchStyleFilters 属性
swatchStyleFilters:Object
[]
上述参数用法:(示例)
<?xml version="1.0" encoding="utf-8"?> <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="vertical" backgroundColor="white" <!-- 以下定义作为colorpicker颜色种类数据源,包含name,value两个值 --> <mx:Array id="colorPicker_dataProvider"> <mx:Object name="black" value="0x000000" /> <mx:Object name="blue" value="0x0000FF" /> <mx:Object name="green" value="0x008000" /> <mx:Object name="gray" value="0x808080" /> <mx:Object name="silver" value="0xC0C0C0" /> <mx:Object name="lime" value="0x00FF00" /> <mx:Object name="olive" value="0x808000" /> <mx:Object name="white" value="0xFFFFFF" /> <mx:Object name="yellow" value="0xFFFF00" /> <mx:Object name="maroon" value="0x800000" /> <mx:Object name="navy" value="0x000080" /> <mx:Object name="red" value="0xFF0000" /> </mx:Array> <mx:HBox width="{box.width}"> <mx:ColorPicker id="colorPicker" dataProvider="{colorPicker_dataProvider}" colorField="value" labelField="name" editable="false" change="box.setStyle('backgroundColor' event.color);" /> <!-- 以上代码,定义一个ColorPicker,将上面clolorPicker_dataProvider数组做为此控件的数据源(与默认情况不同,此控件只包含了上述几种颜色),colorField属性是颜色对认数组中的value,用来表示颜色值,labelField属性是要在 SwatchPanel 对象文本框中作为标签显示的文本(个人觉得意义不大,关键在于colorField,change是事件,change="mon.setStyle('backgroundColor',event.color)",注意此引用方法,其中mon为所要控制颜色对象的id -->
</mx:HBox> <mx:Box id="box" width="200" height="100" /> </mx:Application>