IItemRenderer - Adobe ActionScript® 3 (AS3 Flex) API 参考

包	spark.components
接口	public interface IItemRenderer extends IDataRenderer , IVisualElement , ILayoutElement , ILayoutDirectionElement , IEventDispatcher
实现器	AttachmentIconRenderer, ButtonBarButton, DefaultItemRenderer, DefaultItemRenderer, GapDisplayer, ItemRenderer, LabelItemRenderer, ModuleItemRenderer, TableRowNameDisplayer, TargetAreaAssignmentEditor, TargetAreaRenderer

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

IItemRenderer 接口定义基本 API 集，类必须实现这些 API 才能创建可以与主机组件通信的项呈示器。主机组件（如 List 或 ButtonBar 控件）必须实现 IItemRendererOwner 接口。

相关 API 元素

spark.components.IItemRendererOwner

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		alpha : Number 表示指定对象的 Alpha 透明度值。	IVisualElement
		baseline : Object 从锚点目标到控件的基线位置的垂直距离（以像素为单位）。	ILayoutElement
		baselinePosition : Number [只读] 组件第一行文本的基线的 y 坐标。	ILayoutElement
		bottom : Object 从组件的下边缘到锚点目标的下边缘的垂直距离（以像素为单位）。	ILayoutElement
		data : Object 要呈示或编辑的数据。	IDataRenderer
		depth : Number 确定容器内各项目的呈示顺序。	IVisualElement
		designLayer : DesignLayer 指定与该可视元素关联的可选 DesignLayer 实例。	IVisualElement
		dragging : Boolean 如果正在拖动项呈示器，则包含 true。	IItemRenderer
		hasLayoutMatrix3D : Boolean [只读] 如果元素具有 3D 矩阵，则为 true。	ILayoutElement
		height : Number 表示显示对象的高度，以像素为单位。	IVisualElement
		horizontalCenter : Object 从组件中心到锚点目标的内容区域中心的水平距离（以像素为单位）。	ILayoutElement
		includeInLayout : Boolean 指定此组件是否包含在父容器的布局中。	ILayoutElement
		is3D : Boolean [只读] 当元素为 3D 时，则为 true。	IVisualElement
		itemIndex : int 项呈示器的主机组件的数据提供程序中的项目索引。	IItemRenderer
		label : String 要在项呈示器中显示的 String。	IItemRenderer
		layoutDirection : String 指定元素的所需布局方向：LayoutDirection.LTR（从左到右）、LayoutDirection.RTL（从右到左）或 null（继承）。	ILayoutDirectionElement
		left : Object 从组件的左边缘到锚点目标的左边缘的水平距离（以像素为单位）。	ILayoutElement
		owner : DisplayObjectContainer 此 IVisualElement 对象的所有者。	IVisualElement
		parent : DisplayObjectContainer [只读] 此组件的父容器或组件。	IVisualElement
		percentHeight : Number 以组件父代大小百分比的方式指定组件高度。	ILayoutElement
		percentWidth : Number 以组件父代大小百分比的方式指定组件宽度。	ILayoutElement
		postLayoutTransformOffsets : mx.geom:TransformOffsets 定义能够应用于对象转换且在一定程度上对其父布局不可视的一组调整。	IVisualElement
		right : Object 从组件的右边缘到锚点目标的右边缘的水平距离（以像素为单位）。	ILayoutElement
		selected : Boolean 如果项呈示器可以将其自身显示为已选中，则包含 true。	IItemRenderer
		showsCaret : Boolean 如果项呈示器可以将其自身显示为已获取焦点，则包含 true。	IItemRenderer
		top : Object 从组件的上边缘到锚点目标的上边缘的垂直距离（以像素为单位）。	ILayoutElement
		verticalCenter : Object 从组件中心到锚点目标的内容区域中心的垂直距离（以像素为单位）。	ILayoutElement
		visible : Boolean 控制此可视元素的可见性。	IVisualElement
		width : Number 表示显示对象的宽度，以像素为单位。	IVisualElement
		x : Number 表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 x 坐标。	IVisualElement
		y : Number 表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 y 坐标。	IVisualElement

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	IEventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	IEventDispatcher
		getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number 按指定的元素大小，返回元素边界的 x 坐标。	ILayoutElement
		getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number 按指定的元素大小，返回元素边界的 y 坐标。	ILayoutElement
		getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的布局高度。	ILayoutElement
		getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的布局宽度。	ILayoutElement
		getLayoutBoundsX(postLayoutTransform:Boolean = true):Number 返回元素在屏幕上进行绘制时所用的 x 坐标。	ILayoutElement
		getLayoutBoundsY(postLayoutTransform:Boolean = true):Number 返回元素在屏幕上进行绘制时所用的 y 坐标。	ILayoutElement
		getLayoutMatrix():Matrix 返回用于相对于其同级组件计算组件的布局的转换矩阵。	ILayoutElement
		getLayoutMatrix3D():Matrix3D 返回此元素的布局转换 Matrix3D。	ILayoutElement
		getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的最大高度。	ILayoutElement
		getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的最大宽度。	ILayoutElement
		getMinBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的最小高度。	ILayoutElement
		getMinBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的最小宽度。	ILayoutElement
		getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的首选高度。	ILayoutElement
		getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的首选宽度。	ILayoutElement
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	IEventDispatcher
		invalidateLayoutDirection():void 当某元素的 layoutDirection 更改或其父代的 layoutDirection 更改时，该元素必须调用该方法。	ILayoutDirectionElement
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	IEventDispatcher
		setLayoutBoundsPosition(x:Number, y:Number, postLayoutTransform:Boolean = true):void 设置元素在屏幕上进行绘制时所用的坐标。	ILayoutElement
		setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void 设置元素的布局大小。	ILayoutElement
		setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void 设置用于相对于其同级组件计算组件的布局大小和位置的转换 Matrix。	ILayoutElement
		setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void 设置用于计算组件相对于其同级组件的布局大小和位置的转换 Matrix3D。	ILayoutElement
		transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void 用于更新转换的旋转、缩放和平移的一种实用程序方法，同时保留某个特定点，该点是在组件自己的坐标空间中指定的，且在父项的坐标空间中是固定的。	ILayoutElement
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	IEventDispatcher

属性详细信息

dragging

属性

dragging:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

如果正在拖动项呈示器，则包含 true。

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

itemIndex

属性

itemIndex:int

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

项呈示器的主机组件的数据提供程序中的项目索引。

实现
public function get itemIndex():int
public function set itemIndex(value:int):void

label

属性

label:String

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

要在项呈示器中显示的 String。

项呈示器的主机组件可以使用 itemToLabel() 方法将数据项目转换为 String 以便项呈示器可以将其显示。

对于诸如 List 和 ButtonBar 等控件，可以使用 labelField 或 labelFunction 属性指定包含 String 的数据项目的字段。否则，主机组件使用 toString() 方法将数据项目转换为 String。

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

selected

属性

selected:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

如果项呈示器可以将其自身显示为已选中，则包含 true。

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

showsCaret

属性

showsCaret:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

如果项呈示器可以将其自身显示为已获取焦点，则包含 true。

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

法律声明 | 在线隐私策略

IItemRenderer - AS3 Flex

类 x

dragging

itemIndex

label

selected

showsCaret