ListBase

套件	mx.controls.listClasses
類別	public class ListBase
繼承	ListBase ScrollControlBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object
實作	IDataRenderer, IFocusManagerComponent, IListItemRenderer, IDropInListItemRenderer, IEffectTargetHost
子類別	DataGridBase, List, TileBase

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The ListBase class is the base class for controls that represent lists of items that can have one or more selected and can scroll through the items. Items are supplied using the dataProvider property and displayed via item renderers.

In a model/view architecture, the ListBase-derived class represents the view, and the dataProvider object represents the model.

MXML 語法

隱藏 MXML 語法

The ListBase class inherits all of the tag properties of its superclasses, and adds the following tag properties:

  <mx:tagname
    Properties
    allowDragSelection="false|true"
    allowMultipleSelection="false|true"
    columnCount="4"
    columnWidth="NaN"
    dataProvider="null"
    dataTipField="label"
    dataTipFunction="null"
    dragEnabled="false|true"
    dragMoveEnabled="false|true"
    dropEnabled="false|true"
    iconField="null"
    iconFunction="null"
    itemRenderer="null"
    labelField="label"
    labelFunction="null"
    menuSelectionMode="false|true"
    offscreenExtraRowsOrColumns="0"
    rowCount="-1"
    rowHeight="NaN"
    selectable="true|false"
    selectedIndex="-1"
    selectedIndices="null"
    selectedItem="null"
    selectedItems="null"
    showDataTips="false|true"
    variableRowHeight="false|true"
    wordWrap="false|true"
 
    Styles
    alternatingItemColors="undefined"
    itemsChangeEffect="undefined"
    dropIndicatorSkin="ListDropIndicator"
    focusAlpha="0.5"
    focusRoundedCorners="tl tr bl br"
    paddingBottom="2"
    paddingLeft="2"
    paddingRight="0"
    paddingTop="2"
    rollOverColor="0xEEFEE6"
    selectionColor="0x7FCEFF"
    selectionDisabledColor="0xDDDDDD"
    selectionDuration="250"
    selectionEasingFunction="undefined"
    textRollOverColor="0x2B333C"
    textSelectedColor="0x2B333C"
    useRollOver="true|false"
    verticalAlign="top|middle|bottom"
 
    Events
    change="No default"
    dataChange="No default"
    itemClick="No default"
    itemDoubleClick="No default"
    itemRollOut="No default"
    itemRollOver="No default"
   />

相關 API 元素

mx.collections.ICollectionView

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		accessibilityDescription : String A convenience accessor for the description property in this UIComponent's accessibilityProperties object.	UIComponent
		accessibilityEnabled : Boolean A convenience accessor for the silent property in this UIComponent's accessibilityProperties object.	UIComponent
		accessibilityImplementation : AccessibilityImplementation 對此 InteractiveObject 實體目前的輔助功能實作 (AccessibilityImplementation)。	InteractiveObject
		accessibilityName : String A convenience accessor for the name property in this UIComponent's accessibilityProperties object.	UIComponent
		accessibilityProperties : AccessibilityProperties 此顯示物件的目前輔助功能選項。	DisplayObject
		accessibilityShortcut : String A convenience accessor for the shortcut property in this UIComponent's accessibilityProperties object.	UIComponent
		activeEffects : Array [唯讀] The list of effects that are currently playing on the component, as an Array of EffectInstance instances.	UIComponent
		allowDragSelection : Boolean = false A flag that indicates whether drag-selection is enabled.	ListBase
		allowMultipleSelection : Boolean A flag that indicates whether you can allow more than one item to be selected at the same time.	ListBase
		alpha : Number 指出所指定物件的 Alpha 透明度值。	DisplayObject
		automationDelegate : Object The delegate object that handles the automation-related functionality.	UIComponent
		automationEnabled : Boolean [唯讀] True if this component is enabled for automation, false otherwise.	UIComponent
		automationName : String Name that can be used as an identifier for this object.	UIComponent
		automationOwner : DisplayObjectContainer [唯讀] The owner of this component for automation purposes.	UIComponent
		automationParent : DisplayObjectContainer [唯讀] The parent of this component for automation purposes.	UIComponent
		automationTabularData : Object [唯讀] An implementation of the IAutomationTabularData interface, which can be used to retrieve the data.	UIComponent
		automationValue : Array [唯讀] This value generally corresponds to the rendered appearance of the object and should be usable for correlating the identifier with the object as it appears visually within the application.	UIComponent
		automationVisible : Boolean [唯讀] True if this component is visible for automation, false otherwise.	UIComponent
		baseline : Object For components, this layout constraint property is a facade on top of the similarly-named style.	UIComponent
		baselinePosition : Number [唯讀] The y-coordinate of the baseline of the first line of text of the component.	UIComponent
		blendMode : String 來自 BlendMode 類別的值，會指定要使用何種混合模式。	DisplayObject
		blendShader : Shader [唯寫] 設定用來混合前景和背景的著色器。	DisplayObject
		borderMetrics : EdgeMetrics [唯讀] Returns an EdgeMetrics object that has four properties: left, top, right, and bottom.	ScrollControlBase
		bottom : Object For components, this layout constraint property is a facade on top of the similarly-named style.	UIComponent
		buttonMode : Boolean 可指定此 sprite 的按鈕模式。	Sprite
		cacheAsBitmap : Boolean 如果設定為 true，Flash 執行階段會快取顯示物件的內部點陣圖表示法。	DisplayObject
		cacheAsBitmapMatrix : Matrix 如果為非 null，當 cacheAsBitmap 設定為 true 時，這個 Matrix 物件會定義顯示物件的顯示方法。	DisplayObject
		cacheHeuristic : Boolean [唯寫] Used by Flex to suggest bitmap caching for the object.	UIComponent
		cachePolicy : String Specifies the bitmap caching policy for this object.	UIComponent
		className : String [唯讀] The name of this instance's class, such as "Button".	UIComponent
		columnCount : int The number of columns to be displayed in a TileList control or items in a HorizontalList control.	ListBase
		columnWidth : Number The width of the control's columns.	ListBase
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object
		contentMouseX : Number [唯讀] Returns the x position of the mouse, in the content coordinate system.	UIComponent
		contentMouseY : Number [唯讀] Returns the y position of the mouse, in the content coordinate system.	UIComponent
		contextMenu : NativeMenu 指定與此物件有關聯的快顯選單。	InteractiveObject
		currentState : String The current view state of the component.	UIComponent
		cursorManager : ICursorManager [唯讀] Gets the CursorManager that controls the cursor for this component and its peers.	UIComponent
		data : Object The item in the data provider this component should render when this component is used as an item renderer or item editor.	ListBase
		dataProvider : Object Set of data to be viewed.	ListBase
		dataTipField : String Name of the field in the data provider items to display as the data tip.	ListBase
		dataTipFunction : Function User-supplied function to run on each item to determine its dataTip.	ListBase
		depth : Number Determines the order in which items inside of containers are rendered.	UIComponent
		descriptor : UIComponentDescriptor Reference to the UIComponentDescriptor, if any, that was used by the createComponentFromDescriptor() method to create this UIComponent instance.	UIComponent
		designLayer : DesignLayer Specifies the optional DesignLayer instance associated with this visual element.	UIComponent
		document : Object A reference to the document object associated with this UIComponent.	UIComponent
		doubleClickEnabled : Boolean [覆寫] Specifies whether the UIComponent object receives doubleClick events.	UIComponent
		dragEnabled : Boolean A flag that indicates whether you can drag items out of this control and drop them on other controls.	ListBase
		dragMoveEnabled : Boolean A flag that indicates whether items can be moved instead of just copied from the control as part of a drag-and-drop operation.	ListBase
		dropEnabled : Boolean A flag that indicates whether dragged items can be dropped onto the control.	ListBase
		dropTarget : DisplayObject [唯讀] 指定要將 sprite 拖曳至或丟棄至哪個顯示物件上。	Sprite
		enabled : Boolean Whether the component can accept user interaction.	UIComponent
		errorString : String The text that displayed by a component's error tip when a component is monitored by a Validator and validation fails.	UIComponent
		explicitHeight : Number Number that specifies the explicit height of the component, in pixels, in the component's coordinates.	UIComponent
		explicitMaxHeight : Number The maximum recommended height of the component to be considered by the parent during layout.	UIComponent
		explicitMaxWidth : Number The maximum recommended width of the component to be considered by the parent during layout.	UIComponent
		explicitMinHeight : Number The minimum recommended height of the component to be considered by the parent during layout.	UIComponent
		explicitMinWidth : Number The minimum recommended width of the component to be considered by the parent during layout.	UIComponent
		explicitWidth : Number Number that specifies the explicit width of the component, in pixels, in the component's coordinates.	UIComponent
		filters : Array 索引的陣列，其中包含目前和顯示物件相關的每個濾鏡物件。	DisplayObject
		flexContextMenu : IFlexContextMenu The context menu for this UIComponent.	UIComponent
		focusEnabled : Boolean Indicates whether the component can receive focus when tabbed to.	UIComponent
		focusManager : IFocusManager Gets the FocusManager that controls focus for this component and its peers.	UIComponent
		focusPane : Sprite The focus pane associated with this object.	UIComponent
		focusRect : Object 會指定這個物件是否會顯示焦點矩形。	InteractiveObject
		graphics : Graphics [唯讀] 指定屬於此 sprite 物件的 Graphics 物件，其中可能會產生向量繪圖命令。	Sprite
		hasFocusableChildren : Boolean A flag that indicates whether child objects can receive focus.	UIComponent
		hasLayoutMatrix3D : Boolean [唯讀] Contains true if the element has 3D Matrix.	UIComponent
		height : Number [覆寫] Number that specifies the height of the component, in pixels, in the parent's coordinates.	UIComponent
		hitArea : Sprite 指定用來當作 sprite 作用區域的另一個 sprite。	Sprite
		horizontalCenter : Object For components, this layout constraint property is a facade on top of the similarly-named style.	UIComponent
		horizontalScrollPolicy : String A property that indicates whether the horizontal scroll bar is always on, always off, or automatically changes based on the parameters passed to the setScrollBarProperties() method.	ScrollControlBase
		horizontalScrollPosition : Number The offset into the content from the left edge.	ScrollControlBase
		iconField : String The name of the field in the data provider object that determines what to display as the icon.	ListBase
		iconFunction : Function A user-supplied function to run on each item to determine its icon.	ListBase
		id : String ID of the component.	UIComponent
		includeInLayout : Boolean Specifies whether this component is included in the layout of the parent container.	UIComponent
		inheritingStyles : Object The beginning of this component's chain of inheriting styles.	UIComponent
		initialized : Boolean A flag that determines if an object has been through all three phases of layout: commitment, measurement, and layout (provided that any were required).	UIComponent
		instanceIndex : int [唯讀] The index of a repeated component.	UIComponent
		instanceIndices : Array An Array containing the indices required to reference this UIComponent object from its parent document.	UIComponent
		is3D : Boolean [唯讀] Contains true when the element is in 3D.	UIComponent
		isDocument : Boolean [唯讀] Contains true if this UIComponent instance is a document object.	UIComponent
		isPopUp : Boolean Set to true by the PopUpManager to indicate that component has been popped up.	UIComponent
		itemRenderer : IFactory The custom item renderer for the control.	ListBase
		labelField : String The name of the field in the data provider items to display as the label.	ListBase
		labelFunction : Function A user-supplied function to run on each item to determine its label.	ListBase
		layoutMatrix3D : Matrix3D [唯寫] The transform matrix that is used to calculate a component's layout relative to its siblings.	UIComponent
		left : Object For components, this layout constraint property is a facade on top of the similarly-named style.	UIComponent
		listData : BaseListData When a component is used as a drop-in item renderer or drop-in item editor, Flex initializes the listData property of the component with the additional data from the list control.	ListBase
		liveScrolling : Boolean = true A flag that indicates whether scrolling is live as the scrollbar thumb is moved or the view is not updated until the thumb is released.	ScrollControlBase
		loaderInfo : LoaderInfo [唯讀] 會傳回 LoaderInfo 物件，其中包含關於載入此顯示物件所屬之檔案的資訊。	DisplayObject
		maintainProjectionCenter : Boolean When true, the component keeps its projection matrix centered on the middle of its bounding box.	UIComponent
		mask : DisplayObject 呼叫之顯示物件會以指定的 mask 物件遮蓋。	DisplayObject
		maxHeight : Number The maximum recommended height of the component to be considered by the parent during layout.	UIComponent
		maxHorizontalScrollPosition : Number The maximum value for the horizontalScrollPosition property.	ScrollControlBase
		maxVerticalScrollPosition : Number The maximum value for the verticalScrollPosition property.	ScrollControlBase
		maxWidth : Number The maximum recommended width of the component to be considered by the parent during layout.	UIComponent
		measuredHeight : Number The default height of the component, in pixels.	UIComponent
		measuredMinHeight : Number The default minimum height of the component, in pixels.	UIComponent
		measuredMinWidth : Number The default minimum width of the component, in pixels.	UIComponent
		measuredWidth : Number The default width of the component, in pixels.	UIComponent
		menuSelectionMode : Boolean = false A flag that indicates whether menu-style selection should be used.	ListBase
		metaData : Object 如果中繼資料是透過 PlaceObject4 標籤與 SWF 檔案中的這個 DisplayObject 實體一同儲存，則會取得 DisplayObject 實體的中繼資料物件。	DisplayObject
		minHeight : Number The minimum recommended height of the component to be considered by the parent during layout.	UIComponent
		minWidth : Number The minimum recommended width of the component to be considered by the parent during layout.	UIComponent
		moduleFactory : IFlexModuleFactory A module factory is used as context for using embedded fonts and for finding the style manager that controls the styles for this component.	UIComponent
		mouseChildren : Boolean 判斷物件的子系是否支援啟用滑鼠或使用者輸入裝置。	DisplayObjectContainer
		mouseEnabled : Boolean 指定此物件是否接收滑鼠或其他使用者輸入及訊息。	InteractiveObject
		mouseFocusEnabled : Boolean Whether you can receive focus when clicked on.	UIComponent
		mouseX : Number [唯讀] 指出滑鼠或使用者輸入裝置位置的 x 座標，以像素為單位。	DisplayObject
		mouseY : Number [唯讀] 指出滑鼠或使用者輸入裝置位置的 y 座標，以像素為單位。	DisplayObject
		name : String 指出 DisplayObject 的實體名稱。	DisplayObject
		needsSoftKeyboard : Boolean 指定虛擬鍵盤 (螢幕上的軟體鍵盤) 是否應在此 InteractiveObject 實體接收到焦點時顯示。	InteractiveObject
		nestLevel : int Depth of this object in the containment hierarchy.	UIComponent
		nonInheritingStyles : Object The beginning of this component's chain of non-inheriting styles.	UIComponent
		nullItemRenderer : IFactory The custom item renderer for the control.	ListBase
		numAutomationChildren : int [唯讀] The number of automation children this container has.	UIComponent
		numChildren : int [唯讀] 傳回此物件的子系數量。	DisplayObjectContainer
		offscreenExtraRowsOrColumns : int The target number of extra rows or columns of item renderers to be used in the layout of the control.	ListBase
		opaqueBackground : Object 會指定顯示物件是否不透明，並具有特定背景顏色。	DisplayObject
		owner : DisplayObjectContainer The owner of this IVisualElement object.	UIComponent
		parent : DisplayObjectContainer [覆寫] [唯讀] The parent container or component for this component.	UIComponent
		parentApplication : Object [唯讀] A reference to the Application object that contains this UIComponent instance.	UIComponent
		parentDocument : Object [唯讀] A reference to the parent document object for this UIComponent.	UIComponent
		percentHeight : Number Specifies the height of a component as a percentage of its parent's size.	UIComponent
		percentWidth : Number Specifies the width of a component as a percentage of its parent's size.	UIComponent
		postLayoutTransformOffsets : mx.geom:TransformOffsets Defines a set of adjustments that can be applied to the object's transform in a way that is invisible to its parent's layout.	UIComponent
		processedDescriptors : Boolean Set to true after immediate or deferred child creation, depending on which one happens.	UIComponent
		repeater : IRepeater [唯讀] A reference to the Repeater object in the parent document that produced this UIComponent.	UIComponent
		repeaterIndex : int [唯讀] The index of the item in the data provider of the Repeater that produced this UIComponent.	UIComponent
		repeaterIndices : Array An Array containing the indices of the items in the data provider of the Repeaters in the parent document that produced this UIComponent.	UIComponent
		repeaters : Array An Array containing references to the Repeater objects in the parent document that produced this UIComponent.	UIComponent
		right : Object For components, this layout constraint property is a facade on top of the similarly-named style.	UIComponent
		root : DisplayObject [唯讀] 對載入之 SWF 檔案的顯示物件而言，root 屬性就是該 SWF 檔案所呈現之顯示清單樹狀結構部分的最上層顯示物件。	DisplayObject
		rotation : Number [覆寫] 指出 DisplayObject 實體的旋轉度數 (從該物件原本方向算起)。	UIComponent
		rotationX : Number [覆寫] Indicates the x-axis rotation of the DisplayObject instance, in degrees, from its original orientation relative to the 3D parent container.	UIComponent
		rotationY : Number [覆寫] Indicates the y-axis rotation of the DisplayObject instance, in degrees, from its original orientation relative to the 3D parent container.	UIComponent
		rotationZ : Number [覆寫] Indicates the z-axis rotation of the DisplayObject instance, in degrees, from its original orientation relative to the 3D parent container.	UIComponent
		rowCount : int Number of rows to be displayed.	ListBase
		rowHeight : Number The height of the rows in pixels.	ListBase
		scale9Grid : Rectangle 目前產生效用的縮放格線。	DisplayObject
		scaleX : Number [覆寫] Number that specifies the horizontal scaling factor.	UIComponent
		scaleY : Number [覆寫] Number that specifies the vertical scaling factor.	UIComponent
		scaleZ : Number [覆寫] Number that specifies the scaling factor along the z axis.	UIComponent
		screen : Rectangle [唯讀] Returns an object that contains the size and position of the base drawing surface for this object.	UIComponent
		scrollRect : Rectangle 顯示物件的捲動矩形範圍。	DisplayObject
		scrollTipFunction : Function A function that computes the string to be displayed as the ScrollTip.	ScrollControlBase
		selectable : Boolean A flag that indicates whether the list shows selected items as selected.	ListBase
		selectedIndex : int The index in the data provider of the selected item.	ListBase
		selectedIndices : Array An array of indices in the data provider of the selected items.	ListBase
		selectedItem : Object A reference to the selected item in the data provider.	ListBase
		selectedItems : Array An array of references to the selected items in the data provider.	ListBase
		selectedItemsCompareFunction : Function A function used to compare items in the selectedItems property against items in the data provider.	ListBase
		showDataTips : Boolean A flag that indicates whether dataTips are displayed for text in the rows.	ListBase
		showInAutomationHierarchy : Boolean A flag that determines if an automation object shows in the automation hierarchy.	UIComponent
		showScrollTips : Boolean = false A flag that indicates whether a tooltip should appear near the scroll thumb when it is being dragged.	ScrollControlBase
		softKeyboard : String 控制軟體鍵盤的外觀。	InteractiveObject
		softKeyboardInputAreaOfInterest : Rectangle 定義顯示軟體鍵盤時，應保留於螢幕上的區域 (iOS 未提供)。	InteractiveObject
		soundTransform : flash.media:SoundTransform 控制此 Sprite 的聲音。	Sprite
		stage : Stage [唯讀] 顯示物件的「舞台」。	DisplayObject
		states : Array The view states that are defined for this component.	UIComponent
		styleDeclaration : CSSStyleDeclaration Storage for the inline inheriting styles on this object.	UIComponent
		styleManager : IStyleManager2 [唯讀] Returns the StyleManager instance used by this component.	UIComponent
		styleName : Object The class style used by this component.	UIComponent
		styleParent : IAdvancedStyleClient A component's parent is used to evaluate descendant selectors.	UIComponent
		systemManager : ISystemManager Returns the SystemManager object used by this component.	UIComponent
		tabChildren : Boolean 判斷物件的子系是否支援啟用定位鍵。	DisplayObjectContainer
		tabEnabled : Boolean 會指定這個物件是否在停駐點順序中。	InteractiveObject
		tabFocusEnabled : Boolean A flag that indicates whether this object can receive focus via the TAB key This is similar to the tabEnabled property used by the Flash Player. This is usually true for components that handle keyboard input, but some components in controlbars have them set to false because they should not steal focus from another component like an editor.	UIComponent
		tabIndex : int 會指定 SWF 檔中的物件停駐點順序。	InteractiveObject
		textSnapshot : flash.text:TextSnapshot [唯讀] 傳回此 DisplayObjectContainer 實體的 TextSnapshot 物件。	DisplayObjectContainer
		toolTip : String Text to display in the ToolTip.	UIComponent
		top : Object For components, this layout constraint property is a facade on top of the similarly-named style.	UIComponent
		transform : flash.geom:Transform [覆寫] An object with properties pertaining to a display object's matrix, color transform, and pixel bounds.	UIComponent
		transformX : Number Sets the x coordinate for the transform center of the component.	UIComponent
		transformY : Number Sets the y coordinate for the transform center of the component.	UIComponent
		transformZ : Number Sets the z coordinate for the transform center of the component.	UIComponent
		transitions : Array An Array of Transition objects, where each Transition object defines a set of effects to play when a view state change occurs.	UIComponent
		tweeningProperties : Array Array of properties that are currently being tweened on this object.	UIComponent
		uid : String A unique identifier for the object.	UIComponent
		updateCompletePendingFlag : Boolean A flag that determines if an object has been through all three phases of layout validation (provided that any were required).	UIComponent
		useHandCursor : Boolean 指示當指標滑入 Sprite，且其 buttonMode 屬性設為 true 時，是否要出現指示手掌 (手掌游標) 的 Boolean 值。	Sprite
		validationSubField : String Used by a validator to associate a subfield with this component.	UIComponent
		value : Object [唯讀] The selected item, or the data or label field of the selected item.	ListBase
		variableRowHeight : Boolean A flag that indicates whether the individual rows can have different height.	ListBase
		verticalCenter : Object For components, this layout constraint property is a facade on top of the similarly-named style.	UIComponent
		verticalScrollPolicy : String A property that indicates whether the vertical scroll bar is always on, always off, or automatically changes based on the parameters passed to the setScrollBarProperties() method.	ScrollControlBase
		verticalScrollPosition : Number The offset into the content from the top edge.	ScrollControlBase
		viewMetrics : EdgeMetrics [唯讀] An EdgeMetrics object taking into account the scroll bars, if visible.	ScrollControlBase
		visible : Boolean [覆寫] Whether or not the display object is visible.	UIComponent
		width : Number [覆寫] Number that specifies the width of the component, in pixels, in the parent's coordinates.	UIComponent
		wordWrap : Boolean A flag that indicates whether text in the row should be word wrapped.	ListBase
		x : Number [覆寫] Number that specifies the component's horizontal position, in pixels, within its parent container.	UIComponent
		y : Number [覆寫] Number that specifies the component's vertical position, in pixels, within its parent container.	UIComponent
		z : Number [覆寫] Indicates the z coordinate position along the z-axis of the DisplayObject instance relative to the 3D parent container.	UIComponent

保護屬性

隱藏繼承保護屬性

顯示繼承保護屬性

	屬性		定義自
		actualCollection : ICollectionView A copy of the value normally stored in collection used while running data changes effects.	ListBase
		actualIterator : IViewCursor A copy of the value normally stored in iterator used while running data changes effects.	ListBase
		allowItemSizeChangeNotification : Boolean [唯寫] If false, renderers cannot invalidate size of List.	ListBase
		anchorBookmark : CursorBookmark A bookmark to the item that is the anchor.	ListBase
		anchorIndex : int = -1 The offset of the item in the data provider that is the selection anchor point.	ListBase
		border : IFlexDisplayObject The border object.	ScrollControlBase
		cachedItemsChangeEffect : IEffect = null The effect that plays when changes occur in the data provider for the control, set through the itemsChangeEffect style.	ListBase
		caretBookmark : CursorBookmark A bookmark to the item under the caret.	ListBase
		caretIndex : int = -1 The offset of the item in the data provider that is the selection caret point.	ListBase
		caretIndicator : Sprite The DisplayObject that contains the graphics that indicate which renderer is the caret.	ListBase
		caretItemRenderer : IListItemRenderer The renderer for the item under the caret.	ListBase
		caretUID : String The UID of the item under the caret.	ListBase
		collection : ICollectionView An ICollectionView that represents the data provider.	ListBase
		currentCSSState : String [唯讀] The state to be used when matching CSS pseudo-selectors.	UIComponent
		dataEffectCompleted : Boolean = false A flag that indicates that the a data change effect has just completed.	ListBase
		dataItemWrappersByRenderer : Dictionary A dictionary mapping item renderers to the ItemWrappers used to supply their data.	ListBase
		defaultColumnCount : int = 4 The default number of columns to display.	ListBase
		defaultRowCount : int = 4 The default number of rows to display.	ListBase
		dragImage : IUIComponent [唯讀] Gets an instance of a class that displays the visuals during a drag and drop operation.	ListBase
		dragImageOffsets : Point [唯讀] Gets the offset of the drag image for drag and drop.	ListBase
		explicitColumnCount : int = -1 The column count requested by explicitly setting the columnCount property.	ListBase
		explicitColumnWidth : Number The column width requested by explicitly setting the columnWidth.	ListBase
		explicitRowCount : int = -1 The row count requested by explicitly setting rowCount.	ListBase
		explicitRowHeight : Number The row height requested by explicitly setting rowHeight.	ListBase
		factoryMap : Dictionary A map of item renderers by factory.	ListBase
		freeItemRenderers : Array A stack of unused item renderers.	ListBase
		freeItemRenderersByFactory : Dictionary A map of free item renderers by factory.	ListBase
		hasComplexLayoutMatrix : Boolean [唯讀] Returns true if the UIComponent has any non-translation (x,y) transform properties.	UIComponent
		highlightIndicator : Sprite The DisplayObject that contains the graphics that indicates which renderer is highlighted.	ListBase
		highlightItemRenderer : IListItemRenderer The renderer that is currently rolled over or under the caret.	ListBase
		highlightUID : String The UID of the item that is current rolled over or under the caret.	ListBase
		horizontalScrollBar : ScrollBar The horizontal scroll bar.	ScrollControlBase
		itemsNeedMeasurement : Boolean = true A flag that indicates whether the columnWidth and rowHeight properties need to be calculated.	ListBase
		itemsSizeChanged : Boolean = false A flag that indicates that the size of the renderers may have changed.	ListBase
		iterator : IViewCursor The main IViewCursor used to fetch items from the data provider and pass the items to the renderers.	ListBase
		iteratorValid : Boolean = true A flag that indicates that a page fault as occurred and that the iterator's position is not valid (not positioned at the topmost item being displayed).	ListBase
		keySelectionPending : Boolean = false A flag that indicates if keyboard selection was interrupted by a page fault.	ListBase
		lastDropIndex : int The most recently calculated index where the drag item should be added to the drop target.	ListBase
		lastSeekPending : ListBaseSeekPending The most recent seek that caused a page fault.	ListBase
		listContent : ListBaseContentHolder An internal display object that parents all of the item renderers, selection and highlighting indicators and other supporting graphics.	ListBase
		listContentStyleFilters : Object [唯讀] The set of styles to pass from the ListBase to the listContent.	ListBase
		listItems : Array [唯讀] An Array of Arrays that contains the itemRenderer instances that render each data provider item.	ListBase
		maskShape : Shape The mask.	ScrollControlBase
		modifiedCollectionView : ModifiedCollectionView The collection view that temporarily preserves previous data provider state to facilitate running data change effects.	ListBase
		offscreenExtraColumns : int = 0 The target number of extra columns of item renderers used in the layout of the control.	ListBase
		offscreenExtraColumnsLeft : int = 0 The number of offscreen columns currently to the left of the leftmost visible column.	ListBase
		offscreenExtraColumnsRight : int = 0 The number of offscreen columns currently to the right of the right visible column.	ListBase
		offscreenExtraRows : int = 0 The target number of extra rows of item renderers to be used in the layout of the control.	ListBase
		offscreenExtraRowsBottom : int = 0 The number of offscreen rows currently below the bottom visible item renderer.	ListBase
		offscreenExtraRowsOrColumnsChanged : Boolean = false A flag indicating that the number of offscreen rows or columns may have changed.	ListBase
		offscreenExtraRowsTop : int = 0 The number of offscreen rows currently above the topmost visible row.	ListBase
		rendererChanged : Boolean = false A flag that indicates that the renderer changed.	ListBase
		reservedItemRenderers : Object A hash map of currently unused item renderers that may be used again in the near future.	ListBase
		resourceManager : IResourceManager [唯讀] A reference to the object which manages all of the application's localized resources.	UIComponent
		rowInfo : Array [唯讀] An array of ListRowInfo objects that cache row heights and other tracking information for the rows in listItems.	ListBase
		rowMap : Object A hash map of item renderers to their respective ListRowInfo object.	ListBase
		runDataEffectNextUpdate : Boolean = false A flag that indicates if a data effect should be initiated the next time the display is updated.	ListBase
		runningDataEffect : Boolean = false A flag indicating if a data change effect is currently running.	ListBase
		scrollAreaChanged : Boolean A flag that the scrolling area changed due to the appearance or disappearance of scrollbars.	ScrollControlBase
		selectedData : Object A hash table of ListBaseSelectionData objects that track which items are currently selected.	ListBase
		selectionIndicators : Object A hash table of selection indicators.	ListBase
		selectionLayer : Sprite The layer in listContent where all selection and highlight indicators are drawn.	ListBase
		selectionTweens : Object A hash table of selection tweens.	ListBase
		showCaret : Boolean A flag that indicates whether to show caret.	ListBase
		unconstrainedRenderers : Dictionary A hash map of item renderers that are not subject to the layout algorithms of the list.	ListBase
		unscaledHeight : Number [唯讀] A convenience method for determining the unscaled height of the component.	UIComponent
		unscaledWidth : Number [唯讀] A convenience method for determining the unscaled width of the component All of a component's drawing and child layout should be done within a bounding rectangle of this width, which is also passed as an argument to updateDisplayList().	UIComponent
		verticalScrollBar : ScrollBar The vertical scroll bar.	ScrollControlBase
		visibleData : Object [唯讀] A hash table of data provider item renderers currently in view.	ListBase
		wordWrapChanged : Boolean = false A flag that indicates whether the value of the wordWrap property has changed since the last time the display list was updated.	ListBase

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		ListBase() Constructor.	ListBase
		addChild(child:DisplayObject):DisplayObject 將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject 將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。	DisplayObjectContainer
		addDataEffectItem(item:Object):void Adds an item renderer if a data change effect is running.	ListBase
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。	EventDispatcher
		addStyleClient(styleClient:IAdvancedStyleClient):void Adds a non-visual style client to this component instance.	UIComponent
		areInaccessibleObjectsUnderPoint(point:Point):Boolean 指出安全性限制是否會造成傳回的清單 (可用指定的 point 點呼叫 DisplayObjectContainer.getObjectsUnderPoint() 方法來取得) 省略任何顯示物件。	DisplayObjectContainer
		calculateDropIndex(event:DragEvent = null):int Returns the index where the dropped items should be added to the drop target.	ListBase
		callLater(method:Function, args:Array = null):void Queues a function to be called later.	UIComponent
		clearStyle(styleProp:String):void Deletes a style property from this component instance.	UIComponent
		contains(child:DisplayObject):Boolean 判斷指定的顯示物件是否為 DisplayObjectContainer 實體的子系，或為實體本身。	DisplayObjectContainer
		contentToGlobal(point:Point):Point Converts a Point object from content coordinates to global coordinates.	UIComponent
		contentToLocal(point:Point):Point Converts a Point object from content to local coordinates.	UIComponent
		createAutomationIDPart(child:IAutomationObject):Object Returns a set of properties that identify the child within this container.	UIComponent
		createAutomationIDPartWithRequiredProperties(child:IAutomationObject, properties:Array):Object Returns a set of properties that identify the child within this container.	UIComponent
		createItemRenderer(data:Object):IListItemRenderer Creates an item renderer given the data object.	ListBase
		createReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void Creates an id reference to this IUIComponent object on its parent document object.	UIComponent
		deleteReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void Deletes the id reference to this IUIComponent object on its parent document object.	UIComponent
		determineTextFormatFromStyles():mx.core:UITextFormat Returns a UITextFormat object corresponding to the text styles for this UIComponent.	UIComponent
		dispatchEvent(event:Event):Boolean [覆寫] Dispatches an event into the event flow.	UIComponent
		drawFocus(isFocused:Boolean):void Shows or hides the focus indicator around this component.	UIComponent
		drawRoundRect(x:Number, y:Number, w:Number, h:Number, r:Object = null, c:Object = null, alpha:Object = null, rot:Object = null, gradient:String = null, ratios:Array = null, hole:Object = null):void Programmatically draws a rectangle into this skin's Graphics object.	UIComponent
		effectFinished(effectInst:IEffectInstance):void Called by the effect instance when it stops playing on the component.	UIComponent
		effectStarted(effectInst:IEffectInstance):void Called by the effect instance when it starts playing on the component.	UIComponent
		endEffectsStarted():void Ends all currently playing effects on the component.	UIComponent
		executeBindings(recurse:Boolean = false):void Executes all the bindings for which the UIComponent object is the destination.	UIComponent
		findString(str:String):Boolean Finds an item in the list based on a String, and moves the selection to it.	ListBase
		finishPrint(obj:Object, target:IFlexDisplayObject):void Called after printing is complete.	UIComponent
		getAutomationChildAt(index:int):IAutomationObject Provides the automation object at the specified index.	UIComponent
		getAutomationChildren():Array Provides the automation object list .	UIComponent
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle 傳回可定義顯示物件區域 (相對於 targetCoordinateSpace 物件的座標系統) 的矩形。	DisplayObject
		getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Returns the x coordinate of the element's bounds at the specified element size.	UIComponent
		getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Returns the y coordinate of the element's bounds at the specified element size.	UIComponent
		getChildAt(index:int):DisplayObject 傳回存在於指定索引位置的子顯示物件實體。	DisplayObjectContainer
		getChildByName(name:String):DisplayObject 傳回具有指定名稱的子顯示物件。	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int 傳回 child DisplayObject 實體的索引位置。	DisplayObjectContainer
		getClassStyleDeclarations():Array Finds the type selectors for this UIComponent instance.	UIComponent
		getConstraintValue(constraintName:String):* Returns a layout constraint value, which is the same as getting the constraint style for this component.	UIComponent
		getExplicitOrMeasuredHeight():Number A convenience method for determining whether to use the explicit or measured height	UIComponent
		getExplicitOrMeasuredWidth():Number A convenience method for determining whether to use the explicit or measured width	UIComponent
		getFocus():InteractiveObject Gets the object that currently has focus.	UIComponent
		getItemRendererFactory(data:Object):IFactory Return the appropriate factory, using the default factory if none specified.	ListBase
		getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number Returns the element's layout height.	UIComponent
		getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number Returns the element's layout width.	UIComponent
		getLayoutBoundsX(postLayoutTransform:Boolean = true):Number Returns the x coordinate that the element uses to draw on screen.	UIComponent
		getLayoutBoundsY(postLayoutTransform:Boolean = true):Number Returns the y coordinate that the element uses to draw on screen.	UIComponent
		getLayoutMatrix():Matrix Returns the transform matrix that is used to calculate the component's layout relative to its siblings.	UIComponent
		getLayoutMatrix3D():Matrix3D Returns the layout transform Matrix3D for this element.	UIComponent
		getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number Returns the element's maximum height.	UIComponent
		getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number Returns the element's maximum width.	UIComponent
		getMinBoundsHeight(postLayoutTransform:Boolean = true):Number Returns the element's minimum height.	UIComponent
		getMinBoundsWidth(postLayoutTransform:Boolean = true):Number Returns the element's minimum width.	UIComponent
		getObjectsUnderPoint(point:Point):Array 傳回位於指定點底下，且屬於此 DisplayObjectContainer 實體之子系 (或孫系，以下類推) 的物件陣列。	DisplayObjectContainer
		getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number Returns the element's preferred height.	UIComponent
		getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number Returns the element's preferred width.	UIComponent
		getRect(targetCoordinateSpace:DisplayObject):Rectangle 根據 targetCoordinateSpace 參數所定義的座標系統，並排除形狀上的任何筆畫，傳回可定義顯示物件邊界的矩形。	DisplayObject
		getRendererSemanticValue(target:Object, semanticProperty:String):Object Returns true or false to indicates whether the effect should play on the target.	ListBase
		getRepeaterItem(whichRepeater:int = -1):Object Returns the item in the dataProvider that was used by the specified Repeater to produce this Repeater, or null if this Repeater isn't repeated.	UIComponent
		getStyle(styleProp:String):* Gets a style property that has been set anywhere in this component's style lookup chain.	UIComponent
		globalToContent(point:Point):Point Converts a Point object from global to content coordinates.	UIComponent
		globalToLocal(point:Point):Point 將 point 物件從「舞台」(全域) 座標轉換成顯示物件的 (區域) 座標。	DisplayObject
		globalToLocal3D(point:Point):Vector3D 將二維點從「舞台」(全域) 座標轉換為三維顯示物件的 (區域) 座標。	DisplayObject
		hasCSSState():Boolean Returns true if currentCSSState is not null.	UIComponent
		hasEventListener(type:String):Boolean 會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		hasState(stateName:String):Boolean Determines whether the specified state has been defined on this UIComponent.	UIComponent
		hideDropFeedback(event:DragEvent):void Hides the drop indicator under the mouse pointer that indicates that a drag and drop operation is allowed.	ListBase
		hitTestObject(obj:DisplayObject):Boolean 評估顯示物件的範圍框，看它是否與 obj 顯示物件的範圍框重疊或相交。	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean 評估顯示物件，看它是否與 x 和 y 參數所指定的點重疊或相交。	DisplayObject
		horizontalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix Returns a box Matrix which can be passed to the drawRoundRect() method as the rot parameter when drawing a horizontal gradient.	UIComponent
		indexToItemRenderer(index:int):IListItemRenderer Get an item renderer for the index of an item in the data provider, if one exists.	ListBase
		indicesToIndex(rowIndex:int, colIndex:int):int Computes the offset into the data provider of the item at colIndex, rowIndex.	ListBase
		initialize():void Initializes the internal structure of this component.	UIComponent
		initializeRepeaterArrays(parent:IRepeaterClient):void Initializes various properties which keep track of repeated instances of this component.	UIComponent
		invalidateDisplayList():void Marks a component so that its updateDisplayList() method gets called during a later screen update.	UIComponent
		invalidateLayering():void Called by a component's items to indicate that their depth property has changed.	UIComponent
		invalidateLayoutDirection():void An element must call this method when its layoutDirection changes or when its parent's layoutDirection changes.	UIComponent
		invalidateList():void Refresh all rows on the next update.	ListBase
		invalidateProperties():void Marks a component so that its commitProperties() method gets called during a later screen update.	UIComponent
		invalidateSize():void Marks a component so that its measure() method gets called during a later screen update.	UIComponent
		isItemHighlighted(data:Object):Boolean Determines if the item renderer for a data provider item is highlighted (is rolled over via the mouse or under the caret due to keyboard navigation).	ListBase
		isItemSelectable(data:Object):Boolean Determines if the item renderer for a data provider item is selectable.	ListBase
		isItemSelected(data:Object):Boolean Determines if the item renderer for a data provider item is selected.	ListBase
		isItemShowingCaret(data:Object):Boolean Determines if the item renderer for a data provider item is the item under the caret due to keyboard navigation.	ListBase
		isItemVisible(item:Object):Boolean Determines if an item is being displayed by a renderer.	ListBase
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		itemRendererContains(renderer:IListItemRenderer, object:DisplayObject):Boolean Determines whether a renderer contains (or owns) a display object.	ListBase
		itemRendererToIndex(itemRenderer:IListItemRenderer):int Returns the index of the item in the data provider of the item being rendered by this item renderer.	ListBase
		itemToDataTip(data:Object):String Returns the dataTip string the renderer would display for the given data object based on the dataTipField and dataTipFunction properties.	ListBase
		itemToIcon(data:Object):Class Returns the class for an icon, if any, for a data item, based on the iconField and iconFunction properties.	ListBase
		itemToItemRenderer(item:Object):IListItemRenderer Returns the item renderer for a given item in the data provider, if there is one.	ListBase
		itemToLabel(data:Object):String Returns the string the renderer would display for the given data object based on the labelField and labelFunction properties.	ListBase
		local3DToGlobal(point3d:Vector3D):Point 將三維顯示物件的 (區域) 座標的三維點轉換為「舞台」(全域) 座標中的二維點。	DisplayObject
		localToContent(point:Point):Point Converts a Point object from local to content coordinates.	UIComponent
		localToGlobal(point:Point):Point 將 point 物件從顯示物件的 (區域) 座標轉換成「舞台」(全域) 座標。	DisplayObject
		matchesCSSState(cssState:String):Boolean Returns true if cssState matches currentCSSState.	UIComponent
		matchesCSSType(cssType:String):Boolean Determines whether this instance is the same as, or is a subclass of, the given type.	UIComponent
		measureHeightOfItems(index:int = -1, count:int = 0):Number Measures a set of items from the data provider using the current item renderer and returns the sum of the heights of those items.	ListBase
		measureHTMLText(htmlText:String):flash.text:TextLineMetrics Measures the specified HTML text, which can contain HTML tags such as <font> and <b>, assuming that it is displayed in a single-line UITextField using a UITextFormat determined by the styles of this UIComponent.	UIComponent
		measureText(text:String):flash.text:TextLineMetrics Measures the specified text, assuming that it is displayed in a single-line UITextField (or UIFTETextField) using a UITextFormat determined by the styles of this UIComponent.	UIComponent
		measureWidthOfItems(index:int = -1, count:int = 0):Number Measures a set of items from the data provider using the current item renderer and returns the maximum width found.	ListBase
		move(x:Number, y:Number):void Moves the component to a specified position within its parent.	UIComponent
		notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void Propagates style changes to the children.	UIComponent
		owns(child:DisplayObject):Boolean Returns true if the chain of owner properties points from child to this UIComponent.	UIComponent
		parentChanged(p:DisplayObjectContainer):void Called by Flex when a UIComponent object is added to or removed from a parent.	UIComponent
		prepareToPrint(target:IFlexDisplayObject):Object Prepares an IFlexDisplayObject for printing.	UIComponent
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		regenerateStyleCache(recursive:Boolean):void Builds or rebuilds the CSS style cache for this component and, if the recursive parameter is true, for all descendants of this component as well.	UIComponent
		registerEffects(effects:Array):void For each effect event, registers the EffectManager as one of the event listeners.	UIComponent
		removeChild(child:DisplayObject):DisplayObject 將指定的 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject 從 DisplayObjectContainer 子清單中的指定索引位置移除子 DisplayObject。	DisplayObjectContainer
		removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void 將所有 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。	DisplayObjectContainer
		removeDataEffectItem(item:Object):void Removes an item renderer if a data change effect is running.	ListBase
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 會從 EventDispatcher 物件移除偵聽程式。	EventDispatcher
		removeStyleClient(styleClient:IAdvancedStyleClient):void Removes a non-visual style client from this component instance.	UIComponent
		replayAutomatableEvent(event:Event):Boolean Replays the specified event.	UIComponent
		requestSoftKeyboard():Boolean 升起顯示虛擬鍵盤。	InteractiveObject
		resolveAutomationIDPart(criteria:Object):Array Resolves a child by using the id provided.	UIComponent
		resumeBackgroundProcessing():void [靜態] Resumes the background processing of methods queued by callLater(), after a call to suspendBackgroundProcessing().	UIComponent
		scrollToIndex(index:int):Boolean Ensures that the data provider item at the given index is visible.	ListBase
		setActualSize(w:Number, h:Number):void Sizes the object.	UIComponent
		setChildIndex(child:DisplayObject, index:int):void 變更顯示物件容器中現有子系的位置。	DisplayObjectContainer
		setConstraintValue(constraintName:String, value:*):void Sets a layout constraint value, which is the same as setting the constraint style for this component.	UIComponent
		setCurrentState(stateName:String, playTransition:Boolean = true):void Set the current state.	UIComponent
		setFocus():void Sets the focus to this component.	UIComponent
		setLayoutBoundsPosition(x:Number, y:Number, postLayoutTransform:Boolean = true):void Sets the coordinates that the element uses to draw on screen.	UIComponent
		setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void Sets the layout size of the element.	UIComponent
		setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void Sets the transform Matrix that is used to calculate the component's layout size and position relative to its siblings.	UIComponent
		setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void Sets the transform Matrix3D that is used to calculate the component's layout size and position relative to its siblings.	UIComponent
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		setStyle(styleProp:String, newValue:*):void Sets a style property on this component instance.	UIComponent
		setVisible(value:Boolean, noEvent:Boolean = false):void Called when the visible property changes.	UIComponent
		showDropFeedback(event:DragEvent):void Displays a drop indicator under the mouse pointer to indicate that a drag and drop operation is allowed and where the items will be dropped.	ListBase
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void 讓使用者拖曳指定的 sprite。	Sprite
		startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void 讓使用者將指定的 Sprite 拖曳至觸控裝置上。	Sprite
		stopAllMovieClips():void 遞迴停止執行所有 MovieClips 的時間軸根源於此物件。	DisplayObjectContainer
		stopDrag():void 結束 startDrag() 方法。	Sprite
		stopTouchDrag(touchPointID:int):void 結束觸控裝置使用的 startTouchDrag() 方法。	Sprite
		styleChanged(styleProp:String):void Detects changes to style properties.	UIComponent
		stylesInitialized():void Flex calls the stylesInitialized() method when the styles for a component are first initialized.	UIComponent
		suspendBackgroundProcessing():void [靜態] Blocks the background processing of methods queued by callLater(), until resumeBackgroundProcessing() is called.	UIComponent
		swapChildren(child1:DisplayObject, child2:DisplayObject):void 替換兩個指定子物件的 z 順序 (深度階層，由前至後順序)。	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void 在子清單的兩個指定索引位置，替換子物件的 z 順序 (深度階層，由前至後順序)。	DisplayObjectContainer
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String [覆寫] Returns a string indicating the location of this object within the hierarchy of DisplayObjects in the Application.	FlexSprite
		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 A utility method to update the rotation, scale, and translation of the transform while keeping a particular point, specified in the component's own coordinate space, fixed in the parent's coordinate space.	UIComponent
		transformPointToParent(localPosition:Vector3D, position:Vector3D, postLayoutPosition:Vector3D):void A utility method to transform a point specified in the local coordinates of this object to its location in the object's parent's coordinates.	UIComponent
		unconstrainRenderer(item:Object):void Called by an UnconstrainItemAction effect as part of a data change effect if the item renderers corresponding to certain data items need to move outside the normal positions of item renderers in the control.	ListBase
		validateDisplayList():void Validates the position and size of children and draws other visuals.	UIComponent
		validateNow():void Validate and update the properties and layout of this object and redraw it, if necessary.	UIComponent
		validateProperties():void Used by layout logic to validate the properties of a component by calling the commitProperties() method.	UIComponent
		validateSize(recursive:Boolean = false):void Validates the measured size of the component If the LayoutManager.invalidateSize() method is called with this ILayoutManagerClient, then the validateSize() method is called when it's time to do measurements.	UIComponent
		validationResultHandler(event:ValidationResultEvent):void Handles both the valid and invalid events from a validator assigned to this component.	UIComponent
		valueOf():Object 會傳回指定之物件的基本值。	Object
		verticalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix Returns a box Matrix which can be passed to drawRoundRect() as the rot parameter when drawing a vertical gradient.	UIComponent
		willTrigger(type:String):Boolean 檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。	EventDispatcher

保護方法

隱藏繼承保護方法

顯示繼承保護方法

	方法		定義自
		addDragData(dragSource:Object):void Adds the selected items to the DragSource object as part of a drag-and-drop operation.	ListBase
		addToFreeItemRenderers(item:IListItemRenderer):void Adds a renderer to the recycled renderer list, making it invisible and cleaning up references to it.	ListBase
		addToRowArrays():void Add a blank row to the beginning of the arrays that store references to the rows.	ListBase
		adjustFocusRect(obj:DisplayObject = null):void Adjust the focus rectangle.	UIComponent
		adjustListContent(unscaledWidth:Number = -1, unscaledHeight:Number = -1):void Called from the updateDisplayList() method to adjust the size and position of listContent.	ListBase
		applyComputedMatrix():void Commits the computed matrix built from the combination of the layout matrix and the transform offsets to the flash displayObject's transform.	UIComponent
		applySelectionEffect(indicator:Sprite, uid:String, itemRenderer:IListItemRenderer):void Sets up the effect for applying the selection indicator.	ListBase
		attachOverlay():void This is an internal method used by the Flex framework to support the Dissolve effect.	UIComponent
		calculateDropIndicatorY(rowCount:Number, rowNum:int):Number Calculates the y position of the drop indicator when performing a drag-and-drop operation.	ListBase
		canSkipMeasurement():Boolean Determines if the call to the measure() method can be skipped.	UIComponent
		childrenCreated():void Performs any final processing after child objects are created.	UIComponent
		clearCaretIndicator(indicator:Sprite, itemRenderer:IListItemRenderer):void Clears the caret indicator into the given Sprite.	ListBase
		clearHighlightIndicator(indicator:Sprite, itemRenderer:IListItemRenderer):void Clears the highlight indicator in the given Sprite.	ListBase
		clearIndicators():void Removes all selection and highlight and caret indicators.	ListBase
		clearSelected(transition:Boolean = false):void Clears the set of selected items and removes all graphics depicting the selected state of those items.	ListBase
		clearVisibleData():void Empty the visibleData hash table.	ListBase
		collectionChangeHandler(event:Event):void Handles CollectionEvents dispatched from the data provider as the data changes.	ListBase
		commitProperties():void [覆寫] Calculates the column width and row height and number of rows and columns based on whether properties like columnCount columnWidth, rowHeight and rowCount were explicitly set.	ListBase
		configureScrollBars():void Configures the ScrollBars based on the number of rows and columns and viewable rows and columns.	ListBase
		copyItemWithUID(item:Object):Object Makes a deep copy of the object by calling the ObjectUtil.copy() method, and replaces the copy's uid property (if present) with a new value by calling the UIDUtil.createUID() method.	ListBase
		copySelectedItems(useDataField:Boolean = true):Array Copies the selected items in the order that they were selected.	ListBase
		createBorder():void Creates the border for this component.	ScrollControlBase
		createChildren():void [覆寫] Creates objects that are children of this ListBase; in this case, the listContent object that will hold all the item renderers.	ListBase
		createInFontContext(classObj:Class):Object Creates a new object using a context based on the embedded font being used.	UIComponent
		createInModuleContext(moduleFactory:IFlexModuleFactory, className:String):Object Creates the object using a given moduleFactory.	UIComponent
		destroyRow(i:int, numCols:int):void Recycle a row that is no longer needed, and remove its indicators.	ListBase
		dispatchPropertyChangeEvent(prop:String, oldValue:, value:):void Helper method for dispatching a PropertyChangeEvent when a property is updated.	UIComponent
		dragCompleteHandler(event:DragEvent):void Handles DragEvent.DRAG_COMPLETE events.	ListBase
		dragDropHandler(event:DragEvent):void Handles DragEvent.DRAG_DROP events.	ListBase
		dragEnterHandler(event:DragEvent):void Handles DragEvent.DRAG_ENTER events.	ListBase
		dragExitHandler(event:DragEvent):void Handles DragEvent.DRAG_EXIT events.	ListBase
		dragOverHandler(event:DragEvent):void Handles DragEvent.DRAG_OVER events.	ListBase
		dragScroll():void Interval function that scrolls the list up or down if the mouse goes above or below the list.	ListBase
		dragStartHandler(event:DragEvent):void The default handler for the dragStart event.	ListBase
		drawCaretIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void Draws the caret indicator into the given Sprite at the position, width and height specified using the color specified.	ListBase
		drawHighlightIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void Draws the highlight indicator into the given Sprite at the position, width and height specified using the color specified.	ListBase
		drawItem(item:IListItemRenderer, selected:Boolean = false, highlighted:Boolean = false, caret:Boolean = false, transition:Boolean = false):void Draws the renderer with indicators that it is highlighted, selected, or the caret.	ListBase
		drawRowBackgrounds():void Draws any alternating row colors, borders and backgrounds for the rows.	ListBase
		drawSelectionIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void Draws the selection indicator into the given Sprite at the position, width and height specified using the color specified.	ListBase
		findKey(eventCode:int):Boolean Tries to find the next item in the data provider that starts with the character in the eventCode parameter.	ListBase
		finishDataChangeEffect(event:EffectEvent):void Cleans up after a data change effect has finished running by restoring the original collection and iterator and removing any cached values used by the effect.	ListBase
		finishKeySelection():void Sets selected items based on the caretIndex and anchorIndex properties.	ListBase
		focusInHandler(event:FocusEvent):void The event handler called when a UIComponent object gets focus.	UIComponent
		focusOutHandler(event:FocusEvent):void The event handler called when a UIComponent object loses focus.	UIComponent
		getReservedOrFreeItemRenderer(data:Object):IListItemRenderer Retrieves an already-created item renderer not currently in use.	ListBase
		indexToColumn(index:int):int The column for the data provider item at the given index.	ListBase
		indexToRow(index:int):int The row for the data provider item at the given index.	ListBase
		initAdvancedLayoutFeatures():void Initializes the implementation and storage of some of the less frequently used advanced layout features of a component.	UIComponent
		initializationComplete():void Finalizes the initialization of this component.	UIComponent
		initializeAccessibility():void Initializes this component's accessibility code.	UIComponent
		initiateDataChangeEffect(unscaledWidth:Number, unscaledHeight:Number):void Initiates a data change effect when there have been changes in the data provider.	ListBase
		invalidateParentSizeAndDisplayList():void Helper method to invalidate parent size and display list if this object affects its layout (includeInLayout is true).	UIComponent
		isOurFocus(target:DisplayObject):Boolean Typically overridden by components containing UITextField objects, where the UITextField object gets focus.	UIComponent
		isRendererUnconstrained(item:Object):Boolean Returns true if an item renderer is no longer being positioned by the list's layout algorithm while a data change effect is running as a result of a call to the unconstrainRenderer() method.	ListBase
		itemRendererToIndices(item:IListItemRenderer):Point Returns a Point containing the columnIndex and rowIndex of an item renderer.	ListBase
		itemToUID(data:Object):String Determines the UID for a data provider item.	ListBase
		keyDownHandler(event:KeyboardEvent):void The event handler called for a keyDown event.	UIComponent
		keyUpHandler(event:KeyboardEvent):void The event handler called for a keyUp event.	UIComponent
		layoutChrome(unscaledWidth:Number, unscaledHeight:Number):void Responds to size changes by setting the positions and sizes of this control's borders.	ScrollControlBase
		makeRowsAndColumns(left:Number, top:Number, right:Number, bottom:Number, firstColumn:int, firstRow:int, byCount:Boolean = false, rowsNeeded:uint = 0):Point Make enough rows and columns to fill the area described by left, top, right, bottom.	ListBase
		measure():void [覆寫] Calculates the measured width and height of the component based on the rowCount, columnCount, rowHeight and columnWidth properties.	ListBase
		mouseClickHandler(event:MouseEvent):void Handles MouseEvent.MOUSE_CLICK events from any mouse targets contained in the list including the renderers.	ListBase
		mouseDoubleClickHandler(event:MouseEvent):void Handles MouseEvent.MOUSE_DOUBLE_CLICK events from any mouse targets contained in the list including the renderers.	ListBase
		mouseDownHandler(event:MouseEvent):void Handles MouseEvent.MOUSE_DOWN events from any mouse targets contained in the list including the renderers.	ListBase
		mouseEventToItemRenderer(event:MouseEvent):IListItemRenderer Determines which item renderer is under the mouse.	ListBase
		mouseMoveHandler(event:MouseEvent):void Handles MouseEvent.MOUSE_MOVE events from any mouse targets contained in the list including the renderers.	ListBase
		mouseOutHandler(event:MouseEvent):void Handles MouseEvent.MOUSE_OUT events from any mouse targets contained in the list including the renderers.	ListBase
		mouseOverHandler(event:MouseEvent):void Handles MouseEvent.MOUSE_OVER events from any mouse targets contained in the list, including the renderers.	ListBase
		mouseUpHandler(event:MouseEvent):void Handles MouseEvent.MOUSE_DOWN events from any mouse targets contained in the list including the renderers.	ListBase
		mouseWheelHandler(event:MouseEvent):void [覆寫] Handles mouseWheel events by changing scroll positions.	ListBase
		moveIndicatorsHorizontally(uid:String, moveBlockDistance:Number):void Move the selection and highlight indicators horizontally.	ListBase
		moveIndicatorsVertically(uid:String, moveBlockDistance:Number):void Move the selection and highlight indicators vertically.	ListBase
		moveRowVertically(i:int, numCols:int, moveBlockDistance:Number):void Move a row vertically, and update the rowInfo record.	ListBase
		moveSelectionHorizontally(code:uint, shiftKey:Boolean, ctrlKey:Boolean):void Moves the selection in a horizontal direction in response to the user selecting items using the left arrow or right arrow keys and modifiers such as the Shift and Ctrl keys.	ListBase
		moveSelectionVertically(code:uint, shiftKey:Boolean, ctrlKey:Boolean):void Moves the selection in a vertical direction in response to the user selecting items using the up arrow or down arrow Keys and modifiers such as the Shift and Ctrl keys.	ListBase
		prepareDataEffect(ce:CollectionEvent):void Prepares the data effect for the collection event.	ListBase
		purgeItemRenderers():void Called by the updateDisplayList() method to remove existing item renderers and clean up various caching structures when the renderer changes.	ListBase
		reKeyVisibleData():void Update the keys in the visibleData hash table.	ListBase
		removeFromRowArrays(i:int):void Remove a row from the arrays that store references to the row.	ListBase
		removeIndicators(uid:String):void Cleans up selection highlights and other associated graphics for a given item in the data provider.	ListBase
		resourcesChanged():void This method is called when a UIComponent is constructed, and again whenever the ResourceManager dispatches a "change" Event to indicate that the localized resources have changed in some way.	UIComponent
		restoreRowArrays(modDeltaPos:int):void Remove the requested number of rows from the beginning of the arrays that store references to the rows.	ListBase
		roomForScrollBar(bar:ScrollBar, unscaledWidth:Number, unscaledHeight:Number):Boolean Determines if there is enough space in this component to display a given scrollbar.	ScrollControlBase
		scrollHandler(event:Event):void Default event handler for the scroll event.	ScrollControlBase
		scrollHorizontally(pos:int, deltaPos:int, scrollUp:Boolean):void Adjusts the renderers in response to a change in scroll position.	ListBase
		scrollPositionToIndex(horizontalScrollPosition:int, verticalScrollPosition:int):int Returns the data provider index for the item at the first visible row and column for the given scroll positions.	ListBase
		scrollVertically(pos:int, deltaPos:int, scrollUp:Boolean):void Adjusts the renderers in response to a change in scroll position.	ListBase
		seekPendingFailureHandler(data:Object, info:ListBaseSeekPending):void The default failure handler when a seek fails due to a page fault.	ListBase
		seekPendingResultHandler(data:Object, info:ListBaseSeekPending):void The default result handler when a seek fails due to a page fault.	ListBase
		seekPositionSafely(index:int):Boolean Seek to a position, and handle an ItemPendingError if necessary.	ListBase
		selectItem(item:IListItemRenderer, shiftKey:Boolean, ctrlKey:Boolean, transition:Boolean = true):Boolean Updates the set of selected items given that the item renderer provided was clicked by the mouse and the keyboard modifiers are in the given state.	ListBase
		setRowCount(v:int):void Sets the rowCount property without causing invalidation or setting the explicitRowCount property, which permanently locks in the number of rows.	ListBase
		setRowHeight(v:Number):void Sets the rowHeight property without causing invalidation or setting of explicitRowHeight which permanently locks in the height of the rows.	ListBase
		setScrollBarProperties(totalColumns:int, visibleColumns:int, totalRows:int, visibleRows:int):void Causes the ScrollControlBase to show or hide scrollbars based on the parameters passed in.	ScrollControlBase
		setStretchXY(stretchX:Number, stretchY:Number):void Specifies a transform stretch factor in the horizontal and vertical direction.	UIComponent
		shiftRow(oldIndex:int, newIndex:int, numCols:int, shiftItems:Boolean):void Shift a row in the arrays that reference rows.	ListBase
		stateChanged(oldState:String, newState:String, recursive:Boolean):void This method is called when a state changes to check whether state-specific styles apply to this component.	UIComponent
		sumRowHeights(startRowIdx:int, endRowIdx:int):Number Determine the height of the requested set of rows.	ListBase
		truncateRowArrays(numRows:int):void Remove all remaining rows from the end of the arrays that store references to the rows.	ListBase
		UIDToItemRenderer(uid:String):IListItemRenderer Find an item renderer based on its UID if it is visible.	ListBase
		updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void [覆寫] Adds or removes item renderers if the number of displayable items changed.	ListBase
		updateList():void Refreshes all rows.	ListBase

事件

按一下以瞭解事件的詳細資訊

隱藏繼承事件

顯示繼承事件

	摘要	定義自
activate	[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。	EventDispatcher
add	Dispatched when the component is added to a container as a content child by using the addChild(), addChildAt(), addElement(), or addElementAt() method.	UIComponent
added	當顯示物件加入顯示清單中時傳送。	DisplayObject
addedToStage	會在顯示物件加入舞台上的顯示清單時，以直接或是透過加入包含該顯示物件之子樹狀結構的方式傳送。	DisplayObject
change	Dispatched when the selectedIndex or selectedItem property changes as a result of user interaction.	ListBase
clear	當使用者從文字快顯選單中選取「清除」(或「刪除」) 時傳送。	InteractiveObject
click	會當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置主按鈕時傳送。	InteractiveObject
contextMenu	當使用者手勢在 AIR 應用程式中觸發與此互動式物件相關聯的快顯選單時傳送。	InteractiveObject
copy	當使用者針對複製作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「複製」時傳送。	InteractiveObject
creationComplete	Dispatched when the component has finished its construction, property processing, measuring, layout, and drawing.	UIComponent
currentStateChange	Dispatched after the view state has changed.	UIComponent
currentStateChanging	Dispatched after the currentState property changes, but before the view state changes.	UIComponent
cut	當使用者針對剪下作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「剪下」時傳送。	InteractiveObject
dataChange	Dispatched when the data property changes.	ListBase
deactivate	[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。	EventDispatcher
doubleClick	在 InteractiveObject 物件的 doubleClickEnabled 旗標設為 true 的情況下，當使用者在相同的物件上方連續兩次快速按下並放開指標裝置主要按鈕時傳送。	InteractiveObject
dragComplete	Dispatched by the drag initiator (the component that is the source of the data being dragged) when the drag operation completes, either when you drop the dragged data onto a drop target or when you end the drag-and-drop operation without performing a drop.	UIComponent
dragDrop	Dispatched by the drop target when the user releases the mouse over it.	UIComponent
dragEnter	Dispatched by a component when the user moves the mouse over the component during a drag operation.	UIComponent
dragExit	Dispatched by the component when the user drags outside the component, but does not drop the data onto the target.	UIComponent
dragOver	Dispatched by a component when the user moves the mouse while over the component during a drag operation.	UIComponent
dragStart	Dispatched by the drag initiator when starting a drag operation.	UIComponent
effectEnd	Dispatched after an effect ends.	UIComponent
effectStart	Dispatched just before an effect starts.	UIComponent
effectStop	Dispatched after an effect is stopped, which happens only by a call to stop() on the effect.	UIComponent
enterFrame	[廣播事件] 當播放磁頭進入新影格時傳送。	DisplayObject
enterState	Dispatched after the component has entered a view state.	UIComponent
exitFrame	[廣播事件] 當播放磁頭結束目前影格時傳送。	DisplayObject
exitState	Dispatched just before the component exits a view state.	UIComponent
focusIn	當顯示物件取得焦點之後傳送。	InteractiveObject
focusOut	當顯示物件失去焦點時傳送。	InteractiveObject
frameConstructed	[廣播事件] 在影格顯示物件的建構函式執行之後，且影格指令碼執行之前傳送。	DisplayObject
gestureDirectionalTap	當使用者沿著觸控面與 InteractiveObject 實體建立接觸點 (例如沿著 Apple TV 的 Siri Remote 觸控面點選)，某些裝置可能也會將此接觸解譯為數個觸控事件的組合。	InteractiveObject
gestureLongPress	當使用在觸控裝置上的同一個 InteractiveObject 實體上按下兩個接觸點後送出 (例如在行動電話或平板電腦觸控螢幕的顯示物件上方，以兩支手指按下後鬆開)。	InteractiveObject
gesturePan	當使用者在觸控裝置上，將接觸點移動到 InteractiveObject 實體上方後傳送 (例如，在行動電話或平板電腦觸控螢幕的顯示物件上，由左向右移動手指)。	InteractiveObject
gestureRotate	當使用者在 InteractiveObject 實體的接觸點上做出旋轉手勢後傳送 (例如兩指觸摸行動電話或平板電腦的觸控螢幕，然後手指在顯示物件上旋轉)。	InteractiveObject
gestureSwipe	當使用者在與 InteractiveObject 實體的某個接觸點上做出揮動手勢後傳送 (例如，三指併在一起觸碰行動電話或平板電腦的觸控螢幕，然後在顯示物件上快速平行移動手指)。	InteractiveObject
gestureTap	當使用者與 InteractiveObject 實體建立接觸點，然後在觸控裝置上點一下後送出 (例如，將多根手指放到行動電話或平板電腦觸控螢幕的顯示物件上以開啟選單，然後其中一根手點一下，選取選單項目)。	InteractiveObject
gestureZoom	當使用者在 InteractiveObject 實體的某個接觸點上做出放大縮小手勢後傳送 (例如兩指併在一起觸摸行動電話或平板電腦的觸控螢幕，然後手指在顯示物件上快速張開)。	InteractiveObject
hide	Dispatched when an object's state changes from visible to invisible.	UIComponent
imeStartComposition	這個事件會送出至任何支援 IME 內嵌輸入的用戶端應用程式。	InteractiveObject
initialize	Dispatched when the component has finished its construction and has all initialization properties set.	UIComponent
invalid	Dispatched when a component is monitored by a Validator and the validation failed.	UIComponent
itemClick	Dispatched when the user clicks on an item in the control.	ListBase
itemDoubleClick	Dispatched when the user double-clicks on an item in the control.	ListBase
itemRollOut	Dispatched when the user rolls the mouse pointer out of an item in the control.	ListBase
itemRollOver	Dispatched when the user rolls the mouse pointer over an item in the control.	ListBase
keyDown	會當使用者按下按鍵時傳送。	InteractiveObject
keyFocusChange	當使用者嘗試使用鍵盤瀏覽變更焦點時傳送。	InteractiveObject
keyUp	會當使用者放開按鍵時傳送。	InteractiveObject
middleClick	當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置中間按鈕時傳送。	InteractiveObject
middleMouseDown	當使用者將指向裝置的中間按鈕移至 InteractiveObject 實體上方按下時傳送。	InteractiveObject
middleMouseUp	當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。	InteractiveObject
mouseDown	當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。	InteractiveObject
mouseDownOutside	Dispatched from a component opened using the PopUpManager when the user clicks outside it.	UIComponent
mouseFocusChange	會當使用者嘗試使用指向裝置變更焦點時傳送。	InteractiveObject
mouseMove	會當指向裝置停在 InteractiveObject 上方的情況下使用者將其移動時傳送。	InteractiveObject
mouseOut	會當使用者將指向裝置移開 InteractiveObject 實體時傳送。	InteractiveObject
mouseOver	會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。	InteractiveObject
mouseUp	當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。	InteractiveObject
mouseWheel	當滑鼠滾輪在 InteractiveObject 實體上方轉動時傳送。	InteractiveObject
mouseWheelOutside	Dispatched from a component opened using the PopUpManager when the user scrolls the mouse wheel outside it.	UIComponent
move	Dispatched when the object has moved.	UIComponent
nativeDragComplete	當使用者釋放手勢時，由拖曳初始程式 InteractiveObject 傳送。	InteractiveObject
nativeDragDrop	已在目標 InteractiveObject 上放下拖曳的物件，而且已呼叫 DragManager.acceptDragDrop() 接受該放開的資料時，由此目標 InteractiveObject 傳送。	InteractiveObject
nativeDragEnter	當手勢進入 InteractiveObject 的邊界時，由此 InteractiveObject 傳送。	InteractiveObject
nativeDragExit	當手勢離開 InteractiveObject 的邊界時，由此 InteractiveObject 傳送。	InteractiveObject
nativeDragOver	當拖曳手勢還留在 InteractiveObject 的邊界內，由此 InteractiveObject 持續傳送。	InteractiveObject
nativeDragStart	在呼叫 DragManager.doDrag() 進行拖曳作業初期，由指定做為拖曳初始程式的 InteractiveObject 傳送。	InteractiveObject
nativeDragUpdate	在呼叫 DragManager.doDrag() 進行拖曳作業期間，由指定做為拖曳初始程式的 InteractiveObject 傳送。	InteractiveObject
paste	當使用者針對貼上作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「貼上」時傳送。	InteractiveObject
preinitialize	Dispatched at the beginning of the component initialization sequence.	UIComponent
proximityBegin	在使用者將作用中觸控筆往下移至超過螢幕鄰近偵測邊框時傳送。	InteractiveObject
proximityEnd	在使用者將作用中觸控筆提到螢幕鄰近偵測邊框時傳送。	InteractiveObject
proximityMove	在使用者將作用中觸控筆移到螢幕上方，而其餘仍在鄰近偵測邊框內時傳送。	InteractiveObject
proximityOut	在使用者將作用中觸控筆移出這個 InteractiveObject 之外，而其餘仍在螢幕的鄰近偵測邊框內時傳送。	InteractiveObject
proximityOver	在使用者直接將作用中觸控筆移到這個 InteractiveObject 上方，而其餘仍在螢幕的鄰近偵測邊框內時傳送。	InteractiveObject
proximityRollOut	在使用者將作用中觸控筆移出這個 InteractiveObject 及其任一子系之外，而其餘仍在螢幕的鄰近偵測邊框內時傳送。	InteractiveObject
proximityRollOver	在使用者透過這個 InteractiveObject，從顯示清單中後代的物件樹狀結構之外移動作用中觸控筆時傳送 (而其餘仍在螢幕的鄰近偵測邊框內)。	InteractiveObject
releaseOutside	當使用者第一次按下 InteractiveObject 實體上方的按鈕，然後將指向裝置滑出 InteractiveObject 實體之後即放開指向裝置上的按鈕時傳送。	InteractiveObject
remove	Dispatched when the component is removed from a container as a content child by using the removeChild(), removeChildAt(), removeElement(), or removeElementAt() method.	UIComponent
removed	會當顯示物件將要從顯示清單移除時傳送。	DisplayObject
removedFromStage	會在顯示物件即將從顯示清單移除時，以直接或是透過移除包含該顯示物件之子樹狀結構的方式傳送。	DisplayObject
render	[廣播事件] 當顯示清單將要更新和顯示時傳送。	DisplayObject
resize	Dispatched when the component is resized.	UIComponent
rightClick	當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置右邊按鈕時傳送。	InteractiveObject
rightMouseDown	當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。	InteractiveObject
rightMouseUp	當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。	InteractiveObject
rollOut	會當使用者將指向裝置移開 InteractiveObject 實體時傳送。	InteractiveObject
rollOver	會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。	InteractiveObject
scroll	Dispatched when the content is scrolled.	ScrollControlBase
selectAll	當使用者針對全選作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「全選」時傳送。	InteractiveObject
show	Dispatched when an object's state changes from invisible to visible.	UIComponent
softKeyboardActivate	升起顯示軟體鍵盤之後立即傳送。	InteractiveObject
softKeyboardActivating	升起顯示軟體鍵盤前立即傳送。	InteractiveObject
softKeyboardDeactivate	降下隱藏軟體鍵盤之後立即傳送。	InteractiveObject
stateChangeComplete	Dispatched after the component has entered a new state and any state transition animation to that state has finished playing.	UIComponent
stateChangeInterrupted	Dispatched when a component interrupts a transition to its current state in order to switch to a new state.	UIComponent
tabChildrenChange	在物件的 tabChildren 旗標值變更時傳送。	InteractiveObject
tabEnabledChange	在物件的 tabEnabled 旗標變更時傳送。	InteractiveObject
tabIndexChange	在物件的 tabIndex 屬性值變更時傳送。	InteractiveObject
textInput	當使用者輸入一或多文字的字元時送出。	InteractiveObject
toolTipCreate	Dispatched by the component when it is time to create a ToolTip.	UIComponent
toolTipEnd	Dispatched by the component when its ToolTip has been hidden and is to be discarded soon.	UIComponent
toolTipHide	Dispatched by the component when its ToolTip is about to be hidden.	UIComponent
toolTipShow	Dispatched by the component when its ToolTip is about to be shown.	UIComponent
toolTipShown	Dispatched by the component when its ToolTip has been shown.	UIComponent
toolTipStart	Dispatched by a component whose toolTip property is set, as soon as the user moves the mouse over it.	UIComponent
touchBegin	當使用者在第一次接觸觸控裝置後傳送 (例如手指觸摸行動電話或平板電腦的觸控螢幕)。	InteractiveObject
touchEnd	當使用者在觸控裝置上移除接觸點後傳送 (例如在行動電話或平板電腦觸控螢幕上移開手指)。	InteractiveObject
touchInteractionEnd	A non-cancellable event, dispatched by a component when it is done responding to a touch interaction user gesture.	UIComponent
touchInteractionStart	A non-cancellable event, dispatched by a component when it starts responding to a touch interaction user gesture.	UIComponent
touchInteractionStarting	A cancellable event, dispatched by a component in an attempt to respond to a touch interaction user gesture.	UIComponent
touchMove	當使用者觸控裝置時傳送，並且連續不斷地傳送，直到接觸點移除為止。	InteractiveObject
touchOut	當使用者在觸控裝置中，將接觸點移出 InteractiveObject 實體後送出 (例如在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件移至另一個顯示物件)。	InteractiveObject
touchOver	當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件外面的某一點，往顯示物件上方拖曳)。	InteractiveObject
touchRollOut	當使用者在觸控裝置上，將接觸點從 InteractiveObject 實體移出後送出 (例如，在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件上方拖曳到顯示物件以外)。	InteractiveObject
touchRollOver	當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上，將手指從顯示物件外面的某一點，往顯示物件上方拖曳)。	InteractiveObject
touchTap	當使用者在觸控裝置的同一個 InteractiveObject 實體上，在原先開始接觸點放開後送出 (例如在行動電話或平板電腦觸控螢幕上的顯示物件上方，以手指按下某個點後又鬆開)。	InteractiveObject
updateComplete	Dispatched when an object has had its commitProperties(), measure(), and updateDisplayList() methods called (if needed).	UIComponent
valid	Dispatched when a component is monitored by a Validator and the validation succeeded.	UIComponent
valueCommit	Dispatched when values are changed programmatically or by user interaction.	UIComponent

樣式

樣式可分為一般樣式及與特定主題關聯的樣式兩種。如果是一般樣式，可以與任何主題搭配使用。如果是與特定主題關聯的樣式，只有在您的應用程式使用特定主題時才能使用該樣式。

一般樣式

按一下以瞭解樣式的詳細資訊

隱藏繼承樣式

顯示繼承樣式

	說明	定義自
alternatingItemColors	類型: Array 格式: Color CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The colors to use for the backgrounds of the items in the list. The value is an array of one or more colors. The backgrounds of the list items alternate among the colors in the array. For DataGrid controls, all items in a row have the same background color, and each row's background color is determined from the array of colors. For the TileList control, which uses a single list to populate a two-dimensional display, the style can result in a checkerboard appearance, stripes, or other patterns based on the number of columns and rows and the number of colors specified. TileList cycles through the colors, placing the individual item background colors according to the layout direction. If you have an even number of colors and an even number of columns for a TileList layed out horizontally, you will get striping. If the number of columns is an odd number, you will get a checkerboard pattern. 預設值為 `undefined`。	ListBase
baseline	類型: String CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The vertical distance in pixels from the top edge of the content area to the control's baseline position.	UIComponent
borderSkin	類型: Class CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The border skin class of the component.	ScrollControlBase
borderStyle	類型: String CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Bounding box style.	ScrollControlBase
bottom	類型: String CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The vertical distance, in pixels, from the bottom edge of the component to the bottom edge of its parent container's content area.	UIComponent
color	類型: uint 格式: Color CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Color of text in the component, including the component label.	ScrollControlBase
direction	類型: String CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 4 執行階段版本: Flash10, AIR 1.5 The directionality of the text displayed by the component.	ScrollControlBase
disabledColor	類型: uint 格式: Color CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Color of text in the component if it is disabled.	ScrollControlBase
dropIndicatorSkin	類型: Class CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The skin to use to indicate where a dragged item can be dropped. When a ListBase-derived component is a potential drop target in a drag-and-drop operation, a call to the `showDropFeedback()` method makes an instance of this class and positions it one pixel above the itemRenderer for the item where, if the drop occurs, is the item after the dropped item. 預設值為 `mx.controls.listClasses.ListDropIndicator`。	ListBase
errorColor	類型: uint 格式: Color CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Color of the component highlight when validation fails.	UIComponent
focusAlpha	類型: Number CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Specifies the alpha transparency value of the focus skin.	ScrollControlBase
focusBlendMode	類型: String CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Blend mode used by the focus rectangle.	UIComponent
focusRoundedCorners	類型: String CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Specifies which corners of the focus rectangle should be rounded.	ScrollControlBase
focusSkin	類型: Class CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Skin used to draw the focus rectangle.	UIComponent
focusThickness	類型: Number 格式: Length CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Thickness, in pixels, of the focus rectangle outline.	UIComponent
fontAntiAliasType	類型: String CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Sets the `antiAliasType` property of internal TextFields.	ScrollControlBase
fontFamily	類型: String CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Name of the font to use.	ScrollControlBase
fontGridFitType	類型: String CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Sets the `gridFitType` property of internal TextFields that represent text in Flex controls.	ScrollControlBase
fontSharpness	類型: Number CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Sets the `sharpness` property of internal TextFields that represent text in Flex controls.	ScrollControlBase
fontSize	類型: Number 格式: Length CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Height of the text, in pixels.	ScrollControlBase
fontStyle	類型: String CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Determines whether the text is italic font.	ScrollControlBase
fontThickness	類型: Number CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Sets the `thickness` property of internal TextFields that represent text in Flex controls.	ScrollControlBase
fontWeight	類型: String CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Determines whether the text is boldface.	ScrollControlBase
horizontalCenter	類型: String CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The horizontal distance in pixels from the center of the component's content area to the center of the component.	UIComponent
horizontalScrollBarStyleName	類型: String CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Style name for horizontal scrollbar.	ScrollControlBase
interactionMode	類型: String CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 4.5 執行階段版本: Flash10, AIR 2.5 The primary interaction mode for this component.	UIComponent
kerning	類型: Boolean CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 A Boolean value that indicates whether kerning is enabled (`true`) or disabled (`false`).	ScrollControlBase
layoutDirection	類型: String CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 4.1 執行階段版本: Flash10, AIR 1.5 Specifies the desired layout direction of a component.	UIComponent
leading	類型: Number 格式: Length CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Additional vertical space between lines of text.	ScrollControlBase
left	類型: String CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The horizontal distance, in pixels, from the left edge of the component to the left edge of its parent container's content area.	UIComponent
letterSpacing	類型: Number CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The number of additional pixels to appear between each character.	ScrollControlBase
locale	類型: String CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 4 執行階段版本: Flash10, AIR 1.5 The locale of the text displayed by this component.	ScrollControlBase
paddingBottom	類型: Number 格式: Length CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The number of pixels between the bottom of the row and the bottom of the renderer in the row. 預設值為 `2`。	ListBase
paddingLeft	類型: Number 格式: Length CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Number of pixels between the component's left border and the left edge of its content area. The default value is 0. The default value for a Button control in the Halo theme is 10 and in the Spark theme is 6. The default value for the ComboBox control is 5. The default value for the Form container is 16. The default value for the Tree control is 2.	ListBase
paddingRight	類型: Number 格式: Length CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Number of pixels between the component's right border and the right edge of its content area. The default value is 0. The default value for a Button control in the Halo theme is 10 and in the Spark theme is 6. The default value for the ComboBox control is 5. The default value for the Form container is 16.	ListBase
paddingTop	類型: Number 格式: Length CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The number of pixels between the top of the row and the top of the renderer in the row. 預設值為 `2`。	ListBase
right	類型: String CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The horizontal distance, in pixels, from the right edge of the component to the right edge of its parent container's content area.	UIComponent
rollOverColor	類型: uint 格式: Color CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The color of the background of a renderer when the user rolls over it. The default value for the Halo theme is `0xB2E1FF`. The default value for the Spark theme is `0xCEDBEF`.	ListBase
selectionColor	類型: uint 格式: Color CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The color of the background of a renderer when the user selects it. The default value for the Halo theme is `0x7FCEFF`. The default value for the Spark theme is `0xA8C6EE`.	ListBase
selectionDisabledColor	類型: uint 格式: Color CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The color of the background of a renderer when the component is disabled. 預設值為 `0xDDDDDD`。	ListBase
selectionDuration	類型: Number 格式: Time CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The duration of the selection effect. When an item is selected an effect plays as the background is colored. Set to 0 to disable the effect. 預設值為 `250`。	ListBase
selectionEasingFunction	類型: Function CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The easingFunction for the selection effect. When an item is selected an effect plays as the background is colored. The default is a linear fade in of the color. An easingFunction can be used for controlling the selection effect. 預設值為 `undefined`。	ListBase
showErrorSkin	類型: Boolean CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 4.5 執行階段版本: Flash10, AIR 1.5 Show the error border or skin when this component is invalid	UIComponent
showErrorTip	類型: Boolean CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 4.5 執行階段版本: Flash10, AIR 1.5 Show the error tip when this component is invalid and the user rolls over it	UIComponent
textAlign	類型: String CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Alignment of text within a container.	ScrollControlBase
textDecoration	類型: String CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Determines whether the text is underlined.	ScrollControlBase
textFieldClass	類型: Class CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 4 執行階段版本: Flash10, AIR 1.5 The class implementing IUITextField that is used by this component to render text.	ScrollControlBase
textIndent	類型: Number 格式: Length CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Offset of first line of text from the left side of the container, in pixels.	ScrollControlBase
textRollOverColor	類型: uint 格式: Color CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The color of the text of a renderer when the user rolls over a it. The default value for the Halo theme is `0x2B333C`. The default value for the Spark theme is `0x000000`.	ListBase
textSelectedColor	類型: uint 格式: Color CSS 繼承: 是語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The color of the text of a renderer when the user selects it. The default value for the Halo theme is `0x2B333C`. The default value for the Spark theme is `0x000000`.	ListBase
top	類型: String CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The vertical distance, in pixels, from the top edge of the component to the top edge of its parent container's content area.	UIComponent
useRollOver	類型: Boolean CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 A flag that controls whether items are highlighted as the mouse rolls over them. If `true`, rows are highlighted as the mouse rolls over them. If `false`, rows are highlighted only when selected. 預設值為 `true`。	ListBase
verticalAlign	類型: String CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The vertical alignment of a renderer in a row. Possible values are `"top"`, `"middle"`, and `"bottom"`. The DataGrid positions the renderers in a row based on this style and the `paddingTop` and `paddingBottom` styles. if the item in the columns for a row have different heights Other list classes do not use `verticalAlign` but the item renderers can examine this style property and adjust their layout based on it. 預設值為 `"top"`。	ListBase
verticalCenter	類型: String CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 The vertical distance in pixels from the center of the component's content area to the center of the component.	UIComponent
verticalScrollBarStyleName	類型: String CSS 繼承: 否語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Style name for vertical scrollbar.	ScrollControlBase

Spark 主題樣式

按一下以瞭解樣式的詳細資訊

隱藏繼承樣式

顯示繼承樣式

	說明	定義自
accentColor	類型: uint 格式: Color CSS 繼承: 是主題: spark 語言版本: ActionScript 3.0 產品版本: Flex 4 執行階段版本: Flash10, AIR 1.5 Accent color used by component skins.	ScrollControlBase
borderAlpha	類型: Number CSS 繼承: 否主題: spark 語言版本: ActionScript 3.0 產品版本: Flex 4 執行階段版本: Flash10, AIR 1.5 Alpha of the border.	ScrollControlBase
borderColor	類型: uint 格式: Color CSS 繼承: 否主題: halo, spark 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Color of the border.	ScrollControlBase
borderVisible	類型: Boolean CSS 繼承: 否主題: spark 語言版本: ActionScript 3.0 產品版本: Flex 4 執行階段版本: Flash10, AIR 1.5 Visibility of the border.	ScrollControlBase
chromeColor	類型: uint 格式: Color CSS 繼承: 是主題: spark 語言版本: ActionScript 3.0 產品版本: Flex 4 執行階段版本: Flash10, AIR 1.5 The main color for a component.	ScrollControlBase
contentBackgroundAlpha	類型: Number CSS 繼承: 是主題: spark 語言版本: ActionScript 3.0 產品版本: Flex 4 執行階段版本: Flash10, AIR 1.5 The alpha of the content background for this component.	ScrollControlBase
contentBackgroundColor	類型: uint 格式: Color CSS 繼承: 是主題: spark 語言版本: ActionScript 3.0 產品版本: Flex 4 執行階段版本: Flash10, AIR 1.5 Color of the content area of the component.	ScrollControlBase
dropShadowVisible	類型: Boolean CSS 繼承: 否主題: spark 語言版本: ActionScript 3.0 產品版本: Flex 4 執行階段版本: Flash10, AIR 1.5 Boolean property that specifies whether the component has a visible drop shadow.	ScrollControlBase
focusColor	類型: uint 格式: Color CSS 繼承: 是主題: spark 語言版本: ActionScript 3.0 產品版本: Flex 4 執行階段版本: Flash10, AIR 1.5 Color of focus ring when the component is in focus	ScrollControlBase
symbolColor	類型: uint 格式: Color CSS 繼承: 是主題: spark 語言版本: ActionScript 3.0 產品版本: Flex 4 執行階段版本: Flash10, AIR 1.5 Color of any symbol of a component.	ScrollControlBase

Halo 主題樣式

按一下以瞭解樣式的詳細資訊

隱藏繼承樣式

顯示繼承樣式

	說明	定義自
backgroundAlpha	類型: Number CSS 繼承: 否主題: halo 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Alpha level of the color defined by the `backgroundColor` property, of the image or SWF file defined by the `backgroundImage` style.	ScrollControlBase
backgroundColor	類型: uint 格式: Color CSS 繼承: 否主題: halo 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Background color of a component.	ScrollControlBase
backgroundDisabledColor	類型: uint 格式: Color CSS 繼承: 是主題: halo 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Background color of the component when it is disabled.	ScrollControlBase
backgroundImage	類型: Object 格式: File CSS 繼承: 否主題: halo 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Background image of a component.	ScrollControlBase
backgroundSize	類型: String CSS 繼承: 否主題: halo 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Scales the image specified by `backgroundImage` to different percentage sizes.	ScrollControlBase
borderColor	類型: uint 格式: Color CSS 繼承: 否主題: halo, spark 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Color of the border.	ScrollControlBase
borderSides	類型: String CSS 繼承: 否主題: halo 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Bounding box sides.	ScrollControlBase
borderThickness	類型: Number 格式: Length CSS 繼承: 否主題: halo 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Bounding box thickness.	ScrollControlBase
cornerRadius	類型: Number 格式: Length CSS 繼承: 否主題: halo 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Radius of component corners.	ScrollControlBase
dropShadowColor	類型: uint 格式: Color CSS 繼承: 是主題: halo 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Color of the drop shadow.	ScrollControlBase
dropShadowEnabled	類型: Boolean CSS 繼承: 否主題: halo 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Boolean property that specifies whether the component has a visible drop shadow.	ScrollControlBase
shadowDirection	類型: String CSS 繼承: 否主題: halo 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Direction of the drop shadow.	ScrollControlBase
shadowDistance	類型: Number 格式: Length CSS 繼承: 否主題: halo 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Distance of the drop shadow.	ScrollControlBase
themeColor	類型: uint 格式: Color CSS 繼承: 是主題: halo 語言版本: ActionScript 3.0 產品版本: Flex 3 執行階段版本: Flash9, AIR 1.1 Theme color of a component.	UIComponent

特效

按一下以瞭解效果的詳細資訊

隱藏繼承特效

顯示繼承特效

	說明	定義自
addedEffect	觸發事件: added Played when the component is added as a child to a Container.	UIComponent
creationCompleteEffect	觸發事件: creationComplete Played when the component is created.	UIComponent
focusInEffect	觸發事件: focusIn Played when the component gains keyboard focus.	UIComponent
focusOutEffect	觸發事件: focusOut Played when the component loses keyboard focus.	UIComponent
hideEffect	觸發事件: hide Played when the component becomes invisible.	UIComponent
mouseDownEffect	觸發事件: mouseDown Played when the user presses the mouse button while over the component.	UIComponent
mouseUpEffect	觸發事件: mouseUp Played when the user releases the mouse button while over the component.	UIComponent
moveEffect	觸發事件: move Played when the component is moved.	UIComponent
removedEffect	觸發事件: removed Played when the component is removed from a Container.	UIComponent
resizeEffect	觸發事件: resize Played when the component is resized.	UIComponent
rollOutEffect	觸發事件: rollOut Played when the user rolls the mouse so it is no longer over the component.	UIComponent
rollOverEffect	觸發事件: rollOver Played when the user rolls the mouse over the component.	UIComponent
showEffect	觸發事件: show Played when the component becomes visible.	UIComponent

公用常數

隱藏繼承公用常數

顯示繼承公用常數

	常數		定義自

屬性詳細資訊

actualCollection

屬性

protected var actualCollection:ICollectionView

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A copy of the value normally stored in collection used while running data changes effects. This value should be null when a data change effect is not running.

actualIterator

屬性

protected var actualIterator:IViewCursor

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A copy of the value normally stored in iterator used while running data changes effects.

allowDragSelection

屬性

public var allowDragSelection:Boolean = false

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates whether drag-selection is enabled. Drag-Selection is the ability to select an item by dragging into it as opposed to normal selection where you can't have the mouse button down when you mouse over the item you want to select. This feature is used in ComboBox dropdowns to support pressing the mouse button when the mouse is over the dropdown button then dragging the mouse into the dropdown to select an item.

預設值為 false。

allowItemSizeChangeNotification

屬性

allowItemSizeChangeNotification:Boolean [唯寫]

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

If false, renderers cannot invalidate size of List.

實作
protected function set allowItemSizeChangeNotification(value:Boolean):void

allowMultipleSelection

屬性

allowMultipleSelection:Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates whether you can allow more than one item to be selected at the same time. If true, users can select multiple items. There is no option to disallow discontiguous selection. Standard complex selection options are always in effect (Shift-click, Ctrl-click).

預設值為 false。

實作
public function get allowMultipleSelection():Boolean
public function set allowMultipleSelection(value:Boolean):void

anchorBookmark

屬性

protected var anchorBookmark:CursorBookmark

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A bookmark to the item that is the anchor. A bookmark allows the component to quickly seek to a position in the collection of items. This property is used when selecting a set of items between the anchor and the caret or highlighted item, and when finding the selected item after a Sort or Filter is applied.

anchorIndex

屬性

protected var anchorIndex:int = -1

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The offset of the item in the data provider that is the selection anchor point.

cachedItemsChangeEffect

屬性

protected var cachedItemsChangeEffect:IEffect = null

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The effect that plays when changes occur in the data provider for the control, set through the itemsChangeEffect style.

caretBookmark

屬性

protected var caretBookmark:CursorBookmark

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A bookmark to the item under the caret. A bookmark allows the component to quickly seek to a position in the collection of items.

caretIndex

屬性

protected var caretIndex:int = -1

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The offset of the item in the data provider that is the selection caret point.

caretIndicator

屬性

protected var caretIndicator:Sprite

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The DisplayObject that contains the graphics that indicate which renderer is the caret.

caretItemRenderer

屬性

protected var caretItemRenderer:IListItemRenderer

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The renderer for the item under the caret. In the selection model, there is an anchor, a caret and a highlighted item. When the mouse is being used for selection, the item under the mouse is highlighted as the mouse rolls over the item. When the mouse is clicked with no modifier keys (Shift or Ctrl), the set of selected items is cleared and the item under the highlight is selected and becomes the anchor. The caret is unused in mouse selection. If there is an anchor and another item is selected while using the Shift key, the old set of selected items is cleared, and all items between the item and the anchor are selected. Clicking items while using the Ctrl key toggles the selection of individual items and does not move the anchor.

When selecting items using the keyboard, if the arrow keys are used with no modifier keys, the old selection is cleared and the new item is selected and becomes the anchor and the caret, and a caret indicator is shown around the selection highlight. If the user uses arrow keys with the Shift key, the old selection is cleared and the items between the anchor and the new item are selected. The caret moves to the new item. If arrow keys are used with the Ctrl key, just the caret moves. The user can use the Space key to toggle selection of the item under the caret.

caretUID

屬性

protected var caretUID:String

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The UID of the item under the caret.

collection

屬性

protected var collection:ICollectionView

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

An ICollectionView that represents the data provider. When you set the dataProvider property, Flex wraps the data provider as necessary to support the ICollectionView interface and sets this property to the result. The ListBase class then uses this property to access data in the provider. When you get the dataProvider property, Flex returns this value.

columnCount

屬性

columnCount:int

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The number of columns to be displayed in a TileList control or items in a HorizontalList control. For the DataGrid it is the number of visible columns. Note: Setting this property has no effect on a DataGrid control, which bases the number of columns on the control width and the individual column widths.

預設值為 4。

實作
public function get columnCount():int
public function set columnCount(value:int):void

columnWidth

屬性

columnWidth:Number

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The width of the control's columns. This property is used by TileList and HorizontalList controls; It has no effect on DataGrid controls, where you set the individual DataGridColumn widths.

預設值為 50。

實作
public function get columnWidth():Number
public function set columnWidth(value:Number):void

data

屬性

data:Object

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The item in the data provider this component should render when this component is used as an item renderer or item editor. The list class sets this property on each renderer or editor and the component displays the data. ListBase-derived classes support this property for complex situations like having a List of DataGrids or a DataGrid where one column is a List.

The list classes use the listData property in addition to the data property to determine what to display. If the list class is in a DataGrid it expects the dataField property of the column to map to a property in the data and sets selectedItem value to that property. If it is in a List or TileList control, it expects the labelField property of the list to map to a property in the data, and sets selectedItem value to that property. Otherwise it sets the selectedItem to the data itself.

This property uses the data provider but does not set it. In all cases, you must set the data provider in some other way.

You do not set this property in MXML.

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 dataChange 事件。

實作
public function get data():Object
public function set data(value:Object):void

相關 API 元素

mx.core.IDataRenderer

dataEffectCompleted

屬性

protected var dataEffectCompleted:Boolean = false

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates that the a data change effect has just completed. The component usually responds by cleaning up various internal data structures on the next updateDisplayList() call.

dataItemWrappersByRenderer

屬性

protected var dataItemWrappersByRenderer:Dictionary

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A dictionary mapping item renderers to the ItemWrappers used to supply their data. Only applicable if a data effect is running.

dataProvider

屬性

dataProvider:Object

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Set of data to be viewed. This property lets you use most types of objects as data providers. If you set the dataProvider property to an Array, it will be converted to an ArrayCollection. If you set the property to an XML object, it will be converted into an XMLListCollection with only one item. If you set the property to an XMLList, it will be converted to an XMLListCollection. If you set the property to an object that implements the IList or ICollectionView interface, the object will be used directly.

As a consequence of the conversions, when you get the dataProvider property, it will always be an ICollectionView, and therefore not necessarily be the type of object you used to you set the property. This behavior is important to understand if you want to modify the data in the data provider: changes to the original data may not be detected, but changes to the ICollectionView object that you get back from the dataProvider property will be detected.

預設值為 null。

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 collectionChange 事件。

實作
public function get dataProvider():Object
public function set dataProvider(value:Object):void

相關 API 元素

mx.collections.ICollectionView

dataTipField

屬性

dataTipField:String

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Name of the field in the data provider items to display as the data tip. By default, the list looks for a property named label on each item and displays it. However, if the data objects do not contain a label property, you can set the dataTipField property to use a different property in the data object. An example would be "FullName" when viewing a set of people's names retrieved from a database.

預設值為 null。

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 dataTipFieldChanged 事件。

實作
public function get dataTipField():String
public function set dataTipField(value:String):void

dataTipFunction

屬性

dataTipFunction:Function

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

User-supplied function to run on each item to determine its dataTip. By default, the list looks for a property named label on each data provider item and displays it. However, some items do not have a label property nor do they have another property that can be used for displaying in the rows. An example is a data set that has lastName and firstName fields, but you want to display full names. You can supply a dataTipFunction that finds the appropriate fields and return a displayable string. The dataTipFunction is also good for handling formatting and localization.

The dataTipFunction takes a single argument which is the item in the data provider and returns a String, as the following example shows:

myDataTipFunction(item:Object):String

預設值為 null。

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 dataTipFunctionChanged 事件。

實作
public function get dataTipFunction():Function
public function set dataTipFunction(value:Function):void

defaultColumnCount

屬性

protected var defaultColumnCount:int = 4

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The default number of columns to display. This value is used if the calculation for the number of columns results in a value less than 1 when trying to calculate the columnCount based on size or content.

預設值為 4。

defaultRowCount

屬性

protected var defaultRowCount:int = 4

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The default number of rows to display. This value is used if the calculation for the number of columns results in a value less than 1 when trying to calculate the rowCount based on size or content.

預設值為 4。

dragEnabled

屬性

dragEnabled:Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates whether you can drag items out of this control and drop them on other controls. If true, dragging is enabled for the control. If the dropEnabled property is also true, you can drag items and drop them within this control to reorder the items.

預設值為 false。

實作
public function get dragEnabled():Boolean
public function set dragEnabled(value:Boolean):void

dragImage

屬性

dragImage:IUIComponent [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Gets an instance of a class that displays the visuals during a drag and drop operation.

預設值為 mx.controls.listClasses.ListItemDragProxy。

實作
protected function get dragImage():IUIComponent

dragImageOffsets

屬性

dragImageOffsets:Point [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Gets the offset of the drag image for drag and drop.

實作
protected function get dragImageOffsets():Point

dragMoveEnabled

屬性

dragMoveEnabled:Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates whether items can be moved instead of just copied from the control as part of a drag-and-drop operation. If true, and the dragEnabled property is true, items can be moved. Often the data provider cannot or should not have items removed from it, so a MOVE operation should not be allowed during drag-and-drop.

預設值為 false。

實作
public function get dragMoveEnabled():Boolean
public function set dragMoveEnabled(value:Boolean):void

dropEnabled

屬性

dropEnabled:Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates whether dragged items can be dropped onto the control.

If you set this property to true, the control accepts all data formats, and assumes that the dragged data matches the format of the data in the data provider. If you want to explicitly check the data format of the data being dragged, you must handle one or more of the drag events, such as dragOver, and call the DragEvent's preventDefault() method to customize the way the list class accepts dropped data.

When you set dropEnabled to true, Flex automatically calls the showDropFeedback() and hideDropFeedback() methods to display the drop indicator.

預設值為 false。

實作
public function get dropEnabled():Boolean
public function set dropEnabled(value:Boolean):void

explicitColumnCount

屬性

protected var explicitColumnCount:int = -1

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The column count requested by explicitly setting the columnCount property.

explicitColumnWidth

屬性

protected var explicitColumnWidth:Number

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The column width requested by explicitly setting the columnWidth.

explicitRowCount

屬性

protected var explicitRowCount:int = -1

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The row count requested by explicitly setting rowCount.

explicitRowHeight

屬性

protected var explicitRowHeight:Number

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The row height requested by explicitly setting rowHeight.

factoryMap

屬性

protected var factoryMap:Dictionary

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A map of item renderers by factory. This property is a Dictionary indexed by itemRenderers where the values are IFactory.

freeItemRenderers

屬性

protected var freeItemRenderers:Array

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A stack of unused item renderers. Most list classes recycle renderers they've already created as they scroll out of the displayable area; doing so saves time during scrolling. The recycled renderers are stored here.

freeItemRenderersByFactory

屬性

protected var freeItemRenderersByFactory:Dictionary

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A map of free item renderers by factory. This property is a Dictionary indexed by factories where the values are Dictionaries of itemRenderers.

highlightIndicator

屬性

protected var highlightIndicator:Sprite

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The DisplayObject that contains the graphics that indicates which renderer is highlighted.

highlightItemRenderer

屬性

protected var highlightItemRenderer:IListItemRenderer

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The renderer that is currently rolled over or under the caret.

highlightUID

屬性

protected var highlightUID:String

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The UID of the item that is current rolled over or under the caret.

iconField

屬性

iconField:String

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The name of the field in the data provider object that determines what to display as the icon. By default, the list class does not try to display icons with the text in the rows. However, by specifying an icon field, you can specify a graphic that is created and displayed as an icon in the row. This property is ignored by DataGrid.

The renderers will look in the data provider object for a property of the name supplied as the iconField. If the value of the property is a Class, it will instantiate that class and expect it to be an instance of an IFlexDisplayObject. If the value of the property is a String, it will look to see if a Class exists with that name in the application, and if it can't find one, it will also look for a property on the document with that name and expect that property to map to a Class.

預設值為 null。

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 iconFieldChanged 事件。

實作
public function get iconField():String
public function set iconField(value:String):void

iconFunction

屬性

iconFunction:Function

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A user-supplied function to run on each item to determine its icon. By default the list does not try to display icons with the text in the rows. However, by specifying an icon function, you can specify a Class for a graphic that will be created and displayed as an icon in the row. This property is ignored by DataGrid.

The iconFunction takes a single argument which is the item in the data provider and returns a Class, as the following example shows:

iconFunction(item:Object):Class

預設值為 null。

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 iconFunctionChanged 事件。

實作
public function get iconFunction():Function
public function set iconFunction(value:Function):void

itemRenderer

屬性

itemRenderer:IFactory

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The custom item renderer for the control. You can specify a drop-in, inline, or custom item renderer.

The default item renderer depends on the component class. The TileList and HorizontalList class use TileListItemRenderer, The List class uses ListItemRenderer. The DataGrid class uses DataGridItemRenderer from DataGridColumn.

實作
public function get itemRenderer():IFactory
public function set itemRenderer(value:IFactory):void

itemsNeedMeasurement

屬性

protected var itemsNeedMeasurement:Boolean = true

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates whether the columnWidth and rowHeight properties need to be calculated. This property is set if a style changes that can affect the measurements of the renderer, or if the data provider is changed.

itemsSizeChanged

屬性

protected var itemsSizeChanged:Boolean = false

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates that the size of the renderers may have changed. The component usually responds by re-applying the data items to all of the renderers on the next updateDisplayList() call. There is an assumption that re-applying the items will invalidate the item renderers and cause them to re-measure.

iterator

屬性

protected var iterator:IViewCursor

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The main IViewCursor used to fetch items from the data provider and pass the items to the renderers. At the end of any sequence of code, it must always be positioned at the topmost visible item being displayed.

iteratorValid

屬性

protected var iteratorValid:Boolean = true

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates that a page fault as occurred and that the iterator's position is not valid (not positioned at the topmost item being displayed). If the component gets a page fault (an ItemPending error), it sets iteratorValid to false. Code that normally handles the rendering of items checks this flag and does not run until the page of data comes in from the server.

keySelectionPending

屬性

protected var keySelectionPending:Boolean = false

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates if keyboard selection was interrupted by a page fault. The component responds by suspending the rendering of items until the page of data arrives. The finishKeySelection() method will be called when the paged data arrives.

labelField

屬性

labelField:String

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The name of the field in the data provider items to display as the label. By default the list looks for a property named label on each item and displays it. However, if the data objects do not contain a label property, you can set the labelField property to use a different property in the data object. An example would be "FullName" when viewing a set of people names fetched from a database.

預設值為 "label"。

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 labelFieldChanged 事件。

實作
public function get labelField():String
public function set labelField(value:String):void

labelFunction

屬性

labelFunction:Function

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A user-supplied function to run on each item to determine its label. By default, the list looks for a property named label on each data provider item and displays it. However, some data sets do not have a label property nor do they have another property that can be used for displaying. An example is a data set that has lastName and firstName fields but you want to display full names.

You can supply a labelFunction that finds the appropriate fields and returns a displayable string. The labelFunction is also good for handling formatting and localization.

For most components, the label function takes a single argument which is the item in the data provider and returns a String.

      myLabelFunction(item:Object):String

The method signature for the DataGrid and DataGridColumn classes is:

      myLabelFunction(item:Object, column:DataGridColumn):String

where item contains the DataGrid item object, and column specifies the DataGrid column.

預設值為 null。

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 labelFunctionChanged 事件。

實作
public function get labelFunction():Function
public function set labelFunction(value:Function):void

lastDropIndex

屬性

protected var lastDropIndex:int

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The most recently calculated index where the drag item should be added to the drop target.

lastSeekPending

屬性

protected var lastSeekPending:ListBaseSeekPending

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The most recent seek that caused a page fault. If there are multiple page faults, only the most recent one is of interest, as that is where to position the iterator and start rendering rows again.

listContent

屬性

protected var listContent:ListBaseContentHolder

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

An internal display object that parents all of the item renderers, selection and highlighting indicators and other supporting graphics. This is roughly equivalent to the contentPane in the Container class, and is used for managing scrolling.

listContentStyleFilters

屬性

listContentStyleFilters:Object [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The set of styles to pass from the ListBase to the listContent.

實作
protected function get listContentStyleFilters():Object

相關 API 元素

mx.styles.StyleProxy

listData

屬性

listData:BaseListData

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

When a component is used as a drop-in item renderer or drop-in item editor, Flex initializes the listData property of the component with the additional data from the list control. The component can then use the listData property and the data property to display the appropriate information as a drop-in item renderer or drop-in item editor.

You do not set this property in MXML or ActionScript; Flex sets it when the component is used as a drop-in item renderer or drop-in item editor.

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 dataChange 事件。

實作
public function get listData():BaseListData
public function set listData(value:BaseListData):void

listItems

屬性

listItems:Array [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

An Array of Arrays that contains the itemRenderer instances that render each data provider item. This is a two-dimensional row major array (array of rows that are arrays of columns).

實作
protected function get listItems():Array

menuSelectionMode

屬性

public var menuSelectionMode:Boolean = false

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates whether menu-style selection should be used. In a Menu, dragging from one renderer into another selects the new one and un-selects the old.

modifiedCollectionView

屬性

protected var modifiedCollectionView:ModifiedCollectionView

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The collection view that temporarily preserves previous data provider state to facilitate running data change effects.

nullItemRenderer

屬性

nullItemRenderer:IFactory

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The custom item renderer for the control. You can specify a drop-in, inline, or custom item renderer.

實作
public function get nullItemRenderer():IFactory
public function set nullItemRenderer(value:IFactory):void

offscreenExtraColumns

屬性

protected var offscreenExtraColumns:int = 0

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The target number of extra columns of item renderers used in the layout of the control. Half of these columns are created to the left of the visible onscreen columns; half are created to the right. Typically this property will be set indirectly when you set the offscreenExtraRowsOrColumns property.

預設值為 0。

offscreenExtraColumnsLeft

屬性

protected var offscreenExtraColumnsLeft:int = 0

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The number of offscreen columns currently to the left of the leftmost visible column. This value will be <= offscreenExtraColumns / 2.

預設值為 0。

offscreenExtraColumnsRight

屬性

protected var offscreenExtraColumnsRight:int = 0

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The number of offscreen columns currently to the right of the right visible column. This value will be <= offscreenExtraColumns / 2.

預設值為 0。

offscreenExtraRows

屬性

protected var offscreenExtraRows:int = 0

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The target number of extra rows of item renderers to be used in the layout of the control. Half of these rows are created above the visible onscreen rows; half are created below. Typically this property is set indirectly when you set the offscreenExtraRowsOrColumns property.

預設值為 0。

offscreenExtraRowsBottom

屬性

protected var offscreenExtraRowsBottom:int = 0

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The number of offscreen rows currently below the bottom visible item renderer. This value will be <= offscreenExtraRows / 2.

預設值為 0。

offscreenExtraRowsOrColumns

屬性

offscreenExtraRowsOrColumns:int

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The target number of extra rows or columns of item renderers to be used in the layout of the control. Half of these rows/columns are created above or to the left of the visible onscreen rows/columns; half are created below or to the right.

Whether rows or columns are created is dependent on the control and its properties. Generally rows will be used, except for TileBase components where direction is set to TileBaseDirection.VERTICAL. In that case, columns are created.

You set this property to a non-zero value primarily when applying data effects to the List or TileList controls. Changes that affect the data provider element corresponding to the currently visible items, or changes that affect the data provider element for the specified number of items before or after the visible items, trigger the data effect. Data provider elements outside this range may not be animated perfectly by the data effect.

This property is useful because data effects work by first determining a 'before' layout of the list-based control, then determining an 'after' layout, and finally setting the properties of the effect to create an animation from the before layout to the after layout. Since many effects cause currently invisible items to become visible, or currently visible items to become invisible, this property configures the control to create the offscreen item renderers so that they already exist when the data effect plays.

A reasonable value for this property might be the number of rows visible onscreen. Setting it to a very large value may cause performance problems when used with a data provider that contains a large number of elements.

預設值為 0。

實作
public function get offscreenExtraRowsOrColumns():int
public function set offscreenExtraRowsOrColumns(value:int):void

offscreenExtraRowsOrColumnsChanged

屬性

protected var offscreenExtraRowsOrColumnsChanged:Boolean = false

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag indicating that the number of offscreen rows or columns may have changed.

offscreenExtraRowsTop

屬性

protected var offscreenExtraRowsTop:int = 0

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The number of offscreen rows currently above the topmost visible row. This value will be <= offscreenExtraRows / 2. It is used when computing the relationship of listItems and rowInfo Arrays to items in the data provider (in conjunction with verticalScrollPosition property).

預設值為 0。

rendererChanged

屬性

protected var rendererChanged:Boolean = false

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates that the renderer changed. The component usually responds by destroying all existing renderers and redrawing all of the renderers on the next updateDisplayList() call.

reservedItemRenderers

屬性

protected var reservedItemRenderers:Object

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A hash map of currently unused item renderers that may be used again in the near future. Used when running data effects. The map is indexed by the data provider item's UID.

rowCount

屬性

rowCount:int

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Number of rows to be displayed. If the height of the component has been explicitly set, this property might not have any effect.

For a DataGrid control, the rowCount property does not include the header row.

預設值為 4。

實作
public function get rowCount():int
public function set rowCount(value:int):void

rowHeight

屬性

rowHeight:Number

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The height of the rows in pixels. Unless the variableRowHeight property is true, all rows are the same height. If not specified, the row height is based on the font size and other properties of the renderer.

實作
public function get rowHeight():Number
public function set rowHeight(value:Number):void

rowInfo

屬性

rowInfo:Array [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

An array of ListRowInfo objects that cache row heights and other tracking information for the rows in listItems.

實作
protected function get rowInfo():Array

rowMap

屬性

protected var rowMap:Object

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A hash map of item renderers to their respective ListRowInfo object. The ListRowInfo object is indexed by the DisplayObject name of the item renderer.

runDataEffectNextUpdate

屬性

protected var runDataEffectNextUpdate:Boolean = false

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates if a data effect should be initiated the next time the display is updated.

runningDataEffect

屬性

protected var runningDataEffect:Boolean = false

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag indicating if a data change effect is currently running.

selectable

屬性

selectable:Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates whether the list shows selected items as selected. If true, the control supports selection. The Menu class, which subclasses ListBase, sets this property to false by default, because it doesn't show the chosen menu item as selected.

預設值為 true。

實作
public function get selectable():Boolean
public function set selectable(value:Boolean):void

selectedData

屬性

protected var selectedData:Object

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A hash table of ListBaseSelectionData objects that track which items are currently selected. The table is indexed by the UID of the items.

selectedIndex

屬性

selectedIndex:int

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The index in the data provider of the selected item.

The default value is -1 (no selected item).

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 valueCommit 事件。

實作
public function get selectedIndex():int
public function set selectedIndex(value:int):void

selectedIndices

屬性

selectedIndices:Array

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

An array of indices in the data provider of the selected items. The items are in the reverse order that the user selected the items.

預設值為 [ ]。

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 valueCommit 事件。

實作
public function get selectedIndices():Array
public function set selectedIndices(value:Array):void

selectedItem

屬性

selectedItem:Object

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A reference to the selected item in the data provider.

預設值為 null。

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 valueCommit 事件。

實作
public function get selectedItem():Object
public function set selectedItem(value:Object):void

selectedItems

屬性

selectedItems:Array

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

An array of references to the selected items in the data provider. The items are in the reverse order that the user selected the items.

預設值為 [ ]。

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 valueCommit 事件。

實作
public function get selectedItems():Array
public function set selectedItems(value:Array):void

selectedItemsCompareFunction

屬性

selectedItemsCompareFunction:Function

語言版本:

ActionScript 3.0

產品版本:

Flex 4

執行階段版本:

Flash Player 9, AIR 1.5

A function used to compare items in the selectedItems property against items in the data provider. If there is a match, the item in the data provider becomes part of the selection. By default, or if selectedItemsCompareFunction is set to null, the default comparision function is used, which uses strict equality (===). Note that earlier releases of Flex used simple equality (==) so there could be behavioral differences in certain cases. A common compare function might simply compare UIDs of objects or test that a particular property matches.

The compare function takes two arguments. The first argument is the object in the data provider. The second argument is an object in selectedItems property. The function returns true if the data provider item should be selected.

      myCompareFunction(itemInDataProvider:Object, itemInSelectedItems):Boolean

The default value is null, which uses strict equality.

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 selectedItemsCompareFunctionChanged 事件。

實作
public function get selectedItemsCompareFunction():Function
public function set selectedItemsCompareFunction(value:Function):void

selectionIndicators

屬性

protected var selectionIndicators:Object

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A hash table of selection indicators. This table allows the component to quickly find and remove the indicators when the set of selected items is cleared. The table is indexed by the item's UID.

selectionLayer

屬性

protected var selectionLayer:Sprite

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The layer in listContent where all selection and highlight indicators are drawn.

selectionTweens

屬性

protected var selectionTweens:Object

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A hash table of selection tweens. This allows the component to quickly find and clean up any tweens in progress if the set of selected items is cleared. The table is indexed by the item's UID.

showCaret

屬性

protected var showCaret:Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates whether to show caret. This property is usually set to false when mouse activity is detected and set back to true when the keyboard is used for selection.

showDataTips

屬性

showDataTips:Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates whether dataTips are displayed for text in the rows. If true, dataTips are displayed. DataTips are tooltips designed to show the text that is too long for the row. If you set a dataTipFunction, dataTips are shown regardless of whether the text is too long for the row.

預設值為 false。

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 showDataTipsChanged 事件。

實作
public function get showDataTips():Boolean
public function set showDataTips(value:Boolean):void

unconstrainedRenderers

屬性

protected var unconstrainedRenderers:Dictionary

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A hash map of item renderers that are not subject to the layout algorithms of the list.

value

屬性

value:Object [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The selected item, or the data or label field of the selected item. If the selected item is a Number or String the value is the item. If the item is an object, the value is the data property if it exists, or the label property if it exists.

Note: Using selectedItem is often preferable. This property exists for backward compatibility with older applications.

此屬性可以做為資料繫結的來源。一旦修改此屬性，將傳送 valueCommit 事件。

實作
public function get value():Object

variableRowHeight

屬性

variableRowHeight:Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates whether the individual rows can have different height. This property is ignored by TileList and HorizontalList. If true, individual rows can have different height values.

預設值為 false。

實作
public function get variableRowHeight():Boolean
public function set variableRowHeight(value:Boolean):void

visibleData

屬性

visibleData:Object [唯讀]

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A hash table of data provider item renderers currently in view. The table is indexed by the data provider item's UID and is used to quickly get the renderer used to display a particular item.

實作
protected function get visibleData():Object

wordWrap

屬性

wordWrap:Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates whether text in the row should be word wrapped. If true, enables word wrapping for text in the rows. Only takes effect if the variableRowHeight property is also true.

預設值為 false。

實作
public function get wordWrap():Boolean
public function set wordWrap(value:Boolean):void

wordWrapChanged

屬性

protected var wordWrapChanged:Boolean = false

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

A flag that indicates whether the value of the wordWrap property has changed since the last time the display list was updated. This property is set when you change the wordWrap property value, and is reset to false by the updateDisplayList() method. The component usually responds by re-applying the data items to all of the renderers on the next updateDisplayList() call. This is different from itemsSizeChanged because it further indicates that re-applying the data items to the renderers may not invalidate them since the only thing that changed was whether or not the renderer should factor in wordWrap into its size calculations.

建構函式詳細資料

()

建構函式

public function ListBase()

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Constructor.

方法詳細資訊

addDataEffectItem

()

方法

public function addDataEffectItem(item:Object):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Adds an item renderer if a data change effect is running. The item renderer should correspond to a recently added data item in the data provider's collection that isn't yet being displayed.

This function will be called by an AddItemAction effect as part of a data change effect to specify the point at which a data item added to a collection begins to be displayed by the control using an item renderer.

參數

item:Object — The item renderer to add to the control's layout.

addDragData

()

方法

protected function addDragData(dragSource:Object):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Adds the selected items to the DragSource object as part of a drag-and-drop operation. Override this method to add other data to the drag source.

參數

dragSource:Object — The DragSource object to which to add the data.

addToFreeItemRenderers

()

方法

protected function addToFreeItemRenderers(item:IListItemRenderer):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Adds a renderer to the recycled renderer list, making it invisible and cleaning up references to it. If a data effect is running, the renderer is reserved for future use for that data. Otherwise it is added to the general freeItemRenderers stack.

參數

item:IListItemRenderer — The renderer to add.

addToRowArrays

()

方法

protected function addToRowArrays():void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Add a blank row to the beginning of the arrays that store references to the rows.

adjustListContent

()

方法

protected function adjustListContent(unscaledWidth:Number = -1, unscaledHeight:Number = -1):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Called from the updateDisplayList() method to adjust the size and position of listContent.

參數

	`unscaledWidth:Number` (default = `-1`) — Specifies the width of the component, in pixels, in the component's coordinates, regardless of the value of the `scaleX` property of the component.

	`unscaledHeight:Number` (default = `-1`) — Specifies the height of the component, in pixels, in the component's coordinates, regardless of the value of the `scaleY` property of the component.

applySelectionEffect

()

方法

protected function applySelectionEffect(indicator:Sprite, uid:String, itemRenderer:IListItemRenderer):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Sets up the effect for applying the selection indicator. The default is a basic alpha tween.

參數

	`indicator:Sprite` — A Sprite that contains the graphics depicting selection.

	`uid:String` — The UID of the item being selected which can be used to index into a table and track more than one selection effect.

	`itemRenderer:IListItemRenderer` — The item renderer that is being shown as selected.

calculateDropIndex

()

方法

public function calculateDropIndex(event:DragEvent = null):int

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Returns the index where the dropped items should be added to the drop target.

參數

event:DragEvent (default = null) — A DragEvent that contains information about the position of the mouse. If null the method should return the dropIndex value from the last valid event.

傳回值

int — Index where the dropped items should be added.

calculateDropIndicatorY

()

方法

protected function calculateDropIndicatorY(rowCount:Number, rowNum:int):Number

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Calculates the y position of the drop indicator when performing a drag-and-drop operation.

參數

	`rowCount:Number` — The number of visible rows in the control.

	`rowNum:int` — The row number in the control where the drop indicator should appear.

傳回值

Number — The y axis coordinate of the drop indicator.

clearCaretIndicator

()

方法

protected function clearCaretIndicator(indicator:Sprite, itemRenderer:IListItemRenderer):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Clears the caret indicator into the given Sprite.

參數

	`indicator:Sprite` — A Sprite that should contain the graphics for that make a renderer look highlighted.

	`itemRenderer:IListItemRenderer` — The item renderer that is being highlighted.

clearHighlightIndicator

()

方法

protected function clearHighlightIndicator(indicator:Sprite, itemRenderer:IListItemRenderer):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Clears the highlight indicator in the given Sprite.

參數

	`indicator:Sprite` — A Sprite that should contain the graphics for that make a renderer look highlighted.

	`itemRenderer:IListItemRenderer` — The item renderer that is being highlighted.

clearIndicators

()

方法

protected function clearIndicators():void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Removes all selection and highlight and caret indicators.

clearSelected

()

方法

protected function clearSelected(transition:Boolean = false):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Clears the set of selected items and removes all graphics depicting the selected state of those items.

參數

transition:Boolean (default = false) — true if the graphics should have a fadeout effect.

clearVisibleData

()

方法

protected function clearVisibleData():void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Empty the visibleData hash table.

collectionChangeHandler

()

方法

protected function collectionChangeHandler(event:Event):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Handles CollectionEvents dispatched from the data provider as the data changes. Updates the renderers, selected indices and scrollbars as needed.

參數

event:Event — The CollectionEvent.

commitProperties

()

方法

override protected function commitProperties():void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Calculates the column width and row height and number of rows and columns based on whether properties like columnCount columnWidth, rowHeight and rowCount were explicitly set.

相關 API 元素

mx.core.ScrollControlBase

configureScrollBars

()

方法

protected function configureScrollBars():void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Configures the ScrollBars based on the number of rows and columns and viewable rows and columns. This method is called from the updateDisplayList() method after the rows and columns have been updated. The method should figures out what parameters to pass into the setScrollBarProperties() method to properly set up the ScrollBars.

copyItemWithUID

()

方法

protected function copyItemWithUID(item:Object):Object

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Makes a deep copy of the object by calling the ObjectUtil.copy() method, and replaces the copy's uid property (if present) with a new value by calling the UIDUtil.createUID() method.

This method is used for a drag and drop copy.

參數

item:Object — The item to copy.

傳回值

Object — The copy of the object.

相關 API 元素

mx.utils.ObjectUtil
mx.utils.UIDUtil

copySelectedItems

()

方法

protected function copySelectedItems(useDataField:Boolean = true):Array

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Copies the selected items in the order that they were selected.

參數

useDataField:Boolean (default = true) — true if the array should be filled with the actual items or false if the array should be filled with the indexes of the items.

傳回值

Array — An array of selected items.

createChildren

()

方法

override protected function createChildren():void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Creates objects that are children of this ListBase; in this case, the listContent object that will hold all the item renderers. The item renderers are not created immediately, but later when the updateDisplayList() method is called.

createItemRenderer

()

方法

public function createItemRenderer(data:Object):IListItemRenderer

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Creates an item renderer given the data object.

參數

data:Object — data object.

傳回值

IListItemRenderer — The item renderer.

destroyRow

()

方法

protected function destroyRow(i:int, numCols:int):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Recycle a row that is no longer needed, and remove its indicators.

參數

	`i:int` — The index of the row to remove.

	`numCols:int` — The number of columns in the row.

dragCompleteHandler

()

方法

protected function dragCompleteHandler(event:DragEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Handles DragEvent.DRAG_COMPLETE events. This method removes the item from the data provider.

參數

event:DragEvent — The DragEvent object.

dragDropHandler

()

方法

protected function dragDropHandler(event:DragEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Handles DragEvent.DRAG_DROP events. This method hides the drop feedback by calling the hideDropFeedback() method.

If the action is a COPY, then this method makes a deep copy of the object by calling the ObjectUtil.copy() method, and replaces the copy's uid property (if present) with a new value by calling the UIDUtil.createUID() method.

參數

event:DragEvent — The DragEvent object.

相關 API 元素

mx.utils.ObjectUtil
mx.utils.UIDUtil

dragEnterHandler

()

方法

protected function dragEnterHandler(event:DragEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Handles DragEvent.DRAG_ENTER events. This method determines if the DragSource object contains valid elements and uses the showDropFeedback() method to set up the UI feedback.

參數

event:DragEvent — The DragEvent object.

dragExitHandler

()

方法

protected function dragExitHandler(event:DragEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Handles DragEvent.DRAG_EXIT events. This method hides the UI feeback by calling the hideDropFeedback() method.

參數

event:DragEvent — The DragEvent object.

dragOverHandler

()

方法

protected function dragOverHandler(event:DragEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Handles DragEvent.DRAG_OVER events. This method determines if the DragSource object contains valid elements and uses the showDropFeedback() method to set up the UI feeback.

參數

event:DragEvent — The DragEvent object.

dragScroll

()

方法

protected function dragScroll():void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Interval function that scrolls the list up or down if the mouse goes above or below the list.

dragStartHandler

()

方法

protected function dragStartHandler(event:DragEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The default handler for the dragStart event.

參數

event:DragEvent — The DragEvent object.

drawCaretIndicator

()

方法

 protected function drawCaretIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Draws the caret indicator into the given Sprite at the position, width and height specified using the color specified.

參數

	`indicator:Sprite` — A Sprite that should contain the graphics for that make a renderer look highlighted.

	`x:Number` — The suggested x position for the indicator.

	`y:Number` — The suggested y position for the indicator.

	`width:Number` — The suggested width for the indicator.

	`height:Number` — The suggested height for the indicator.

	`color:uint` — The suggested color for the indicator.

	`itemRenderer:IListItemRenderer` — The item renderer that is being highlighted.

drawHighlightIndicator

()

方法

 protected function drawHighlightIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Draws the highlight indicator into the given Sprite at the position, width and height specified using the color specified.

參數

	`indicator:Sprite` — A Sprite that should contain the graphics for that make a renderer look highlighted.

	`x:Number` — The suggested x position for the indicator.

	`y:Number` — The suggested y position for the indicator.

	`width:Number` — The suggested width for the indicator.

	`height:Number` — The suggested height for the indicator.

	`color:uint` — The suggested color for the indicator.

	`itemRenderer:IListItemRenderer` — The item renderer that is being highlighted.

drawItem

()

方法

 protected function drawItem(item:IListItemRenderer, selected:Boolean = false, highlighted:Boolean = false, caret:Boolean = false, transition:Boolean = false):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Draws the renderer with indicators that it is highlighted, selected, or the caret.

參數

	`item:IListItemRenderer` — The renderer.

	`selected:Boolean` (default = `false`) — `true` if the renderer should be drawn in its selected state.

	`highlighted:Boolean` (default = `false`) — `true` if the renderer should be drawn in its highlighted state.

	`caret:Boolean` (default = `false`) — `true` if the renderer should be drawn as if it is the selection caret.

	`transition:Boolean` (default = `false`) — `true` if the selection state should fade in via an effect.

drawRowBackgrounds

()

方法

protected function drawRowBackgrounds():void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Draws any alternating row colors, borders and backgrounds for the rows.

drawSelectionIndicator

()

方法

 protected function drawSelectionIndicator(indicator:Sprite, x:Number, y:Number, width:Number, height:Number, color:uint, itemRenderer:IListItemRenderer):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Draws the selection indicator into the given Sprite at the position, width and height specified using the color specified.

參數

	`indicator:Sprite` — A Sprite that should contain the graphics for that make a renderer look highlighted.

	`x:Number` — The suggested x position for the indicator.

	`y:Number` — The suggested y position for the indicator.

	`width:Number` — The suggested width for the indicator.

	`height:Number` — The suggested height for the indicator.

	`color:uint` — The suggested color for the indicator.

	`itemRenderer:IListItemRenderer` — The item renderer that is being highlighted.

findKey

()

方法

protected function findKey(eventCode:int):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Tries to find the next item in the data provider that starts with the character in the eventCode parameter. You can override this to do fancier typeahead lookups. The search starts at the selectedIndex location; if it reaches the end of the data provider it starts over from the beginning.

參數

eventCode:int — The key that was pressed on the keyboard.

傳回值

Boolean — true if a match was found.

findString

()

方法

public function findString(str:String):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Finds an item in the list based on a String, and moves the selection to it. The search starts at the selectedIndex location; if it reaches the end of the data provider it starts over from the beginning.

For a DataGrid control, by default this method searches the first column in the control. To search a different column, set the sort property of the collection used to populate the control to the specific field or fields that you want to search. Each field corresponds to a single column of the control.

參數

str:String — The String to match.

傳回值

Boolean — true if a match is found.

finishDataChangeEffect

()

方法

protected function finishDataChangeEffect(event:EffectEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Cleans up after a data change effect has finished running by restoring the original collection and iterator and removing any cached values used by the effect. This method is called by the Flex framework; you do not need to call it from your code.

參數

event:EffectEvent — The EffectEvent.

finishKeySelection

()

方法

protected function finishKeySelection():void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Sets selected items based on the caretIndex and anchorIndex properties. Called by the keyboard selection handlers and by the updateDisplayList() method in case the keyboard selection handler received a page fault while scrolling to get more items.

getItemRendererFactory

()

方法

public function getItemRendererFactory(data:Object):IFactory

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Return the appropriate factory, using the default factory if none specified.

參數

data:Object — The data to be presented by the item renderer.

傳回值

IFactory — if data is null, the default item renderer, otherwise it returns the custom item renderer.

getRendererSemanticValue

()

方法

public function getRendererSemanticValue(target:Object, semanticProperty:String):Object

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Returns true or false to indicates whether the effect should play on the target. The EffectTargetFilter class calls this method when you set the filter property on a data effect. For example, you set filter property to addItem or removeItem.

參數

	`target:Object` — An item renderer

	`semanticProperty:String` — The semantic property of the renderer whose value will be returned.

傳回值

Object — true or false to indicates whether the effect should play on the target.

getReservedOrFreeItemRenderer

()

方法

protected function getReservedOrFreeItemRenderer(data:Object):IListItemRenderer

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Retrieves an already-created item renderer not currently in use. If a data effect is running, it first tries to retrieve from the reservedItemRenderers map. Otherwise (or if no reserved renderer is found) it retrieves from the freeItemRenderers stack.

參數

data:Object — The data to be presented by the item renderer.

傳回值

IListItemRenderer — An already-created item renderer not currently in use.

hideDropFeedback

()

方法

public function hideDropFeedback(event:DragEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Hides the drop indicator under the mouse pointer that indicates that a drag and drop operation is allowed.

參數

event:DragEvent — A DragEvent object that contains information about the mouse location.

indexToColumn

()

方法

protected function indexToColumn(index:int):int

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The column for the data provider item at the given index.

參數

index:int — The offset into the data provider.

傳回值

int — The column the item would be displayed at in the component; -1 if not displayable in listContent container.

indexToItemRenderer

()

方法

public function indexToItemRenderer(index:int):IListItemRenderer

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Get an item renderer for the index of an item in the data provider, if one exists. Because item renderers only exist for items within the set of viewable rows, you cannot use this method for items that are not visible.

參數

index:int — The offset into the data provider for an item.

傳回值

IListItemRenderer — The item renderer that is displaying the item, or null if the item is not currently displayed.

indexToRow

()

方法

protected function indexToRow(index:int):int

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The row for the data provider item at the given index.

參數

index:int — The offset into the data provider.

傳回值

int — The row the item would be displayed at in the component; -1 if not displayable in listContent container.

indicesToIndex

()

方法

public function indicesToIndex(rowIndex:int, colIndex:int):int

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Computes the offset into the data provider of the item at colIndex, rowIndex. The 9th row 3rd column in a TileList could be different items in the data provider based on the direction the tiles are laid out and the number of rows and columns in the TileList.

參數

	`rowIndex:int` — The 0-based index of the row, including rows scrolled off the top. Thus, if `verticalScrollPosition` is 2 then the first visible row has a rowIndex of 2.

	`colIndex:int` — The 0-based index of the column, including columns scrolled off the left. If `horizontalScrollPosition` is 2 then the first column on the left has a columnIndex of 2.

傳回值

int — The offset into the data provider.

initiateDataChangeEffect

()

方法

protected function initiateDataChangeEffect(unscaledWidth:Number, unscaledHeight:Number):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Initiates a data change effect when there have been changes in the data provider.

參數

	`unscaledWidth:Number` — The width of the control before external sizings are applied.

	`unscaledHeight:Number` — The height of the control before external sizings are applied.

invalidateList

()

方法

public function invalidateList():void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Refresh all rows on the next update.

isItemHighlighted

()

方法

public function isItemHighlighted(data:Object):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Determines if the item renderer for a data provider item is highlighted (is rolled over via the mouse or under the caret due to keyboard navigation).

參數

data:Object — The data provider item.

傳回值

Boolean — true if the item is highlighted.

isItemSelectable

()

方法

public function isItemSelectable(data:Object):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Determines if the item renderer for a data provider item is selectable.

參數

data:Object — The data provider item.

傳回值

Boolean — true if the item is selectable.

isItemSelected

()

方法

public function isItemSelected(data:Object):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Determines if the item renderer for a data provider item is selected.

參數

data:Object — The data provider item.

傳回值

Boolean — true if the item is selected.

isItemShowingCaret

()

方法

public function isItemShowingCaret(data:Object):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Determines if the item renderer for a data provider item is the item under the caret due to keyboard navigation.

參數

data:Object — The data provider item.

傳回值

Boolean — true if the item under the caret

isItemVisible

()

方法

public function isItemVisible(item:Object):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Determines if an item is being displayed by a renderer.

參數

item:Object — A data provider item.

傳回值

Boolean — true if the item is being displayed.

isRendererUnconstrained

()

方法

protected function isRendererUnconstrained(item:Object):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Returns true if an item renderer is no longer being positioned by the list's layout algorithm while a data change effect is running as a result of a call to the unconstrainRenderer() method.

參數

item:Object — An item renderer.

傳回值

Boolean — true if an item renderer is no longer being positioned by the list's layout algorithm.

itemRendererContains

()

方法

public function itemRendererContains(renderer:IListItemRenderer, object:DisplayObject):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Determines whether a renderer contains (or owns) a display object. Ownership means that the display object isn't actually parented by the renderer but is associated with it in some way. Popups should be owned by the renderers so that activity in the popup is associated with the renderer and not seen as activity in another component.

參數

	`renderer:IListItemRenderer` — The renderer that might contain or own the display object.

	`object:DisplayObject` — The display object that might be associated with the renderer.

傳回值

Boolean — true if the display object is contained or owned by the renderer.

itemRendererToIndex

()

方法

public function itemRendererToIndex(itemRenderer:IListItemRenderer):int

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Returns the index of the item in the data provider of the item being rendered by this item renderer. Because item renderers only exist for items that are within the set of viewable rows, you cannot use this method for items that are not visible.

參數

itemRenderer:IListItemRenderer — The item renderer that is displaying the item for which you want to know the data provider index.

傳回值

int — The index of the item in the data provider.

itemRendererToIndices

()

方法

protected function itemRendererToIndices(item:IListItemRenderer):Point

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Returns a Point containing the columnIndex and rowIndex of an item renderer. Because item renderers are only created for items within the set of viewable rows, you cannot use this method to get the indices for items that are not visible. Also note that item renderers are recycled so the indices you get for an item may change if that item renderer is reused to display a different item. Usually, this method is called during mouse and keyboard handling when the set of data displayed by the item renderers hasn't yet changed.

參數

item:IListItemRenderer — An item renderer.

傳回值

Point — A Point. The x property is the columnIndex and the y property is the rowIndex.

itemToDataTip

()

方法

public function itemToDataTip(data:Object):String

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Returns the dataTip string the renderer would display for the given data object based on the dataTipField and dataTipFunction properties. If the method cannot convert the parameter to a string, it returns a single space.

For use by developers creating subclasses of ListBase or its children. Not used by application developers.

參數

data:Object — Object to be rendered.

傳回值

String — String displayable string based on the data.

itemToIcon

()

方法

public function itemToIcon(data:Object):Class

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Returns the class for an icon, if any, for a data item, based on the iconField and iconFunction properties. The field in the item can return a string as long as that string represents the name of a class in the application. The field in the item can also be a string that is the name of a variable in the document that holds the class for the icon.

參數

data:Object — The item from which to extract the icon class.

傳回值

Class — The icon for the item, as a class reference or null if none.

itemToItemRenderer

()

方法

public function itemToItemRenderer(item:Object):IListItemRenderer

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Returns the item renderer for a given item in the data provider, if there is one. Since item renderers only exist for items that are within the set of viewable rows, this method returns null if the item is not visible. For DataGrid, this will return the first column's renderer.

參數

item:Object — The data provider item.

傳回值

IListItemRenderer — The item renderer or null if the item is not currently displayed.

itemToLabel

()

方法

public function itemToLabel(data:Object):String

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Returns the string the renderer would display for the given data object based on the labelField and labelFunction properties. If the method cannot convert the parameter to a string, it returns a single space.

參數

data:Object — Object to be rendered.

傳回值

String — The string to be displayed based on the data.

itemToUID

()

方法

protected function itemToUID(data:Object):String

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Determines the UID for a data provider item. All items in a data provider must either have a unique ID (UID) or one will be generated and associated with it. This means that you cannot have an object or scalar value appear twice in a data provider.

For example, the following data provider is not supported because the value "foo" appears twice and the UID for a string is the string itself:

var sampleDP:Array = ["foo", "bar", "foo"]

Simple dynamic objects can appear twice if they are two separate instances. The following is supported because each of the instances will be given a different UID because they are different objects:

var sampleDP:Array = [{label: "foo"}, {label: "foo"}]

Note that the following is not supported because the same instance appears twice.

      var foo:Object = {label: "foo"};
      sampleDP:Array = [foo, foo];

參數

data:Object — The data provider item.

傳回值

String — The UID as a string.

makeRowsAndColumns

()

方法

 protected function makeRowsAndColumns(left:Number, top:Number, right:Number, bottom:Number, firstColumn:int, firstRow:int, byCount:Boolean = false, rowsNeeded:uint = 0):Point

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Make enough rows and columns to fill the area described by left, top, right, bottom. Renderers are created and inserted into the listItems array starting at (firstColumn, firstRow)( and moving downwards.

If byCount and rowsNeeded are specified, then just make that many rows and ignore the bottom and right parameters.

參數

	`left:Number` — Horizontal pixel offset of area to fill.

	`top:Number` — Vertical pixel offset of area to fill.

	`right:Number` — Horizontal pixel offset of area to fill (from left side of component).

	`bottom:Number` — Vertical pixel offset of area to fill (from top of component).

	`firstColumn:int` — Offset into `listItems` to store the first renderer to be created.

	`firstRow:int` — Offset into `listItems` to store the first renderer to be created.

	`byCount:Boolean` (default = `false`) — If true, make `rowsNeeded` number of rows and ignore `bottom` parameter.

	`rowsNeeded:uint` (default = `0`) — Number of rows to create if `byCount` is true.

傳回值

Point — A Point containing the number of rows and columns created.

measure

()

方法

override protected function measure():void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Calculates the measured width and height of the component based on the rowCount, columnCount, rowHeight and columnWidth properties.

相關 API 元素

mx.core.ScrollControlBase

measureHeightOfItems

()

方法

public function measureHeightOfItems(index:int = -1, count:int = 0):Number

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Measures a set of items from the data provider using the current item renderer and returns the sum of the heights of those items.

This method is not implemented in the ListBase class and must be implemented in the child class.

A negative index value can be used to specify that the height calculation includes any headers.

參數

	`index:int` (default = `-1`) — The data provider item at which to start calculating the height.

	`count:int` (default = `0`) — The number of items to use in calculating the height.

傳回值

Number — the sum of the height of the measured items.

measureWidthOfItems

()

方法

public function measureWidthOfItems(index:int = -1, count:int = 0):Number

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Measures a set of items from the data provider using the current item renderer and returns the maximum width found. This method is used to calculate the width of the component. The various ListBase-derived classes have slightly different implementations. DataGrid measures its columns instead of data provider items, and TileList just measures the first item and assumes all items are the same size.

This method is not implemented in the ListBase class and must be implemented in the child class.

A negative index value can be used to specify that the width calculation includes any headers.

參數

	`index:int` (default = `-1`) — The data provider item at which to start measuring the width.

	`count:int` (default = `0`) — The number of items to measure in calculating the width.

傳回值

Number — The widest of the measured items.

mouseClickHandler

()

方法

protected function mouseClickHandler(event:MouseEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Handles MouseEvent.MOUSE_CLICK events from any mouse targets contained in the list including the renderers. This method determines which renderer was clicked and dispatches a ListEvent.ITEM_CLICK event.

參數

event:MouseEvent — The MouseEvent object.

mouseDoubleClickHandler

()

方法

protected function mouseDoubleClickHandler(event:MouseEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Handles MouseEvent.MOUSE_DOUBLE_CLICK events from any mouse targets contained in the list including the renderers. This method determines which renderer was clicked and dispatches a ListEvent.ITEM_DOUBLE_CLICK event.

參數

event:MouseEvent — The MouseEvent object.

mouseDownHandler

()

方法

protected function mouseDownHandler(event:MouseEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Handles MouseEvent.MOUSE_DOWN events from any mouse targets contained in the list including the renderers. This method finds the renderer that was pressed and prepares to receive a MouseEvent.MOUSE_UP event.

參數

event:MouseEvent — The MouseEvent object.

mouseEventToItemRenderer

()

方法

protected function mouseEventToItemRenderer(event:MouseEvent):IListItemRenderer

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Determines which item renderer is under the mouse. Item renderers can be made of multiple mouse targets, or have visible areas that are not mouse targets. This method checks both targets and position to determine which item renderer the mouse is over from the user's perspective, which can differ from the information provided by the mouse event.

參數

event:MouseEvent — A MouseEvent that contains the position of the mouse and the object it is over.

傳回值

IListItemRenderer — The item renderer the mouse is over or null if none.

mouseMoveHandler

()

方法

protected function mouseMoveHandler(event:MouseEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Handles MouseEvent.MOUSE_MOVE events from any mouse targets contained in the list including the renderers. This method watches for a gesture that constitutes the beginning of a drag drop and send a DragEvent.DRAG_START event. It also checks to see if the mouse is over a non-target area of a renderer so that Flex can try to make it look like that renderer was the target.

參數

event:MouseEvent — The MouseEvent object.

mouseOutHandler

()

方法

protected function mouseOutHandler(event:MouseEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Handles MouseEvent.MOUSE_OUT events from any mouse targets contained in the list including the renderers. This method finds out which renderer the mouse has left and removes the highlights.

參數

event:MouseEvent — The MouseEvent object.

mouseOverHandler

()

方法

protected function mouseOverHandler(event:MouseEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Handles MouseEvent.MOUSE_OVER events from any mouse targets contained in the list, including the renderers. This method finds out which renderer the mouse is over and shows it as highlighted.

The list classes also call this from a MouseEvent.MOUSE_MOVE event. This event is used to detect movement in non-target areas of the renderers and in padded areas around the renderers.

參數

event:MouseEvent — The MouseEvent object.

mouseUpHandler

()

方法

protected function mouseUpHandler(event:MouseEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

參數

event:MouseEvent — The MouseEvent object.

mouseWheelHandler

()

方法

override protected function mouseWheelHandler(event:MouseEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Handles mouseWheel events by changing scroll positions. This is a copy of the version in the ScrollControlBase class, modified to change the horizontalScrollPosition if the target is run horizontally.

參數

event:MouseEvent — The MouseEvent object.

moveIndicatorsHorizontally

()

方法

protected function moveIndicatorsHorizontally(uid:String, moveBlockDistance:Number):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Move the selection and highlight indicators horizontally.

參數

	`uid:String` — UID used to find the indicators.

	`moveBlockDistance:Number` — The distance to move horizontally.

moveIndicatorsVertically

()

方法

protected function moveIndicatorsVertically(uid:String, moveBlockDistance:Number):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Move the selection and highlight indicators vertically.

參數

	`uid:String` — UID used to find the indicators.

	`moveBlockDistance:Number` — The distance to move vertically.

moveRowVertically

()

方法

protected function moveRowVertically(i:int, numCols:int, moveBlockDistance:Number):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Move a row vertically, and update the rowInfo record.

參數

	`i:int` — The index of the row.

	`numCols:int` — The number of columns in the row.

	`moveBlockDistance:Number` — The distance to move.

moveSelectionHorizontally

()

方法

protected function moveSelectionHorizontally(code:uint, shiftKey:Boolean, ctrlKey:Boolean):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Moves the selection in a horizontal direction in response to the user selecting items using the left arrow or right arrow keys and modifiers such as the Shift and Ctrl keys. This method might change the horizontalScrollPosition, verticalScrollPosition, and caretIndex properties, and call the finishKeySelection() method to update the selection.

Not implemented in ListBase because the default list is single column and therefore does not scroll horizontally.

參數

	`code:uint` — The key that was pressed (for example, `Keyboard.LEFT`).

	`shiftKey:Boolean` — `true` if the Shift key was held down when the keyboard key was pressed.

	`ctrlKey:Boolean` — `true` if the Ctrl key was held down when the keyboard key was pressed.

moveSelectionVertically

()

方法

protected function moveSelectionVertically(code:uint, shiftKey:Boolean, ctrlKey:Boolean):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Moves the selection in a vertical direction in response to the user selecting items using the up arrow or down arrow Keys and modifiers such as the Shift and Ctrl keys. This method might change the horizontalScrollPosition, verticalScrollPosition, and caretIndex properties, and call the finishKeySelection() method to update the selection.

參數

	`code:uint` — The key that was pressed (for example, `Keyboard.DOWN`).

	`shiftKey:Boolean` — `true` if the Shift key was held down when the keyboard key was pressed.

	`ctrlKey:Boolean` — `true` if the Ctrl key was held down when the keyboard key was pressed.

prepareDataEffect

()

方法

protected function prepareDataEffect(ce:CollectionEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Prepares the data effect for the collection event.

參數

ce:CollectionEvent — The collection event.

purgeItemRenderers

()

方法

protected function purgeItemRenderers():void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Called by the updateDisplayList() method to remove existing item renderers and clean up various caching structures when the renderer changes.

reKeyVisibleData

()

方法

protected function reKeyVisibleData():void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Update the keys in the visibleData hash table.

removeDataEffectItem

()

方法

public function removeDataEffectItem(item:Object):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Removes an item renderer if a data change effect is running. The item renderer must correspond to data that has already been removed from the data provider collection. This function will be called by a RemoveItemAction effect as part of a data change effect to specify the point at which a data item ceases to displayed by the control using an item renderer.

參數

item:Object — The item renderer to remove from the control's layout.

removeFromRowArrays

()

方法

protected function removeFromRowArrays(i:int):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Remove a row from the arrays that store references to the row.

參數

i:int — The index of the row.

removeIndicators

()

方法

protected function removeIndicators(uid:String):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Cleans up selection highlights and other associated graphics for a given item in the data provider.

參數

uid:String — The UID of the data provider item.

restoreRowArrays

()

方法

protected function restoreRowArrays(modDeltaPos:int):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Remove the requested number of rows from the beginning of the arrays that store references to the rows.

參數

modDeltaPos:int — The number of rows to remove.

scrollHorizontally

()

方法

protected function scrollHorizontally(pos:int, deltaPos:int, scrollUp:Boolean):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Adjusts the renderers in response to a change in scroll position.

The list classes attempt to optimize scrolling when the scroll position has changed by less than the number of visible rows. In that situation some rows are unchanged and just need to be moved, other rows are removed and then new rows are added. If the scroll position changes too much, all old rows are removed and new rows are added by calling the makeRowsAndColumns() method for the entire viewable area.

Not implemented in ListBase because the default list is single column and therefore doesn't scroll horizontally.

參數

	`pos:int` — The new scroll position.

	`deltaPos:int` — The change in position. This value is always a positive number.

	`scrollUp:Boolean` — `true` if scroll position is getting smaller.

scrollPositionToIndex

()

方法

protected function scrollPositionToIndex(horizontalScrollPosition:int, verticalScrollPosition:int):int

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Returns the data provider index for the item at the first visible row and column for the given scroll positions.

參數

	`horizontalScrollPosition:int` — The `horizontalScrollPosition` property value corresponding to the scroll position.

	`verticalScrollPosition:int` — The `verticalScrollPosition` property value corresponding to the scroll position.

傳回值

int — The data provider index.

scrollToIndex

()

方法

public function scrollToIndex(index:int):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Ensures that the data provider item at the given index is visible. If the item is visible, the verticalScrollPosition property is left unchanged even if the item is not the first visible item. If the item is not currently visible, the verticalScrollPosition property is changed make the item the first visible item, unless there aren't enough rows to do so because the verticalScrollPosition value is limited by the maxVerticalScrollPosition property.

參數

index:int — The index of the item in the data provider.

傳回值

Boolean — true if verticalScrollPosition changed.

scrollVertically

()

方法

protected function scrollVertically(pos:int, deltaPos:int, scrollUp:Boolean):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Adjusts the renderers in response to a change in scroll position.

參數

	`pos:int` — The new scroll position.

	`deltaPos:int` — The change in position. This value is always a positive number.

	`scrollUp:Boolean` — `true` if the scroll position is getting smaller.

seekPendingFailureHandler

()

方法

protected function seekPendingFailureHandler(data:Object, info:ListBaseSeekPending):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The default failure handler when a seek fails due to a page fault.

參數

	`data:Object` — The data that caused the error.

	`info:ListBaseSeekPending` — Data about a seek operation that was interrupted by an ItemPendingError error.

seekPendingResultHandler

()

方法

protected function seekPendingResultHandler(data:Object, info:ListBaseSeekPending):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

The default result handler when a seek fails due to a page fault. This method checks to see if it has the most recent page fault result: if not it simply exits; if it does, it sets the iterator to the correct position.

參數

	`data:Object` — The data that caused the error.

	`info:ListBaseSeekPending` — Data about a seek operation that was interrupted by an ItemPendingError error.

seekPositionSafely

()

方法

protected function seekPositionSafely(index:int):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Seek to a position, and handle an ItemPendingError if necessary.

參數

index:int — Index into the collection.

傳回值

Boolean — false if an ItemPendingError is thrown.

selectItem

()

方法

 protected function selectItem(item:IListItemRenderer, shiftKey:Boolean, ctrlKey:Boolean, transition:Boolean = true):Boolean

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Updates the set of selected items given that the item renderer provided was clicked by the mouse and the keyboard modifiers are in the given state. This method also updates the display of the item renderers based on their updated selected state.

參數

	`item:IListItemRenderer` — The item renderer that was clicked.

	`shiftKey:Boolean` — `true` if the Shift key was held down when the mouse was clicked.

	`ctrlKey:Boolean` — `true` if the Ctrl key was held down when the mouse was clicked.

	`transition:Boolean` (default = `true`) — `true` if the graphics for the selected state should be faded in using an effect.

傳回值

Boolean — true if the set of selected items changed. Clicking on an already-selected item does not always change the set of selected items.

setRowCount

()

方法

protected function setRowCount(v:int):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Sets the rowCount property without causing invalidation or setting the explicitRowCount property, which permanently locks in the number of rows.

參數

v:int — The row count.

setRowHeight

()

方法

protected function setRowHeight(v:Number):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Sets the rowHeight property without causing invalidation or setting of explicitRowHeight which permanently locks in the height of the rows.

參數

v:Number — The row height, in pixels.

shiftRow

()

方法

protected function shiftRow(oldIndex:int, newIndex:int, numCols:int, shiftItems:Boolean):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Shift a row in the arrays that reference rows.

參數

	`oldIndex:int` — Old index in the arrays.

	`newIndex:int` — New index in the arrays.

	`numCols:int` — The number of columns in the row.

	`shiftItems:Boolean` — `true` if we actually move the item. `false` if we simply change the item's rowIndex.

showDropFeedback

()

方法

public function showDropFeedback(event:DragEvent):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Displays a drop indicator under the mouse pointer to indicate that a drag and drop operation is allowed and where the items will be dropped.

參數

event:DragEvent — A DragEvent object that contains information as to where the mouse is.

sumRowHeights

()

方法

protected function sumRowHeights(startRowIdx:int, endRowIdx:int):Number

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Determine the height of the requested set of rows.

參數

	`startRowIdx:int` — The index of first row.

	`endRowIdx:int` — The index of last row.

傳回值

Number — The total height of the rows.

truncateRowArrays

()

方法

protected function truncateRowArrays(numRows:int):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Remove all remaining rows from the end of the arrays that store references to the rows.

參數

numRows:int — The row index to truncate from.

UIDToItemRenderer

()

方法

protected function UIDToItemRenderer(uid:String):IListItemRenderer

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Find an item renderer based on its UID if it is visible.

參數

uid:String — The UID of the item.

傳回值

IListItemRenderer — The item renderer.

unconstrainRenderer

()

方法

public function unconstrainRenderer(item:Object):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Called by an UnconstrainItemAction effect as part of a data change effect if the item renderers corresponding to certain data items need to move outside the normal positions of item renderers in the control. The control does not attempt to position the item render for the duration of the effect.

參數

item:Object — The item renderer that is a target of the effect.

updateDisplayList

()

方法

override protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Adds or removes item renderers if the number of displayable items changed. Refreshes the item renderers if they might have changed. Applies the selection if it was changed programmatically.

參數

	`unscaledWidth:Number` — Specifies the width of the component, in pixels, in the component's coordinates, regardless of the value of the `scaleX` property of the component.

	`unscaledHeight:Number` — Specifies the height of the component, in pixels, in the component's coordinates, regardless of the value of the `scaleY` property of the component.

相關 API 元素

mx.core.ScrollControlBase

updateList

()

方法

protected function updateList():void

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Refreshes all rows. Calling this method can require substantial processing, because it completely redraws all renderers in the list and does not return until complete.

事件詳細資訊

change

事件

事件物件類型: mx.events.ListEvent
屬性 ListEvent.type = mx.events.ListEvent.CHANGE

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Dispatched when the selectedIndex or selectedItem property changes as a result of user interaction.

The ListEvent.CHANGE constant defines the value of the type property of the ListEvent object for a change event, which indicates that selection changed as a result of user interaction.

The properties of the event object have the following values:

Property	Value
`bubbles`	false
`cancelable`	false
`columnIndex`	The zero-based index of the column associated with the event.
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`itemRenderer`	The item renderer that was clicked.
`reason`	null
`rowIndex`	The zero-based index of the item associated with the event.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.
`Type`	ListEvent.CHANGE

dataChange

事件

事件物件類型: mx.events.FlexEvent
屬性 FlexEvent.type = mx.events.FlexEvent.DATA_CHANGE

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Dispatched when the data property changes.

When you use a component as an item renderer, the data property contains the data to display. You can listen for this event and update the component when the data property changes.

The FlexEvent.DATA_CHANGE constant defines the value of the type property of the event object for a dataChange event.

The properties of the event object have the following values:

Property	Value
`bubbles`	false
`cancelable`	false
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.

itemClick

事件

事件物件類型: mx.events.ListEvent
屬性 ListEvent.type = mx.events.ListEvent.ITEM_CLICK

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Dispatched when the user clicks on an item in the control.

The ListEvent.ITEM_CLICK constant defines the value of the type property of the ListEvent object for an itemClick event, which indicates that the user clicked the mouse over a visual item in the control.

The properties of the event object have the following values:

Property	Value
`bubbles`	false
`cancelable`	false
`columnIndex`	The zero-based index of the column associated with the event.
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`itemRenderer`	The item renderer that was clicked.
`reason`	null
`rowIndex`	The zero-based index of the item associated with the event.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.
`Type`	ListEvent.ITEM_CLICK

itemDoubleClick

事件

事件物件類型: mx.events.ListEvent
屬性 ListEvent.type = mx.events.ListEvent.ITEM_DOUBLE_CLICK

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Dispatched when the user double-clicks on an item in the control.

The ListEvent.ITEM_DOUBLE_CLICK constant defines the value of the type property of the ListEvent object for an itemDoubleClick event, which indicates that the user double clicked the mouse over a visual item in the control.

To receive itemDoubleClick events, you must set the component's doubleClickEnabled property to true.

The properties of the event object have the following values:

Property	Value
`bubbles`	false
`cancelable`	false
`columnIndex`	The zero-based index of the column associated with the event.
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`itemRenderer`	The item renderer that was double clicked.
`reason`	null
`rowIndex`	The zero-based index of the item associated with the event.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.
`Type`	ListEvent.ITEM_DOUBLE_CLICK

itemRollOut

事件

事件物件類型: mx.events.ListEvent
屬性 ListEvent.type = mx.events.ListEvent.ITEM_ROLL_OUT

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Dispatched when the user rolls the mouse pointer out of an item in the control.

The ListEvent.ITEM_ROLL_OUT constant defines the value of the type property of the ListEvent object for an itemRollOut event, which indicates that the user rolled the mouse pointer out of a visual item in the control.

The properties of the event object have the following values:

Property	Value
`bubbles`	false
`cancelable`	false
`columnIndex`	The zero-based index of the column associated with the event.
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`itemRenderer`	The item renderer that was rolled out.
`reason`	null
`rowIndex`	The zero-based index of the item associated with the event.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.
`Type`	ListEvent.ITEM_ROLL_OUT

itemRollOver

事件

事件物件類型: mx.events.ListEvent
屬性 ListEvent.type = mx.events.ListEvent.ITEM_ROLL_OVER

語言版本:

ActionScript 3.0

產品版本:

Flex 3

執行階段版本:

Flash Player 9, AIR 1.1

Dispatched when the user rolls the mouse pointer over an item in the control.

The ListEvent.ITEM_ROLL_OVER constant defines the value of the type property of the ListEvent object for an itemRollOver event, which indicates that the user rolled the mouse pointer over a visual item in the control.

The properties of the event object have the following values:

Property	Value
`bubbles`	false
`cancelable`	false
`columnIndex`	The zero-based index of the column associated with the event.
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`itemRenderer`	The item renderer that was rolled over.
`reason`	null
`rowIndex`	The zero-based index of the item associated with the event.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.
`Type`	ListEvent.ITEM_ROLL_OVER

法律聲明 | 線上隱私權政策

ListBase - AS3 Flex

套件x

語言元素

附錄

套件 mx.controls.listClasses

actualCollection

actualIterator

allowDragSelection

allowItemSizeChangeNotification

allowMultipleSelection

anchorBookmark

anchorIndex

cachedItemsChangeEffect

caretBookmark

caretIndex

caretIndicator

caretItemRenderer

caretUID

collection

columnCount

columnWidth

data

dataEffectCompleted

dataItemWrappersByRenderer

dataProvider

dataTipField

dataTipFunction

defaultColumnCount

defaultRowCount

dragEnabled

dragImage

dragImageOffsets

dragMoveEnabled

dropEnabled

explicitColumnCount

explicitColumnWidth

explicitRowCount

explicitRowHeight

factoryMap

freeItemRenderers

freeItemRenderersByFactory

highlightIndicator

highlightItemRenderer

highlightUID

iconField

iconFunction

itemRenderer

itemsNeedMeasurement

itemsSizeChanged

iterator

iteratorValid

keySelectionPending

labelField

labelFunction

lastDropIndex

lastSeekPending

listContent

listContentStyleFilters

listData

listItems

menuSelectionMode

modifiedCollectionView

nullItemRenderer

offscreenExtraColumns

offscreenExtraColumnsLeft

offscreenExtraColumnsRight

offscreenExtraRows

offscreenExtraRowsBottom

offscreenExtraRowsOrColumns

offscreenExtraRowsOrColumnsChanged

offscreenExtraRowsTop

rendererChanged

reservedItemRenderers

rowCount

rowHeight

rowInfo

rowMap

runDataEffectNextUpdate

runningDataEffect

selectable