fl.controls
public class ColorPicker
继承ColorPicker Inheritance UIComponent Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
实现 IFocusManagerComponent

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

ColorPicker 组件将显示包含一个或多个样本的列表,用户可以从中选择颜色。

默认情况下,该组件在方形按钮中显示单一颜色样本。 当用户单击此按钮时,将打开一个面板,其中显示样本的完整列表。

查看示例

另请参见

ColorPickerEvent



公共 属性
 属性定义方
 InheritedaccessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。
DisplayObject
 Inheritedalpha : Number
指示指定对象的 Alpha 透明度值。
DisplayObject
 InheritedblendMode : String
BlendMode 类中的一个值,用于指定要使用的混合模式。
DisplayObject
 InheritedbuttonMode : Boolean
指定此 sprite 的按钮模式。
Sprite
 InheritedcacheAsBitmap : Boolean
如果设置为 true,则 Flash Player 将缓存显示对象的内部位图表示形式。
DisplayObject
  colors : Array
获取或设置 ColorPicker 组件提供的自定义颜色的数组。
ColorPicker
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcontextMenu : ContextMenu
指定与此对象相关联的上下文菜单。
InteractiveObject
 InheriteddoubleClickEnabled : Boolean
指定此对象是否接收 doubleClick 事件。
InteractiveObject
 InheriteddropTarget : DisplayObject
[read-only] 指定拖动 sprite 时经过的显示对象,或放置 sprite 的显示对象。
Sprite
  editable : Boolean
获取或设置一个布尔值,指示 ColorPicker 组件的内部文本字段能否进行编辑。
ColorPicker
  enabled : Boolean
获取或设置一个值,该值指示组件是否可以接受用户交互。
ColorPicker
 Inheritedfilters : Array
包含当前与显示对象关联的每个滤镜对象的索引数组。
DisplayObject
 InheritedfocusEnabled : Boolean
获取或设置一个布尔值,该值指示组件是否可以在用户单击它后获得焦点。
UIComponent
 InheritedfocusManager : IFocusManager
获取或设置为此组件及其同级组件控制焦点的 FocusManager。
UIComponent
 InheritedfocusRect : Object
指定此对象是否显示焦点矩形。
InteractiveObject
 Inheritedgraphics : Graphics
[read-only] 指定属于此 sprite 的 Graphics 对象,在此 sprite 中可执行矢量绘画命令。
Sprite
 Inheritedheight : Number
获取或设置组件的高度,以像素为单位。
UIComponent
  hexValue : String
[read-only] 获取当前选定颜色的字符串值。
ColorPicker
 InheritedhitArea : Sprite
指定一个 sprite 用作另一个 sprite 的点击区域。
Sprite
  imeMode : String
获取或设置输入法编辑器 (IME) 的模式。
ColorPicker
 InheritedloaderInfo : LoaderInfo
[read-only] 返回一个 LoaderInfo 对象,其中包含加载此显示对象所属的文件的相关信息。
DisplayObject
 Inheritedmask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。
DisplayObject
 InheritedmouseChildren : Boolean
确定对象的子项是否支持鼠标。
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
指定此对象是否接收鼠标消息。
InteractiveObject
 InheritedmouseFocusEnabled : Boolean
获取或设置一个值,该值指示组件是否可以在用户单击它后获得焦点。
UIComponent
 InheritedmouseX : Number
[read-only] 指示鼠标位置的 x 坐标,以像素为单位。
DisplayObject
 InheritedmouseY : Number
[read-only] 指示鼠标位置的 y 坐标,以像素为单位。
DisplayObject
 Inheritedname : String
指示 DisplayObject 的实例名称。
DisplayObject
 InheritednumChildren : int
[read-only] 返回此对象的子项数目。
DisplayObjectContainer
 InheritedopaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。
DisplayObject
 Inheritedparent : DisplayObjectContainer
[read-only] 指示包含此显示对象的 DisplayObjectContainer 对象。
DisplayObject
 Inheritedprototype : Object
[static] 对类或函数对象的原型对象的引用。
Object
 Inheritedroot : DisplayObject
[read-only] 对于加载的 SWF 文件中的显示对象,root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。
DisplayObject
 Inheritedrotation : Number
指示 DisplayObject 实例距其原始方向的旋转程度,以度为单位。
DisplayObject
 Inheritedscale9Grid : Rectangle
当前有效的缩放网格。
DisplayObject
 InheritedscaleX : Number
将组件的当前宽度与缩放系数相乘。
UIComponent
 InheritedscaleY : Number
将组件的当前高度与缩放系数相乘。
UIComponent
 InheritedscrollRect : Rectangle
显示对象的滚动矩形范围。
DisplayObject
  selectedColor : uint
获取或设置在 ColorPicker 组件的调色板中当前加亮显示的样本。
ColorPicker
  showTextField : Boolean
获取或设置一个布尔值,指示是否显示 ColorPicker 组件的内部文本字段。
ColorPicker
 InheritedsoundTransform : SoundTransform
控制此 sprite 中的声音。
Sprite
 Inheritedstage : Stage
[read-only] 显示对象的舞台。
DisplayObject
 InheritedtabChildren : Boolean
确定对象的子项是否支持 Tab 键。
DisplayObjectContainer
 InheritedtabEnabled : Boolean
指定此对象是否遵循 Tab 键顺序。
InteractiveObject
 InheritedtabIndex : int
指定 SWF 文件中的对象按 Tab 键顺序排列。
InteractiveObject
  textField : TextField
对 ColorPicker 组件的内部文本字段的引用。
ColorPicker
 InheritedtextSnapshot : TextSnapshot
[read-only] 返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。
DisplayObjectContainer
 Inheritedtransform : Transform
一个对象,具有与显示对象的矩阵、颜色转换和像素范围有关的属性。
DisplayObject
 InheriteduseHandCursor : Boolean
布尔值,指示当鼠标滑过其 buttonMode 属性设置为 true 的 sprite 时是否显示手指形(手形光标)。
Sprite
 Inheritedversion : String = "3.0.0.13"
组件的版本号。
UIComponent
 Inheritedvisible : Boolean
获取或设置一个值,该值指示当前组件实例是否可见。
UIComponent
 Inheritedwidth : Number
获取或设置组件的宽度(以像素为单位)。
UIComponent
 Inheritedx : Number
获取或设置 x 坐标,该坐标表示组件在其父容器内沿 x 轴的位置。
UIComponent
 Inheritedy : Number
获取或设置 y 坐标,该坐标表示组件在其父容器内沿 y 轴的位置。
UIComponent
公共 方法
 方法定义方
  
创建 ColorPicker 类的实例。
ColorPicker
 Inherited
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。
DisplayObjectContainer
 Inherited
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
指示安全限制是否会导致出现以下情况:在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。
DisplayObjectContainer
 Inherited
删除此组件实例中的样式属性。
UIComponent
  
隐藏调色板。
ColorPicker
 Inherited
确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。
DisplayObjectContainer
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
在此组件上显示或隐藏焦点指示符。
UIComponent
 Inherited
启动立即绘制操作,但不像 invalidateNow 那样使全部设置失效。
UIComponent
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。
DisplayObject
 Inherited
返回位于指定索引处的子显示对象实例。
DisplayObjectContainer
 Inherited
返回具有指定名称的子显示对象。
DisplayObjectContainer
 Inherited
返回 DisplayObject 的 child 实例的索引位置。
DisplayObjectContainer
 Inherited
检索当前具有焦点的对象。
UIComponent
 Inherited
返回对象的数组,这些对象位于指定点下,并且是该 DisplayObjectContainer 实例的子项(或孙子项,依此类推)。
DisplayObjectContainer
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。
DisplayObject
 Inherited
检索组件的样式查找链中设置的样式属性。
UIComponent
  
[static] 检索当前组件的默认样式映射。
ColorPicker
 Inherited
将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。
DisplayObject
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
计算显示对象,以确定它是否与 obj 显示对象重叠或相交。
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。
DisplayObject
 Inherited
invalidate(property:String, callLater:Boolean = true):void
在未另外指定的情况下,将属性标记为无效,并在下一帧上重绘组件。
UIComponent
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。
DisplayObject
 Inherited
[static] 将多个类的样式合并到一个对象中。
UIComponent
 Inherited
将组件移动到其父项内的指定位置。
UIComponent
  
显示调色板。
ColorPicker
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。
DisplayObjectContainer
 Inherited
从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
更改现有子项在显示对象容器中的位置。
DisplayObjectContainer
 Inherited
设置此组件的焦点。
UIComponent
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
setSize(width:Number, height:Number):void
将组件设置为指定宽度和高度。
UIComponent
 Inherited
setStyle(style:String, value:Object):void
对此组件实例设置样式属性。
UIComponent
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
允许用户拖动指定的 Sprite。
Sprite
 Inherited
结束 startDrag() 方法。
Sprite
 Inherited
交换两个指定子对象的 Z 轴顺序(从前到后顺序)。
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
在子级列表中两个指定的索引位置,交换子对象的 Z 轴顺序(前后顺序)。
DisplayObjectContainer
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
验证并更新此对象的属性和布局,如果需要的话重绘对象。
UIComponent
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
事件
 事件摘要定义方
 Inherited Flash Player 获得操作系统焦点并变为活动状态时调度。EventDispatcher
 Inherited 将显示对象添加到显示列表中时调度。DisplayObject
 Inherited 在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。DisplayObject
   当用户单击调色板中的颜色时调度。ColorPicker
 Inherited 用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。InteractiveObject
   当用户关闭调色板时调度。ColorPicker
 Inherited Flash Player 失去操作系统焦点并变为非活动状态时调度。EventDispatcher
 Inherited 如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true,当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。InteractiveObject
   当用户在编辑完 ColorPicker 组件的内部文本字段后按下 Enter 时调度。ColorPicker
 Inherited 播放头进入新帧时调度。DisplayObject
 Inherited 显示对象获得焦点后调度。InteractiveObject
 Inherited 显示对象失去焦点后调度。InteractiveObject
 Inherited 在组件可见性从可见改为不可见以后调度。UIComponent
   当用户将鼠标滑离调色板中的样本时调度。ColorPicker
   当用户将鼠标滑过调色板中的样本时调度。ColorPicker
 Inherited 用户按下某个键时调度。InteractiveObject
 Inherited 用户尝试使用键盘导航更改焦点时调度。InteractiveObject
 Inherited 用户释放某个键时调度。InteractiveObject
 Inherited 在 Flash Player 窗口中,用户在 InteractiveObject 实例上按下指针设备按钮时调度。InteractiveObject
 Inherited 用户尝试使用指针设备更改焦点时调度。InteractiveObject
 Inherited 用户移动 InteractiveObject 上的指针设备时调度。InteractiveObject
 Inherited 用户将指针设备从 InteractiveObject 实例上移开时调度。InteractiveObject
 Inherited 在 Flash Player 窗口中,用户将指针设备移动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited 在 Flash Player 窗口中,用户在 InteractiveObject 实例上释放指针设备按钮时调度。InteractiveObject
 Inherited 在 Flash Player 窗口中,鼠标滚轮滚动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited 在移动组件以后调度。UIComponent
   当用户打开调色板时调度。ColorPicker
 Inherited 将要从显示列表中删除显示对象时调度。DisplayObject
 Inherited 在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。DisplayObject
 Inherited 将要更新和呈现显示列表时调度。DisplayObject
 Inherited 在调整组件大小以后调度。UIComponent
 Inherited 用户将指针设备从 InteractiveObject 实例上移开时调度。InteractiveObject
 Inherited 用户将指针设备移动到 InteractiveObject 实例上时调度。InteractiveObject
 Inherited 在组件可见性从不可见改为可见以后调度。UIComponent
 Inherited 对象的 tabChildren 标志值发生更改时调度。InteractiveObject
 Inherited 对象的 tabEnabled 标志发生更改时调度。InteractiveObject
 Inherited 对象的 tabIndex 属性值发生更改时调度。InteractiveObject
样式
 样式说明定义方
  
background
类型: Class
提供 ColorPicker 组件中显示的调色板的背景的类。 默认值为 ColorPicker_backgroundSkin.
ColorPicker
  
backgroundPadding
类型: Number   格式: Length
显示在颜色样本组周围的填充(以像素为单位)。 默认值为 5.
ColorPicker
  
colorWell
类型: Class
提供当颜色池填充了一种颜色时颜色池外观的类。 默认值为 ColorPicker_colorWell.
ColorPicker
  
columnCount
类型: Number   格式: Length
要在 ColorPicker 调色板中绘制的列数。 默认值为 18.
ColorPicker
  
disabledSkin
类型: Class
提供 ColorPicker 中被禁用按钮的外观的类。 默认值为 ColorPicker_disabledSkin.
ColorPicker
 Inherited 类型: flash.text.TextFormat
用于在禁用了按钮的情况下呈现组件标签的 TextFormat 对象。 默认值为 TextFormat("_sans", 11, 0x999999, false, false, false, '', '', TextFormatAlign.LEFT, 0, 0, 0, 0).
UIComponent
  
downSkin
类型: Class
提供当 ColorPicker 按钮处于按下位置时的外观的类。 默认值为 ColorPicker_downSkin.
ColorPicker
  
embedFonts
类型: Boolean
指示是否使用嵌入字体轮廓呈现文本字段。 如果该值为 true,则 Flash Player 使用嵌入字体轮廓呈现文本字段。 如果该值为 false,则 Flash Player 使用设备字体呈现文本字段。

如果将文本字段的 embedFonts 属性设置为 true,则必须使用应用于该文本字段的 TextFormat 对象的 font 属性来指定该文本的字体。 如果指定的字体没有嵌入 SWF 文件中,则不会显示该文本。

. 默认值为 false.
ColorPicker
 Inherited 类型: Number   格式: Length
用于分隔组件的外边框和焦点指示符的外边框的填充(以像素为单位)。 默认值为 2.
UIComponent
 Inherited 类型: Class
用于显示焦点指示符的外观。 默认值为 focusRectSkin.
UIComponent
  
overSkin
类型: Class
提供当指针设备悬停于颜色池上方时颜色池的外观的类。 默认值为 ColorPicker_overSkin.
ColorPicker
  
swatchHeight
类型: Number   格式: Length
每个样本的高度(以像素为单位)。 默认值为 10.
ColorPicker
  
swatchPadding
类型: Number   格式: Length
定义显示在调色板中每个样本周围的填充(以像素为单位)。 默认值为 1.
ColorPicker
  
swatchSelectedSkin
类型: Class
提供用于加亮显示当前所选颜色的外观的类。 默认值为 ColorPicker_swatchSelectedSkin.
ColorPicker
  
swatchSkin
类型: Class
提供用于绘制 ColorPicker 组件中包含的样本的外观的类。 默认值为 ColorPicker_swatchSkin.
ColorPicker
  
swatchWidth
类型: Number   格式: Length
每个样本的宽度(以像素为单位)。 默认值为 10.
ColorPicker
  
textFieldSkin
类型: Class
提供 ColorPicker 组件的文本字段背景的类。 默认值为 ColorPicker_textFieldSkin.
ColorPicker
 Inherited 类型: flash.text.TextFormat
用于呈现组件标签的 TextFormat 对象。 默认值为 TextFormat("_sans", 11, 0x000000, false, false, false, '', '', TextFormatAlign.LEFT, 0, 0, 0, 0).
UIComponent
  
textPadding
类型: Number   格式: Length
显示在颜色 TextField 周围的填充(以像素为单位)。 默认值为 3.
ColorPicker
  
upSkin
类型: Class
提供当 ColorPicker 按钮处于弹起位置时的外观的类。 默认值为 ColorPicker_upSkin.
ColorPicker
属性详细信息
colors属性
colors:Array  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置 ColorPicker 组件提供的自定义颜色的数组。 ColorPicker 组件绘制和显示此数组中描述的颜色。

注意:ColorPicker 组件最多可显示 1024 种颜色。

默认情况下,此数组包含 216 种自动生成的颜色。


实现
    public function get colors():Array
    public function set colors(value:Array):void

示例
如何使用示例

下例创建一个限定为绿色的颜色选择器:
import fl.controls.ColorPicker;

var cp:ColorPicker = new ColorPicker();
cp.colors = [ 0x001100, 
              0x003300, 
              0x005500, 
              0x007700, 
              0x009900, 
              0x00BB00, 
              0x00DD00, 
              0x00FF00 ];
addChild(cp);
editable属性 
editable:Boolean  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置一个布尔值,指示 ColorPicker 组件的内部文本字段能否进行编辑。 true 值指示内部文本字段可以进行编辑;false 值指示内部文本字段不能进行编辑。

默认值为 true.


实现
    public function get editable():Boolean
    public function set editable(value:Boolean):void
enabled属性 
enabled:Boolean  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置一个值,该值指示组件是否可以接受用户交互。 true 值指示组件可以接受用户交互;false 值指示组件无法接受用户交互。

如果将 enabled 属性设置为 false,则容器的颜色将变暗,并且禁止用户输入(Label 和 ProgressBar 组件除外)。

默认值为 true.


实现
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
hexValue属性 
hexValue:String  [read-only]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取当前选定颜色的字符串值。


实现
    public function get hexValue():String

示例
如何使用示例

下例在颜色更改时显示所选颜色的十六进制值:

import fl.controls.ColorPicker;
import fl.events.ColorPickerEvent;

var myColorPicker:ColorPicker = new ColorPicker();
myColorPicker.addEventListener(ColorPickerEvent.CHANGE, changeHandler);
myColorPicker.move(10, 10);
addChild(myColorPicker);

function changeHandler(event:ColorPickerEvent):void {
    trace("color changed:", event.color, "(#" + event.target.hexValue + ")");
}
imeMode属性 
imeMode:String  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置输入法编辑器 (IME) 的模式。 IME 使用户能够使用 QWERTY 键盘从中文、日文和韩文字符集输入字符。

Flash 在组件获得焦点时将 IME 设置为指定模式,并在组件失去焦点后还原为初始值。

flash.system.IMEConversionMode 类定义此属性的有效值的常量。 将此属性设置为 null 阻止对组件使用 IME。


实现
    public function get imeMode():String
    public function set imeMode(value:String):void

另请参见

selectedColor属性 
selectedColor:uint  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置在 ColorPicker 组件的调色板中当前加亮显示的样本。

默认值为 0x000000.


实现
    public function get selectedColor():uint
    public function set selectedColor(value:uint):void

示例
如何使用示例

下例创建一个 ColorPicker 组件实例,该实例在所选颜色发生更改时显示其 selectedColorhexValue 属性:

import fl.controls.ColorPicker;
import fl.events.ColorPickerEvent;

var myColorPicker:ColorPicker = new ColorPicker();
myColorPicker.addEventListener(ColorPickerEvent.CHANGE, changeHandler);
myColorPicker.setSize(60, 60);
myColorPicker.move(10, 10);
addChild(myColorPicker);

function changeHandler(event:ColorPickerEvent):void {
    var myCP:ColorPicker = event.currentTarget as ColorPicker;
    trace("{ColorPickerEvent}.color:", event.color);
    trace("{ColorPicker}.selectedColor:", myCP.selectedColor);
    trace("{ColorPicker}.hexValue:", myCP.hexValue);
}
showTextField属性 
showTextField:Boolean  [read-write]

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

获取或设置一个布尔值,指示是否显示 ColorPicker 组件的内部文本字段。 true 值指示显示内部文本字段;false 值指示不显示内部文本字段。

默认值为 true.


实现
    public function get showTextField():Boolean
    public function set showTextField(value:Boolean):void

另请参见


示例
如何使用示例

下例使用 CheckBox 组件切换 ColorPicker 组件的 showTextField 属性值:

import fl.controls.CheckBox;
import fl.controls.ColorPicker;

var myCheckBox:CheckBox = new CheckBox();
myCheckBox.textField.autoSize = TextFieldAutoSize.LEFT;
myCheckBox.label = "showTextField:";
myCheckBox.move(10, 10);
myCheckBox.selected = true;
myCheckBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myCheckBox);

var myColorPicker:ColorPicker = new ColorPicker();
myColorPicker.showTextField = myCheckBox.selected;
myColorPicker.move(myCheckBox.x, myCheckBox.y + myCheckBox.height);
myColorPicker.open();
addChild(myColorPicker);

function changeHandler(event:Event):void {
    myColorPicker.showTextField = myCheckBox.selected;
    try {
    myColorPicker.open();
    } catch (error:*) {
        trace("Caught");
    }
}
textField属性 
public var textField:TextField

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

对 ColorPicker 组件的内部文本字段的引用。

另请参见

构造函数详细信息
ColorPicker()构造函数
public function ColorPicker()

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

创建 ColorPicker 类的实例。

方法详细信息
close()方法
public function close():void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

隐藏调色板。 调用此方法将导致 close 事件被调度。 如果调色板已经关闭或被禁用,则此方法无效。

另请参见

getStyleDefinition()方法 
public static function getStyleDefinition():Object

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

检索当前组件的默认样式映射。 样式映射包含适合组件的类型,具体取决于组件使用的样式。 例如,disabledTextFormat 样式包含 null 值或 TextFormat 对象。 可以使用这些样式并对当前组件调用 setStyle()。 下面的代码覆盖指定组件上默认的 disabledTextFormat 样式:
componentInstance.setStyle("disabledTextFormat", new TextFormat());

返回
Object — 默认样式对象。

另请参见


示例
如何使用示例

下例为多个组件类创建一个样式浏览器:
import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}
open()方法 
public function open():void

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

显示调色板。 调用此方法将导致 open 事件被调度。 如果调色板已经打开或被禁用,则此方法无效。

另请参见


示例
如何使用示例

下例创建一个 ColorPicker 组件实例,并在用户将鼠标滑过该实例时调用 open() 方法:

import fl.controls.ColorPicker;

var myColorPicker:ColorPicker = new ColorPicker();
myColorPicker.editable = false;
myColorPicker.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler);
myColorPicker.move(10, 10);
addChild(myColorPicker);

function rollOverHandler(event:MouseEvent):void {
    event.currentTarget.open();
}
事件详细信息
change 事件
事件对象类型: fl.events.ColorPickerEvent
ColorPickerEvent.type property = fl.events.ColorPickerEvent.CHANGE

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

当用户单击调色板中的颜色时调度。

定义 change 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblestrue
cancelabletrue
colorColorPicker 组件的当前颜色值。
currentTarget当前正在使用某个事件侦听器处理事件对象的对象。
target调度了事件的对象。target 不一定是侦听该事件的对象。使用 currentTarget 属性可以访问侦听该事件的对象。

示例
如何使用示例

下例在颜色更改时显示所选颜色的十六进制值:

import fl.controls.ColorPicker;
import fl.events.ColorPickerEvent;

var myColorPicker:ColorPicker = new ColorPicker();
myColorPicker.addEventListener(ColorPickerEvent.CHANGE, changeHandler);
myColorPicker.move(10, 10);
addChild(myColorPicker);

function changeHandler(event:ColorPickerEvent):void {
    trace("color changed:", event.color, "(#" + event.target.hexValue + ")");
}
close 事件  
事件对象类型: flash.events.Event
Event.type property = flash.events.Event.CLOSE

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

当用户关闭调色板时调度。

定义 close 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target已关闭其连接的对象。

另请参见

enter 事件  
事件对象类型: fl.events.ColorPickerEvent
ColorPickerEvent.type property = fl.events.ColorPickerEvent.ENTER

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

当用户在编辑完 ColorPicker 组件的内部文本字段后按下 Enter 时调度。

定义 enter 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblestrue
cancelabletrue
colorColorPicker 组件的当前颜色值。
currentTarget当前正在使用某个事件侦听器处理事件对象的对象。
target调度了事件的对象。target 不一定是侦听该事件的对象。使用 currentTarget 属性可以访问侦听该事件的对象。

示例
如何使用示例

下例创建一个可编辑 ComboBox 组件实例,该实例在用户在内部文本字段中按下 Enter 键时跟踪 selectedColorhexValue 属性:

import fl.controls.ColorPicker;
import fl.events.ColorPickerEvent;

var myColorPicker:ColorPicker = new ColorPicker();
myColorPicker.move(10, 10);
myColorPicker.addEventListener(ColorPickerEvent.ENTER, enterHandler);
addChild(myColorPicker);

function enterHandler(event:ColorPickerEvent):void {
    trace("color: " + event.color);
    trace("selectedColor: " + myColorPicker.selectedColor);
    trace("hexValue: " + myColorPicker.hexValue);
    trace("");
}

另请参见

itemRollOut 事件  
事件对象类型: fl.events.ColorPickerEvent
ColorPickerEvent.type property = fl.events.ColorPickerEvent.ITEM_ROLL_OUT

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

当用户将鼠标滑离调色板中的样本时调度。

定义 itemRollOut 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblestrue
cancelabletrue
colorColorPicker 组件的当前颜色值。
currentTarget当前正在使用某个事件侦听器处理事件对象的对象。
target调度了事件的对象。target 不一定是侦听该事件的对象。使用 currentTarget 属性可以访问侦听该事件的对象。

另请参见

itemRollOver 事件  
事件对象类型: fl.events.ColorPickerEvent
ColorPickerEvent.type property = fl.events.ColorPickerEvent.ITEM_ROLL_OVER

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

当用户将鼠标滑过调色板中的样本时调度。

定义 itemRollOver 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblestrue
cancelabletrue
colorColorPicker 组件的当前颜色值。
currentTarget当前正在使用某个事件侦听器处理事件对象的对象。
target调度了事件的对象。target 不一定是侦听该事件的对象。使用 currentTarget 属性可以访问侦听该事件的对象。

另请参见

open 事件  
事件对象类型: flash.events.Event
Event.type property = flash.events.Event.OPEN

语言版本 : ActionScript 3.0
Player 版本 : Flash Player 9.0.28.0

当用户打开调色板时调度。

定义 open 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubblesfalse
cancelablefalse;没有要取消的默认行为。
currentTarget当前正在使用某个事件侦听器处理 Event 对象的对象。
target已打开连接的网络对象。

示例
如何使用示例

下例创建一个 ColorPicker 组件实例,并在用户将鼠标滑过该实例时调用 open() 方法:

import fl.controls.ColorPicker;

var myColorPicker:ColorPicker = new ColorPicker();
myColorPicker.editable = false;
myColorPicker.addEventListener(MouseEvent.ROLL_OVER, rollOverHandler);
myColorPicker.move(10, 10);
addChild(myColorPicker);

function rollOverHandler(event:MouseEvent):void {
    event.currentTarget.open();
}

另请参见

示例 如何使用示例

此示例演示如何通过从 ColorPicker 实例侦听事件来更改 Shape 实例的颜色。

若要运行该示例,请按照下列步骤操作:

  1. 将三个 ColorPicker 实例和一个 ComboBox 实例拖到舞台上。
  2. 将 ColorPicker 实例命名为 cp1cp2cp3
  3. 将 ComboBox 命名为 cb
  4. 将该代码作为 ColorPickerExample.as 另存到 FLA 文件所在的同一目录中。
  5. 将 FLA 文件中的 Document 类设置为 ColorPickerExample。
package 
{
    import fl.controls.ColorPicker;
    import fl.controls.ComboBox;
    import flash.display.BlendMode;
    import flash.display.Shape;
    import flash.display.Sprite;
    import flash.events.*;
    
    public class ColorPickerExample extends Sprite
    {
        var circle1:Shape;
        var circle2:Shape;
        var circle3:Shape;
        
        public function ColorPickerExample():void {
            setupCircles();
            setupComboBox();
            
            cp1.addEventListener(Event.RENDER, colorChange);
            cp2.addEventListener(Event.RENDER, colorChange);
            cp3.addEventListener(Event.RENDER, colorChange);
        }
        private function colorChange(e:Event):void {
            var cp:ColorPicker = e.target as ColorPicker
            switch (cp) {
                case cp1:
                    colorCircle(circle1, cp.selectedColor);
                    break;
                case cp2:
                    colorCircle(circle2, cp.selectedColor);
                    break;
                case cp3:
                    colorCircle(circle3, cp.selectedColor);
                    break;
                default:
                    break;
            }
        }
        private function setupComboBox():void {
            cb.setSize(150,24);
            cb.addItem( { label: "Select BlendMode:",     data:BlendMode.NORMAL } );
            cb.addItem( { label: "DARKEN",                 data:BlendMode.DARKEN } );
            cb.addItem( { label: "DIFFERENCE",             data:BlendMode.DIFFERENCE } );
            cb.addItem( { label: "HARDLIGHT",             data:BlendMode.HARDLIGHT } );
            cb.addItem( { label: "INVERT",                 data:BlendMode.INVERT } );
            cb.addItem( { label: "LAYER",                 data:BlendMode.LAYER } );
            cb.addItem( { label: "MULTIPLY",             data:BlendMode.MULTIPLY } );
            cb.addItem( { label: "SUBTRACT",             data:BlendMode.SUBTRACT } );
            cb.addEventListener(Event.CHANGE,blendChange);
        }
        private function blendChange(e:Event):void {
            var newBlend:String = cb.selectedItem.data;
            if (newBlend) {
                circle1.blendMode = newBlend;
                circle2.blendMode = newBlend;
                circle3.blendMode = newBlend;
            }
        }
        private function setupCircles():void {
            circle1 = new Shape();
            circle2 = new Shape();
            circle3 = new Shape();
            
            circle1.x = 127;
            circle1.y = 64;
            circle2.x = 87;
            circle2.y = 130;
            circle3.x = 164;
            circle3.y = 130;
            
            colorCircle(circle1, 0xFF0000);
            colorCircle(circle2, 0xFF0000);
            colorCircle(circle3, 0xFF0000);
            
            addChild(circle1);
            addChild(circle2);
            addChild(circle3);
        }
        private function colorCircle(circle:Shape, newColor:uint):void {
            circle.graphics.clear();
            circle.graphics.beginFill(newColor, 1);
            circle.graphics.drawCircle(0, 0, 50);
            circle.graphics.endFill();    
        }
    }
}




 

评论添加到页面后给我发送电子邮件 | 评论报告

当前页: http://livedocs.adobe.com/flash/9.0_cn/ActionScriptLangRefV3/fl/controls/ColorPicker.html