適用於 Adobe® Flash® Platform 的 ActionScript® 3.0 參考
首頁  |  隱藏套件和類別清單 |  套件  |  類別  |  新增內容  |  索引  |  附錄  |  為什麼顯示英文?
篩選: AIR 30.0 和更早版本, Flash Player 30.0 和更早版本, Flash Lite 4
Flex 4.6 和更早版本, Flash Pro CS6 和更早版本
隱藏篩選
mx.core 

UIComponent  - AS3 Flex

套件x

最上層
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

語言元素

全域常數
全域函數
運算子
陳述式、關鍵字和指令
特殊類型

附錄

新增內容
編譯器錯誤
編譯器警告
執行階段錯誤
移轉至 ActionScript 3
支援的字元集
僅限 MXML 標籤
移動 XML 元素
Timed Text 標籤
不建議元素清單
AccessibilityImplementation 常數
如何使用 ActionScript 範例
法律聲明
套件mx.core
類別public class UIComponent
繼承UIComponent Inheritance FlexSprite Inheritance Sprite Inheritance DisplayObjectContainer Inheritance InteractiveObject Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
實作 IAutomationObject, IChildList, IConstraintClient, IDeferredInstantiationUIComponent, IFlexDisplayObject, IFlexModule, IInvalidating, ILayoutManagerClient, IPropertyChangeNotifier, IRepeaterClient, IStateClient, IAdvancedStyleClient, IToolTipManagerClient, IUIComponent, IValidatorListener, IVisualElement
子類別 AdvancedDataGridDragProxy, AdvancedDataGridGroupItemRenderer, AdvancedDataGridHeaderRenderer, AdvancedDataGridSortItemRenderer, BoxDivider, BusyIndicator, Button, CalloutArrow, ChartBase, ChartItemDragProxy, ChartLabel, ComboBase, Container, DataGridDragProxy, DataGridHeaderBase, DataTip, DateChooser, DefaultItemRenderer, DefaultItemRenderer, DualStyleObject, FlexBundleLoaderBase, FormHeading, GroupBase, HighlightBitmapCaptureSkin, HRule, HSliderDataTip, Label, LabelItemRenderer, Legend, LegendItem, ListBaseContentHolder, ListItemDragProxy, ListItemRenderer, MenuBar, MenuBarItem, MenuItemRenderer, MobileSkin, NumericStepper, OLAPDataGridGroupRenderer, PopUpAnchor, PopUpButtonSkin, ProgressBar, RectangularDropShadow, Repeater, RichEditableText, ScrollBar, ScrollControlBase, SkinnableComponent, Slider, Spacer, StatusBar, StyleableStageText, SwatchSkin, SWFLoader, TextBase, TextInput, TileListItemRenderer, TitleBar, ToolTip, TreeItemRenderer, UIServiceBase, VideoDisplay, VideoDisplay, VRule, WindowCloseButtonSkin, WindowMaximizeButtonSkin, WindowMinimizeButtonSkin, WindowRestoreButtonSkin

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The UIComponent class is the base class for all visual components, both interactive and noninteractive.

An interactive component can participate in tabbing and other kinds of keyboard focus manipulation, accept low-level events like keyboard and mouse input, and be disabled so that it does not receive keyboard and mouse input. This is in contrast to noninteractive components, like Label and ProgressBar, which simply display contents and are not manipulated by the user.

The UIComponent class is not used as an MXML tag, but is used as a base class for other classes.

MXML 語法expanded隱藏 MXML 語法

All user interface components in Flex extend the UIComponent class. Flex components inherit the following properties from the UIComponent class:

  <mx:tagname
   Properties 
    accessibilityDescription="null"
    accessibilityName="null"
    accessibilityShortcut="null"
    accessibilitySilent="true|false"
    automationName="null"
    cachePolicy="auto|on|off"
    currentState="null"
    doubleClickEnabled="false|true"
    enabled="true|false"
    explicitHeight="NaN"
    explicitMaxHeight="NaN"
    explicitMaxWidth="NaN"
    explicitMinHeight="NaN"
    explicitMinWidth="NaN"
    explicitWidth="NaN"
    focusEnabled="true|false"
    hasFocusableChildren="false|true"
    height="0"
    id=""
    includeInLayout="true|false"
    maxHeight="10000"
    maxWidth="10000"
    measuredHeight=
    measuredMinHeight=
    measuredMinWidth=
    measuredWidth=
    minHeight="0"
    minWidth="0"
    mouseFocusEnabled="true|false"
    percentHeight="NaN"
    percentWidth="NaN"
    scaleX="1.0"
    scaleY="1.0"
    states="null"
    styleName="undefined"
    toolTip="null"
    transitions=""
    validationSubField
    width="0"
    x="0"
    y="0"
 
  Styles
    bottom="undefined"
    errorColor="0xFF0000"
    focusBlendMode="normal"
    focusSkin="HaloFocusRect""
    focusThickness="2"
    horizontalCenter="undefined"
    layoutDirection="ltr"
    left="undefined"
    right="undefined"
    themeColor="haloGreen"
    top="undefined"
    verticalCenter="undefined"
 
  Effects
    addedEffect="No default"
    creationCompleteEffect="No default"
    focusInEffect="No default"
    focusOutEffect="No default"
    hideEffect="No default"
    mouseDownEffect="No default"
    mouseUpEffect="No default"
    moveEffect="No default"
    removedEffect="No default"
    resizeEffect="No default"
    rollOutEffect="No default"
    rollOverEffect="No default"
    showEffect="No default"
 
  Events
    add="No default"
    creationComplete="No default"
    currentStateChange="No default"
    currentStateChanging="No default"
    dragComplete="No default"
    dragDrop="No default"
    dragEnter="No default"
    dragExit="No default"
    dragOver="No default"
    effectEnd="No default"
    effectStart="No default"
    enterState="No default"
    exitState="No default"
    hide="No default"
    initialize="No default"
    invalid="No default"
    mouseDownOutside="No default"
    mouseWheelOutside="No default"
    move="No default"
    preinitialize="No default"
    remove="No default"
    resize="No default"
    show="No default"
    toolTipCreate="No default"
    toolTipEnd="No default"
    toolTipHide="No default"
    toolTipShow="No default"
    toolTipShown="No default"
    toolTipStart="No default"
    updateComplete="No default"
    valid="No default"
    valueCommit="No default"
  >
  

更多範例

相關 API 元素



公用屬性
 屬性定義自
  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
 InheritedaccessibilityImplementation : AccessibilityImplementation
對此 InteractiveObject 實體目前的輔助功能實作 (AccessibilityImplementation)。
InteractiveObject
  accessibilityName : String
A convenience accessor for the name property in this UIComponent's accessibilityProperties object.
UIComponent
 InheritedaccessibilityProperties : 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
 Inheritedalpha : 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
 InheritedblendMode : String
來自 BlendMode 類別的值,會指定要使用何種混合模式。
DisplayObject
 InheritedblendShader : Shader
[唯寫] 設定用來混合前景和背景的著色器。
DisplayObject
  bottom : Object
For components, this layout constraint property is a facade on top of the similarly-named style.
UIComponent
 InheritedbuttonMode : Boolean
可指定此 sprite 的按鈕模式。
Sprite
 InheritedcacheAsBitmap : Boolean
如果設定為 true,Flash 執行階段會快取顯示物件的內部點陣圖表示法。
DisplayObject
 Inherited    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
 Inheritedconstructor : 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
 InheritedcontextMenu : 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
  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
 InheriteddropTarget : 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
 Inheritedfilters : 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
 InheritedfocusRect : Object
會指定這個物件是否會顯示焦點矩形。
InteractiveObject
 Inheritedgraphics : 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
 InheritedhitArea : Sprite
指定用來當作 sprite 作用區域的另一個 sprite。
Sprite
  horizontalCenter : Object
For components, this layout constraint property is a facade on top of the similarly-named style.
UIComponent
  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
  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
 InheritedloaderInfo : LoaderInfo
[唯讀] 會傳回 LoaderInfo 物件,其中包含關於載入此顯示物件所屬之檔案的資訊。
DisplayObject
  maintainProjectionCenter : Boolean
When true, the component keeps its projection matrix centered on the middle of its bounding box.
UIComponent
 Inheritedmask : DisplayObject
呼叫之顯示物件會以指定的 mask 物件遮蓋。
DisplayObject
  maxHeight : Number
The maximum recommended height of the component to be considered by the parent during layout.
UIComponent
  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
 InheritedmetaData : 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
 InheritedmouseChildren : Boolean
判斷物件的子系是否支援啟用滑鼠或使用者輸入裝置。
DisplayObjectContainer
 InheritedmouseEnabled : Boolean
指定此物件是否接收滑鼠或其他使用者輸入及訊息。
InteractiveObject
  mouseFocusEnabled : Boolean
Whether you can receive focus when clicked on.
UIComponent
 InheritedmouseX : Number
[唯讀] 指出滑鼠或使用者輸入裝置位置的 x 座標,以像素為單位。
DisplayObject
 InheritedmouseY : Number
[唯讀] 指出滑鼠或使用者輸入裝置位置的 y 座標,以像素為單位。
DisplayObject
 Inheritedname : String
指出 DisplayObject 的實體名稱。
DisplayObject
 InheritedneedsSoftKeyboard : 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
  numAutomationChildren : int
[唯讀] The number of automation children this container has.
UIComponent
 InheritednumChildren : int
[唯讀] 傳回此物件的子系數量。
DisplayObjectContainer
 InheritedopaqueBackground : 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
 Inheritedroot : 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
 Inheritedscale9Grid : 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
 InheritedscrollRect : Rectangle
顯示物件的捲動矩形範圍。
DisplayObject
  showInAutomationHierarchy : Boolean
A flag that determines if an automation object shows in the automation hierarchy.
UIComponent
 Inherited    softKeyboard : String
控制軟體鍵盤的外觀。
InteractiveObject
 InheritedsoftKeyboardInputAreaOfInterest : Rectangle
定義顯示軟體鍵盤時,應保留於螢幕上的區域 (iOS 未提供)。
InteractiveObject
 InheritedsoundTransform : flash.media:SoundTransform
控制此 Sprite 的聲音。
Sprite
 Inheritedstage : 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
 InheritedtabChildren : Boolean
判斷物件的子系是否支援啟用定位鍵。
DisplayObjectContainer
 InheritedtabEnabled : 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
 InheritedtabIndex : int
會指定 SWF 檔中的物件停駐點順序。
InteractiveObject
 InheritedtextSnapshot : 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
 InheriteduseHandCursor : Boolean
指示當指標滑入 Sprite,且其 buttonMode 屬性設為 true 時,是否要出現指示手掌 (手掌游標) 的 Boolean 值。
Sprite
  validationSubField : String
Used by a validator to associate a subfield with this component.
UIComponent
  verticalCenter : Object
For components, this layout constraint property is a facade on top of the similarly-named style.
UIComponent
  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
  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
保護屬性
 屬性定義自
  currentCSSState : String
[唯讀] The state to be used when matching CSS pseudo-selectors.
UIComponent
  hasComplexLayoutMatrix : Boolean
[唯讀] Returns true if the UIComponent has any non-translation (x,y) transform properties.
UIComponent
  resourceManager : IResourceManager
[唯讀] A reference to the object which manages all of the application's localized resources.
UIComponent
  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
公用方法
 方法定義自
  
Constructor.
UIComponent
 Inherited
將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。
DisplayObjectContainer
 Inherited
將 DisplayObject 子實體加入至此 DisplayObjectContainer 實體。
DisplayObjectContainer
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式,以便讓偵聽程式收到事件的通知。
EventDispatcher
  
Adds a non-visual style client to this component instance.
UIComponent
 Inherited
指出安全性限制是否會造成傳回的清單 (可用指定的 point 點呼叫 DisplayObjectContainer.getObjectsUnderPoint() 方法來取得) 省略任何顯示物件。
DisplayObjectContainer
  
callLater(method:Function, args:Array = null):void
Queues a function to be called later.
UIComponent
  
Deletes a style property from this component instance.
UIComponent
 Inherited
判斷指定的顯示物件是否為 DisplayObjectContainer 實體的子系,或為實體本身。
DisplayObjectContainer
  
Converts a Point object from content coordinates to global coordinates.
UIComponent
  
Converts a Point object from content to local coordinates.
UIComponent
  
Returns a set of properties that identify the child within this container.
UIComponent
  
Returns a set of properties that identify the child within this container.
UIComponent
  
Creates an id reference to this IUIComponent object on its parent document object.
UIComponent
  
Deletes the id reference to this IUIComponent object on its parent document object.
UIComponent
  
Returns a UITextFormat object corresponding to the text styles for this UIComponent.
UIComponent
  
[覆寫] Dispatches an event into the event flow.
UIComponent
  
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
  
Called by the effect instance when it stops playing on the component.
UIComponent
  
Called by the effect instance when it starts playing on the component.
UIComponent
  
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
  
Called after printing is complete.
UIComponent
  
Provides the automation object at the specified index.
UIComponent
  
Provides the automation object list .
UIComponent
 Inherited
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
 Inherited
傳回存在於指定索引位置的子顯示物件實體。
DisplayObjectContainer
 Inherited
傳回具有指定名稱的子顯示物件。
DisplayObjectContainer
 Inherited
傳回 child DisplayObject 實體的索引位置。
DisplayObjectContainer
  
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
  
A convenience method for determining whether to use the explicit or measured height
UIComponent
  
A convenience method for determining whether to use the explicit or measured width
UIComponent
  
Gets the object that currently has focus.
UIComponent
  
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
  
Returns the transform matrix that is used to calculate the component's layout relative to its siblings.
UIComponent
  
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
 Inherited
傳回位於指定點底下,且屬於此 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
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
根據 targetCoordinateSpace 參數所定義的座標系統,並排除形狀上的任何筆畫,傳回可定義顯示物件邊界的矩形。
DisplayObject
  
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
  
Converts a Point object from global to content coordinates.
UIComponent
 Inherited
將 point 物件從「舞台」(全域) 座標轉換成顯示物件的 (區域) 座標。
DisplayObject
 Inherited
將二維點從「舞台」(全域) 座標轉換為三維顯示物件的 (區域) 座標。
DisplayObject
  
Returns true if currentCSSState is not null.
UIComponent
 Inherited
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。
EventDispatcher
 Inherited
指出物件是否有已定義的指定屬性。
Object
  
Determines whether the specified state has been defined on this UIComponent.
UIComponent
 Inherited
評估顯示物件的範圍框,看它是否與 obj 顯示物件的範圍框重疊或相交。
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
評估顯示物件,看它是否與 x 和 y 參數所指定的點重疊或相交。
DisplayObject
  
Returns a box Matrix which can be passed to the drawRoundRect() method as the rot parameter when drawing a horizontal gradient.
UIComponent
  
Initializes the internal structure of this component.
UIComponent
  
Initializes various properties which keep track of repeated instances of this component.
UIComponent
  
Marks a component so that its updateDisplayList() method gets called during a later screen update.
UIComponent
  
Called by a component's items to indicate that their depth property has changed.
UIComponent
  
An element must call this method when its layoutDirection changes or when its parent's layoutDirection changes.
UIComponent
  
Marks a component so that its commitProperties() method gets called during a later screen update.
UIComponent
  
Marks a component so that its measure() method gets called during a later screen update.
UIComponent
 Inherited
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。
Object
 Inherited
將三維顯示物件的 (區域) 座標的三維點轉換為「舞台」(全域) 座標中的二維點。
DisplayObject
  
Converts a Point object from local to content coordinates.
UIComponent
 Inherited
將 point 物件從顯示物件的 (區域) 座標轉換成「舞台」(全域) 座標。
DisplayObject
  
Returns true if cssState matches currentCSSState.
UIComponent
  
Determines whether this instance is the same as, or is a subclass of, the given type.
UIComponent
  
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
  
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
  
Moves the component to a specified position within its parent.
UIComponent
  
Propagates style changes to the children.
UIComponent
  
Returns true if the chain of owner properties points from child to this UIComponent.
UIComponent
  
Called by Flex when a UIComponent object is added to or removed from a parent.
UIComponent
  
Prepares an IFlexDisplayObject for printing.
UIComponent
 Inherited
指出指定的屬性是否存在,以及是否可列舉。
Object
  
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
  
For each effect event, registers the EffectManager as one of the event listeners.
UIComponent
 Inherited
將指定的 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。
DisplayObjectContainer
 Inherited
從 DisplayObjectContainer 子清單中的指定索引位置移除子 DisplayObject。
DisplayObjectContainer
 Inherited
removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void
將所有 child DisplayObject 實體從 DisplayObjectContainer 實體的子清單中移除。
DisplayObjectContainer
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
會從 EventDispatcher 物件移除偵聽程式。
EventDispatcher
  
Removes a non-visual style client from this component instance.
UIComponent
  
Replays the specified event.
UIComponent
 Inherited
升起顯示虛擬鍵盤。
InteractiveObject
  
Resolves a child by using the id provided.
UIComponent
  
[靜態] Resumes the background processing of methods queued by callLater(), after a call to suspendBackgroundProcessing().
UIComponent
  
Sizes the object.
UIComponent
 Inherited
變更顯示物件容器中現有子系的位置。
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
  
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
 Inherited
為迴圈作業設定動態屬性的可用性。
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
 Inherited
startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void
讓使用者拖曳指定的 sprite。
Sprite
 Inherited
startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void
讓使用者將指定的 Sprite 拖曳至觸控裝置上。
Sprite
 Inherited
遞迴停止執行所有 MovieClips 的時間軸根源於此物件。
DisplayObjectContainer
 Inherited
結束 startDrag() 方法。
Sprite
 Inherited
stopTouchDrag(touchPointID:int):void
結束觸控裝置使用的 startTouchDrag() 方法。
Sprite
  
Detects changes to style properties.
UIComponent
  
Flex calls the stylesInitialized() method when the styles for a component are first initialized.
UIComponent
  
[靜態] Blocks the background processing of methods queued by callLater(), until resumeBackgroundProcessing() is called.
UIComponent
 Inherited
替換兩個指定子物件的 z 順序 (深度階層,由前至後順序)。
DisplayObjectContainer
 Inherited
swapChildrenAt(index1:int, index2:int):void
在子清單的兩個指定索引位置,替換子物件的 z 順序 (深度階層,由前至後順序)。
DisplayObjectContainer
 Inherited
傳回代表此物件的字串,根據地區特定慣例進行格式化。
Object
 Inherited
[覆寫] 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
  
Validates the position and size of children and draws other visuals.
UIComponent
  
Validate and update the properties and layout of this object and redraw it, if necessary.
UIComponent
  
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
  
Handles both the valid and invalid events from a validator assigned to this component.
UIComponent
 Inherited
會傳回指定之物件的基本值。
Object
  
Returns a box Matrix which can be passed to drawRoundRect() as the rot parameter when drawing a vertical gradient.
UIComponent
 Inherited
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式,或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。
EventDispatcher
保護方法
 方法定義自
  
Adjust the focus rectangle.
UIComponent
  
Commits the computed matrix built from the combination of the layout matrix and the transform offsets to the flash displayObject's transform.
UIComponent
  
This is an internal method used by the Flex framework to support the Dissolve effect.
UIComponent
  
Determines if the call to the measure() method can be skipped.
UIComponent
  
Performs any final processing after child objects are created.
UIComponent
  
Processes the properties set on the component.
UIComponent
  
Create child objects of the component.
UIComponent
  
Creates a new object using a context based on the embedded font being used.
UIComponent
  
Creates the object using a given moduleFactory.
UIComponent
  
dispatchPropertyChangeEvent(prop:String, oldValue:*, value:*):void
Helper method for dispatching a PropertyChangeEvent when a property is updated.
UIComponent
  
The event handler called when a UIComponent object gets focus.
UIComponent
  
The event handler called when a UIComponent object loses focus.
UIComponent
  
Initializes the implementation and storage of some of the less frequently used advanced layout features of a component.
UIComponent
  
Finalizes the initialization of this component.
UIComponent
  
Initializes this component's accessibility code.
UIComponent
  
Helper method to invalidate parent size and display list if this object affects its layout (includeInLayout is true).
UIComponent
  
Typically overridden by components containing UITextField objects, where the UITextField object gets focus.
UIComponent
  
The event handler called for a keyDown event.
UIComponent
  
The event handler called for a keyUp event.
UIComponent
  
Calculates the default size, and optionally the default minimum size, of the component.
UIComponent
  
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
  
setStretchXY(stretchX:Number, stretchY:Number):void
Specifies a transform stretch factor in the horizontal and vertical direction.
UIComponent
  
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
  
updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void
Draws the object and/or sizes and positions its children.
UIComponent
事件
 事件 摘要 定義自
 Inherited[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。EventDispatcher
  Dispatched when the component is added to a container as a content child by using the addChild(), addChildAt(), addElement(), or addElementAt() method.UIComponent
 Inherited當顯示物件加入顯示清單中時傳送。DisplayObject
 Inherited會在顯示物件加入舞台上的顯示清單時,以直接或是透過加入包含該顯示物件之子樹狀結構的方式傳送。DisplayObject
 Inherited當使用者從文字快顯選單中選取「清除」(或「刪除」) 時傳送。InteractiveObject
 Inherited會當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置主按鈕時傳送。InteractiveObject
 Inherited
    contextMenu
當使用者手勢在 AIR 應用程式中觸發與此互動式物件相關聯的快顯選單時傳送。InteractiveObject
 Inherited當使用者針對複製作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「複製」時傳送。InteractiveObject
  Dispatched when the component has finished its construction, property processing, measuring, layout, and drawing.UIComponent
  Dispatched after the view state has changed.UIComponent
  Dispatched after the currentState property changes, but before the view state changes.UIComponent
 Inherited當使用者針對剪下作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「剪下」時傳送。InteractiveObject
 Inherited[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。EventDispatcher
 Inherited在 InteractiveObject 物件的 doubleClickEnabled 旗標設為 true 的情況下,當使用者在相同的物件上方連續兩次快速按下並放開指標裝置主要按鈕時傳送。InteractiveObject
  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
  Dispatched by the drop target when the user releases the mouse over it.UIComponent
  Dispatched by a component when the user moves the mouse over the component during a drag operation.UIComponent
  Dispatched by the component when the user drags outside the component, but does not drop the data onto the target.UIComponent
  Dispatched by a component when the user moves the mouse while over the component during a drag operation.UIComponent
  Dispatched by the drag initiator when starting a drag operation.UIComponent
  Dispatched after an effect ends.UIComponent
  Dispatched just before an effect starts.UIComponent
  Dispatched after an effect is stopped, which happens only by a call to stop() on the effect.UIComponent
 Inherited[廣播事件] 當播放磁頭進入新影格時傳送。DisplayObject
  Dispatched after the component has entered a view state.UIComponent
 Inherited[廣播事件] 當播放磁頭結束目前影格時傳送。DisplayObject
  Dispatched just before the component exits a view state.UIComponent
 Inherited當顯示物件取得焦點之後傳送。InteractiveObject
 Inherited當顯示物件失去焦點時傳送。InteractiveObject
 Inherited[廣播事件] 在影格顯示物件的建構函式執行之後,且影格指令碼執行之前傳送。DisplayObject
 Inherited當使用者沿著觸控面與 InteractiveObject 實體建立接觸點 (例如沿著 Apple TV 的 Siri Remote 觸控面點選),某些裝置可能也會將此接觸解譯為數個觸控事件的組合。InteractiveObject
 Inherited當使用在觸控裝置上的同一個 InteractiveObject 實體上按下兩個接觸點後送出 (例如在行動電話或平板電腦觸控螢幕的顯示物件上方,以兩支手指按下後鬆開)。InteractiveObject
 Inherited當使用者在觸控裝置上,將接觸點移動到 InteractiveObject 實體上方後傳送 (例如,在行動電話或平板電腦觸控螢幕的顯示物件上,由左向右移動手指)。InteractiveObject
 Inherited當使用者在 InteractiveObject 實體的接觸點上做出旋轉手勢後傳送 (例如兩指觸摸行動電話或平板電腦的觸控螢幕,然後手指在顯示物件上旋轉)。InteractiveObject
 Inherited當使用者在與 InteractiveObject 實體的某個接觸點上做出揮動手勢後傳送 (例如,三指併在一起觸碰行動電話或平板電腦的觸控螢幕,然後在顯示物件上快速平行移動手指)。InteractiveObject
 Inherited當使用者與 InteractiveObject 實體建立接觸點,然後在觸控裝置上點一下後送出 (例如,將多根手指放到行動電話或平板電腦觸控螢幕的顯示物件上以開啟選單,然後其中一根手點一下,選取選單項目)。InteractiveObject
 Inherited當使用者在 InteractiveObject 實體的某個接觸點上做出放大縮小手勢後傳送 (例如兩指併在一起觸摸行動電話或平板電腦的觸控螢幕,然後手指在顯示物件上快速張開)。InteractiveObject
  Dispatched when an object's state changes from visible to invisible.UIComponent
 Inherited這個事件會送出至任何支援 IME 內嵌輸入的用戶端應用程式。InteractiveObject
  Dispatched when the component has finished its construction and has all initialization properties set.UIComponent
  Dispatched when a component is monitored by a Validator and the validation failed.UIComponent
 Inherited會當使用者按下按鍵時傳送。InteractiveObject
 Inherited當使用者嘗試使用鍵盤瀏覽變更焦點時傳送。InteractiveObject
 Inherited會當使用者放開按鍵時傳送。InteractiveObject
 Inherited當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置中間按鈕時傳送。InteractiveObject
 Inherited當使用者將指向裝置的中間按鈕移至 InteractiveObject 實體上方按下時傳送。InteractiveObject
 Inherited當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。InteractiveObject
 Inherited當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。InteractiveObject
  Dispatched from a component opened using the PopUpManager when the user clicks outside it.UIComponent
 Inherited會當使用者嘗試使用指向裝置變更焦點時傳送。InteractiveObject
 Inherited會當指向裝置停在 InteractiveObject 上方的情況下使用者將其移動時傳送。InteractiveObject
 Inherited會當使用者將指向裝置移開 InteractiveObject 實體時傳送。InteractiveObject
 Inherited會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。InteractiveObject
 Inherited當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。InteractiveObject
 Inherited當滑鼠滾輪在 InteractiveObject 實體上方轉動時傳送。InteractiveObject
  Dispatched from a component opened using the PopUpManager when the user scrolls the mouse wheel outside it.UIComponent
  Dispatched when the object has moved.UIComponent
 Inherited當使用者釋放手勢時,由拖曳初始程式 InteractiveObject 傳送。InteractiveObject
 Inherited已在目標 InteractiveObject 上放下拖曳的物件,而且已呼叫 DragManager.acceptDragDrop() 接受該放開的資料時,由此目標 InteractiveObject 傳送。InteractiveObject
 Inherited當手勢進入 InteractiveObject 的邊界時,由此 InteractiveObject 傳送。InteractiveObject
 Inherited當手勢離開 InteractiveObject 的邊界時,由此 InteractiveObject 傳送。InteractiveObject
 Inherited當拖曳手勢還留在 InteractiveObject 的邊界內,由此 InteractiveObject 持續傳送。InteractiveObject
 Inherited在呼叫 DragManager.doDrag() 進行拖曳作業初期,由指定做為拖曳初始程式的 InteractiveObject 傳送。InteractiveObject
 Inherited在呼叫 DragManager.doDrag() 進行拖曳作業期間,由指定做為拖曳初始程式的 InteractiveObject 傳送。InteractiveObject
 Inherited當使用者針對貼上作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「貼上」時傳送。InteractiveObject
  Dispatched at the beginning of the component initialization sequence.UIComponent
 Inherited在使用者將作用中觸控筆往下移至超過螢幕鄰近偵測邊框時傳送。InteractiveObject
 Inherited
    proximityEnd
在使用者將作用中觸控筆提到螢幕鄰近偵測邊框時傳送。InteractiveObject
 Inherited在使用者將作用中觸控筆移到螢幕上方,而其餘仍在鄰近偵測邊框內時傳送。InteractiveObject
 Inherited
    proximityOut
在使用者將作用中觸控筆移出這個 InteractiveObject 之外,而其餘仍在螢幕的鄰近偵測邊框內時傳送。InteractiveObject
 Inherited在使用者直接將作用中觸控筆移到這個 InteractiveObject 上方,而其餘仍在螢幕的鄰近偵測邊框內時傳送。InteractiveObject
 Inherited在使用者將作用中觸控筆移出這個 InteractiveObject 及其任一子系之外,而其餘仍在螢幕的鄰近偵測邊框內時傳送。InteractiveObject
 Inherited在使用者透過這個 InteractiveObject,從顯示清單中後代的物件樹狀結構之外移動作用中觸控筆時傳送 (而其餘仍在螢幕的鄰近偵測邊框內)。InteractiveObject
 Inherited當使用者第一次按下 InteractiveObject 實體上方的按鈕,然後將指向裝置滑出 InteractiveObject 實體之後即放開指向裝置上的按鈕時傳送。InteractiveObject
  Dispatched when the component is removed from a container as a content child by using the removeChild(), removeChildAt(), removeElement(), or removeElementAt() method.UIComponent
 Inherited會當顯示物件將要從顯示清單移除時傳送。DisplayObject
 Inherited會在顯示物件即將從顯示清單移除時,以直接或是透過移除包含該顯示物件之子樹狀結構的方式傳送。DisplayObject
 Inherited[廣播事件] 當顯示清單將要更新和顯示時傳送。DisplayObject
  Dispatched when the component is resized.UIComponent
 Inherited當使用者在相同的 InteractiveObject 上方按下並放開使用者的指向裝置右邊按鈕時傳送。InteractiveObject
 Inherited當使用者將指向裝置按鈕移至 InteractiveObject 實體上方按下時傳送。InteractiveObject
 Inherited當使用者將指向裝置按鈕移至 InteractiveObject 實體上方放開時傳送。InteractiveObject
 Inherited會當使用者將指向裝置移開 InteractiveObject 實體時傳送。InteractiveObject
 Inherited會當使用者將指向裝置移至 InteractiveObject 實體上方時傳送。InteractiveObject
 Inherited當使用者針對全選作業啟動平台特有的快速鍵組合或從文字快顯選單中選取「全選」時傳送。InteractiveObject
  Dispatched when an object's state changes from invisible to visible.UIComponent
 Inherited升起顯示軟體鍵盤之後立即傳送。InteractiveObject
 Inherited升起顯示軟體鍵盤前立即傳送。InteractiveObject
 Inherited降下隱藏軟體鍵盤之後立即傳送。InteractiveObject
  Dispatched after the component has entered a new state and any state transition animation to that state has finished playing.UIComponent
  Dispatched when a component interrupts a transition to its current state in order to switch to a new state.UIComponent
 Inherited在物件的 tabChildren 旗標值變更時傳送。InteractiveObject
 Inherited在物件的 tabEnabled 旗標變更時傳送。InteractiveObject
 Inherited在物件的 tabIndex 屬性值變更時傳送。InteractiveObject
 Inherited當使用者輸入一或多文字的字元時送出。InteractiveObject
  Dispatched by the component when it is time to create a ToolTip.UIComponent
  Dispatched by the component when its ToolTip has been hidden and is to be discarded soon.UIComponent
  Dispatched by the component when its ToolTip is about to be hidden.UIComponent
  Dispatched by the component when its ToolTip is about to be shown.UIComponent
  Dispatched by the component when its ToolTip has been shown.UIComponent
  Dispatched by a component whose toolTip property is set, as soon as the user moves the mouse over it.UIComponent
 Inherited當使用者在第一次接觸觸控裝置後傳送 (例如手指觸摸行動電話或平板電腦的觸控螢幕)。InteractiveObject
 Inherited當使用者在觸控裝置上移除接觸點後傳送 (例如在行動電話或平板電腦觸控螢幕上移開手指)。InteractiveObject
  A non-cancellable event, dispatched by a component when it is done responding to a touch interaction user gesture.UIComponent
  A non-cancellable event, dispatched by a component when it starts responding to a touch interaction user gesture.UIComponent
  A cancellable event, dispatched by a component in an attempt to respond to a touch interaction user gesture.UIComponent
 Inherited當使用者觸控裝置時傳送,並且連續不斷地傳送,直到接觸點移除為止。InteractiveObject
 Inherited當使用者在觸控裝置中,將接觸點移出 InteractiveObject 實體後送出 (例如在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件移至另一個顯示物件)。InteractiveObject
 Inherited當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件外面的某一點,往顯示物件上方拖曳)。InteractiveObject
 Inherited當使用者在觸控裝置上,將接觸點從 InteractiveObject 實體移出後送出 (例如,在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件上方拖曳到顯示物件以外)。InteractiveObject
 Inherited當使用者在觸控裝置中將接觸點移至 InteractiveObject 實體上方後送出 (例如在行動電話或平板電腦的觸控螢幕上,將手指從顯示物件外面的某一點,往顯示物件上方拖曳)。InteractiveObject
 Inherited當使用者在觸控裝置的同一個 InteractiveObject 實體上,在原先開始接觸點放開後送出 (例如在行動電話或平板電腦觸控螢幕上的顯示物件上方,以手指按下某個點後又鬆開)。InteractiveObject
  Dispatched when an object has had its commitProperties(), measure(), and updateDisplayList() methods called (if needed).UIComponent
  Dispatched when a component is monitored by a Validator and the validation succeeded.UIComponent
  Dispatched when values are changed programmatically or by user interaction.UIComponent
樣式

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

一般樣式
 樣式 說明 定義自
  
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. If this style is set, the baseline of the component is anchored to the top edge of its content area; when its container is resized, the two edges maintain their separation.

This style only has an effect when used on a component in a Canvas container, or when used on a component in a Panel or Application container that has the layout property set to absolute.

The default value is undefined, which means it is not set.

UIComponent
  
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. If this style is set, the lower edge of the component is anchored to the bottom edge of its content area; when its container is resized, the two edges maintain their separation.

This style only has an effect when used on a component in a Canvas container, or when used on a component in a Panel or Application container that has the layout property set to absolute.

The default value is undefined, which means it is not set.

UIComponent
  
errorColor
類型: uint 格式: Color CSS 繼承:
語言版本: ActionScript 3.0  產品版本: Flex 3  執行階段版本: Flash9, AIR 1.1

Color of the component highlight when validation fails. Flex also sets the borderColor style of the component to this errorColor on a validation failure. The default value for the Halo theme is 0xFF0000. The default value for the Spark theme is 0xFE0000.
UIComponent
  
focusBlendMode
類型: String CSS 繼承:
語言版本: ActionScript 3.0  產品版本: Flex 3  執行階段版本: Flash9, AIR 1.1

Blend mode used by the focus rectangle. For more information, see the blendMode property of the flash.display.DisplayObject class. 預設值為 "normal"
UIComponent
  
focusSkin
類型: Class CSS 繼承:
語言版本: ActionScript 3.0  產品版本: Flex 3  執行階段版本: Flash9, AIR 1.1

Skin used to draw the focus rectangle. The default value for Halo components is mx.skins.halo.HaloFocusRect. The default value for Spark components is spark.skins.spark.FocusSkin.
UIComponent
  
focusThickness
類型: Number 格式: Length CSS 繼承:
語言版本: ActionScript 3.0  產品版本: Flex 3  執行階段版本: Flash9, AIR 1.1

Thickness, in pixels, of the focus rectangle outline. 預設值為 2
UIComponent
  
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. If this style is set, the center of the component is anchored to the center of its content area; when its container is resized, the two centers maintain their horizontal separation.

This style only has an effect when used on a component in a Canvas container, or when used on a component in a Panel or Application container that has the layout property set to absolute.

The default value is undefined, which means it is not set.

UIComponent
  
interactionMode
類型: String CSS 繼承:
語言版本: ActionScript 3.0  產品版本: Flex 4.5  執行階段版本: Flash10, AIR 2.5

The primary interaction mode for this component. The acceptable values are: mouse and touch. The default value for the Halo theme is mouse. The default value for the Spark theme is mouse. The default value for the Mobile theme is touch.

相關 API 元素

UIComponent
  
layoutDirection
類型: String CSS 繼承:
語言版本: ActionScript 3.0  產品版本: Flex 4.1  執行階段版本: Flash10, AIR 1.5

Specifies the desired layout direction of a component. The allowed values are "ltr" for left-to-right layout, used for components using Latin-style scripts, and "rtl" for right-to-left layout, used for components using scripts such as Arabic and Hebrew.

In ActionScript you can set the layoutDirection using the values mx.core.LayoutDirection.LTR, mx.core.LayoutDirection.RTL or undefined, to inherit the layoutDirection from the parent.

The layoutDirection should typically be set on the Application rather than on individual components. If the layoutDirection is "rtl", most visual elements, except text and images, will be mirrored. The directionality of text is determined by the direction style.

Components which handle Keyboard.LEFT and Keyboard.RIGHT events typically swap the key’s meaning when layoutDirection is “rtl”. In other words, left always means move left and right always means move right, regardless of the layoutDirection

Note: This style applies to all Spark components and MX components that specify UIFTETextField as their textFieldClass.

預設值為 "ltr"

相關 API 元素

UIComponent
  
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. If this style is set, the left edge of the component is anchored to the left edge of its content area; when its container is resized, the two edges maintain their separation.

This style only has an effect when used on a component in a Canvas container, or when used on a component in a Panel or Application container that has the layout property set to absolute.

The default value is undefined, which means it is not set.

UIComponent
  
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. If this style is set, the right edge of the component is anchored to the right edge of its content area; when its container is resized, the two edges maintain their separation.

This style only has an effect when used on a component in a Canvas container, or when used on a component in a Panel or Application container that has the layout property set to absolute.

The default value is undefined, which means it is not set.

UIComponent
  
showErrorSkin
類型: Boolean CSS 繼承:
語言版本: ActionScript 3.0  產品版本: Flex 4.5  執行階段版本: Flash10, AIR 1.5

Show the error border or skin when this component is invalid 預設值為 true
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 預設值為 true
UIComponent
  
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. If this style is set, the top edge of the component is anchored to the top edge of its content area; when its container is resized, the two edges maintain their separation.

This style only has an effect when used on a component in a Canvas container, or when used on a component in a Panel or Application container that has the layout property set to absolute.

The default value is undefined, which means it is not set.

UIComponent
  
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. If this style is set, the center of the component is anchored to the center of its content area; when its container is resized, the two centers maintain their vertical separation.

This style only has an effect when used on a component in a Canvas container, or when used on a component in a Panel or Application container that has the layout property set to absolute.

The default value is undefined, which means it is not set.

UIComponent
Spark 主題樣式
 樣式 說明 定義自
  
chromeColor
類型: uint 格式: Color CSS 繼承: 是 主題: spark
語言版本: ActionScript 3.0  產品版本: Flex 4  執行階段版本: Flash10, AIR 1.5

The main color for a component.
UIComponent
Halo 主題樣式
 樣式 說明 定義自
  
themeColor
類型: uint 格式: Color CSS 繼承: 是 主題: halo
語言版本: ActionScript 3.0  產品版本: Flex 3  執行階段版本: Flash9, AIR 1.1

Theme color of a component. This property controls the appearance of highlights, appearance when a component is selected, and other similar visual cues, but it does not have any effect on the regular borders or background colors of the component. The preferred values are haloGreen, haloBlue, haloOrange, and haloSilver, although any valid color value can be used.

The default values of the rollOverColor and selectionColor styles are based on the themeColor value.

預設值為 "haloBlue"
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
公用常數
 常數定義自
  DEFAULT_MAX_HEIGHT : Number = 10000
[靜態] The default value for the maxHeight property.
UIComponent
  DEFAULT_MAX_WIDTH : Number = 10000
[靜態] The default value for the maxWidth property.
UIComponent
  DEFAULT_MEASURED_HEIGHT : Number = 22
[靜態] The default value for the measuredHeight property.
UIComponent
  DEFAULT_MEASURED_MIN_HEIGHT : Number = 22
[靜態] The default value for the measuredMinHeight property.
UIComponent
  DEFAULT_MEASURED_MIN_WIDTH : Number = 40
[靜態] The default value for the measuredMinWidth property.
UIComponent
  DEFAULT_MEASURED_WIDTH : Number = 160
[靜態] The default value for the measuredWidth property.
UIComponent
屬性詳細資訊

accessibilityDescription

屬性
accessibilityDescription:String

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A convenience accessor for the description property in this UIComponent's accessibilityProperties object.

The getter simply returns accessibilityProperties.description, or "" if accessibilityProperties is null. The setter first checks whether accessibilityProperties is null, and if it is, sets it to a new AccessibilityProperties instance. Then it sets accessibilityProperties.description.



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

accessibilityEnabled

屬性 
accessibilityEnabled:Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A convenience accessor for the silent property in this UIComponent's accessibilityProperties object.

Note that accessibilityEnabled has the opposite sense from silent; accessibilityEnabled is true when silent is false.

The getter simply returns accessibilityProperties.silent, or true if accessibilityProperties is null. The setter first checks whether accessibilityProperties is null, and if it is, sets it to a new AccessibilityProperties instance. Then it sets accessibilityProperties.silent.



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

accessibilityName

屬性 
accessibilityName:String

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A convenience accessor for the name property in this UIComponent's accessibilityProperties object.

The getter simply returns accessibilityProperties.name, or "" if accessibilityProperties is null. The setter first checks whether accessibilityProperties is null, and if it is, sets it to a new AccessibilityProperties instance. Then it sets accessibilityProperties.name.



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

accessibilityShortcut

屬性 
accessibilityShortcut:String

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A convenience accessor for the shortcut property in this UIComponent's accessibilityProperties object.

The getter simply returns accessibilityProperties.shortcut, or "" if accessibilityProperties is null. The setter first checks whether accessibilityProperties is null, and if it is, sets it to a new AccessibilityProperties instance. Then it sets accessibilityProperties.shortcut.



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

activeEffects

屬性 
activeEffects:Array  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The list of effects that are currently playing on the component, as an Array of EffectInstance instances.



實作
    public function get activeEffects():Array

automationDelegate

屬性 
automationDelegate:Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The delegate object that handles the automation-related functionality.



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

automationEnabled

屬性 
automationEnabled:Boolean  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 9, AIR 1.1

True if this component is enabled for automation, false otherwise.



實作
    public function get automationEnabled():Boolean

automationName

屬性 
automationName:String

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Name that can be used as an identifier for this object.



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

automationOwner

屬性 
automationOwner:DisplayObjectContainer  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 9, AIR 1.1

The owner of this component for automation purposes.



實作
    public function get automationOwner():DisplayObjectContainer

automationParent

屬性 
automationParent:DisplayObjectContainer  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 9, AIR 1.1

The parent of this component for automation purposes.



實作
    public function get automationParent():DisplayObjectContainer

automationTabularData

屬性 
automationTabularData:Object  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

An implementation of the IAutomationTabularData interface, which can be used to retrieve the data.



實作
    public function get automationTabularData():Object

automationValue

屬性 
automationValue:Array  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

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.



實作
    public function get automationValue():Array

automationVisible

屬性 
automationVisible:Boolean  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 9, AIR 1.1

True if this component is visible for automation, false otherwise.



實作
    public function get automationVisible():Boolean

baseline

屬性 
baseline:Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

For components, this layout constraint property is a facade on top of the similarly-named style. To set the property to its default value of undefined, use the @Clear() directive in MXML or the undefined value in ActionScript code. For example, in MXML code, baseline.s2="@Clear()" unsets the baseline constraint in state s2. Or in ActionScript code, button.baseline = undefined unsets the baseline constraint on button.

The vertical distance in pixels from the anchor target to the control's baseline position.

By default the anchor target is the top edge of the container's content area. In layouts with advanced constraints, the target can be a constraint row.

Setting the property to a number or to a numerical string like "10" specifies use of the default anchor target.

To specify an anchor target, set the property value to a string in the format: "anchorTargetName:value". For example, "row1:10".



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

baselinePosition

屬性 
baselinePosition:Number  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The y-coordinate of the baseline of the first line of text of the component.

This property is used to implement the baseline constraint style. It is also used to align the label of a FormItem with the controls in the FormItem.



實作
    public function get baselinePosition():Number

bottom

屬性 
bottom:Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

For components, this layout constraint property is a facade on top of the similarly-named style. To set the property to its default value of undefined, use the @Clear() directive in MXML or the undefined value in ActionScript code. For example, in MXML code, bottom.s2="@Clear()" unsets the bottom constraint in state s2. Or in ActionScript code, button.bottom = undefined unsets the bottom constraint on button.

The vertical distance in pixels from the bottom edge of the component to the anchor target's bottom edge.

By default the anchor target is the container's content area. In layouts with advanced constraints, the target can be a constraint row.

Setting the property to a number or to a numerical string like "10" specifies use of the default anchor target.

To specify an anchor target, set the property value to a string in the format: "anchorTargetName:value". For example, "row1:10".



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

cacheHeuristic

屬性 
cacheHeuristic:Boolean  [唯寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Used by Flex to suggest bitmap caching for the object. If cachePolicy is UIComponentCachePolicy.AUTO, then cacheHeuristic is used to control the object's cacheAsBitmap property.



實作
    public function set cacheHeuristic(value:Boolean):void

cachePolicy

屬性 
cachePolicy:String

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Specifies the bitmap caching policy for this object. Possible values in MXML are "on", "off" and "auto" (default).

Possible values in ActionScript are UIComponentCachePolicy.ON, UIComponentCachePolicy.OFF and UIComponentCachePolicy.AUTO (default).

  • A value of UIComponentCachePolicy.ON means that the object is always cached as a bitmap.
  • A value of UIComponentCachePolicy.OFF means that the object is never cached as a bitmap.
  • A value of UIComponentCachePolicy.AUTO means that the framework uses heuristics to decide whether the object should be cached as a bitmap.

預設值為 UIComponentCachePolicy.AUTO。



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

className

屬性 
className:String  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The name of this instance's class, such as "Button".

This string does not include the package name. If you need the package name as well, call the getQualifiedClassName() method in the flash.utils package. It returns a string such as "mx.controls::Button".



實作
    public function get className():String

contentMouseX

屬性 
contentMouseX:Number  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Returns the x position of the mouse, in the content coordinate system. Content coordinates specify a pixel position relative to the upper left corner of the component's content, and include all of the component's content area, including any regions that are currently clipped and must be accessed by scrolling the component.



實作
    public function get contentMouseX():Number

contentMouseY

屬性 
contentMouseY:Number  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Returns the y position of the mouse, in the content coordinate system. Content coordinates specify a pixel position relative to the upper left corner of the component's content, and include all of the component's content area, including any regions that are currently clipped and must be accessed by scrolling the component.



實作
    public function get contentMouseY():Number

currentCSSState

屬性 
currentCSSState:String  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 4.5
執行階段版本: Flash Player 10, AIR 2.5

The state to be used when matching CSS pseudo-selectors. By default this is the currentState.



實作
    protected function get currentCSSState():String

currentState

屬性 
currentState:String

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The current view state of the component. Set to "" or null to reset the component back to its base state.

When you use this property to set a component's state, Flex applies any transition you have defined. You can also use the setCurrentState() method to set the current state; this method can optionally change states without applying a transition.

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



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

相關 API 元素

cursorManager

屬性 
cursorManager:ICursorManager  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Gets the CursorManager that controls the cursor for this component and its peers. Each top-level window has its own instance of a CursorManager; To make sure you're talking to the right one, use this method.



實作
    public function get cursorManager():ICursorManager

depth

屬性 
depth:Number

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Determines the order in which items inside of containers are rendered. Spark containers order their items based on their depth property, with the lowest depth in the back, and the higher in the front. Items with the same depth value appear in the order they are added to the container.



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

descriptor

屬性 
descriptor:UIComponentDescriptor

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Reference to the UIComponentDescriptor, if any, that was used by the createComponentFromDescriptor() method to create this UIComponent instance. If this UIComponent instance was not created from a descriptor, this property is null.



實作
    public function get descriptor():UIComponentDescriptor
    public function set descriptor(value:UIComponentDescriptor):void

相關 API 元素

designLayer

屬性 
designLayer:DesignLayer

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Specifies the optional DesignLayer instance associated with this visual element.

When a DesignLayer is assigned, a visual element must consider the visibility and alpha of its parent layer when ultimately committing its own effective visibility or alpha to its backing DisplayObject (if applicable).

A visual element must listen for layerPropertyChange notifications from the associated layer parent. When the effectiveAlpha or effectiveVisibility of the layer changes, the element must then compute its own effective visibility (or alpha) and apply it accordingly.

This property should not be set within MXML directly.

The designLayer property is not used for z-order control, please see depth.



實作
    public function get designLayer():DesignLayer
    public function set designLayer(value:DesignLayer):void

document

屬性 
document:Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A reference to the document object associated with this UIComponent. A document object is an Object at the top of the hierarchy of a Flex application, MXML component, or AS component.



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

doubleClickEnabled

屬性 
doubleClickEnabled:Boolean[覆寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Specifies whether the UIComponent object receives doubleClick events. The default value is false, which means that the UIComponent object does not receive doubleClick events.

The mouseEnabled property must also be set to true, its default value, for the object to receive doubleClick events.

預設值為 false。



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

enabled

屬性 
enabled:Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Whether the component can accept user interaction. After setting the enabled property to false, some components still respond to mouse interactions such as mouseOver. As a result, to fully disable UIComponents, you should also set the value of the mouseEnabled property to false. If you set the enabled property to false for a container, Flex dims the color of the container and of all of its children, and blocks user input to the container and to all of its children.

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



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

errorString

屬性 
errorString:String

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The text that displayed by a component's error tip when a component is monitored by a Validator and validation fails.

You can use the errorString property to show a validation error for a component, without actually using a validator class. When you write a String value to the errorString property, Flex draws a red border around the component to indicate the validation error, and the String appears in a tooltip as the validation error message when you move the mouse over the component, just as if a validator detected a validation error.

To clear the validation error, write an empty String, "", to the errorString property.

Note that writing a value to the errorString property does not trigger the valid or invalid events; it only changes the border color and displays the validation error message.

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



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

explicitHeight

屬性 
explicitHeight:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Number that specifies the explicit height of the component, in pixels, in the component's coordinates.

This value is used by the container in calculating the size and position of the component. It is not used by the component itself in determining its default size. Thus this property may not have any effect if parented by Container, or containers that don't factor in this property. Because the value is in component coordinates, the true explicitHeight with respect to its parent is affected by the scaleY property.

Setting the height property also sets this property to the specified height value.

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



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

explicitMaxHeight

屬性 
explicitMaxHeight:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The maximum recommended height of the component to be considered by the parent during layout. This value is in the component's coordinates, in pixels.

Application developers typically do not set the explicitMaxHeight property. Instead, they set the value of the maxHeight property, which sets the explicitMaxHeight property. The value of maxHeight does not change.

At layout time, if maxHeight was explicitly set by the application developer, then the value of explicitMaxHeight is used. Otherwise, the default value for maxHeight is used.

This value is used by the container in calculating the size and position of the component. It is not used by the component itself in determining its default size. Thus this property may not have any effect if parented by Container, or containers that don't factor in this property. Because the value is in component coordinates, the true maxHeight with respect to its parent is affected by the scaleY property. Some components have no theoretical limit to their height. In those cases their maxHeight is set to UIComponent.DEFAULT_MAX_HEIGHT.

預設值為 NaN。

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



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

explicitMaxWidth

屬性 
explicitMaxWidth:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The maximum recommended width of the component to be considered by the parent during layout. This value is in the component's coordinates, in pixels.

Application developers typically do not set the explicitMaxWidth property. Instead, they set the value of the maxWidth property, which sets the explicitMaxWidth property. The value of maxWidth does not change.

At layout time, if maxWidth was explicitly set by the application developer, then the value of explicitMaxWidth is used. Otherwise, the default value for maxWidth is used.

This value is used by the container in calculating the size and position of the component. It is not used by the component itself in determining its default size. Thus this property may not have any effect if parented by Container, or containers that don't factor in this property. Because the value is in component coordinates, the true maxWidth with respect to its parent is affected by the scaleX property. Some components have no theoretical limit to their width. In those cases their maxWidth is set to UIComponent.DEFAULT_MAX_WIDTH.

預設值為 NaN。

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



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

explicitMinHeight

屬性 
explicitMinHeight:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The minimum recommended height of the component to be considered by the parent during layout. This value is in the component's coordinates, in pixels.

Application developers typically do not set the explicitMinHeight property. Instead, they set the value of the minHeight property, which sets the explicitMinHeight property. The value of minHeight does not change.

At layout time, if minHeight was explicitly set by the application developer, then the value of explicitMinHeight is used. Otherwise, the value of measuredMinHeight is used.

This value is used by the container in calculating the size and position of the component. It is not used by the component itself in determining its default size. Thus this property may not have any effect if parented by Container, or containers that don't factor in this property. Because the value is in component coordinates, the true minHeight with respect to its parent is affected by the scaleY property.

預設值為 NaN。

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



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

explicitMinWidth

屬性 
explicitMinWidth:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The minimum recommended width of the component to be considered by the parent during layout. This value is in the component's coordinates, in pixels.

Application developers typically do not set the explicitMinWidth property. Instead, they set the value of the minWidth property, which sets the explicitMinWidth property. The value of minWidth does not change.

At layout time, if minWidth was explicitly set by the application developer, then the value of explicitMinWidth is used. Otherwise, the value of measuredMinWidth is used.

This value is used by the container in calculating the size and position of the component. It is not used by the component itself in determining its default size. Thus this property may not have any effect if parented by Container, or containers that don't factor in this property. Because the value is in component coordinates, the true minWidth with respect to its parent is affected by the scaleX property.

預設值為 NaN。

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



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

explicitWidth

屬性 
explicitWidth:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Number that specifies the explicit width of the component, in pixels, in the component's coordinates.

This value is used by the container in calculating the size and position of the component. It is not used by the component itself in determining its default size. Thus this property may not have any effect if parented by Container, or containers that don't factor in this property. Because the value is in component coordinates, the true explicitWidth with respect to its parent is affected by the scaleX property.

Setting the width property also sets this property to the specified width value.

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



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

flexContextMenu

屬性 
flexContextMenu:IFlexContextMenu

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The context menu for this UIComponent.

預設值為 null。



實作
    public function get flexContextMenu():IFlexContextMenu
    public function set flexContextMenu(value:IFlexContextMenu):void

focusEnabled

屬性 
focusEnabled:Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Indicates whether the component can receive focus when tabbed to. You can set focusEnabled to false when a UIComponent is used as a subcomponent of another component so that the outer component becomes the focusable entity. If this property is false, focus is transferred to the first parent that has focusEnable set to true.

The default value is true, except for the spark.components.Scroller component. For that component, the default value is false.



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

相關 API 元素

focusManager

屬性 
focusManager:IFocusManager

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Gets the FocusManager that controls focus for this component and its peers. Each popup has its own focus loop and therefore its own instance of a FocusManager. To make sure you're talking to the right one, use this method.



實作
    public function get focusManager():IFocusManager
    public function set focusManager(value:IFocusManager):void

focusPane

屬性 
focusPane:Sprite

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The focus pane associated with this object. An object has a focus pane when one of its children has focus.



實作
    public function get focusPane():Sprite
    public function set focusPane(value:Sprite):void

hasComplexLayoutMatrix

屬性 
hasComplexLayoutMatrix:Boolean  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns true if the UIComponent has any non-translation (x,y) transform properties.



實作
    protected function get hasComplexLayoutMatrix():Boolean

hasFocusableChildren

屬性 
hasFocusableChildren:Boolean

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

A flag that indicates whether child objects can receive focus.

Note: This property is similar to the tabChildren property used by Flash Player. Use the hasFocusableChildren property with Flex applications. Do not use the tabChildren property.

This property is usually false because most components either receive focus themselves or delegate focus to a single internal sub-component and appear as if the component has received focus. For example, a TextInput control contains a focusable child RichEditableText control, but while the RichEditableText sub-component actually receives focus, it appears as if the TextInput has focus. TextInput sets hasFocusableChildren to false because TextInput is considered the component that has focus. Its internal structure is an abstraction.

Usually only navigator components, such as TabNavigator and Accordion, have this flag set to true because they receive focus on Tab but focus goes to components in the child containers on further Tabs.

The default value is false, except for the spark.components.Scroller component. For that component, the default value is true.

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



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

相關 API 元素

hasLayoutMatrix3D

屬性 
hasLayoutMatrix3D:Boolean  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Contains true if the element has 3D Matrix.

Use hasLayoutMatrix3D instead of calling and examining the return value of getLayoutMatrix3D() because that method returns a valid matrix even when the element is in 2D.



實作
    public function get hasLayoutMatrix3D():Boolean

height

屬性 
height:Number[覆寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Number that specifies the height of the component, in pixels, in the parent's coordinates. The default value is 0, but this property contains the actual component height after Flex completes sizing the components in your application.

Note: You can specify a percentage value in the MXML height attribute, such as height="100%", but you cannot use a percentage value for the height property in ActionScript; use the percentHeight property instead.

Setting this property causes a resize event to be dispatched. See the resize event for details on when this event is dispatched.

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



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

相關 API 元素

horizontalCenter

屬性 
horizontalCenter:Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

For components, this layout constraint property is a facade on top of the similarly-named style. To set the property to its default value of undefined, use the @Clear() directive in MXML or the undefined value in ActionScript code. For example, in MXML code, horizontalCenter.s2="@Clear()" unsets the horizontalCenter constraint in state s2. Or in ActionScript code, button.horizontalCenter = undefined unsets the horizontalCenter constraint on button.

The horizontal distance in pixels from the center of the component to the center of the anchor target's content area.

The default anchor target is the container itself.

In layouts with advanced constraints, the anchor target can be a constraint column. Then the content area is the space between the preceding column (or container side) and the target column.

Setting the property to a number or to a numerical string like "10" specifies use of the default anchor target.

To specify an anchor target, set the property value to a string in the format "constraintColumnId:value". For example, "col1:10".



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

id

屬性 
id:String

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

ID of the component. This value becomes the instance name of the object and should not contain any white space or special characters. Each component throughout an application should have a unique id.

If your application is going to be tested by third party tools, give each component a meaningful id. Testing tools use ids to represent the control in their scripts and having a meaningful name can make scripts more readable. For example, set the value of a button to submit_button rather than b1 or button1.



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

includeInLayout

屬性 
includeInLayout:Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Specifies whether this component is included in the layout of the parent container. If true, the object is included in its parent container's layout and is sized and positioned by its parent container as per its layout rules. If false, the object size and position are not affected by its parent container's layout.

預設值為 true。

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



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

inheritingStyles

屬性 
inheritingStyles:Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The beginning of this component's chain of inheriting styles. The getStyle() method simply accesses inheritingStyles[styleName] to search the entire prototype-linked chain. This object is set up by initProtoChain(). Developers typically never need to access this property directly.



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

initialized

屬性 
initialized:Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A flag that determines if an object has been through all three phases of layout: commitment, measurement, and layout (provided that any were required).



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

instanceIndex

屬性 
instanceIndex:int  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The index of a repeated component. If the component is not within a Repeater, the value is -1.



實作
    public function get instanceIndex():int

instanceIndices

屬性 
instanceIndices:Array

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

An Array containing the indices required to reference this UIComponent object from its parent document. The Array is empty unless this UIComponent object is within one or more Repeaters. The first element corresponds to the outermost Repeater. For example, if the id is "b" and instanceIndices is [2,4], you would reference it on the parent document as b[2][4].



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

is3D

屬性 
is3D:Boolean  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Contains true when the element is in 3D. The element can be in 3D either because it has 3D transform properties or it has 3D post layout transform offsets or both.



實作
    public function get is3D():Boolean

isDocument

屬性 
isDocument:Boolean  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Contains true if this UIComponent instance is a document object. That means it is at the top of the hierarchy of a Flex application, MXML component, or ActionScript component.



實作
    public function get isDocument():Boolean

isPopUp

屬性 
isPopUp:Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Set to true by the PopUpManager to indicate that component has been popped up.



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

layoutMatrix3D

屬性 
layoutMatrix3D:Matrix3D  [唯寫]

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

The transform matrix that is used to calculate a component's layout relative to its siblings. This matrix is defined by the component's 3D properties (which include the 2D properties such as x, y, rotation, scaleX, scaleY, transformX, and transformY, as well as rotationX, rotationY, scaleZ, z, and transformZ.

Most components do not have any 3D transform properties set on them.

This layout matrix is combined with the values of the postLayoutTransformOffsets property to determine the component's final, computed matrix.



實作
    public function set layoutMatrix3D(value:Matrix3D):void

相關 API 元素

left

屬性 
left:Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

For components, this layout constraint property is a facade on top of the similarly-named style. To set a state-specific value of the property in MXML to its default value of undefined, use the @Clear() directive. For example, in MXML code, left.s2="@Clear()" unsets the left constraint in state s2. Or in ActionScript code, button.left = undefined unsets the left constraint on button.

The horizontal distance in pixels from the left edge of the component to the anchor target's left edge.

By default the anchor target is the container's content area. In layouts with advanced constraints, the target can be a constraint column.

Setting the property to a number or to a numerical string like "10" specifies use of the default anchor target.

To specify an anchor target, set the property value to a string in the format "anchorTargetName:value". For example, "col1:10".



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

maintainProjectionCenter

屬性 
maintainProjectionCenter:Boolean

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

When true, the component keeps its projection matrix centered on the middle of its bounding box. If no projection matrix is defined on the component, one is added automatically.



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

maxHeight

屬性 
maxHeight:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The maximum recommended height of the component to be considered by the parent during layout. This value is in the component's coordinates, in pixels. The default value of this property is set by the component developer.

The component developer uses this property to set an upper limit on the height of the component.

If the application developer overrides the default value of maxHeight, the new value is stored in explicitMaxHeight. The default value of maxHeight does not change. As a result, at layout time, if maxHeight was explicitly set by the application developer, then the value of explicitMaxHeight is used for the component's maximum recommended height. If maxHeight is not set explicitly by the user, then the default value is used.

This value is used by the container in calculating the size and position of the component. It is not used by the component itself in determining its default size. Thus this property may not have any effect if parented by Container, or containers that don't factor in this property. Because the value is in component coordinates, the true maxHeight with respect to its parent is affected by the scaleY property. Some components have no theoretical limit to their height. In those cases their maxHeight is set to UIComponent.DEFAULT_MAX_HEIGHT.

預設值為 10000。

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



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

maxWidth

屬性 
maxWidth:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The maximum recommended width of the component to be considered by the parent during layout. This value is in the component's coordinates, in pixels. The default value of this property is set by the component developer.

The component developer uses this property to set an upper limit on the width of the component.

If the application developer overrides the default value of maxWidth, the new value is stored in explicitMaxWidth. The default value of maxWidth does not change. As a result, at layout time, if maxWidth was explicitly set by the application developer, then the value of explicitMaxWidth is used for the component's maximum recommended width. If maxWidth is not set explicitly by the user, then the default value is used.

This value is used by the container in calculating the size and position of the component. It is not used by the component itself in determining its default size. Thus this property may not have any effect if parented by Container, or containers that don't factor in this property. Because the value is in component coordinates, the true maxWidth with respect to its parent is affected by the scaleX property. Some components have no theoretical limit to their width. In those cases their maxWidth is set to UIComponent.DEFAULT_MAX_WIDTH.

預設值為 10000。

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



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

measuredHeight

屬性 
measuredHeight:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The default height of the component, in pixels. This value is set by the measure() method.



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

measuredMinHeight

屬性 
measuredMinHeight:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The default minimum height of the component, in pixels. This value is set by the measure() method.



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

measuredMinWidth

屬性 
measuredMinWidth:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The default minimum width of the component, in pixels. This value is set by the measure() method.



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

measuredWidth

屬性 
measuredWidth:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The default width of the component, in pixels. This value is set by the measure() method.



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

minHeight

屬性 
minHeight:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The minimum recommended height of the component to be considered by the parent during layout. This value is in the component's coordinates, in pixels. The default value depends on the component's implementation.

If the application developer sets the value of minHeight, the new value is stored in explicitMinHeight. The default value of minHeight does not change. As a result, at layout time, if minHeight was explicitly set by the application developer, then the value of explicitMinHeight is used for the component's minimum recommended height. If minHeight is not set explicitly by the application developer, then the value of measuredMinHeight is used.

This value is used by the container in calculating the size and position of the component. It is not used by the component itself in determining its default size. Thus this property may not have any effect if parented by Container, or containers that don't factor in this property. Because the value is in component coordinates, the true minHeight with respect to its parent is affected by the scaleY property.

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



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

minWidth

屬性 
minWidth:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The minimum recommended width of the component to be considered by the parent during layout. This value is in the component's coordinates, in pixels. The default value depends on the component's implementation.

If the application developer sets the value of minWidth, the new value is stored in explicitMinWidth. The default value of minWidth does not change. As a result, at layout time, if minWidth was explicitly set by the application developer, then the value of explicitMinWidth is used for the component's minimum recommended width. If minWidth is not set explicitly by the application developer, then the value of measuredMinWidth is used.

This value is used by the container in calculating the size and position of the component. It is not used by the component itself in determining its default size. Thus this property may not have any effect if parented by Container, or containers that don't factor in this property. Because the value is in component coordinates, the true minWidth with respect to its parent is affected by the scaleX property.

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



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

moduleFactory

屬性 
moduleFactory:IFlexModuleFactory

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A module factory is used as context for using embedded fonts and for finding the style manager that controls the styles for this component.



實作
    public function get moduleFactory():IFlexModuleFactory
    public function set moduleFactory(value:IFlexModuleFactory):void

mouseFocusEnabled

屬性 
mouseFocusEnabled:Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Whether you can receive focus when clicked on. If false, focus is transferred to the first parent that is mouseFocusEnable set to true. For example, you can set this property to false on a Button control so that you can use the Tab key to move focus to the control, but not have the control get focus when you click on it.

The default value is true for most subclasses, except the Spark TabBar. In that case, the default is false.

預設值為 true。



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

nestLevel

屬性 
nestLevel:int

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Depth of this object in the containment hierarchy. This number is used by the measurement and layout code. The value is 0 if this component is not on the DisplayList.



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

nonInheritingStyles

屬性 
nonInheritingStyles:Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The beginning of this component's chain of non-inheriting styles. The getStyle() method simply accesses nonInheritingStyles[styleName] to search the entire prototype-linked chain. This object is set up by initProtoChain(). Developers typically never need to access this property directly.



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

numAutomationChildren

屬性 
numAutomationChildren:int  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The number of automation children this container has. This sum should not include any composite children, though it does include those children not significant within the automation hierarchy.



實作
    public function get numAutomationChildren():int

owner

屬性 
owner:DisplayObjectContainer

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The owner of this IVisualElement object. By default, it is the parent of this IVisualElement object. However, if this IVisualElement object is a child component that is popped up by its parent, such as the drop-down list of a ComboBox control, the owner is the component that popped up this IVisualElement object.

This property is not managed by Flex, but by each component. Therefore, if you use the PopUpManger.createPopUp() or PopUpManger.addPopUp() method to pop up a child component, you should set the owner property of the child component to the component that popped it up.

The default value is the value of the parent property.



實作
    public function get owner():DisplayObjectContainer
    public function set owner(value:DisplayObjectContainer):void

parent

屬性 
parent:DisplayObjectContainer  [唯讀] [覆寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The parent container or component for this component. Only visual elements should have a parent property. Non-visual items should use another property to reference the object to which they belong. By convention, non-visual objects use an owner property to reference the object to which they belong.



實作
    override public function get parent():DisplayObjectContainer

parentApplication

屬性 
parentApplication:Object  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A reference to the Application object that contains this UIComponent instance. This Application object might exist in a SWFLoader control in another Application, and so on, creating a chain of Application objects that can be walked using parentApplication.

The parentApplication property of an Application is never itself; it is either the Application into which it was loaded or null (for the top-level Application).

Walking the application chain using the parentApplication property is similar to walking the document chain using the parentDocument property. You can access the top-level application using the application property of the Application class.

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



實作
    public function get parentApplication():Object

parentDocument

屬性 
parentDocument:Object  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A reference to the parent document object for this UIComponent. A document object is a UIComponent at the top of the hierarchy of a Flex application, MXML component, or AS component.

For the Application object, the parentDocument property is null. This property is useful in MXML scripts to go up a level in the chain of document objects. It can be used to walk this chain using parentDocument.parentDocument, and so on.

It is typed as Object so that authors can access properties and methods on ancestor document objects without casting.

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



實作
    public function get parentDocument():Object

percentHeight

屬性 
percentHeight:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Specifies the height of a component as a percentage of its parent's size. Allowed values are 0-100. The default value is NaN. Setting the height or explicitHeight properties resets this property to NaN.

This property returns a numeric value only if the property was previously set; it does not reflect the exact size of the component in percent.

This property is always set to NaN for the UITextField control.

When used with Spark layouts, this property is used to calculate the height of the component's bounds after scaling and rotation. For example if the component is rotated at 90 degrees, then specifying percentHeight will affect the component's width.

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



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

percentWidth

屬性 
percentWidth:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Specifies the width of a component as a percentage of its parent's size. Allowed values are 0-100. The default value is NaN. Setting the width or explicitWidth properties resets this property to NaN.

This property returns a numeric value only if the property was previously set; it does not reflect the exact size of the component in percent.

This property is always set to NaN for the UITextField control.

When used with Spark layouts, this property is used to calculate the width of the component's bounds after scaling and rotation. For example if the component is rotated at 90 degrees, then specifying percentWidth will affect the component's height.

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



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

postLayoutTransformOffsets

屬性 
postLayoutTransformOffsets:mx.geom:TransformOffsets

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

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.

For example, if you want a layout to adjust for an object that is rotated 90 degrees, set the object's rotation property. If you want the layout to not adjust for the object being rotated, set its postLayoutTransformOffsets.rotationZ property.



實作
    public function get postLayoutTransformOffsets():mx.geom:TransformOffsets
    public function set postLayoutTransformOffsets(value:mx.geom:TransformOffsets):void

processedDescriptors

屬性 
processedDescriptors:Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Set to true after immediate or deferred child creation, depending on which one happens. For a Container object, it is set to true at the end of the createComponentsFromDescriptors() method, meaning after the Container object creates its children from its child descriptors.

For example, if an Accordion container uses deferred instantiation, the processedDescriptors property for the second pane of the Accordion container does not become true until after the user navigates to that pane and the pane creates its children. But, if the Accordion had set the creationPolicy property to "all", the processedDescriptors property for its second pane is set to true during application startup.

For classes that are not containers, which do not have descriptors, it is set to true after the createChildren() method creates any internal component children.



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

repeater

屬性 
repeater:IRepeater  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A reference to the Repeater object in the parent document that produced this UIComponent. Use this property, rather than the repeaters property, when the UIComponent is created by a single Repeater object. Use the repeaters property when this UIComponent is created by nested Repeater objects.

The property is set to null when this UIComponent is not created by a Repeater.



實作
    public function get repeater():IRepeater

repeaterIndex

屬性 
repeaterIndex:int  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The index of the item in the data provider of the Repeater that produced this UIComponent. Use this property, rather than the repeaterIndices property, when the UIComponent is created by a single Repeater object. Use the repeaterIndices property when this UIComponent is created by nested Repeater objects.

This property is set to -1 when this UIComponent is not created by a Repeater.



實作
    public function get repeaterIndex():int

repeaterIndices

屬性 
repeaterIndices:Array

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

An Array containing the indices of the items in the data provider of the Repeaters in the parent document that produced this UIComponent. The Array is empty unless this UIComponent is within one or more Repeaters.

The first element in the Array corresponds to the outermost Repeater. For example, if repeaterIndices is [2,4] it means that the outer repeater used item dataProvider[2] and the inner repeater used item dataProvider[4].

Note that this property differs from the instanceIndices property if the startingIndex property of any of the Repeaters is not 0. For example, even if a Repeater starts at dataProvider[4], the document reference of the first repeated object is b[0], not b[4].



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

repeaters

屬性 
repeaters:Array

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

An Array containing references to the Repeater objects in the parent document that produced this UIComponent. The Array is empty unless this UIComponent is within one or more Repeaters. The first element corresponds to the outermost Repeater object.



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

resourceManager

屬性 
resourceManager:IResourceManager  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A reference to the object which manages all of the application's localized resources. This is a singleton instance which implements the IResourceManager interface.

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



實作
    protected function get resourceManager():IResourceManager

right

屬性 
right:Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

For components, this layout constraint property is a facade on top of the similarly-named style. To set the property to its default value of undefined, use the @Clear() directive in MXML or the undefined value in ActionScript code. For example, in MXML code, right.s2="@Clear()" unsets the right constraint in state s2. Or in ActionScript code, button.right = undefined unsets the right constraint on button.

The horizontal distance in pixels from the right edge of the component to the anchor target's right edge.

By default the anchor target is the container's content area. In layouts with advanced constraints, the target can be a constraint column.

Setting the property to a number or to a numerical string like "10" specifies use of the default anchor target.

To specify an anchor target, set the property value to a string in the format "anchorTargetName:value". For example, "col1:10".



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

rotation

屬性 
rotation:Number[覆寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

指出 DisplayObject 實體的旋轉度數 (從該物件原本方向算起)。 0 至 180 之間的數值代表順時針方向旋轉;0 至 -180 之間的數值代表逆時針方向旋轉。超過此範圍的數值會被加上或減去 360 的倍數,以獲得該範圍之內的數值。 例如,my_video.rotation = 450 陳述式會與 my_video.rotation = 90 相同。



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

rotationX

屬性 
rotationX:Number[覆寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 10, AIR 1.5

Indicates the x-axis rotation of the DisplayObject instance, in degrees, from its original orientation relative to the 3D parent container. Values from 0 to 180 represent clockwise rotation; values from 0 to -180 represent counterclockwise rotation. Values outside this range are added to or subtracted from 360 to obtain a value within the range. This property is ignored during calculation by any of Flex's 2D layouts.



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

rotationY

屬性 
rotationY:Number[覆寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Indicates the y-axis rotation of the DisplayObject instance, in degrees, from its original orientation relative to the 3D parent container. Values from 0 to 180 represent clockwise rotation; values from 0 to -180 represent counterclockwise rotation. Values outside this range are added to or subtracted from 360 to obtain a value within the range. This property is ignored during calculation by any of Flex's 2D layouts.



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

rotationZ

屬性 
rotationZ:Number[覆寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Indicates the z-axis rotation of the DisplayObject instance, in degrees, from its original orientation relative to the 3D parent container. Values from 0 to 180 represent clockwise rotation; values from 0 to -180 represent counterclockwise rotation. Values outside this range are added to or subtracted from 360 to obtain a value within the range.



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

scaleX

屬性 
scaleX:Number[覆寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Number that specifies the horizontal scaling factor.

The default value is 1.0, which means that the object is not scaled. A scaleX of 2.0 means the object has been magnified by a factor of 2, and a scaleX of 0.5 means the object has been reduced by a factor of 2.

A value of 0.0 is an invalid value. Rather than setting it to 0.0, set it to a small value, or set the visible property to false to hide the component.

預設值為 1.0。

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



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

scaleY

屬性 
scaleY:Number[覆寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Number that specifies the vertical scaling factor.

The default value is 1.0, which means that the object is not scaled. A scaleY of 2.0 means the object has been magnified by a factor of 2, and a scaleY of 0.5 means the object has been reduced by a factor of 2.

A value of 0.0 is an invalid value. Rather than setting it to 0.0, set it to a small value, or set the visible property to false to hide the component.

預設值為 1.0。

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



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

scaleZ

屬性 
scaleZ:Number[覆寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Number that specifies the scaling factor along the z axis.

A scaling along the z axis does not affect a typical component, which lies flat in the z=0 plane. components with children that have 3D transforms applied, or components with a non-zero transformZ, is affected.

The default value is 1.0, which means that the object is not scaled.

This property is ignored during calculation by any of Flex's 2D layouts.

預設值為 1.0。

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



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

screen

屬性 
screen:Rectangle  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Returns an object that contains the size and position of the base drawing surface for this object.



實作
    public function get screen():Rectangle

showInAutomationHierarchy

屬性 
showInAutomationHierarchy:Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A flag that determines if an automation object shows in the automation hierarchy. Children of containers that are not visible in the hierarchy appear as children of the next highest visible parent. Typically containers used for layout, such as boxes and Canvas, do not appear in the hierarchy.

Some controls force their children to appear in the hierarchy when appropriate. For example a List will always force item renderers, including boxes, to appear in the hierarchy. Implementers must support setting this property to true.



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

states

屬性 
states:Array

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The view states that are defined for this component. You can specify the states property only on the root of the application or on the root tag of an MXML component. The compiler generates an error if you specify it on any other control.



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

styleDeclaration

屬性 
styleDeclaration:CSSStyleDeclaration

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Storage for the inline inheriting styles on this object. This CSSStyleDeclaration is created the first time that the setStyle() method is called on this component to set an inheriting style. Developers typically never need to access this property directly.



實作
    public function get styleDeclaration():CSSStyleDeclaration
    public function set styleDeclaration(value:CSSStyleDeclaration):void

styleManager

屬性 
styleManager:IStyleManager2  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns the StyleManager instance used by this component.



實作
    public function get styleManager():IStyleManager2

styleName

屬性 
styleName:Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The class style used by this component. This can be a String, CSSStyleDeclaration or an IStyleClient.

If this is a String, it is the name of one or more whitespace delimited class declarations in an <fx:Style> tag or CSS file. You do not include the period in the styleName. For example, if you have a class style named ".bigText", set the styleName property to "bigText" (no period).

If this is an IStyleClient (typically a UIComponent), all styles in the styleName object are used by this component.

預設值為 null。



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

styleParent

屬性 
styleParent:IAdvancedStyleClient

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A component's parent is used to evaluate descendant selectors. A parent must also be an IAdvancedStyleClient to participate in advanced style declarations.



實作
    public function get styleParent():IAdvancedStyleClient
    public function set styleParent(value:IAdvancedStyleClient):void

systemManager

屬性 
systemManager:ISystemManager

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Returns the SystemManager object used by this component.



實作
    public function get systemManager():ISystemManager
    public function set systemManager(value:ISystemManager):void

tabFocusEnabled

屬性 
tabFocusEnabled:Boolean

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

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.

預設值為 true。

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



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

toolTip

屬性 
toolTip:String

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Text to display in the ToolTip.

預設值為 null。

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



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

top

屬性 
top:Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

For components, this layout constraint property is a facade on top of the similarly-named style. To set the property to its default value of undefined, use the @Clear() directive in MXML or the undefined value in ActionScript code. For example, in MXML code, top.s2="@Clear()" unsets the top constraint in state s2. Or in ActionScript code, button.top = undefined unsets the top constraint on button.

The vertical distance in pixels from the top edge of the component to the anchor target's top edge.

By default the anchor target is the container's content area. In layouts with advanced constraints, the target can be a constraint row.

Setting the property to a number or to a numerical string like "10" specifies use of the default anchor target.

To specify an anchor target, set the property value to a string in the format "anchorTargetName:value". For example, "row1:10".



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

transform

屬性 
transform:flash.geom:Transform[覆寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

An object with properties pertaining to a display object's matrix, color transform, and pixel bounds. The specific properties — matrix, colorTransform, and three read-only properties (concatenatedMatrix, concatenatedColorTransform, and pixelBounds) — are described in the entry for the Transform class.

Each of the transform object's properties is itself an object. This concept is important because the only way to set new values for the matrix or colorTransform objects is to create a new object and copy that object into the transform.matrix or transform.colorTransform property.

For example, to increase the tx value of a display object's matrix, you must make a copy of the entire matrix object, then copy the new object into the matrix property of the transform object:

      var myMatrix:Matrix = myUIComponentObject.transform.matrix;  
      myMatrix.tx += 10; 
      myUIComponent.transform.matrix = myMatrix;
      
You cannot directly set the tx property. The following code has no effect on myUIComponent:
      myUIComponent.transform.matrix.tx += 10;
      

Note that for UIComponent, unlike DisplayObject, the transform keeps the matrix and matrix3D values in sync and matrix3D is not null even when the component itself has no 3D properties set. Developers should use the is3D property to check if the component has 3D propertis set. If the component has 3D properties, the transform's matrix3D should be used instead of transform's matrix.



實作
    override public function get transform():flash.geom:Transform
    override public function set transform(value:flash.geom:Transform):void

相關 API 元素

transformX

屬性 
transformX:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Sets the x coordinate for the transform center of the component.

When this component is the target of a Spark transform effect, you can override this property by setting the AnimateTransform.autoCenterTransform property. If autoCenterTransform is false, the transform center is determined by the transformX, transformY, and transformZ properties of the effect target. If autoCenterTransform is true, the effect occurs around the center of the target, (width/2, height/2).

Setting this property on the Spark effect class overrides the setting on the target component.



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

相關 API 元素

transformY

屬性 
transformY:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Sets the y coordinate for the transform center of the component.

When this component is the target of a Spark transform effect, you can override this property by setting the AnimateTransform.autoCenterTransform property. If autoCenterTransform is false, the transform center is determined by the transformX, transformY, and transformZ properties of the effect target. If autoCenterTransform is true, the effect occurs around the center of the target, (width/2, height/2).

Seeting this property on the Spark effect class overrides the setting on the target component.



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

相關 API 元素

transformZ

屬性 
transformZ:Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Sets the z coordinate for the transform center of the component.

When this component is the target of a Spark transform effect, you can override this property by setting the AnimateTransform.autoCenterTransform property. If autoCenterTransform is false, the transform center is determined by the transformX, transformY, and transformZ properties of the effect target. If autoCenterTransform is true, the effect occurs around the center of the target, (width/2, height/2).

Seeting this property on the Spark effect class overrides the setting on the target component.



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

相關 API 元素

transitions

屬性 
transitions:Array

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

An Array of Transition objects, where each Transition object defines a set of effects to play when a view state change occurs.



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

相關 API 元素

tweeningProperties

屬性 
tweeningProperties:Array

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Array of properties that are currently being tweened on this object.

Used to alert the EffectManager that certain properties of this object are being tweened, so that the EffectManger doesn't attempt to animate the same properties.



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

uid

屬性 
uid:String

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A unique identifier for the object. Flex data-driven controls, including all controls that are subclasses of List class, use a UID to track data provider items.

Flex can automatically create and manage UIDs. However, there are circumstances when you must supply your own uid property by implementing the IUID interface, or when supplying your own uid property improves processing efficiency. UIDs do not need to be universally unique for most uses in Flex. One exception is for messages sent by data services.



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

相關 API 元素

unscaledHeight

屬性 
unscaledHeight:Number  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A convenience method for determining the unscaled height of the component. All of a component's drawing and child layout should be done within a bounding rectangle of this height, which is also passed as an argument to updateDisplayList().



實作
    protected function get unscaledHeight():Number

unscaledWidth

屬性 
unscaledWidth:Number  [唯讀]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

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().



實作
    protected function get unscaledWidth():Number

updateCompletePendingFlag

屬性 
updateCompletePendingFlag:Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A flag that determines if an object has been through all three phases of layout validation (provided that any were required).



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

validationSubField

屬性 
validationSubField:String

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Used by a validator to associate a subfield with this component.



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

verticalCenter

屬性 
verticalCenter:Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

For components, this layout constraint property is a facade on top of the similarly-named style. To set the property to its default value of undefined, use the @Clear() directive in MXML or the undefined value in ActionScript code. For example, in MXML code, verticalCenter.s2="@Clear()" unsets the verticalCenter constraint in state s2. Or in ActionScript code, button.verticalCenter = undefined unsets the verticalCenter constraint on button.

The vertical distance in pixels from the center of the component to the center of the anchor target's content area.

The default anchor target is the container itself.

In layouts with advanced constraints, the anchor target can be a constraint row. Then the content area is the space between the preceding row (or container side) and the target row.

Setting the property to a number or to a numerical string like "10" specifies use of the default anchor target.

To specify an anchor target, set the property value to a string in the format "constraintColumnId:value". For example, "row1:10".



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

visible

屬性 
visible:Boolean[覆寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Whether or not the display object is visible. Display objects that are not visible are disabled. For example, if visible=false for an InteractiveObject instance, it cannot be clicked.

When setting to true, the object dispatches a show event. When setting to false, the object dispatches a hide event. In either case the children of the object does not emit a show or hide event unless the object has specifically written an implementation to do so.

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



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

width

屬性 
width:Number[覆寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Number that specifies the width of the component, in pixels, in the parent's coordinates. The default value is 0, but this property contains the actual component width after Flex completes sizing the components in your application.

Note: You can specify a percentage value in the MXML width attribute, such as width="100%", but you cannot use a percentage value in the width property in ActionScript. Use the percentWidth property instead.

Setting this property causes a resize event to be dispatched. See the resize event for details on when this event is dispatched.

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



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

相關 API 元素

x

屬性 
x:Number[覆寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Number that specifies the component's horizontal position, in pixels, within its parent container.

Setting this property directly or calling move() has no effect -- or only a temporary effect -- if the component is parented by a layout container such as HBox, Grid, or Form, because the layout calculations of those containers set the x position to the results of the calculation. However, the x property must almost always be set when the parent is a Canvas or other absolute-positioning container because the default value is 0.

預設值為 0。

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



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

y

屬性 
y:Number[覆寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Number that specifies the component's vertical position, in pixels, within its parent container.

Setting this property directly or calling move() has no effect -- or only a temporary effect -- if the component is parented by a layout container such as HBox, Grid, or Form, because the layout calculations of those containers set the x position to the results of the calculation. However, the x property must almost always be set when the parent is a Canvas or other absolute-positioning container because the default value is 0.

預設值為 0。

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



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

z

屬性 
z:Number[覆寫]

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 10, AIR 1.5

Indicates the z coordinate position along the z-axis of the DisplayObject instance relative to the 3D parent container. The z property is used for 3D coordinates, not screen or pixel coordinates.

When you set a z property for a display object to something other than the default value of 0, a corresponding Matrix3D object is automatically created. for adjusting a display object's position and orientation in three dimensions. When working with the z-axis, the existing behavior of x and y properties changes from screen or pixel coordinates to positions relative to the 3D parent container.

For example, a child of the _root at position x = 100, y = 100, z = 200 is not drawn at pixel location (100,100). The child is drawn wherever the 3D projection calculation puts it. The calculation is:

(x*cameraFocalLength/cameraRelativeZPosition, y*cameraFocalLength/cameraRelativeZPosition)

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



實作
    override public function get z():Number
    override public function set z(value:Number):void
建構函式詳細資料

UIComponent

()建構函式
public function UIComponent()

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Constructor.

方法詳細資訊

addStyleClient

()方法
public function addStyleClient(styleClient:IAdvancedStyleClient):void

語言版本: ActionScript 3.0
產品版本: Flex 4.5
執行階段版本: Flash Player 9, AIR 1.1

Adds a non-visual style client to this component instance. Once this method has been called, the style client will inherit style changes from this component instance. Style clients that are DisplayObjects must use the addChild or addChildAt methods to be added to a UIComponent. As a side effect, this method will set the styleParent property of the styleClient parameter to reference this instance of the UIComponent. If the styleClient parameter already has a styleParent, this method will call removeStyleClient from this previous styleParent.

參數

styleClient:IAdvancedStyleClient — The IAdvancedStyleClient to add to this component's list of non-visual style clients.


擲回值
ArgumentError — if the styleClient parameter is a DisplayObject.

相關 API 元素

adjustFocusRect

()方法 
protected function adjustFocusRect(obj:DisplayObject = null):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Adjust the focus rectangle.

參數

obj:DisplayObject (default = null) — component whose focus rectangle to modify. If omitted, the default value is this UIComponent object.

applyComputedMatrix

()方法 
protected function applyComputedMatrix():void

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Commits the computed matrix built from the combination of the layout matrix and the transform offsets to the flash displayObject's transform.

attachOverlay

()方法 
protected function attachOverlay():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

This is an internal method used by the Flex framework to support the Dissolve effect. You do not have to call it or override it.

callLater

()方法 
public function callLater(method:Function, args:Array = null):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Queues a function to be called later.

Before each update of the screen, Flash Player or AIR calls the set of functions that are scheduled for the update. Sometimes, a function should be called in the next update to allow the rest of the code scheduled for the current update to be executed. Some features, like effects, can cause queued functions to be delayed until the feature completes.

參數

method:Function — Reference to a method to be executed later.
 
args:Array (default = null) — Array of Objects that represent the arguments to pass to the method.

canSkipMeasurement

()方法 
protected function canSkipMeasurement():Boolean

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 9, AIR 1.1

Determines if the call to the measure() method can be skipped.

傳回值
Boolean — Returns true when the measureSizes() method can skip the call to the measure() method. For example this is usually true when both explicitWidth and explicitHeight are set. For paths, this is true when the bounds of the path have not changed.

childrenCreated

()方法 
protected function childrenCreated():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Performs any final processing after child objects are created. This is an advanced method that you might override when creating a subclass of UIComponent.

clearStyle

()方法 
public function clearStyle(styleProp:String):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Deletes a style property from this component instance.

This does not necessarily cause the getStyle() method to return undefined.

參數

styleProp:String — The name of the style property.

commitProperties

()方法 
protected function commitProperties():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Processes the properties set on the component. This is an advanced method that you might override when creating a subclass of UIComponent.

You do not call this method directly. Flex calls the commitProperties() method when you use the addChild() method to add a component to a container, or when you call the invalidateProperties() method of the component. Calls to the commitProperties() method occur before calls to the measure() method. This lets you set property values that might be used by the measure() method.

Some components have properties that affect the number or kinds of child objects that they need to create, or have properties that interact with each other, such as the horizontalScrollPolicy and horizontalScrollPosition properties. It is often best at startup time to process all of these properties at one time to avoid duplicating work.

更多範例

contentToGlobal

()方法 
public function contentToGlobal(point:Point):Point

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Converts a Point object from content coordinates to global coordinates. Content coordinates specify a pixel position relative to the upper left corner of the component's content, and include all of the component's content area, including any regions that are currently clipped and must be accessed by scrolling the component. You use the content coordinate system to set and get the positions of children of a container that uses absolute positioning. Global coordinates specify a pixel position relative to the upper-left corner of the stage, that is, the outermost edge of the application.

參數

point:Point — A Point object that specifies the x and y coordinates in the content coordinate system as properties.

傳回值
Point — A Point object with coordinates relative to the Stage.

相關 API 元素

contentToLocal

()方法 
public function contentToLocal(point:Point):Point

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Converts a Point object from content to local coordinates. Content coordinates specify a pixel position relative to the upper left corner of the component's content, and include all of the component's content area, including any regions that are currently clipped and must be accessed by scrolling the component. You use the content coordinate system to set and get the positions of children of a container that uses absolute positioning. Local coordinates specify a pixel position relative to the upper left corner of the component.

參數

point:Point — A Point object that specifies the x and y coordinates in the content coordinate system as properties.

傳回值
Point — Point A Point object with coordinates relative to the local coordinate system.

相關 API 元素

createAutomationIDPart

()方法 
public function createAutomationIDPart(child:IAutomationObject):Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Returns a set of properties that identify the child within this container. These values should not change during the lifespan of the application.

參數

child:IAutomationObject — Child for which to provide the id.

傳回值
Object — Sets of properties describing the child which can later be used to resolve the component.

createAutomationIDPartWithRequiredProperties

()方法 
public function createAutomationIDPartWithRequiredProperties(child:IAutomationObject, properties:Array):Object

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns a set of properties that identify the child within this container. These values should not change during the lifespan of the application.

參數

child:IAutomationObject — Child for which to provide the id.
 
properties:Array

傳回值
Object — Sets of properties describing the child which can later be used to resolve the component.

createChildren

()方法 
protected function createChildren():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Create child objects of the component. This is an advanced method that you might override when creating a subclass of UIComponent.

A component that creates other components or objects within it is called a composite component. For example, the Flex ComboBox control is actually made up of a TextInput control to define the text area of the ComboBox, and a Button control to define the ComboBox arrow. Components implement the createChildren() method to create child objects (such as other components) within the component.

From within an override of the createChildren() method, you call the addChild() method to add each child object.

You do not call this method directly. Flex calls the createChildren() method in response to the call to the addChild() method to add the component to its parent.

更多範例

createInFontContext

()方法 
protected function createInFontContext(classObj:Class):Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Creates a new object using a context based on the embedded font being used.

This method is used to solve a problem with access to fonts embedded in an application SWF when the framework is loaded as an RSL (the RSL has its own SWF context). Embedded fonts can only be accessed from the SWF file context in which they were created. By using the context of the application SWF, the RSL can create objects in the application SWF context that has access to the application's embedded fonts.

Call this method only after the font styles for this object are set.

參數

classObj:Class — The class to create.

傳回值
Object — The instance of the class created in the context of the SWF owning the embedded font. If this object is not using an embedded font, the class is created in the context of this object.

createInModuleContext

()方法 
protected function createInModuleContext(moduleFactory:IFlexModuleFactory, className:String):Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Creates the object using a given moduleFactory. If the moduleFactory is null or the object cannot be created using the module factory, then fall back to creating the object using a systemManager.

參數

moduleFactory:IFlexModuleFactory — The moduleFactory to create the class in; can be null.
 
className:String — The name of the class to create.

傳回值
Object — The object created in the context of the moduleFactory.

createReferenceOnParentDocument

()方法 
public function createReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Creates an id reference to this IUIComponent object on its parent document object. This function can create multidimensional references such as b[2][4] for objects inside one or more repeaters. If the indices are null, it creates a simple non-Array reference.

參數

parentDocument:IFlexDisplayObject — The parent of this IUIComponent object.

deleteReferenceOnParentDocument

()方法 
public function deleteReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Deletes the id reference to this IUIComponent object on its parent document object. This function can delete from multidimensional references such as b[2][4] for objects inside one or more Repeaters. If the indices are null, it deletes the simple non-Array reference.

參數

parentDocument:IFlexDisplayObject — The parent of this IUIComponent object.

determineTextFormatFromStyles

()方法 
public function determineTextFormatFromStyles():mx.core:UITextFormat

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Returns a UITextFormat object corresponding to the text styles for this UIComponent.

傳回值
mx.core:UITextFormat — UITextFormat object corresponding to the text styles for this UIComponent.

dispatchEvent

()方法 
override public function dispatchEvent(event:Event):Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatches an event into the event flow. The event target is the EventDispatcher object upon which the dispatchEvent() method is called.

參數

event:Event — The Event object that is dispatched into the event flow. If the event is being redispatched, a clone of the event is created automatically. After an event is dispatched, its target property cannot be changed, so you must create a new copy of the event for redispatching to work.

傳回值
Boolean — A value of true if the event was successfully dispatched. A value of false indicates failure or that the preventDefault() method was called on the event.

dispatchPropertyChangeEvent

()方法 
protected function dispatchPropertyChangeEvent(prop:String, oldValue:*, value:*):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Helper method for dispatching a PropertyChangeEvent when a property is updated.

參數

prop:String — Name of the property that changed.
 
oldValue:* — Old value of the property.
 
value:* — New value of the property.

drawFocus

()方法 
public function drawFocus(isFocused:Boolean):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Shows or hides the focus indicator around this component.

UIComponent implements this by creating an instance of the class specified by the focusSkin style and positioning it appropriately.

參數

isFocused:Boolean — Determines if the focus indicator should be displayed. Set to true to display the focus indicator. Set to false to hide it.

drawRoundRect

()方法 
public function 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

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Programmatically draws a rectangle into this skin's Graphics object.

The rectangle can have rounded corners. Its edges are stroked with the current line style of the Graphics object. It can have a solid color fill, a gradient fill, or no fill. A solid fill can have an alpha transparency. A gradient fill can be linear or radial. You can specify up to 15 colors and alpha values at specified points along the gradient, and you can specify a rotation angle or transformation matrix for the gradient. Finally, the rectangle can have a rounded rectangular hole carved out of it.

This versatile rectangle-drawing routine is used by many skins. It calls the drawRect() or drawRoundRect() methods (in the flash.display.Graphics class) to draw into this skin's Graphics object.

參數

x:Number — Horizontal position of upper-left corner of rectangle within this skin.
 
y:Number — Vertical position of upper-left corner of rectangle within this skin.
 
w:Number — Width of rectangle, in pixels.
 
h:Number — Height of rectangle, in pixels.
 
r:Object (default = null) — Corner radius/radii of rectangle. Can be null, a Number, or an Object. If it is null, it specifies that the corners should be square rather than rounded. If it is a Number, it specifies the same radius, in pixels, for all four corners. If it is an Object, it should have properties named tl, tr, bl, and br, whose values are Numbers specifying the radius, in pixels, for the top left, top right, bottom left, and bottom right corners. For example, you can pass a plain Object such as { tl: 5, tr: 5, bl: 0, br: 0 }. The default value is null (square corners).
 
c:Object (default = null) — The RGB color(s) for the fill. Can be null, a uint, or an Array. If it is null, the rectangle not filled. If it is a uint, it specifies an RGB fill color. For example, pass 0xFF0000 to fill with red. If it is an Array, it should contain uints specifying the gradient colors. For example, pass [ 0xFF0000, 0xFFFF00, 0x0000FF ] to fill with a red-to-yellow-to-blue gradient. You can specify up to 15 colors in the gradient. The default value is null (no fill).
 
alpha:Object (default = null) — Alpha value(s) for the fill. Can be null, a Number, or an Array. This argument is ignored if color is null. If color is a uint specifying an RGB fill color, then alpha should be a Number specifying the transparency of the fill, where 0.0 is completely transparent and 1.0 is completely opaque. You can also pass null instead of 1.0 in this case to specify complete opaqueness. If color is an Array specifying gradient colors, then alpha should be an Array of Numbers, of the same length, that specifies the corresponding alpha values for the gradient. In this case, the default value is null (completely opaque).
 
rot:Object (default = null) — Matrix object used for the gradient fill. The utility methods horizontalGradientMatrix(), verticalGradientMatrix(), and rotatedGradientMatrix() can be used to create the value for this parameter.
 
gradient:String (default = null) — Type of gradient fill. The possible values are GradientType.LINEAR or GradientType.RADIAL. (The GradientType class is in the package flash.display.)
 
ratios:Array (default = null) — Specifies the distribution of colors. The number of entries must match the number of colors defined in the color parameter. Each value defines the percentage of the width where the color is sampled at 100%. The value 0 represents the left-hand position in the gradient box, and 255 represents the right-hand position in the gradient box.
 
hole:Object (default = null) — A rounded rectangular hole that should be carved out of the middle of the otherwise solid rounded rectangle { x: #, y: #, w: #, h: #, r: # or { br: #, bl: #, tl: #, tr: # } }

相關 API 元素

effectFinished

()方法 
public function effectFinished(effectInst:IEffectInstance):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Called by the effect instance when it stops playing on the component. You can use this method to restore a modification to the component made by the effectStarted() method when the effect started, or perform some other action when the effect ends.

參數

effectInst:IEffectInstance — The effect instance object playing on the component.

effectStarted

()方法 
public function effectStarted(effectInst:IEffectInstance):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Called by the effect instance when it starts playing on the component. You can use this method to perform a modification to the component as part of an effect. You can use the effectFinished() method to restore the modification when the effect ends.

參數

effectInst:IEffectInstance — The effect instance object playing on the component.

endEffectsStarted

()方法 
public function endEffectsStarted():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Ends all currently playing effects on the component.

executeBindings

()方法 
public function executeBindings(recurse:Boolean = false):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Executes all the bindings for which the UIComponent object is the destination.

參數

recurse:Boolean (default = false) — Recursively execute bindings for children of this component.

finishPrint

()方法 
public function finishPrint(obj:Object, target:IFlexDisplayObject):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Called after printing is complete. For the UIComponent class, the method performs no action. Flex containers override the method to restore the container after printing.

This method is normally not used by application developers.

參數

obj:Object — Contains the properties of the component that restore it to its state before printing.
 
target:IFlexDisplayObject — The component that just finished printing. It can be the current component or one of its children.

相關 API 元素

focusInHandler

()方法 
protected function focusInHandler(event:FocusEvent):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The event handler called when a UIComponent object gets focus. If you override this method, make sure to call the base class version.

參數

event:FocusEvent — The event object.

focusOutHandler

()方法 
protected function focusOutHandler(event:FocusEvent):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The event handler called when a UIComponent object loses focus. If you override this method, make sure to call the base class version.

參數

event:FocusEvent — The event object.

getAutomationChildAt

()方法 
public function getAutomationChildAt(index:int):IAutomationObject

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Provides the automation object at the specified index. This list should not include any children that are composites.

參數

index:int — The index of the child to return

傳回值
IAutomationObject — The child at the specified index.

getAutomationChildren

()方法 
public function getAutomationChildren():Array

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Provides the automation object list . This list does not include any children that are composites.

傳回值
Array — The children .

getBoundsXAtSize

()方法 
public function getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns the x coordinate of the element's bounds at the specified element size.

This method is typically used by layouts during a call to the measure() method to predict what the element position will be, if the element is resized to particular dimensions.

參數

width:Number — The element's bounds width, or NaN to use the preferred width.
 
height:Number — The element's bounds height, or NaN to use the preferred height.
 
postLayoutTransform:Boolean (default = true) — When postLayoutTransform is true, the method returns x coordinate of the element's bounding box top-left corner. The bounding box is in element's parent coordinate space and is calculated from the specified bounds size, layout position and layout transform matrix.

傳回值
Number — The x coordinate of the element's bounds at the specified element size.

getBoundsYAtSize

()方法 
public function getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns the y coordinate of the element's bounds at the specified element size. This method is typically used by layouts during a call to the measure() to predict what the element position will be, if the element is resized to particular dimensions.

參數

width:Number — The element's bounds width, or NaN to use the preferred width.
 
height:Number — The element's bounds height, or NaN to use the preferred height.
 
postLayoutTransform:Boolean (default = true) — When postLayoutTransform is true, the method returns the y coordinate of the element's bounding box top-left corner. The bounding box is in element's parent coordinate space and is calculated from the specified bounds size, layout position and layout transform matrix.

傳回值
Number — The y coordinate of the element's bounds at the specified element size.

getClassStyleDeclarations

()方法 
public function getClassStyleDeclarations():Array

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Finds the type selectors for this UIComponent instance. The algorithm walks up the superclass chain. For example, suppose that class MyButton extends Button. A MyButton instance first looks for a MyButton type selector then, it looks for a Button type selector. then, it looks for a UIComponent type selector. (The superclass chain is considered to stop at UIComponent, not Object.)

傳回值
Array — An Array of type selectors for this UIComponent instance.

getConstraintValue

()方法 
public function getConstraintValue(constraintName:String):*

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Returns a layout constraint value, which is the same as getting the constraint style for this component.

參數

constraintName:String — The name of the constraint style, which can be any of the following: left, right, top, bottom, verticalCenter, horizontalCenter, baseline

傳回值
* — Returns the layout constraint value, which can be specified in either of two forms. It can be specified as a numeric string, for example, "10" or it can be specified as identifier:numeric string. For identifier:numeric string, identifier is the id of a ConstraintRow or ConstraintColumn. For example, a value of "cc1:10" specifies a value of 10 for the ConstraintColumn that has the id "cc1."

getExplicitOrMeasuredHeight

()方法 
public function getExplicitOrMeasuredHeight():Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A convenience method for determining whether to use the explicit or measured height

傳回值
Number — A Number which is explicitHeight if defined or measuredHeight if not.

getExplicitOrMeasuredWidth

()方法 
public function getExplicitOrMeasuredWidth():Number

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

A convenience method for determining whether to use the explicit or measured width

傳回值
Number — A Number which is explicitWidth if defined or measuredWidth if not.

getFocus

()方法 
public function getFocus():InteractiveObject

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Gets the object that currently has focus. It might not be this object. Note that this method does not necessarily return the component that has focus. It can return the internal subcomponent of the component that has focus. To get the component that has focus, use the focusManager.focus property.

傳回值
InteractiveObject — Object that has focus.

getLayoutBoundsHeight

()方法 
public function getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns the element's layout height. This is the size that the element uses to draw on screen.

參數

postLayoutTransform:Boolean (default = true) — When postLayoutTransform is true, the method returns the element's bounding box width. The bounding box is in the element's parent coordinate space and is calculated from the element's layout size and layout transform matrix.

傳回值
Number — The element's layout height.

getLayoutBoundsWidth

()方法 
public function getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns the element's layout width. This is the size that the element uses to draw on screen.

參數

postLayoutTransform:Boolean (default = true) — When postLayoutTransform is true, the method returns the element's bounding box width. The bounding box is in element's parent coordinate space and is calculated from the element's layout size and layout transform matrix.

傳回值
Number — The element's layout width.

getLayoutBoundsX

()方法 
public function getLayoutBoundsX(postLayoutTransform:Boolean = true):Number

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns the x coordinate that the element uses to draw on screen.

參數

postLayoutTransform:Boolean (default = true) — When postLayoutTransform is true, the method returns x coordinate of the element's bounding box top-left corner. The bounding box is in the element's parent coordinate space and is calculated from the element's layout size, layout position and layout transform matrix.

傳回值
Number — The x coordinate that the element uses to draw on screen.

getLayoutBoundsY

()方法 
public function getLayoutBoundsY(postLayoutTransform:Boolean = true):Number

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns the y coordinate that the element uses to draw on screen.

參數

postLayoutTransform:Boolean (default = true) — When postLayoutTransform is true, the method returns y coordinate of the element's bounding box top-left corner. The bounding box is in the element's parent coordinate space and is calculated from the element's layout size, layout position, and layout transform matrix.

傳回值
Number — The y coordinate that the element uses to draw on screen.

getLayoutMatrix

()方法 
public function getLayoutMatrix():Matrix

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns the transform matrix that is used to calculate the component's layout relative to its siblings.

This matrix is typically defined by the component's 2D properties such as x, y, rotation, scaleX, scaleY, transformX, and transformY. Some components may have additional transform properties that are applied on top of the layout matrix to determine the final, computed matrix. For example UIComponent defines the offsets property.

傳回值
Matrix — The layout transform Matrix for this element. Do not directly modify the return value; call the setLayoutMatrix() method instead.

getLayoutMatrix3D

()方法 
public function getLayoutMatrix3D():Matrix3D

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns the layout transform Matrix3D for this element.

This matrix is typically defined by the component's transform properties such as x, y, z, rotationX, rotationY, rotationZ, scaleX, scaleY, scaleZ, transformX, and transformY. Some components may have additional transform properties that are applied on top of the layout matrix to determine the final, computed matrix. For example UIComponent defines the offsets property.

傳回值
Matrix3D — The layout transform Matrix3D for this element. Do not directly modify the return value but call the setLayoutMatrix() method instead.

getMaxBoundsHeight

()方法 
public function getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns the element's maximum height.

參數

postLayoutTransform:Boolean (default = true) — When postLayoutTransform is true, the method returns the element's bounding box height. The bounding box is in the element's parent coordinate space and is calculated from the element's maximum size and layout transform matrix.

傳回值
Number — The element's maximum height.

getMaxBoundsWidth

()方法 
public function getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns the element's maximum width.

參數

postLayoutTransform:Boolean (default = true) — When postLayoutTransform is true, the method returns the element's bounding box width. The bounding box is in the element's parent coordinate space and is calculated from the element's maximum size and layout transform matrix.

傳回值
Number — The element's maximum width.

getMinBoundsHeight

()方法 
public function getMinBoundsHeight(postLayoutTransform:Boolean = true):Number

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns the element's minimum height.

參數

postLayoutTransform:Boolean (default = true) — When postLayoutTransform is true, the method returns the element's bounding box height. The bounding box is in the element's parent coordinate space and is calculated from the element's minimum size and layout transform matrix.

傳回值
Number — The element's maximum height.

getMinBoundsWidth

()方法 
public function getMinBoundsWidth(postLayoutTransform:Boolean = true):Number

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns the element's minimum width.

參數

postLayoutTransform:Boolean (default = true) — When postLayoutTransform is true, the method returns the element's bounding box width. The bounding box is in the element's parent coordinate space and is calculated from the element's minimum size and layout transform matrix.

傳回值
Number — The element's maximum width.

getPreferredBoundsHeight

()方法 
public function getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns the element's preferred height.

參數

postLayoutTransform:Boolean (default = true) — When postLayoutTransform is true, the method returns the element's bounding box height. The bounding box is in the element's parent coordinate space and is calculated from the element's preferred size and layout transform matrix.

傳回值
Number — Returns the element's preferred height. Preferred height is usually based on the default element size and any explicit overrides. For UIComponent this is the same value as returned by the getExplicitOrMeasuredHeight() method.

getPreferredBoundsWidth

()方法 
public function getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Returns the element's preferred width.

參數

postLayoutTransform:Boolean (default = true) — When postLayoutTransform is true, the method returns the element's bounding box width. The bounding box is in the element's parent coordinate space and is calculated from the element's preferred size and layout transform matrix.

傳回值
Number — Returns the element's preferred width. Preferred width is usually based on the default element size and any explicit overrides. For UIComponent this is the same value as returned by the getExplicitOrMeasuredWidth() method.

getRepeaterItem

()方法 
public function getRepeaterItem(whichRepeater:int = -1):Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

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. The argument whichRepeater is 0 for the outermost Repeater, 1 for the next inner Repeater, and so on. If whichRepeater is not specified, the innermost Repeater is used.

參數

whichRepeater:int (default = -1) — Number of the Repeater, counting from the outermost one, starting at 0.

傳回值
Object — The requested repeater item.

getStyle

()方法 
public function getStyle(styleProp:String):*

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Gets a style property that has been set anywhere in this component's style lookup chain.

This same method is used to get any kind of style property, so the value returned can be a Boolean, String, Number, int, uint (for an RGB color), Class (for a skin), or any kind of object. Therefore the return type is simply specified as *.

If you are getting a particular style property, you know its type and often want to store the result in a variable of that type. No casting from * to that type is necessary.

var backgroundColor:uint = getStyle("backgroundColor");

If the style property has not been set anywhere in the style lookup chain, the value returned by getStyle() is undefined. Note that undefined is a special value that is not the same as false, "", NaN, 0, or null. No valid style value is ever undefined. You can use the method IStyleManager2.isValidStyleValue() to test whether the value was set.

參數

styleProp:String — Name of the style property.

傳回值
* — Style value.

更多範例

globalToContent

()方法 
public function globalToContent(point:Point):Point

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Converts a Point object from global to content coordinates. Global coordinates specify a pixel position relative to the upper-left corner of the stage, that is, the outermost edge of the application. Content coordinates specify a pixel position relative to the upper left corner of the component's content, and include all of the component's content area, including any regions that are currently clipped and must be accessed by scrolling the component. You use the content coordinate system to set and get the positions of children of a container that uses absolute positioning.

參數

point:Point — A Point object that specifies the x and y coordinates in the global (Stage) coordinate system as properties.

傳回值
Point — Point A Point object with coordinates relative to the component.

相關 API 元素

hasCSSState

()方法 
public function hasCSSState():Boolean

語言版本: ActionScript 3.0
產品版本: Flex 4.6
執行階段版本: Flash Player 10, AIR 2.5

Returns true if currentCSSState is not null. Typically, you do not call this method directly. It is called by the mx.styles.CSSCondition.matchesStyleClient() method.

Note Spark components use their skin state as the pseudo state. Halo components use the currentState property.

傳回值
Booleantrue if currentCSSState is not null. By default, currentCSSState is the same as currentState. If no state exists, return false.

hasState

()方法 
public function hasState(stateName:String):Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Determines whether the specified state has been defined on this UIComponent.

參數

stateName:String — The name of the state being checked.

傳回值
Boolean — Whether or not the specified state has been defined

horizontalGradientMatrix

()方法 
public function horizontalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Returns a box Matrix which can be passed to the drawRoundRect() method as the rot parameter when drawing a horizontal gradient.

For performance reasons, the Matrix is stored in a static variable which is reused by all calls to horizontalGradientMatrix() and verticalGradientMatrix(). Therefore, pass the resulting Matrix to drawRoundRect() before calling horizontalGradientMatrix() or verticalGradientMatrix() again.

參數

x:Number — The left coordinate of the gradient, in pixels.
 
y:Number — The top coordinate of the gradient, in pixels.
 
width:Number — The width of the gradient, in pixels.
 
height:Number — The height of the gradient, in pixels.

傳回值
Matrix — The Matrix for the horizontal gradient.

initAdvancedLayoutFeatures

()方法 
protected function initAdvancedLayoutFeatures():void

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Initializes the implementation and storage of some of the less frequently used advanced layout features of a component. Call this function before attempting to use any of the features implemented by the AdvancedLayoutFeatures object.

initializationComplete

()方法 
protected function initializationComplete():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Finalizes the initialization of this component.

This method is the last code that executes when you add a component to a parent for the first time using addChild() or addChildAt(). It handles some housekeeping related to dispatching the initialize event. If you are writing a component, you do not need to override this method.

initialize

()方法 
public function initialize():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Initializes the internal structure of this component.

Initializing a UIComponent is the fourth step in the creation of a visual component instance, and happens automatically the first time that the instance is added to a parent. Therefore, you do not generally need to call initialize(); the Flex framework calls it for you from UIComponent's override of the addChild() and addChildAt() methods.

The first step in the creation of a visual component instance is construction, with the new operator:

      var okButton:Button = new Button();

After construction, the new Button instance is a solitary DisplayObject; it does not yet have a UITextField as a child to display its label, and it doesn't have a parent.

The second step is configuring the newly-constructed instance with the appropriate properties, styles, and event handlers:

      okButton.label = "OK";
      okButton.setStyle("cornerRadius", 0);
      okButton.addEventListener(MouseEvent.CLICK, clickHandler);

The third step is adding the instance to a parent:

      someContainer.addChild(okButton);

A side effect of calling addChild() or addChildAt(), when adding a component to a parent for the first time, is that initialize gets automatically called.

This method first dispatches a preinitialize event, giving developers using this component a chance to affect it before its internal structure has been created. Next it calls the createChildren() method to create the component's internal structure; for a Button, this method creates and adds the UITextField for the label. Then it dispatches an initialize event, giving developers a chance to affect the component after its internal structure has been created.

Note that it is the act of attaching a component to a parent for the first time that triggers the creation of its internal structure. If its internal structure includes other UIComponents, then this is a recursive process in which the tree of DisplayObjects grows by one leaf node at a time.

If you are writing a component, you do not need to override this method.

initializeAccessibility

()方法 
protected function initializeAccessibility():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Initializes this component's accessibility code.

This method is called by the initialize() method to hook in the component's accessibility code, which resides in a separate class in the mx.accessibility package. Each subclass that supports accessibility must override this method because the hook-in process uses a different static variable in each subclass.

initializeRepeaterArrays

()方法 
public function initializeRepeaterArrays(parent:IRepeaterClient):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Initializes various properties which keep track of repeated instances of this component.

An MXML <mx:Repeater/> tag can cause repeated instances of a component to be created, one instance for each item in the Repeater's data provider. The instanceIndices, repeaters, and repeaterIndices properties of UIComponent keep track of which instance came from which data item and which Repeater.

This method is an internal method which is automatically called by the Flex framework. You do not have to call it or override it.

參數

parent:IRepeaterClient — The parent object containing the Repeater that created this component.

invalidateDisplayList

()方法 
public function invalidateDisplayList():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Marks a component so that its updateDisplayList() method gets called during a later screen update.

Invalidation is a useful mechanism for eliminating duplicate work by delaying processing of changes to a component until a later screen update. For example, if you want to change the width and height, it would be wasteful to update the component immediately after you change the width and then update again with the new height. It is more efficient to change both properties and then render the component with its new size once.

Invalidation methods rarely get called. In general, setting a property on a component automatically calls the appropriate invalidation method.

invalidateLayering

()方法 
public function invalidateLayering():void

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.4

Called by a component's items to indicate that their depth property has changed. Note that while this function is defined on UIComponent, it is up to subclasses to implement support for complex layering. By default, only Group and DataGroup support arbitrary layering of their children.

相關 API 元素

invalidateLayoutDirection

()方法 
public function invalidateLayoutDirection():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

An element must call this method when its layoutDirection changes or when its parent's layoutDirection changes. If they differ, this method is responsible for mirroring the element’s contents and for updating the element’s post-layout transform so that descendants inherit a mirrored coordinate system. IVisualElements typically implement mirroring by using postLayoutTransformOffsets to scale the X axis by -1 and to translate the x coordinate of the origin by the element's width. The net effect of this "mirror" transform is to reverse the direction in which the X axis increases without changing the element's location relative to its parent's origin.

invalidateParentSizeAndDisplayList

()方法 
protected function invalidateParentSizeAndDisplayList():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Helper method to invalidate parent size and display list if this object affects its layout (includeInLayout is true).

invalidateProperties

()方法 
public function invalidateProperties():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Marks a component so that its commitProperties() method gets called during a later screen update.

Invalidation is a useful mechanism for eliminating duplicate work by delaying processing of changes to a component until a later screen update. For example, if you want to change the text color and size, it would be wasteful to update the color immediately after you change it and then update the size when it gets set. It is more efficient to change both properties and then render the text with its new size and color once.

Invalidation methods rarely get called. In general, setting a property on a component automatically calls the appropriate invalidation method.

invalidateSize

()方法 
public function invalidateSize():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Marks a component so that its measure() method gets called during a later screen update.

Invalidation is a useful mechanism for eliminating duplicate work by delaying processing of changes to a component until a later screen update. For example, if you want to change the text and font size, it would be wasteful to update the text immediately after you change it and then update the size when it gets set. It is more efficient to change both properties and then render the text with its new size once.

Invalidation methods rarely get called. In general, setting a property on a component automatically calls the appropriate invalidation method.

isOurFocus

()方法 
protected function isOurFocus(target:DisplayObject):Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Typically overridden by components containing UITextField objects, where the UITextField object gets focus.

參數

target:DisplayObject — A UIComponent object containing a UITextField object that can receive focus.

傳回值
Boolean — Returns true if the UITextField object has focus.

keyDownHandler

()方法 
protected function keyDownHandler(event:KeyboardEvent):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The event handler called for a keyDown event. If you override this method, make sure to call the base class version.

參數

event:KeyboardEvent — The event object.

keyUpHandler

()方法 
protected function keyUpHandler(event:KeyboardEvent):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The event handler called for a keyUp event. If you override this method, make sure to call the base class version.

參數

event:KeyboardEvent — The event object.

localToContent

()方法 
public function localToContent(point:Point):Point

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Converts a Point object from local to content coordinates. Local coordinates specify a pixel position relative to the upper left corner of the component. Content coordinates specify a pixel position relative to the upper left corner of the component's content, and include all of the component's content area, including any regions that are currently clipped and must be accessed by scrolling the component. You use the content coordinate system to set and get the positions of children of a container that uses absolute positioning.

參數

point:Point — A Point object that specifies the x and y coordinates in the local coordinate system as properties.

傳回值
Point — Point A Point object with coordinates relative to the content coordinate system.

相關 API 元素

matchesCSSState

()方法 
public function matchesCSSState(cssState:String):Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Returns true if cssState matches currentCSSState. Typically, you do not call this method directly. It is called by the mx.styles.CSSCondition.matchesStyleClient() method.

Note Spark components use their skin state as the pseudo state. Halo components use the currentState property.

參數

cssState:String — A possible value of CSSCondition.value. It represents the current state of this component used to match CSS pseudo-selectors.

傳回值
Booleantrue if cssState matches currentCSSState. By default, currentCSSState is the same as currentState. If no state exists, return null.

matchesCSSType

()方法 
public function matchesCSSType(cssType:String):Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Determines whether this instance is the same as, or is a subclass of, the given type. Typically, you do not call this method directly. It is called by the mx.styles.CSSCondition.matchesStyleClient() method.

參數

cssType:String — A CSSSelector object.

傳回值
Booleantrue if cssType is in the hierarchy of qualified type selectors.

measure

()方法 
protected function measure():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Calculates the default size, and optionally the default minimum size, of the component. This is an advanced method that you might override when creating a subclass of UIComponent.

You do not call this method directly. Flex calls the measure() method when the component is added to a container using the addChild() method, and when the component's invalidateSize() method is called.

When you set a specific height and width of a component, Flex does not call the measure() method, even if you explicitly call the invalidateSize() method. That is, Flex only calls the measure() method if the explicitWidth property or the explicitHeight property of the component is NaN.

In your override of this method, you must set the measuredWidth and measuredHeight properties to define the default size. You can optionally set the measuredMinWidth and measuredMinHeight properties to define the default minimum size.

Most components calculate these values based on the content they are displaying, and from the properties that affect content display. A few components simply have hard-coded default values.

The conceptual point of measure() is for the component to provide its own natural or intrinsic size as a default. Therefore, the measuredWidth and measuredHeight properties should be determined by factors such as:

  • The amount of text the component needs to display.
  • The styles, such as fontSize, for that text.
  • The size of a JPEG image that the component displays.
  • The measured or explicit sizes of the component's children.
  • Any borders, margins, and gaps.

In some cases, there is no intrinsic way to determine default values. For example, a simple GreenCircle component might simply set measuredWidth = 100 and measuredHeight = 100 in its measure() method to provide a reasonable default size. In other cases, such as a TextArea, an appropriate computation (such as finding the right width and height that would just display all the text and have the aspect ratio of a Golden Rectangle) might be too time-consuming to be worthwhile.

The default implementation of measure() sets measuredWidth, measuredHeight, measuredMinWidth, and measuredMinHeight to 0.

更多範例

measureHTMLText

()方法 
public function measureHTMLText(htmlText:String):flash.text:TextLineMetrics

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

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.

參數

htmlText:String — A String specifying the HTML text to measure.

傳回值
flash.text:TextLineMetrics — A TextLineMetrics object containing the text measurements.

measureText

()方法 
public function measureText(text:String):flash.text:TextLineMetrics

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

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. Does not work for Spark components since they don't use UITextField (or UIFTETextField). To measure text in Spark components, get the measurements of a spark.components.Label or spark.components.RichText

參數

text:String — A String specifying the text to measure.

傳回值
flash.text:TextLineMetrics — A TextLineMetrics object containing the text measurements.

move

()方法 
public function move(x:Number, y:Number):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Moves the component to a specified position within its parent. Calling this method is exactly the same as setting the component's x and y properties.

If you are overriding the updateDisplayList() method in a custom component, call the move() method rather than setting the x and y properties. The difference is that the move() method changes the location of the component and then dispatches a move event when you call the method, while setting the x and y properties changes the location of the component and dispatches the event on the next screen refresh.

參數

x:Number — Left position of the component within its parent.
 
y:Number — Top position of the component within its parent.

notifyStyleChangeInChildren

()方法 
public function notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Propagates style changes to the children. You typically never need to call this method.

參數

styleProp:String — String specifying the name of the style property.
 
recursive:Boolean — Recursivly notify all children of this component.

owns

()方法 
public function owns(child:DisplayObject):Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Returns true if the chain of owner properties points from child to this UIComponent.

參數

child:DisplayObject — A UIComponent.

傳回值
Booleantrue if the child is parented or owned by this UIComponent.

parentChanged

()方法 
public function parentChanged(p:DisplayObjectContainer):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Called by Flex when a UIComponent object is added to or removed from a parent. Developers typically never need to call this method.

參數

p:DisplayObjectContainer — The parent of this UIComponent object.

prepareToPrint

()方法 
public function prepareToPrint(target:IFlexDisplayObject):Object

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Prepares an IFlexDisplayObject for printing. For the UIComponent class, the method performs no action. Flex containers override the method to prepare for printing; for example, by removing scroll bars from the printed output.

This method is normally not used by application developers.

參數

target:IFlexDisplayObject — The component to be printed. It can be the current component or one of its children.

傳回值
Object — Object containing the properties of the current component required by the finishPrint() method to restore it to its previous state.

相關 API 元素

regenerateStyleCache

()方法 
public function regenerateStyleCache(recursive:Boolean):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

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.

The Flex framework calls this method in the following situations:

  • When you add a UIComponent to a parent using the addChild() or addChildAt() methods.
  • When you change the styleName property of a UIComponent.
  • When you set a style in a CSS selector using the setStyle() method of CSSStyleDeclaration.

Building the style cache is a computation-intensive operation, so avoid changing styleName or setting selector styles unnecessarily.

This method is not called when you set an instance style by calling the setStyle() method of UIComponent. Setting an instance style is a relatively fast operation compared with setting a selector style.

You do not need to call or override this method.

參數

recursive:Boolean — Recursively regenerates the style cache for all children of this component.

registerEffects

()方法 
public function registerEffects(effects:Array):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

For each effect event, registers the EffectManager as one of the event listeners. You typically never need to call this method.

參數

effects:Array — The names of the effect events.

removeStyleClient

()方法 
public function removeStyleClient(styleClient:IAdvancedStyleClient):void

語言版本: ActionScript 3.0
產品版本: Flex 4.5
執行階段版本: Flash Player 9, AIR 1.1

Removes a non-visual style client from this component instance. Once this method has been called, the non-visual style client will no longer inherit style changes from this component instance. As a side effect, this method will set the styleParent property of the styleClient parameter to null. If the styleClient has not been added to this component instance, no action will be taken.

參數

styleClient:IAdvancedStyleClient — The IAdvancedStyleClient to remove from this component's list of non-visual style clients.

相關 API 元素

replayAutomatableEvent

()方法 
public function replayAutomatableEvent(event:Event):Boolean

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Replays the specified event. A component author should probably call super.replayAutomatableEvent in case default replay behavior has been defined in a superclass.

參數

event:Event — The event to replay.

傳回值
Booleantrue if a replay was successful.

resolveAutomationIDPart

()方法 
public function resolveAutomationIDPart(criteria:Object):Array

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Resolves a child by using the id provided. The id is a set of properties as provided by the createAutomationIDPart() method.

參數

criteria:Object — Set of properties describing the child. The criteria can contain regular expression values resulting in multiple children being matched.

傳回值
Array — Array of children that matched the criteria or null if no children could not be resolved.

resourcesChanged

()方法 
protected function resourcesChanged():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

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.

This event is dispatched when you set the ResourceManager's localeChain property, when a resource module has finished loading, and when you call the ResourceManager's update() method.

Subclasses should override this method and, after calling super.resourcesChanged(), do whatever is appropriate in response to having new resource values.

resumeBackgroundProcessing

()方法 
public static function resumeBackgroundProcessing():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Resumes the background processing of methods queued by callLater(), after a call to suspendBackgroundProcessing().

Refer to the description of suspendBackgroundProcessing() for more information.

setActualSize

()方法 
public function setActualSize(w:Number, h:Number):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Sizes the object. Unlike directly setting the width and height properties, calling the setActualSize() method does not set the explictWidth and explicitHeight properties, so a future layout calculation can result in the object returning to its previous size. This method is used primarily by component developers implementing the updateDisplayList() method, by Effects, and by the LayoutManager.

參數

w:Number — Width of the object.
 
h:Number — Height of the object.

setConstraintValue

()方法 
public function setConstraintValue(constraintName:String, value:*):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Sets a layout constraint value, which is the same as setting the constraint style for this component.

參數

constraintName:String — The name of the constraint style, which can be any of the following: left, right, top, bottom, verticalCenter, horizontalCenter, baseline
 
value:* — The value of the constraint can be specified in either of two forms. It can be specified as a numeric string, for example, "10" or it can be specified as identifier:numeric string. For identifier:numeric string, identifier is the id of a ConstraintRow or ConstraintColumn. For example, a value of "cc1:10" specifies a value of 10 for the ConstraintColumn that has the id "cc1."

setCurrentState

()方法 
public function setCurrentState(stateName:String, playTransition:Boolean = true):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Set the current state.

參數

stateName:String — The name of the new view state.
 
playTransition:Boolean (default = true) — If true, play the appropriate transition when the view state changes.

相關 API 元素

setFocus

()方法 
public function setFocus():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Sets the focus to this component. The component can in turn pass focus to a subcomponent.

Note: Only the TextInput and TextArea controls show a highlight when this method sets the focus. All controls show a highlight when the user tabs to the control.

setLayoutBoundsPosition

()方法 
public function setLayoutBoundsPosition(x:Number, y:Number, postLayoutTransform:Boolean = true):void

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Sets the coordinates that the element uses to draw on screen.

Note that calls to the setLayoutBoundSize() method can affect the layout position, so call setLayoutBoundPosition() after calling setLayoutBoundSize().

參數

x:Number — The x-coordinate of the top-left corner of the bounding box.
 
y:Number — The y-coordinate of the top-left corner of the bounding box.
 
postLayoutTransform:Boolean (default = true) — When postLayoutTransform is true, the element is positioned in such a way that the top-left corner of its bounding box is (x, y). The bounding box is in the element's parent coordinate space and is calculated from the element's layout size, layout position and layout transform matrix.

setLayoutBoundsSize

()方法 
public function setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Sets the layout size of the element. This is the size that the element uses to draw on screen.

If the width and/or height parameters are left unspecified (NaN), Flex sets the element's layout size to its preferred width and/or preferred height.

Note that calls to the setLayoutBoundSize() method can affect the layout position, so call setLayoutBoundPosition() after calling setLayoutBoundSize().

參數

width:Number — The element's layout width.
 
height:Number — The element's layout height.
 
postLayoutTransform:Boolean (default = true) — When postLayoutTransform is true, the specified sizes are those of the element's bounding box. The bounding box is in the element's parent coordinate space and is calculated from the element's layout size, layout position, and layout transform matrix.

setLayoutMatrix

()方法 
public function setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Sets the transform Matrix that is used to calculate the component's layout size and position relative to its siblings.

The matrix is typically defined by the component's 2D properties such as x, y, rotation, scaleX, scaleY, transformX, and transformY. Some components may have additional transform properties that are applied on top of the layout matrix to determine the final, computed matrix. For example UIComponent defines the offsets.

Note that layout Matrix is factored in the getPreferredSize(), getMinSize(), getMaxSize(), getLayoutSize() methods when computed in parent coordinates as well as in getLayoutPosition() in both parent and child coordinates. Layouts that calculate the transform matrix explicitly typically call this method and work with sizes in child coordinates. Layouts calling this method pass false to the invalidateLayout() method so that a subsequent layout pass is not triggered.

參數

value:Matrix — The matrix.
 
invalidateLayout:Booleantrue to cause the parent container to re-layout its children. You typically pass true to the invalidateLayout() method.

setLayoutMatrix3D

()方法 
public function setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Sets the transform Matrix3D that is used to calculate the component's layout size and position relative to its siblings.

This matrix is typically defined by the component's transform properties such as x, y, z, rotationX, rotationY, rotationZ, scaleX, scaleY, scaleZ, transformX, and transformY. Some components may have additional transform properties that are applied on top of the layout matrix to determine the final, computed matrix. For example UIComponent defines the offsets property.

Note that layout Matrix3D is factored in the getPreferredSize(), getMinSize(), getMaxSize(), getLayoutSize() when computed in parent coordinates as well as in getLayoutPosition() in both parent and child coordinates. Layouts that calculate the transform matrix explicitly typically call this method and work with sizes in child coordinates. Layouts calling this method pass false to the invalidateLayout() method so that a subsequent layout pass is not triggered.

參數

value:Matrix3D — The matrix.
 
invalidateLayout:Booleantrue to cause the parent container to re-layout its children. You typically pass true to the invalidateLayout() method.

setStretchXY

()方法 
protected function setStretchXY(stretchX:Number, stretchY:Number):void

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

Specifies a transform stretch factor in the horizontal and vertical direction. The stretch factor is applied to the computed matrix before any other transformation.

參數

stretchX:Number — The horizontal component of the stretch factor.
 
stretchY:Number — The vertical component of the stretch factor.

setStyle

()方法 
public function setStyle(styleProp:String, newValue:*):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Sets a style property on this component instance.

This can override a style that was set globally.

Calling the setStyle() method can result in decreased performance. Use it only when necessary.

參數

styleProp:String — Name of the style property.
 
newValue:* — New value for the style.

更多範例

setVisible

()方法 
public function setVisible(value:Boolean, noEvent:Boolean = false):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Called when the visible property changes. Set the visible property to show or hide a component instead of calling this method directly.

參數

value:Boolean — The new value of the visible property. Specify true to show the component, and false to hide it.
 
noEvent:Boolean (default = false) — If true, do not dispatch an event. If false, dispatch a show event when the component becomes visible, and a hide event when the component becomes invisible.

stateChanged

()方法 
protected function stateChanged(oldState:String, newState:String, recursive:Boolean):void

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

This method is called when a state changes to check whether state-specific styles apply to this component. If there is a chance of a matching CSS pseudo-selector for the current state, the style cache needs to be regenerated for this instance and, potentially all children, if the recursive param is set to true.

參數

oldState:String — The name of th eold state.
 
newState:String — The name of the new state.
 
recursive:Boolean — Set to true to perform a recursive check.

styleChanged

()方法 
public function styleChanged(styleProp:String):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Detects changes to style properties. When any style property is set, Flex calls the styleChanged() method, passing to it the name of the style being set.

This is an advanced method that you might override when creating a subclass of UIComponent. When you create a custom component, you can override the styleChanged() method to check the style name passed to it, and handle the change accordingly. This lets you override the default behavior of an existing style, or add your own custom style properties.

If you handle the style property, your override of the styleChanged() method should call the invalidateDisplayList() method to cause Flex to execute the component's updateDisplayList() method at the next screen update.

參數

styleProp:String — The name of the style property, or null if all styles for this component have changed.

stylesInitialized

()方法 
public function stylesInitialized():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Flex calls the stylesInitialized() method when the styles for a component are first initialized.

This is an advanced method that you might override when creating a subclass of UIComponent. Flex guarantees that your component's styles are fully initialized before the first time your component's measure and updateDisplayList methods are called. For most components, that is sufficient. But if you need early access to your style values, you can override the stylesInitialized() function to access style properties as soon as they are initialized the first time.

suspendBackgroundProcessing

()方法 
public static function suspendBackgroundProcessing():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Blocks the background processing of methods queued by callLater(), until resumeBackgroundProcessing() is called.

These methods can be useful when you have time-critical code which needs to execute without interruption. For example, when you set the suspendBackgroundProcessing property of an Effect to true, suspendBackgroundProcessing() is automatically called when it starts playing, and resumeBackgroundProcessing is called when it stops, in order to ensure that the animation is smooth.

Since the LayoutManager uses callLater(), this means that commitProperties(), measure(), and updateDisplayList() is not called in between calls to suspendBackgroundProcessing() and resumeBackgroundProcessing().

It is safe for both an outer method and an inner method (i.e., one that the outer methods calls) to call suspendBackgroundProcessing() and resumeBackgroundProcessing(), because these methods actually increment and decrement a counter which determines whether background processing occurs.

transformAround

()方法 
public function 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

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

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. This function will assign the rotation, scale, and translation values provided, then update the x/y/z properties as necessary to keep the transform center fixed.

參數

transformCenter:Vector3D — The point, in the component's own coordinates, to keep fixed relative to its parent.
 
scale:Vector3D (default = null) — The new values for the scale of the transform.
 
rotation:Vector3D (default = null) — the new values for the rotation of the transform
 
translation:Vector3D (default = null) — The new values for the translation of the transform.
 
postLayoutScale:Vector3D (default = null) — The new values for the post-layout scale of the transform.
 
postLayoutRotation:Vector3D (default = null) — The new values for the post-layout rotation of the transform.
 
postLayoutTranslation:Vector3D (default = null) — The new values for the post-layout translation of the transform.
 
invalidateLayout:Boolean (default = true) — If true, the parent container size and display are invalidated. Layouts calling this method pass false so that a subsequent layout pass is not triggered.

transformPointToParent

()方法 
public function transformPointToParent(localPosition:Vector3D, position:Vector3D, postLayoutPosition:Vector3D):void

語言版本: ActionScript 3.0
產品版本: Flex 4
執行階段版本: Flash Player 10, AIR 1.5

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. The pre-layout and post-layout result is set on the position and postLayoutPosition parameters, if they are non-null.

參數

localPosition:Vector3D — The point to be transformed, specified in the local coordinates of the object.
 
position:Vector3D — A Vector3D point that holds the pre-layout result. If null, the parameter is ignored.
 
postLayoutPosition:Vector3D — A Vector3D point that holds the post-layout result. If null, the parameter is ignored.

updateDisplayList

()方法 
protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Draws the object and/or sizes and positions its children. This is an advanced method that you might override when creating a subclass of UIComponent.

You do not call this method directly. Flex calls the updateDisplayList() method when the component is added to a container using the addChild() method, and when the component's invalidateDisplayList() method is called.

If the component has no children, this method is where you would do programmatic drawing using methods on the component's Graphics object such as graphics.drawRect().

If the component has children, this method is where you would call the move() and setActualSize() methods on its children.

Components can do programmatic drawing even if they have children. In doing either, use the component's unscaledWidth and unscaledHeight as its bounds.

It is important to use unscaledWidth and unscaledHeight instead of the width and height properties.

參數

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.

更多範例

validateDisplayList

()方法 
public function validateDisplayList():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Validates the position and size of children and draws other visuals. If the LayoutManager.invalidateDisplayList() method is called with this ILayoutManagerClient, then the validateDisplayList() method is called when it's time to update the display list.

validateNow

()方法 
public function validateNow():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Validate and update the properties and layout of this object and redraw it, if necessary. Processing properties that require substantial computation are normally not processed until the script finishes executing. For example setting the width property is delayed, because it can require recalculating the widths of the objects children or its parent. Delaying the processing prevents it from being repeated multiple times if the script sets the width property more than once. This method lets you manually override this behavior.

validateProperties

()方法 
public function validateProperties():void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Used by layout logic to validate the properties of a component by calling the commitProperties() method. In general, subclassers should override the commitProperties() method and not this method.

validateSize

()方法 
public function validateSize(recursive:Boolean = false):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

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.

參數

recursive:Boolean (default = false) — If true, call this method on the objects children.

validationResultHandler

()方法 
public function validationResultHandler(event:ValidationResultEvent):void

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Handles both the valid and invalid events from a validator assigned to this component.

You typically handle the valid and invalid events dispatched by a validator by assigning event listeners to the validators. If you want to handle validation events directly in the component that is being validated, you can override this method to handle the valid and invalid events. You typically call super.validationResultHandler(event) in your override.

參數

event:ValidationResultEvent — The event object for the validation.

相關 API 元素

verticalGradientMatrix

()方法 
public function verticalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Returns a box Matrix which can be passed to drawRoundRect() as the rot parameter when drawing a vertical gradient.

For performance reasons, the Matrix is stored in a static variable which is reused by all calls to horizontalGradientMatrix() and verticalGradientMatrix(). Therefore, pass the resulting Matrix to drawRoundRect() before calling horizontalGradientMatrix() or verticalGradientMatrix() again.

參數

x:Number — The left coordinate of the gradient, in pixels.
 
y:Number — The top coordinate of the gradient, in pixels.
 
width:Number — The width of the gradient, in pixels.
 
height:Number — The height of the gradient, in pixels.

傳回值
Matrix — The Matrix for the vertical gradient.
事件詳細資訊

add

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

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched when the component is added to a container as a content child by using the addChild(), addChildAt(), addElement(), or addElementAt() method. If the component is added to the container as a noncontent child by using the rawChildren.addChild() or rawChildren.addChildAt() method, the event is not dispatched.

This event is only dispatched when there are one or more relevant listeners attached to the dispatching object.

The FlexEvent.ADD constant defines the value of the type property of the event object for an add event.

This event will only be dispatched when there are one or more relevant listeners attached to the dispatching object.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.

creationComplete

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

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched when the component has finished its construction, property processing, measuring, layout, and drawing.

At this point, depending on its visible property, the component is not visible even though it has been drawn.

The FlexEvent.CREATION_COMPLETE constant defines the value of the type property of the event object for a creationComplete event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.

currentStateChange

事件  
事件物件類型: mx.events.StateChangeEvent
屬性 StateChangeEvent.type = mx.events.StateChangeEvent.CURRENT_STATE_CHANGE

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched after the view state has changed.

This event is only dispatched when there are one or more relevant listeners attached to the dispatching object.

The StateChangeEvent.CURRENT_STATE_CHANGE constant defines the value of the type property of the event that is dispatched when the view state has changed. The value of this constant is "currentStateChange".

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
newStateThe name of the view state that was entered.
oldStateThe name of the view state that was exited.
targetThe 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.
typeStateChangeEvent.CURRENT_STATE_CHANGE

currentStateChanging

事件  
事件物件類型: mx.events.StateChangeEvent
屬性 StateChangeEvent.type = mx.events.StateChangeEvent.CURRENT_STATE_CHANGING

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched after the currentState property changes, but before the view state changes.

This event is only dispatched when there are one or more relevant listeners attached to the dispatching object.

The StateChangeEvent.CURRENT_STATE_CHANGING constant defines the value of the type property of the event that is dispatched when the view state is about to change. The value of this constant is "currentStateChanging".

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
newStateThe name of the view state that is being entered.
oldStateThe name of the view state that is being exited.
targetThe 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.
typeStateChangeEvent.CURRENT_STATE_CHANGING

dragComplete

事件  
事件物件類型: mx.events.DragEvent
屬性 DragEvent.type = mx.events.DragEvent.DRAG_COMPLETE

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

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.

You can use this event to perform any final cleanup of the drag-and-drop operation. For example, if you drag a List control item from one list to another, you can delete the List control item from the source if you no longer need it.

If you call Event.preventDefault() in the event handler for the dragComplete event for a Tree control when dragging data from one Tree control to another, it prevents the drop.

The DragEvent.DRAG_COMPLETE constant defines the value of the type property of the event object for a dragComplete event.

The properties of the event object have the following values:

PropertyValue
actionThe action that caused the event: DragManager.COPY, DragManager.LINK, DragManager.MOVE, or DragManager.NONE.
bubblesfalse
cancelablefalse
currentTargetThe 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.
dragInitiatorThe component that initiated the drag.
dragSourceThe DragSource object containing the data being dragged.
targetThe 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.

dragDrop

事件  
事件物件類型: mx.events.DragEvent
屬性 DragEvent.type = mx.events.DragEvent.DRAG_DROP

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched by the drop target when the user releases the mouse over it.

You use this event handler to add the drag data to the drop target.

If you call Event.preventDefault() in the event handler for the dragDrop event for a Tree control when dragging data from one Tree control to another, it prevents the drop.

The DragEvent.DRAG_DROP constant defines the value of the type property of the event object for a dragDrop event.

The properties of the event object have the following values:

PropertyValue
actionThe action that caused the event: DragManager.COPY, DragManager.LINK, DragManager.MOVE, or DragManager.NONE.
bubblesfalse
cancelablefalse
currentTargetThe 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.
dragInitiatorThe component that initiated the drag.
dragSourceThe DragSource object containing the data being dragged.
targetThe 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.

dragEnter

事件  
事件物件類型: mx.events.DragEvent
屬性 DragEvent.type = mx.events.DragEvent.DRAG_ENTER

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched by a component when the user moves the mouse over the component during a drag operation. In an application running in Flash Player, the event is dispatched many times when you move the mouse over any component. In an application running in AIR, the event is dispatched only once.

In order to be a valid drop target, you must define a handler for this event. In the handler, you can change the appearance of the drop target to provide visual feedback to the user that the component can accept the drag. For example, you could draw a border around the drop target, or give focus to the drop target.

If you want to accept the drag, you must call the DragManager.acceptDragDrop() method. If you don't call acceptDragDrop(), you do not get any of the other drag events.

In Flash Player, the value of the action property is always DragManager.MOVE, even if you are doing a copy. This is because the dragEnter event occurs before the control recognizes that the Control key is pressed to signal a copy. The action property of the event object for the dragOver event does contain a value that signifies the type of drag operation. You can change the type of drag action by calling the DragManager.showFeedback() method.

In AIR, the default value of the action property is DragManager.COPY.

Because of the way data to a Tree control is structured, the Tree control handles drag and drop differently from the other list-based controls. For the Tree control, the event handler for the dragDrop event only performs an action when you move or copy data in the same Tree control, or copy data to another Tree control. If you drag data from one Tree control and drop it onto another Tree control to move the data, the event handler for the dragComplete event actually performs the work to add the data to the destination Tree control, rather than the event handler for the dragDrop event, and also removes the data from the source Tree control. This is necessary because to reparent the data being moved, Flex must remove it first from the source Tree control.

The DragEvent.DRAG_ENTER constant defines the value of the type property of the event object for a dragEnter event.

The properties of the event object have the following values:

PropertyValue
actionThe action that caused the event, which is always DragManager.MOVE.
bubblesfalse
cancelablefalse
currentTargetThe 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.
dragInitiatorThe component that initiated the drag.
dragSourceThe DragSource object containing the data being dragged.
targetThe 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.

相關 API 元素

dragExit

事件  
事件物件類型: mx.events.DragEvent
屬性 DragEvent.type = mx.events.DragEvent.DRAG_EXIT

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched by the component when the user drags outside the component, but does not drop the data onto the target.

You use this event to restore the drop target to its normal appearance if you modified its appearance as part of handling the dragEnter or dragOver event.

The DragEvent.DRAG_EXIT constant defines the value of the type property of the event object for a dragExit event.

The properties of the event object have the following values:

PropertyValue
actionThe action that caused the event: DragManager.COPY, DragManager.LINK, DragManager.MOVE, or DragManager.NONE.
bubblesfalse
cancelablefalse
currentTargetThe 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.
dragInitiatorThe component that initiated the drag.
dragSourceThe DragSource object containing the data being dragged.
targetThe 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.

dragOver

事件  
事件物件類型: mx.events.DragEvent
屬性 DragEvent.type = mx.events.DragEvent.DRAG_OVER

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched by a component when the user moves the mouse while over the component during a drag operation. In Flash Player, the event is dispatched when you drag an item over a valid drop target. In AIR, the event is dispatched when you drag an item over any component, even if the component is not a valid drop target.

In the handler, you can change the appearance of the drop target to provide visual feedback to the user that the component can accept the drag. For example, you could draw a border around the drop target, or give focus to the drop target.

Handle this event to perform additional logic before allowing the drop, such as dropping data to various locations in the drop target, reading keyboard input to determine if the drag-and-drop action is a move or copy of the drag data, or providing different types of visual feedback based on the type of drag-and-drop action.

You can also change the type of drag action by changing the DragManager.showFeedback() method. The default value of the action property is DragManager.MOVE.

The DragEvent.DRAG_OVER constant defines the value of the type property of the event object for a dragOver event.

The properties of the event object have the following values:

PropertyValue
actionThe action that caused the event: DragManager.COPY, DragManager.LINK, DragManager.MOVE, or DragManager.NONE.
bubblesfalse
cancelablefalse
currentTargetThe 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.
dragInitiatorThe component that initiated the drag.
dragSourceThe DragSource object containing the data being dragged.
targetThe 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.

相關 API 元素

dragStart

事件  
事件物件類型: mx.events.DragEvent
屬性 DragEvent.type = mx.events.DragEvent.DRAG_START

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched by the drag initiator when starting a drag operation. This event is used internally by the list-based controls; you do not handle it when implementing drag and drop. If you want to control the start of a drag-and-drop operation, use the mouseDown or mouseMove event.

The DragEvent.DRAG_START constant defines the value of the type property of the event object for a dragStart event.

The properties of the event object have the following values:

PropertyValue
actionThe action that caused the event: DragManager.COPY, DragManager.LINK, DragManager.MOVE, or DragManager.NONE.
bubblesfalse
cancelablefalse
currentTargetThe 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.
dragInitiatorThe component that initiated the drag.
dragSourceThe DragSource object containing the data being dragged.
targetThe 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.

effectEnd

事件  
事件物件類型: mx.events.EffectEvent
屬性 EffectEvent.type = mx.events.EffectEvent.EFFECT_END

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched after an effect ends.

The effect makes the last set of visual changes before this event is fired, but those changes are not rendered on the screen. Thus, you might have to use the callLater() method to delay any other changes that you want to make until after the changes have been rendered onscreen.

The EffectEvent.EFFECT_END constant defines the value of the type property of the event object for an effectEnd event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
effectInstanceThe effect instance object for the event.
targetThe 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.

effectStart

事件  
事件物件類型: mx.events.EffectEvent
屬性 EffectEvent.type = mx.events.EffectEvent.EFFECT_START

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched just before an effect starts.

The effect does not start changing any visuals until after this event is fired.

The EffectEvent.EFFECT_START constant defines the value of the type property of the event object for an effectStart event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
effectInstanceThe effect instance object for the event.
targetThe 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.

effectStop

事件  
事件物件類型: mx.events.EffectEvent
屬性 EffectEvent.type = mx.events.EffectEvent.EFFECT_STOP

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched after an effect is stopped, which happens only by a call to stop() on the effect.

The effect then dispatches the EFFECT_END event as the effect finishes. The purpose of the EFFECT_STOP event is to let listeners know that the effect came to a premature end, rather than ending naturally or as a result of a call to end().

The EffectEvent.EFFECT_STOP constant defines the value of the type property of the event object for an effectStop event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
effectInstanceThe effect instance object for the event.
targetThe 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.

enterState

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

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched after the component has entered a view state.

This event is only dispatched when there are one or more relevant listeners attached to the dispatching object.

The FlexEvent.ENTER_STATE constant defines the value of the type property of the event object for a enterState event.

This event will only be dispatched when there are one or more relevant listeners attached to the dispatching object.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.

exitState

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

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched just before the component exits a view state.

This event is only dispatched when there are one or more relevant listeners attached to the dispatching object.

The FlexEvent.EXIT_STATE constant defines the value of the type property of the event object for a exitState event.

This event will only be dispatched when there are one or more relevant listeners attached to the dispatching object.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.

hide

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

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched when an object's state changes from visible to invisible.

This event is only dispatched when there are one or more relevant listeners attached to the dispatching object.

The FlexEvent.HIDE constant defines the value of the type property of the event object for a hide event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.

initialize

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

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched when the component has finished its construction and has all initialization properties set.

After the initialization phase, properties are processed, the component is measured, laid out, and drawn, after which the creationComplete event is dispatched.

The FlexEvent.INITIALIZE constant defines the value of the type property of the event object for a initialize event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.

invalid

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

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched when a component is monitored by a Validator and the validation failed.

The FlexEvent.INVALID constant defines the value of the type property of the event object for a invalid event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.

mouseDownOutside

事件  
事件物件類型: mx.events.FlexMouseEvent
屬性 FlexMouseEvent.type = mx.events.FlexMouseEvent.MOUSE_DOWN_OUTSIDE

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched from a component opened using the PopUpManager when the user clicks outside it.

The FlexMouseEvent.MOUSE_DOWN_OUTSIDE constant defines the value of the type property of the event object for a mouseDownOutside event.

The properties of the event object have the following values:

PropertyValue
altKeyIndicates whether the Alt key is down (true) or not (false).
bubblesfalse
buttonDownIndicates whether the main mouse button is down (true) or not (false).
cancelablefalse
ctrlKeyIndicates whether the Control key is down (true) or not (false).
currentTargetThe 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. For PopUpManager events, the object is the pop-up window.
deltaIndicates how many lines should be scrolled for each notch the user scrolls the mouse wheel. For PopUpManager events this value is 0.
localXThe horizontal position at which the event occurred. For PopUpManager events, the value is relative to the pop-up control.
localYThe vertical position at which the event occurred. For PopUpManager events, the value is relative to the pop-up control.
relatedObjectA reference to a display list object that is related to the event. For PopUpManager events, the object is the container over which the mouse pointer is located.
shiftKeyIndicates whether the Shift key is down (true) or not (false).
targetThe 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. For PopUpManager events, the object is the pop-up window.

mouseWheelOutside

事件  
事件物件類型: mx.events.FlexMouseEvent
屬性 FlexMouseEvent.type = mx.events.FlexMouseEvent.MOUSE_WHEEL_OUTSIDE

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched from a component opened using the PopUpManager when the user scrolls the mouse wheel outside it.

The FlexMouseEvent.MOUSE_WHEEL_OUTSIDE constant defines the value of the type property of the event object for a mouseWheelOutside event.

The properties of the event object have the following values:

PropertyValue
altKeyIndicates whether the Alt key is down (true) or not (false).
bubblesfalse
buttonDownIndicates whether the main mouse button is down (true) or not (false).
cancelablefalse
ctrlKeyIndicates whether the Control key is down (true) or not (false).
currentTargetThe 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. For PopUpManager events, the object is the pop-up window.
deltaIndicates how many lines should be scrolled for each notch the user scrolls the mouse wheel. For PopUpManager events this value is 0.
localXThe horizontal position at which the event occurred. For PopUpManager events, the value is relative to the pop-up control.
localYThe vertical position at which the event occurred. For PopUpManager events, the value is relative to the pop-up control.
relatedObjectA reference to a display list object that is related to the event. For PopUpManager events, the object is the container over which the mouse pointer is located.
shiftKeyIndicates whether the Shift key is down (true) or not (false).
targetThe 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. For PopUpManager events, the object is the pop-up window.

move

事件  
事件物件類型: mx.events.MoveEvent
屬性 MoveEvent.type = mx.events.MoveEvent.MOVE

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched when the object has moved.

You can move the component by setting the x or y properties, by calling the move() method, by setting one of the following properties either on the component or on other components such that the LayoutManager needs to change the x or y properties of the component:

  • minWidth
  • minHeight
  • maxWidth
  • maxHeight
  • explicitWidth
  • explicitHeight

When you call the move() method, the move event is dispatched before the method returns. In all other situations, the move event is not dispatched until after the property changes.

This event only dispatched when there are one or more relevant listeners attached to the dispatching object.

The MoveEvent.MOVE constant defines the value of the type property of the event object for a move event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
oldXThe previous x coordinate of the object, in pixels.
oldYThe previous y coordinate of the object, in pixels.
targetThe 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.

preinitialize

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

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched at the beginning of the component initialization sequence. The component is in a very raw state when this event is dispatched. Many components, such as the Button control, create internal child components to implement functionality; for example, the Button control creates an internal UITextField component to represent its label text. When Flex dispatches the preinitialize event, the children, including the internal children, of a component have not yet been created.

The FlexEvent.PREINITIALIZE constant defines the value of the type property of the event object for a preinitialize event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.

remove

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

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched when the component is removed from a container as a content child by using the removeChild(), removeChildAt(), removeElement(), or removeElementAt() method. If the component is removed from the container as a noncontent child by using the rawChildren.removeChild() or rawChildren.removeChildAt() method, the event is not dispatched.

This event only dispatched when there are one or more relevant listeners attached to the dispatching object.

The FlexEvent.REMOVE constant defines the value of the type property of the event object for an remove event.

This event will only be dispatched when there are one or more relevant listeners attached to the dispatching object.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.

resize

事件  
事件物件類型: mx.events.ResizeEvent
屬性 ResizeEvent.type = mx.events.ResizeEvent.RESIZE

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched when the component is resized.

You can resize the component by setting the width or height property, by calling the setActualSize() method, or by setting one of the following properties either on the component or on other components such that the LayoutManager needs to change the width or height properties of the component:

  • minWidth
  • minHeight
  • maxWidth
  • maxHeight
  • explicitWidth
  • explicitHeight

The resize event is not dispatched until after the property changes.

This event only dispatched when there are one or more relevant listeners attached to the dispatching object.

The ResizeEvent.RESIZE constant defines the value of the type property of the event object for a resize event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
oldHeightThe previous height of the object, in pixels.
oldWidthThe previous width of the object, in pixels.
targetThe 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.

show

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

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched when an object's state changes from invisible to visible.

This event is only dispatched when there are one or more relevant listeners attached to the dispatching object.

The FlexEvent.SHOW constant defines the value of the type property of the event object for a show event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.

stateChangeComplete

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

語言版本: ActionScript 3.0
產品版本: Flex 4.5
執行階段版本: Flash Player 10, AIR 2.5

Dispatched after the component has entered a new state and any state transition animation to that state has finished playing. The event is dispatched immediately if there's no transition playing between the states. If the component switches to a different state while the transition is underway, this event will be dispatched after the component completes the transition to that new state.

This event is only dispatched when there are one or more relevant listeners attached to the dispatching object.

The FlexEvent.STATE_CHANGE_COMPLETE constant defines the value of the type property of the event object for a stateChangeComplete event.

This event will only be dispatched when there are one or more relevant listeners attached to the dispatching object.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.

stateChangeInterrupted

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

語言版本: ActionScript 3.0
產品版本: Flex 4.5
執行階段版本: Flash Player 10, AIR 2.5

Dispatched when a component interrupts a transition to its current state in order to switch to a new state.

This event is only dispatched when there are one or more relevant listeners attached to the dispatching object.

The FlexEvent.STATE_CHANGE_INTERRUPTED constant defines the value of the type property of the event object for a stateChangeInterrupted event.

This event will only be dispatched when there are one or more relevant listeners attached to the dispatching object.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.

toolTipCreate

事件  
事件物件類型: mx.events.ToolTipEvent
屬性 ToolTipEvent.type = mx.events.ToolTipEvent.TOOL_TIP_CREATE

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched by the component when it is time to create a ToolTip.

If you create your own IToolTip object and place a reference to it in the toolTip property of the event object that is passed to your toolTipCreate handler, the ToolTipManager displays your custom ToolTip. Otherwise, the ToolTipManager creates an instance of ToolTipManager.toolTipClass to display.

The sequence of ToolTip events is toolTipStart, toolTipCreate, toolTipShow, toolTipShown, toolTipHide, and toolTipEnd.

The ToolTipEvent.TOOL_TIP_CREATE constant defines the value of the type property of the event object for a toolTipCreate event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.
tooltipThe ToolTip object to which this event applies.

toolTipEnd

事件  
事件物件類型: mx.events.ToolTipEvent
屬性 ToolTipEvent.type = mx.events.ToolTipEvent.TOOL_TIP_END

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched by the component when its ToolTip has been hidden and is to be discarded soon.

If you specify an effect using the ToolTipManager.hideEffect property, this event is dispatched after the effect stops playing.

The sequence of ToolTip events is toolTipStart, toolTipCreate, toolTipShow, toolTipShown, toolTipHide, and toolTipEnd.

The ToolTipEvent.TOOL_TIP_END constant defines the value of the type property of the event object for a toolTipEnd event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.
tooltipThe ToolTip object to which this event applies.

toolTipHide

事件  
事件物件類型: mx.events.ToolTipEvent
屬性 ToolTipEvent.type = mx.events.ToolTipEvent.TOOL_TIP_HIDE

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched by the component when its ToolTip is about to be hidden.

If you specify an effect using the ToolTipManager.hideEffect property, this event is dispatched before the effect starts playing.

The sequence of ToolTip events is toolTipStart, toolTipCreate, toolTipShow, toolTipShown, toolTipHide, and toolTipEnd.

The ToolTipEvent.TOOL_TIP_HIDE constant defines the value of the type property of the event object for a toolTipHide event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.
tooltipThe ToolTip object to which this event applies.

toolTipShow

事件  
事件物件類型: mx.events.ToolTipEvent
屬性 ToolTipEvent.type = mx.events.ToolTipEvent.TOOL_TIP_SHOW

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched by the component when its ToolTip is about to be shown.

If you specify an effect using the ToolTipManager.showEffect property, this event is dispatched before the effect starts playing. You can use this event to modify the ToolTip before it appears.

The sequence of ToolTip events is toolTipStart, toolTipCreate, toolTipShow, toolTipShown, toolTipHide, and toolTipEnd.

The ToolTipEvent.TOOL_TIP_SHOW constant defines the value of the type property of the event object for a toolTipShow event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.
tooltipThe ToolTip object to which this event applies.

toolTipShown

事件  
事件物件類型: mx.events.ToolTipEvent
屬性 ToolTipEvent.type = mx.events.ToolTipEvent.TOOL_TIP_SHOWN

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched by the component when its ToolTip has been shown.

If you specify an effect using the ToolTipManager.showEffect property, this event is dispatched after the effect stops playing.

The sequence of ToolTip events is toolTipStart, toolTipCreate, toolTipShow, toolTipShown, toolTipHide, and toolTipEnd.

The ToolTipEvent.TOOL_TIP_SHOWN constant defines the value of the type property of the event object for a toolTipShown event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.
tooltipThe ToolTip object to which this event applies.

toolTipStart

事件  
事件物件類型: mx.events.ToolTipEvent
屬性 ToolTipEvent.type = mx.events.ToolTipEvent.TOOL_TIP_START

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched by a component whose toolTip property is set, as soon as the user moves the mouse over it.

The sequence of ToolTip events is toolTipStart, toolTipCreate, toolTipShow, toolTipShown, toolTipHide, and toolTipEnd.

The ToolTipEvent.TOOL_TIP_START constant defines the value of the type property of the event object for a toolTipStart event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.
tooltipThe ToolTip object to which this event applies.

touchInteractionEnd

事件  
事件物件類型: mx.events.TouchInteractionEvent
屬性 TouchInteractionEvent.type = mx.events.TouchInteractionEvent.TOUCH_INTERACTION_END

語言版本: ActionScript 3.0
產品版本: Flex 4.5
執行階段版本: Flash Player 10, AIR 2.5

A non-cancellable event, dispatched by a component when it is done responding to a touch interaction user gesture.

The event is a bubbling event dispatched on the DisplayObject that the touch interaction started (where the mouseDown/touchBegin occurred).

Components responding to touch interactions should listen for touch interaction events to coordinate with other components around what type of touch interaction the user intended to make and which component is responding to that touch interaction.

A Scroller component will dispatch a touchInteractionEnd event to alert other components that it is done responding to the user's touch interaction.

The TouchInteractionEvent.TOUCH_INTERACTION_END constant defines the value of the type property of the event object for a touchInteractionEnd event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
reasonThe reason for the touch interaction event. See mx.events.TouchInteractionReason.
relatedObjectThe object associated with this touch interaction event.
targetThe 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.

touchInteractionStart

事件  
事件物件類型: mx.events.TouchInteractionEvent
屬性 TouchInteractionEvent.type = mx.events.TouchInteractionEvent.TOUCH_INTERACTION_START

語言版本: ActionScript 3.0
產品版本: Flex 4.5
執行階段版本: Flash Player 10, AIR 2.5

A non-cancellable event, dispatched by a component when it starts responding to a touch interaction user gesture.

The event is a bubbling event dispatched on the DisplayObject that the touch interaction started (where the mouseDown/touchBegin occurred).

Components responding to touch interactions should listen for touch interaction events to coordinate with other components around what type of touch interaction the user intended to make and which component is responding to that touch interaction.

A Scroller component will dispatch a touchInteractionStart event to alert other components that may be responding to the same user's touch interaction that it is taking control of this touch interaction. When they see this event, other components should stop responding to the touch interaction, remove any visual indications that it is responding to the touch interaction, and perform other clean up.

The TouchInteractionEvent.TOUCH_INTERACTION_START constant defines the value of the type property of the event object for a touchInteractionStart event.

The properties of the event object have the following values:

PropertyValue
bubblestrue
cancelablefalse
currentTargetThe 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.
reasonThe reason for the touch interaction event. See mx.events.TouchInteractionReason.
relatedObjectThe object associated with this touch interaction event.
targetThe 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.

touchInteractionStarting

事件  
事件物件類型: mx.events.TouchInteractionEvent
屬性 TouchInteractionEvent.type = mx.events.TouchInteractionEvent.TOUCH_INTERACTION_STARTING

語言版本: ActionScript 3.0
產品版本: Flex 4.5
執行階段版本: Flash Player 10, AIR 2.5

A cancellable event, dispatched by a component in an attempt to respond to a touch interaction user gesture.

The event is a bubbling event dispatched on the DisplayObject that the touch interaction started (where the mouseDown/touchBegin occurred).

Components responding to touch interactions should listen for touch interaction events to coordinate with other components around what type of touch interaction the user intended to make and which component is responding to that touch interaction.

A Scroller component will dispatch a touchInteractionStarting event to alert other components that may be responding to the same user's touch interaction that it would like to take control of this touch interaction. This is an opportunity for other components to cancel the Scroller's action and to maintain control over this touch interaction.

The TouchInteractionEvent.TOUCH_INTERACTION_STARTING constant defines the value of the type property of the event object for a touchInteractionStarting event.

The properties of the event object have the following values:

PropertyValue
bubblestrue
cancelabletrue
currentTargetThe 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.
reasonThe reason for the touch interaction event. See mx.events.TouchInteractionReason.
relatedObjectThe object associated with this touch interaction event.
targetThe 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.

updateComplete

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

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched when an object has had its commitProperties(), measure(), and updateDisplayList() methods called (if needed).

This is the last opportunity to alter the component before it is displayed. All properties have been committed and the component has been measured and layed out.

This event is only dispatched when there are one or more relevant listeners attached to the dispatching object.

The FlexEvent.UPDATE_COMPLETE constant defines the value of the type property of the event object for a updateComplete event.

This event will only be dispatched when there are one or more relevant listeners attached to the dispatching object.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.

valid

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

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched when a component is monitored by a Validator and the validation succeeded.

The FlexEvent.VALID constant defines the value of the type property of the event object for a valid event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.

valueCommit

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

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

Dispatched when values are changed programmatically or by user interaction.

Because a programmatic change triggers this event, make sure that any valueCommit event handler does not change a value that causes another valueCommit event. For example, do not change a control's dataProvider property in a valueCommit event handler.

The FlexEvent.VALUE_COMMIT constant defines the value of the type property of the event object for a valueCommit event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe 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.
targetThe 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.
常數詳細資訊

DEFAULT_MAX_HEIGHT

常數
public static const DEFAULT_MAX_HEIGHT:Number = 10000

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The default value for the maxHeight property.

預設值為 10000。

DEFAULT_MAX_WIDTH

常數 
public static const DEFAULT_MAX_WIDTH:Number = 10000

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The default value for the maxWidth property.

預設值為 10000。

DEFAULT_MEASURED_HEIGHT

常數 
public static const DEFAULT_MEASURED_HEIGHT:Number = 22

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The default value for the measuredHeight property. Most components calculate a measuredHeight but some are flow-based and have to pick a number that looks reasonable.

預設值為 22。

DEFAULT_MEASURED_MIN_HEIGHT

常數 
public static const DEFAULT_MEASURED_MIN_HEIGHT:Number = 22

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The default value for the measuredMinHeight property. Most components calculate a measuredMinHeight but some are flow-based and have to pick a number that looks reasonable.

預設值為 22。

DEFAULT_MEASURED_MIN_WIDTH

常數 
public static const DEFAULT_MEASURED_MIN_WIDTH:Number = 40

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The default value for the measuredMinWidth property. Most components calculate a measuredMinWidth but some are flow-based and have to pick a number that looks reasonable.

預設值為 40。

DEFAULT_MEASURED_WIDTH

常數 
public static const DEFAULT_MEASURED_WIDTH:Number = 160

語言版本: ActionScript 3.0
產品版本: Flex 3
執行階段版本: Flash Player 9, AIR 1.1

The default value for the measuredWidth property. Most components calculate a measuredWidth but some are flow-based and have to pick a number that looks reasonable.

預設值為 160。





[ X ]為什麼顯示英文?
「ActionScript 3.0 參考」的內容是以英文顯示

並非所有「ActionScript 3.0 參考」的內容都翻譯為所有語言。當語言元素未翻譯時,就會以英文顯示。例如,ga.controls.HelpBox 類別並沒有翻譯為任何語言。因此在參考的繁體中文版本中,ga.controls.HelpBox 類別就會以英文顯示。