spark.components.supportClassesSkinnableContainerBase 可设置外观的容器组件的基类。 禁用状态 AIR 1.5 3.0 Flex 4 正常状态 AIR 1.5 3.0 Flex 4 mx.managers:IFocusManagerContainerspark.components.supportClasses:SkinnableComponent 可设置外观的容器组件的基类。 SkinnableContainerBase 构造函数。 构造函数。 getCurrentSkinState 返回要应用到外观的状态的名称。指定要应用到外观的状态的名称的字符串。 返回要应用到外观的状态的名称。例如,一个 Button 组件可能会返回 String“up”、“down”、“over”或“disabled”以指定该状态。

SkinnableComponent 的子类必须覆盖此方法才可返回值。

defaultButton 指定为容器的默认按钮的 Button 控件。null 指定为容器的默认按钮的 Button 控件。当容器中的控件具有焦点时,按 Enter 键与单击此 Button 控件的效果相同。
Range Range 类包含一个值和一个该值所允许的范围,它们由 minimum 和 maximum 属性定义。The <s:Range> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:Range
    Properties
    maximum="100"
    minimum="0"
    snapInterval="1"
    stepSize="1"
    value="0"
  />
  
]]>
spark.components.supportClasses:SkinnableComponent Range 类包含一个值和一个该值所允许的范围,它们由 minimummaximum 属性定义。会始终将 value 属性约束为处于当前 minimummaximum 之间,且始终将 minimummaximum 约束为按照正确的数字顺序,从而使 (minimum <= value <= maximum)true。如果 snapInterval 属性的值不为 0,则也会将 value 属性约束为 snapInterval 的倍数。

Range 是需要 range 功能的各种控件(包括 TrackBase 和 Spinner)的基类。

spark.components.supportClasses.TrackBasespark.components.SpinnerRange 构造函数。 构造函数。 changeValueByStep 按 stepSize 增大或减小 value。increasetrue若为 true,则向 value 增加 stepSize,否则减去它。 stepSize 增大或减小 valuenearestValidValue 返回 minimum 与最接近 value 的 interval 的整数倍数之和,除非 value 更接近最大值限制,在该情况下,返回 maximum。最接近输入的有效值。 value输入值。 intervalsnapInterval 的值,或 snapInterval 的整数倍数。 返回 minimum 与最接近 valueinterval 的整数倍数之和,除非 value 更接近最大值限制,在该情况下,返回 maximum。

如果 interval 等于 0,则会将该值剪裁到最小值和最大值限制。

范围的有效值由 minimum 属性与 interval 的倍数之和定义,还被定义为小于或等于 maximum 属性。maximum 不需要是 snapInterval 的倍数。

例如,如果 minimum 等于 1,maximum 等于 6,且 snapInterval 等于 3,则 Range 的有效值有 1、2、5、6。类似地,如果 minimum 等于 2,maximum 等于 9,且 snapInterval 等于 1.5,则 Range 的有效值有 2、3.5、5、6.5、8 和 9。

setValue 在 value 属性改变时为该属性设置后备存储,并分派 valueCommit 事件。valuevalue 属性的新值。 value 属性改变时为该属性设置后备存储,并分派 valueCommit 事件。

value 属性的所有更新都会导致调用此方法。

此方法假定调用者已经使用了 nearestValidValue() 方法来约束 value 参数

nearestValidValue
maximum 最大有效 value。100 最大有效 value

commitProperties() 使用 nearestValidValue() 方法将对 value 属性的更改约束为小于或等于最大值。

nearestValidValue
minimum 最小有效 value。0 最小有效 value

commitProperties() 使用 nearestValidValue() 方法将对 value 属性的更改约束为大于或等于最小值。

nearestValidValue
snapInterval snapInterval 属性控制 value 属性的有效值。1 snapInterval 属性控制 value 属性的有效值。如果为非零,则有效值为 minimum 与此属性的整数倍数之和,且小于或等于 maximum

例如,如果 minimum 为 10,maximum 为 20,而此属性为 3,则可能的有效值为 10、13、16、19 和 20。

如果此属性的值为零,则仅会将有效值约束到介于 minimum 和 maximum 之间(包括两者)。

此属性还约束 stepSize 属性(如果设置)的有效值。如果未显式设置此属性,但设置了 stepSize,则 snapInterval 将默认为 stepSize

nearestValidValue
stepSize 调用 changeValueByStep() 方法时 value 属性更改的数量。1 调用 changeValueByStep() 方法时 value 属性更改的数量。除非 snapInterval 为 0,否则它必须是 snapInterval 的倍数。如果 stepSize 不是倍数,则会将它近似到大于或等于 snapInterval 的最近的倍数。 value 此范围的当前值。0 此范围的当前值。

commitProperties() 使用 nearestValidValue() 方法将对 value 属性的更改约束为大于或等于 minimum 属性,小于或等于 maximum 属性,以及 snapInterval 的倍数。

setValuenearestValidValue
ToggleButtonBase ToggleButtonBase 组件是支持 selected 属性的 Spark 按钮组件的基类。 选中时按钮的已禁用状态 AIR 1.5 3.0 Flex 4 选中时按钮的按下状态 AIR 1.5 3.0 Flex 4 选中时按钮的经过状态 AIR 1.5 3.0 Flex 4 选中时按钮的弹起状态 AIR 1.5 3.0 Flex 4 The <s:ToggleButtonBase> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:ToggleButtonBase
    Properties
    selected="false"
 
    events
    change="No default"
  />
  
]]>
spark.components.supportClasses:ButtonBase ToggleButtonBase 组件是支持 selected 属性的 Spark 按钮组件的基类。ToggleButton、CheckBox 和 RadioButton 是 ToggleButtonBase 的子类。 spark.components.ToggleButtonspark.components.CheckBoxspark.components.RadioButtonchange ToggleButtonBase 控件的 selected 属性发生变化时分派。flash.events.Event.CHANGEflash.events.Event ToggleButtonBase 控件的 selected 属性发生变化时分派。仅当用户使用鼠标与控件交互时,才分派此事件。 ToggleButtonBase 构造函数。 构造函数。 selected 按钮处于按下状态时包含 true,而按钮处于弹起状态时包含 false。 按钮处于按下状态时包含 true,而按钮处于弹起状态时包含 false
OverlayDepth OverlayDepth 类定义 Flex 使用的各叠加元素的默认深度值。Object OverlayDepth 类定义 Flex 使用的各叠加元素的默认深度值。 spark.components.Group.overlayspark.components.DataGroup.overlayBOTTOM 所有 Flex 叠加元素之下的默认深度值。0 所有 Flex 叠加元素之下的默认深度值。 DROP_INDICATOR 拖放指示符的叠加深度。1000 拖放指示符的叠加深度。 FOCUS_PANE 焦点窗格的叠加深度。2000 焦点窗格的叠加深度。 MASK 遮罩的叠加深度。3000 遮罩的叠加深度。 TOP 所有 Flex 叠加元素之上的默认深度值。10000 所有 Flex 叠加元素之上的默认深度值。 ItemRenderer ItemRenderer 类是 Spark 项呈示器的基类。The <s:ItemRenderer> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:ItemRenderer
    Properties
    autoDrawBackground="true"
    selected="false"
    showsCaret="false"
  />
  
]]>
spark.components:IItemRendererspark.components:DataRenderer ItemRenderer 类是 Spark 项呈示器的基类。

项呈示器支持可选视图状态。您通常在 MXML 项呈示器中使用视图状态,来基于与项的用户交互控制数据项的外观。ItemRenderer 类支持所有视图状态,因此您可以使用这些项呈示器处理基于列表的类。

Flex 定义在您的项呈示器中支持的以下视图状态:

  • normal - 数据项没有用户交互。
  • hovered - 鼠标在数据项上。
  • selected - 已选中数据项。
  • dragging - 正在拖动数据项。
  • normalAndShowCaret - 数据项处于 normal 状态,且它在项列表中具有焦点。
  • hoveredAndShowCaret - 数据项处于 hovered 状态,且它在项列表中具有焦点。
  • selectedAndShowCaret - 数据项处于 normal 状态,且它在项列表中具有焦点。

当用户以更改项呈示器的视图状态的方式与控件交互时,Flex 首先确定呈示器是否定义该视图状态。如果项呈示器支持视图状态,Flex 将设置项呈示器以使用该视图状态。如果项呈示器不支持视图状态,则 Flex 不执行任何操作。

ItemRenderer 构造函数。 构造函数。 getCurrentRendererState 返回要应用到呈示器的状态的名称。指定要应用到呈示器的状态的名称的字符串。 返回要应用到呈示器的状态的名称。例如,一个非常基本的 List 项呈示器会返回字符串“normal”、“hovered”或“selected”以指定呈示器的状态。在处理 touch 交互(或在选择被忽略的情况下的 mouse 交互)时,“down”和“downAndSelected”也是很重要的状态。

如果所需的行为与默认行为不同,则 ItemRenderer 的子类必须覆盖此方法以返回值。

在 Flex 4.0 中,三种主要状态为“normal”、“hovered”和“selected”。在 Flex 4.5 中,添加了“down”和“downAndSelected”。

支持的完整状态集如下所示(按照优先级的顺序):

  • dragging
  • downAndSelected
  • selectedAndShowsCaret
  • hoveredAndShowsCaret
  • normalAndShowsCaret
  • down
  • selected
  • hovered
  • normal

invalidateRendererState 将呈示器的状态标记为无效,以在稍后的屏幕更新过程中设置新状态。 将呈示器的状态标记为无效,以在稍后的屏幕更新过程中设置新状态。 labelDisplay 可选项呈示器标签组件。spark.components.supportClasses:TextBase 可选项呈示器标签组件。此组件用于确定项呈示器的主机组件中 baselinePosition 属性的值。 autoDrawBackground 指定项呈示器是否在用户交互时绘制数据项的背景。true 指定项呈示器是否在用户交互时绘制数据项的背景。交互操作包括将鼠标移到项上、选择项和移动项的尖号。

如果为 true,项呈示器的背景将自动绘制,并取决于设置的样式(contentBackgroundColoralternatingItemColorrollOverColordownColorselectionColor)以及项呈示器所处于的状态。

如果为 false,项呈示器不绘制任何背景。您自定义的项呈示器负责为所有用户交互显示背景色。

down 用户在项呈示器上按下时设置为 true。false 用户在项呈示器上按下时设置为 truedragging 如果正在拖动项呈示器,则包含 true。 如果正在拖动项呈示器,则包含 truehovered 用户将鼠标悬浮在项呈示器上时设置为 true。false 用户将鼠标悬浮在项呈示器上时设置为 trueitemIndex 项呈示器的主机组件的数据提供程序中的项目索引。0 项呈示器的主机组件的数据提供程序中的项目索引。 label 要在项呈示器中显示的 String。"" 要在项呈示器中显示的 String。

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

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

selected 如果项呈示器可以将其自身显示为已选中,则包含 true。false 如果项呈示器可以将其自身显示为已选中,则包含 trueshowsCaret 如果项呈示器可以将其自身显示为已获取焦点,则包含 true。false 如果项呈示器可以将其自身显示为已获取焦点,则包含 true
GroupBase GroupBase 类为显示可视元素的组件定义基类。The <s:GroupBase> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:GroupBase
    Properties
    autoLayout="true"
    clipAndEnableScrolling="false"
    horizontalScrollPosition="null"
    luminosityClip="false"
    luminosityInvert="false"
    layout="BasicLayout"
    mask=""
    maskType="clip"
    mouseEnabledWhereTransparent="true"
    resizeMode="noScale"
    verticalScrollPosition="no default"
  
    Styles
    accentColor="0x0099FF"
    alignmentBaseline="useDominantBaseline"
    alternatingItemColors="undefined"
    baselineShift="0"
    blockProgression="tb"
    breakOpportunity="auto"
    cffHinting="horizontalStem"
    chromeColor="0xCCCCCC"
    color="0x000000"
    contentBackgroundAlpha="1.0"
    contentBackgroundColor="0xFFFFFF"
    clearFloats="none"
    digitCase="default"
    digitWidth="default"
    direction="ltr"
    disabledAlpha="0.5"
    dominantBaseline="auto"
    firstBaselineOffset="auto"
    focusColor="0x70B2EE"
    focusedTextSelectionColor="A8C6EE"
    fontFamily="Arial"
    fontLookup="device"
    fontSize="12"
    fontStyle="normal"
    fontWeight="normal"
    inactiveTextSelectionColor="E8E8E8"
    justificationRule="auto"
    justificationStyle="auto"
    kerning="auto"
    leadingModel="auto"
    ligatureLevel="common"
    lineHeight="120%"
    lineThrough="false"
    listAutoPadding="40"
    listStylePosition="outside"
    listStyleType="disc"
    locale="en"
    paragraphEndIndent="0"
    paragraphSpaceAfter="0"
    paragraphSpaceBefore="0"
    paragraphStartIndent="0"
    renderingMode="cff"
    rollOverColor="0xCEDBEF"
    symbolColor="0x000000"
    tabStops="null"
    textAlign="start"
    textAlignLast="start"
    textAlpha="1"
    textDecoration="none"
    textIndent="0"
    textJustify="interWord"
    textRotation="auto"
    trackingLeft="0"
    trackingRight="0"
    typographicCase="default"
    unfocusedTextSelectionColor="0xE8E8E8"
    whiteSpaceCollapse="collapse"
    wordSpacing="100%,50%,150%"
  />
  
]]>
spark.core:IViewportmx.core:UIComponent GroupBase 类为显示可视元素的组件定义基类。group 组件不控制它所包含的可视项目的布局,而该布局是由单独的 layout 组件进行处理的。 spark.layouts.supportClasses.LayoutBasespark.components.ResizeModeGroupBase 构造函数。 构造函数。 containsElement 确定指定的 IVisualElement 是否为容器实例的子代或该实例本身。如果元素是容器的子代,则为 true element要测试的子对象 确定指定的 IVisualElement 是否为容器实例的子代或该实例本身。将进行深度搜索,即,如果此元素是该容器的子代、孙代、曾孙代等,它将返回 true。 createChildren 如果尚未设置布局对象,则 createChildren() 会为该容器指定默认布局对象 BasicLayout。

如果尚未设置布局对象,则 createChildren() 会为该容器指定默认布局对象 BasicLayout。

getElementAt index getElementIndex element getHorizontalScrollPositionDelta 对水平滚动位置的更改。 navigationUnit采用以下值:
  • END 返回滚动 delta,它将使 scrollRect 与内容区域右对齐。
  • HOME 返回滚动 delta,它将使 scrollRect 与内容区域左对齐。
  • LEFT 返回滚动 delta,它将使 scrollRect 与跨越 scrollRect 的左边或在其左边左侧的第一个元素左对齐。
  • PAGE_LEFT 返回滚动 delta,它将使 scrollRect 与跨越 scrollRect 的左边或在其左边左侧的第一个元素右对齐。
  • PAGE_RIGHT 返回滚动 delta,它将使 scrollRect 与跨越 scrollRect 的右边或在其右边右侧的第一个元素左对齐。
  • RIGHT 返回滚动 delta,它将使 scrollRect 与跨越 scrollRect 的右边或在其右边右侧的第一个元素右对齐。

该实现调用 getElementBoundsLeftOfScrollRect()getElementBoundsRightOfScrollRect() 来确定元素的界限。Layout 类通常覆盖这些方法而不是 getHorizontalScrollPositionDelta() 方法。

getVerticalScrollPositionDelta 对垂直滚动位置的更改。 navigationUnit采用以下值:
  • DOWN 返回滚动 delta,它将使 scrollRect 与跨越 scrollRect 的底边或在其底边之下的第一个元素底对齐。
  • END 返回滚动 delta,它将使 scrollRect 与内容区域底对齐。
  • HOME 返回滚动 delta,它将使 scrollRect 与内容区域顶对齐。
  • PAGE_DOWN 返回滚动 delta,它将使 scrollRect 与跨越 scrollRect 的底边或在其底边之下的第一个元素顶对齐。
  • PAGE_UP
  • 返回滚动 delta,它将使 scrollRect 与跨越 scrollRect 的顶边或在其顶边之上的第一个元素底对齐。
  • UP 返回滚动 delta,它将使 scrollRect 与跨越 scrollRect 的顶边或在其顶边之上的第一个元素顶对齐。

该实现调用 getElementBoundsAboveScrollRect()getElementBoundsBelowScrollRect() 来确定元素的界限。Layout 类通常覆盖这些方法而不是 getVerticalScrollPositionDelta() 方法。

getVirtualElementAt 支持 useVirtualLayout 标志的布局将在 updateDisplayList() 时使用此方法获取“处于视图中”的布局元素,即,位于指定索引位置的已验证的元素。 index要检索的元素的索引。 eltWidthunknown如果已指定,则为新创建的或循环使用的元素的初始宽度。 eltHeightunknown如果已指定,则为新创建的或循环使用的元素的初始高度。 支持 useVirtualLayout 标志的布局将在 updateDisplayList() 时使用此方法来获取“处于视图中”的布局元素(即,重叠 Group 的 scrollRect 的元素)。

如果要返回的元素尚不是可见子项(即,如果已创建或循环使用它,且指定了 eltWidth 或 eltHeight),则会在验证元素之前使用 setLayoutBoundsSize() 设置元素的初始大小。这对于将布局对齐到 Group 的宽度或高度时会重排的组件(如文本)很重要。

返回的布局元素已经过验证。

此方法将根据需要延迟创建或“循环使用”并验证布局元素。

此方法不能直接进行调用,支持虚拟化的布局将对其进行调用。

setContentSize 设置 contentWidth 和 contentHeight 属性。widthcontentWidth 的新值。 heightcontentHeight 的新值。 设置 contentWidthcontentHeight 属性。此方法适用于 layout 类开发者,开发者应该从 updateDisplayList() 方法对其进行调用。 autoLayout 如果为 true,则在更改子项的位置或大小时完成度量和布局。true 如果为 true,则在更改子项的位置或大小时完成度量和布局。如果为 false,则仅当在容器中添加或删除子项时才能执行度量和布局。 baselinePosition clipAndEnableScrolling false contentHeight contentWidth horizontalScrollPosition layout 此容器的 layout 对象。spark.layouts.supportClasses:LayoutBasespark.layouts.BasicLayout 此容器的 layout 对象。此对象负责容器中可视元素的测量和布局。 spark.layouts.supportClasses.LayoutBaseluminosityClip 控制发光度遮罩是否剪辑设置了遮罩的内容的属性。false 控制发光度遮罩是否剪辑设置了遮罩的内容的属性。只有图形元素应用了类型为 MaskType.LUMINOSITY 的遮罩,此属性才会起作用。 maskTypeluminosityInvert 控制计算由发光度遮罩设置遮罩的图形元素的 RGB 颜色值的属性。false 控制计算由发光度遮罩设置遮罩的图形元素的 RGB 颜色值的属性。如果为 true,则遮罩中的相应区域将反转并乘以源内容中像素的 RGB 颜色值。如果为 false,则直接使用源内容中像素的 RGB 颜色值。 maskType 遮罩类型。MaskType.CLIP

遮罩类型。可能的值为 MaskType.CLIPMaskType.ALPHAMaskType.LUMINOSITY

剪辑遮罩

遮罩处于剪辑模式下时,会将剪辑遮罩减少至 1 位。这意味着遮罩将不会影响源内容中像素的不透明度;它要么保留值不进行修改(如果遮罩中的相应像素具有非零 Alpha 值),要么使其完全透明(如果遮罩像素值为零 Alpha 值)。

Alpha 遮罩

在 Alpha 模式下,会将源内容中的每个像素的不透明度与遮罩的相应区域的不透明度相乘。即,对于由不透明度为 0.5 的区域遮罩的、源内容中不透明度为 1 的像素,其结果不透明度将为 0.5。对于由不透明度为 0.5 的区域遮罩的、不透明度为 0.8 的源像素,其结果不透明度为 0.4。

发光度遮罩

发光度遮罩有时称为“柔化遮罩”,除以下方面外其作用极其类似于 Alpha 遮罩:源内容中像素的不透明度和 RGB 颜色值与遮罩中相应区域的不透明度和 RGB 颜色值相乘。

发光度遮罩不是 Flash 的特有功能,但在诸如 Adobe Illustrator 和 Adobe Photoshop 等 Adobe Creative Suite 工具中通用。为了实现 Flash 呈示内容中发光度遮罩的视觉效果,指定发光度遮罩的图形元素实际上会实例化模仿发光度遮罩在 Adobe Creative Suite 工具中呈示时其可视外观的着色器滤镜。

由发光度遮罩设置遮罩的对象可以设置用于控制遮罩 RGB 颜色值和剪辑的属性。请参阅 luminosityInvert 和 luminosityClip 属性。

spark.core.MaskType
mask 设置遮罩。 设置遮罩。将遮罩添加到显示列表中。遮罩不得位于显示列表或元素数组中。 flash.display.DisplayObject.maskmouseEnabledWhereTransparent 为 true 时,此属性确保 Group 的整个边界响应鼠标事件(如 click、roll over 等)。true true 时,此属性确保 Group 的整个边界响应鼠标事件(如 click、roll over 等)。此属性仅在将 mouse、touch 或 flash player gesture 事件添加到此实例时生效。此外,假设对 addEventListener()/removeEventListener() 的调用是必需的。 numElements overlay 此 Group 的叠加平面。spark.components.supportClasses:DisplayLayer 此 Group 的叠加平面。叠加平面上的所有对象都在 Group 元素的顶部呈示。

注意:请不要保留此对象,因为此 Group 会根据需要破坏和创建该对象。

resizeMode 此容器的 ResizeMode。 此容器的 ResizeMode。如果将调整大小模式设置为 ResizeMode.NO_SCALE,则将使用新的宽度和高度布置子代来完成调整大小。如果将调整大小模式设置为 ResizeMode.SCALE,则所有子代将保持未缩放的宽度和高度,且将进行缩放以更改大小。

默认值为对应于“noScale”的 ResizeMode.NO_SCALE

spark.components.ResizeMode
verticalScrollPosition
SkinnableComponent SkinnableComponent 类定义可设置外观的组件的基类。mx.core:UIComponent SkinnableComponent 类定义可设置外观的组件的基类。SkinnableComponent 类所使用的外观通常是 Skin 类的子类。

通过设置 component 类的 skinClass 样式属性,将 skin 类与 component 类相关联。可以在 CSS 中设置 skinClass 属性,如以下示例所示:

MyComponent
  {
    skinClass: ClassReference("my.skins.MyComponentSkin")
  }

以下示例在 MXML 中设置 skinClass 属性:

  <MyComponent skinClass="my.skins.MyComponentSkin"/>
spark.components.supportClasses.SkinSkinnableComponent 构造函数。 构造函数。 attachSkin 为该组件创建外观。 为该组件创建外观。您无需直接调用此方法。Flex 在调用 createChildren()UIComponent.commitProperties() 方法时自动调用此方法。通常,SkinnableComponent 的子类不覆盖此方法。

此方法实例化组件的外观,将外观添加为组件的子项,并解析外观的所有部件关联

clearSkinParts 清除对外观部件的引用。 清除对外观部件的引用。您无需直接调用此方法。Flex 在调用 detachSkin() 方法时自动调用此方法。

通常,SkinnableComponent 的子类不覆盖此方法。

createDynamicPartInstance 创建动态外观部件的实例。部件的实例,或者 null(如果它无法创建部件)。 partName部件的名称。 创建动态外观部件的实例。动态外观部件应该始终由此方法进行实例化,而不是通过对 factory 调用 newInstance() 方法直接进行实例化。此方法创建部件,但不会将其添加到显示列表。组件必须调用 Group.addElement() 方法或相应方法才可将外观部件添加到显示列表中。 detachSkin 破坏和删除此组件的外观。 破坏和删除此组件的外观。您无需直接调用此方法。在运行时修改某个外观时,Flex 自动调用此方法。此方法删除该外观并清除所有部件关联。

通常,SkinnableComponent 的子类不覆盖此方法。

findSkinParts 在 skin 类中找到外观部件并将它们指定给组件的属性。 在 skin 类中找到外观部件并将它们指定给组件的属性。您无需直接调用此方法。Flex 在调用 attachSkin() 方法时自动调用此方法。通常,SkinnableComponent 的子类不覆盖此方法。 getCurrentSkinState 返回要应用到外观的状态的名称。指定要应用到外观的状态的名称的字符串。 返回要应用到外观的状态的名称。例如,一个 Button 组件可能会返回 String“up”、“down”、“over”或“disabled”以指定该状态。

SkinnableComponent 的子类必须覆盖此方法才可返回值。

getDynamicPartAt 返回动态部件的特定实例。部件的实例,或者 null(如果部件不存在)。 partName动态部件的名称。 index动态部件的索引。 返回动态部件的特定实例。 invalidateSkinState 标记组件,以在稍后的屏幕更新过程中设置外观的新状态。 标记组件,以在稍后的屏幕更新过程中设置外观的新状态。 numDynamicParts 返回动态部件的实例数目。动态部件的实例数目。 partName动态部件的名称。 返回动态部件的实例数目。 partAdded 添加外观部件时调用。partName部件的名称。 instance部件实例。 添加外观部件时调用。您无需直接调用此方法。对于静态部件,Flex 会在调用 attachSkin() 方法时自动调用此方法。对于动态部件,Flex 会在调用 createDynamicPartInstance() 方法时自动调用此方法。

覆盖此函数以将行为附加到该部件。如果希望覆盖从某个基类继承的外观部件上的行为,请不要调用 super.partAdded() 方法。否则,应始终调用 super.partAdded() 方法。

partRemoved 正删除外观部件的实例时调用。partName部件的名称。 instance部件实例。 正删除外观部件的实例时调用。您无需直接调用此方法。对于静态部件,Flex 会在调用 detachSkin() 方法时自动调用此方法。对于动态部件,Flex 会在调用 removeDynamicPartInstance() 方法时自动调用此方法。

覆盖此函数以从该部件删除行为。

removeDynamicPartInstance 删除动态部件的实例。partName部件的名称。 instance部件实例。 删除动态部件的实例。必须在删除动态部件之前调用此方法。此方法不会将部件从显示列表中删除。 baselinePosition currentCSSState 匹配 CSS 伪选择器时要使用的状态。 匹配 CSS 伪选择器时要使用的状态。此覆盖会返回当前外观状态而不是组件状态。 skin 此组件实例的 skin 类的实例。 此组件实例的 skin 类的实例。这是 Flex 调用 attachSkin() 方法时自动设置的只读属性。 suggestedFocusSkinExclusions 列出捕获的位图中不包括的用于显示焦点的外观部件。 列出捕获的位图中不包括的用于显示焦点的外观部件。仅当将外观的 focusSkinExclusions 属性设置为 null 时,才能使用此列表。
TextBase 诸如 Label 和 RichText 等 Spark 文本控件(使用默认格式的 CSS 样式显示文本)的基类。spark.core:IDisplayTextmx.core:UIComponent 诸如 Label 和 RichText 等 Spark 文本控件(使用默认格式的 CSS 样式显示文本)的基类。

除了添加 text 属性之外,此类还添加 maxDisplayedLinesisTruncated 属性以支持截断。

TextBase 构造函数。 构造函数。 isTruncated 报告是否已截断文本的只读属性。false 报告是否已截断文本的只读属性。

截断文本意味着使用截断指示符(如 "...")替换超额文本。截断指示符与区域设置相关;它是由 "core" 资源包中的 "truncationIndicator" 资源指定的。

如果 maxDisplayedLines 为 0,则不会发生截断。相反,如果文本不在组件的界限内,则将只是剪辑文本。

如果 maxDisplayedLines 为正整数,则会根据需要截断文本以将行数减少至此整数。

如果 maxDisplayedLines 为 -1,则会截断该文本以显示将完全放在组件的高度内的行。

仅当 lineBreak 样式为 "toFit" 时,才执行截断;如果 lineBreak"explicit",则会忽略此属性的值。

maxDisplayedLines 确定是否截断文本以及在何处截断文本的整数。0 确定是否截断文本以及在何处截断文本的整数。

截断文本意味着使用截断指示符(如 "...")替换超额文本。截断指示符与区域设置相关;它是由 "core" 资源包中的 "truncationIndicator" 资源指定的。

如果值为 0,则不会发生截断。相反,如果文本不在组件的界限内,则将只是剪辑文本。

如果值为正整数,则会根据需要截断文本以将行数减少至此整数。

如果值为 -1,则会截断该文本以显示将完全放在组件的高度内的行。

仅当 lineBreak 样式为 "toFit" 时,才执行截断;如果 lineBreak"explicit",则会忽略此属性的值。

showTruncationTip 一个控制在截断文本时组件是否应显示工具提示的属性。false 一个控制在截断文本时组件是否应显示工具提示的属性。 text 此文本组件所显示的文本。"" 此文本组件所显示的文本。

此文本的格式是由 CSS 样式控制的。支持的样式取决于子类。

ScrollBarBase ScrollBarBase 类可帮助在因数据太多而不能在显示区域完全显示时定位显示的数据部分。 不活动状态。这是没有内容要滚动的状态,这意味着 maximum <= minimum AIR 1.5 3.0 Flex 4 定义某个按钮的可选外观部件,该按钮在按下时会向上步进滚动条。这等同于对 value 属性减小步长。 AIR 1.5 3.0 Flex 4 An optional skin part that defines a button that, when pressed, steps the scrollbar up. 定义某个按钮的可选外观部件,该按钮在按下时会向下步进滚动条。这等同于对 value 属性增大步长。 AIR 1.5 3.0 Flex 4 An optional skin part that defines a button that, when pressed, steps the scrollbar down.The <s:ScrollBarBase> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:ScrollBarBase
    Properties
    pageSize="20"
    snapInterval="1"
    viewport="null"
     Styles
    autoThumbVisibility="true"
    fixedThumbSize="false"
    repeatDelay="500"
    repeatInterval="35"
    smoothScrolling="true"
    symbolColor="0x000000"
  />
  
]]>
spark.components.supportClasses:TrackBase ScrollBarBase 类可帮助在因数据太多而不能在显示区域完全显示时定位显示的数据部分。ScrollBarBase 类显示一对滚动条和一个视域。视域是实现 IViewport 的 UIComponent,如 Group。

此控件扩展 TrackBase 类,且是 HScrollBar 和 VScrollBar 控件的基类。

滚动条由一个轨道、一个可变大小滚动滑块和两个可选箭头按钮组成。ScrollBarBase 类使用四个参数计算其显示状态:

  • minimum:最小范围值。
  • maximum:最大范围值。
  • value:当前位置,必须介于最小范围值和最大范围值之间。
  • 视域大小:表示范围内一次可显示的项目数。该项目数必须小于或等于此范围,其中此范围指介于最小范围值和最大范围值之间的一组值。
spark.core.IViewportspark.skins.spark.ScrollerSkinspark.skins.spark.ScrollBarDownButtonSkinspark.skins.spark.ScrollBarLeftButtonSkinspark.skins.spark.ScrollBarRightButtonSkinspark.skins.spark.ScrollBarUpButtonSkinScrollBarBase 构造函数。 构造函数。 animatePaging 设置操作的动画以移动到 newValue。newValue正在分页到的最后值。 pageSize请求的水平或垂直移动的数量。此值用于使用 repeatInterval 样式计算移动到新值所花费的总时间。pageSize 通常通过将 Scroller 包含到查看位于逻辑内容边界处的内容所需的值,以动态方式进行设置。 设置操作的动画以移动到 newValuepageSize 参数用于计算达到该值所花费的时间,这样设置分页操作的动画所花费的时间大致与非动画版本相同;这两个操作都应在大约相同的时间在相同的位置结束。 animateStepping 设置操作的动画以步进到 newValue。newValue正在步进到的最后值。 stepSize请求的步进的数量。此值用于使用 repeatInterval 样式计算步进到新值所花费的总时间。stepSize 通常通过将 Scroller 包含到查看位于逻辑内容边界处的内容所需的值,以动态方式进行设置。 设置操作的动画以步进到 newValuestepSize 参数用于计算达到该值所花费的时间,这样设置步进操作的动画所花费的时间大致与非动画版本相同;这两个操作都应在大约相同的时间在相同的位置结束。 button_buttonDownHandler 处理滚动条的增量或减量按钮上的单击。event事件对象。 处理滚动条的增量或减量按钮上的单击。这应该导致生成一个步进操作,按下时会重复该操作。在重复操作开始之前的延迟和重复事件之间的延迟由基础 Button 对象的 repeatDelayrepeatInterval 样式确定。 spark.components.Buttonbutton_buttonUpHandler 处理滚动条的增量或减量按钮的释放。event事件对象。 处理滚动条的增量或减量按钮的释放。这会结束由按钮上的原始 buttonDown 事件启动的步进操作。 spark.components.ButtonchangeValueByPage 从 value 增加或减去 pageSize。increasetrue分页操作是增加 (true) 还是减少 (false) valuevalue 增加或减去 pageSize。每次增加后,新的 value 是大于当前 valuepageSize 的最接近倍数。每次减去后,新的 value 是小于当前 value 的 pageSize 的最接近倍数。value 的最小值是 pageSizepageSize 调用 changeValueByPage() 方法时 value 属性值中的更改。20 调用 changeValueByPage() 方法时 value 属性值中的更改。 pendingValue 释放鼠标按钮时滚动条将具有的值。0 释放鼠标按钮时滚动条将具有的值。

如果 liveDragging 样式为 false,则仅在释放鼠标按钮时设置滚动条的值。正在拖动滑块时,不会更新该值。

即使 liveDragging 为 false,也会在滚动条滑块移动时更新此属性。

viewport 由此滚动条控制的视域。spark.core:IViewportnull 由此滚动条控制的视域。如果指定视域,则对其实际大小、内容大小和滚动位置的更改会导致运行相对应的 ScrollBarBase 方法:
  • viewportResizeHandler()
  • contentWidthChangeHandler()
  • contentHeightChangeHandler()
  • viewportVerticalScrollPositionChangeHandler()
  • viewportHorizontalScrollPositionChangeHandler()

VScrollBar 和 HScrollBar 类覆盖这些方法以保持其 pageSizemaximumvalue 属性与该视域同步。同样,它们覆盖其 changeValueByPage()changeValueByStep() 方法以使用视域的 scrollPositionDelta 方法来计算分页和步进偏移量。

spark.components.VScrollBarspark.components.HScrollBar
snapInterval snapInterval 属性控制 value 属性的有效值。1 snapInterval 属性控制 value 属性的有效值。如果为非零,则有效值为 minimum 与此属性的整数倍数之和,且小于或等于 maximum

例如,如果 minimum 为 10,maximum 为 20,而此属性为 3,则可能的有效值为 10、13、16、19 和 20。

如果此属性的值为零,则仅会将有效值约束到介于 minimum 和 maximum 之间(包括两者)。

此属性还约束 stepSize 属性(如果设置)的有效值。如果未显式设置此属性,但设置了 stepSize,则 snapInterval 将默认为 stepSize

ButtonBase ButtonBase 类是所有 Spark 按钮组件的基类。 按钮的禁用状态 AIR 1.5 3.0 Flex 4 按钮的按下状态 AIR 1.5 3.0 Flex 4 按钮的经过状态 AIR 1.5 3.0 Flex 4 按钮的弹起状态 AIR 1.5 3.0 Flex 4 定义按钮的可选图标的外观部件。 AIR 2.0 3.0 Flex 4.5 A skin part that defines an optional icon for the button. 定义按钮的标签的外观部件。 AIR 1.5 3.0 Flex 4 A skin part that defines the label of the button.The <s:ButtonBase> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:ButtonBase
    Properties
    autoRepeat="false"
    content="null"
    label=""
    stickyHighlighting="false"
  
    Events
    buttonDown="No default"
 
    Styles
    alignmentBaseline="USE_DOMINANT_BASELINE"
    cffHinting="HORIZONTAL_STEM"
    color="0"
    cornerRadius="4"
    digitCase="DEFAULT"
    digitWidth="DEFAULT"
    direction="LTR"
    dominantBaseline="AUTO"
    focusAlpha="0.5"
    focusColor="0x70B2EE"
    fontFamily="Arial"
    fontLookup="DEVICE"
    fontSize="12"
    fontStyle="NORMAL"
    fontWeight="NORMAL"
    justificationRule="AUTO"
    justificationStyle="AUTO"
    kerning="AUTO"
    ligatureLevel="COMMON"
    lineHeight="120%"
    lineThrough="false"
    locale="en"
    renderingMode="CFF"
    repeatDelay="500"
    repeatInterval="35"
    textAlign="START"
    textAlignLast="START"
    textAlpha="1"
    textDecoration="NONE"
    textJustify="INTER_WORD"
    trackingLeft="0"
    trackingRight="0"
    typographicCase="DEFAULT"
    wordSpacing="100%"
  />
  
]]>
mx.managers:IFocusManagerComponentspark.components.supportClasses:SkinnableComponent ButtonBase 类是所有 Spark 按钮组件的基类。Button 和 ToggleButtonBase 类是 ButtonBase 的子类。ToggleButton。CheckBox 和 RadioButton 类是 ToggleButtonBase 的子类。 spark.components.Buttonspark.components.supportClasses.ToggleButtonBasespark.components.ToggleButtonspark.components.CheckBoxspark.components.RadioButtonbuttonDown 当用户按下 ButtonBase 控件时分派。mx.events.FlexEvent.BUTTON_DOWNmx.events.FlexEvent 当用户按下 ButtonBase 控件时分派。如果 autoRepeat 属性为 true,则只要按钮处于按下状态,就将重复分派此事件。 ButtonBase 构造函数。 构造函数。 buttonReleased 当在用户单击按钮之后处理 MouseEvent.MOUSE_UP 事件时,将调用此方法。 当在用户单击按钮之后处理 MouseEvent.MOUSE_UP 事件时,将调用此方法。仅当以按钮为目标,并且 mouseCapturedtrue 时,才会调用此方法。该方法允许子类恰好在单击按钮时更新按钮属性,以免按钮处于鼠标弹起和单击事件之间的过渡状态。 clickHandler 在子类中覆盖此方法以处理 click 事件,而不是添加单独的处理函数。event与事件关联的 Event 对象。 在子类中覆盖此方法以处理 click 事件,而不是添加单独的处理函数。禁用按钮后不会调用此方法。 mouseEventHandler 此方法处理鼠标事件,在适当的时候调用 clickHandler 方法,并更新 hovered 和 mouseCaptured 属性。event与事件关联的 Event 对象。 此方法处理鼠标事件,在适当的时候调用 clickHandler 方法,并更新 hoveredmouseCaptured 属性。

调用此方法以处理 MouseEvent.ROLL_OVERMouseEvent.ROLL_OUTMouseEvent.MOUSE_DOWNMouseEvent.MOUSE_UPMouseEvent.CLICK 事件。

autoRepeat 指定在用户按住鼠标按键时是否重复分派 buttonDown 事件。false 指定在用户按住鼠标按键时是否重复分派 buttonDown 事件。 content 使用 content 属性可以传递任意对象以在按钮的自定义外观中使用。null 使用 content 属性可以传递任意对象以在按钮的自定义外观中使用。当外观定义可选部件 labelDisplay 时,会将 content 的字符串表示形式向下推至该部件的 text 属性。默认外观使用此机制将 content 呈示为按钮标签。

label 属性是此属性的 String 类型外观。此属性为可绑定属性,且它与 label 属性共享“contentChange”事件。

label
hovered 指示鼠标指针是否位于按钮上。 指示鼠标指针是否位于按钮上。用于确定外观状态。 keyboardPressed 指示按钮处于焦点时是否按下键盘键。 指示按钮处于焦点时是否按下键盘键。用于确定外观状态。 mouseCaptured 指示第一次分派 MouseEvent.MOUSE_DOWN 时,是否按下鼠标以及鼠标指针是否在按钮上。 指示第一次分派 MouseEvent.MOUSE_DOWN 时,是否按下鼠标以及鼠标指针是否在按钮上。用于确定外观状态。 stickyHighlighting 如果为 false,则按钮会在用户按下它时显示其按下时的外观,但在用户将鼠标拖离它时将改为显示整体外观。false 如果为 false,则按钮会在用户按下它时显示其按下时的外观,但在用户将鼠标拖离它时将改为显示整体外观。如果为 true,则按钮会在用户按下它时显示其按下时的外观,并在用户将鼠标拖离时继续显示此外观。 label 要在 ButtonBase 控件上显示的文本。"" 要在 ButtonBase 控件上显示的文本。

如果标签比 ButtonBase 控件宽,则使用省略号 (...) 截断此标签并终止。当用户将鼠标移到控件上时,将完整标签显示为工具提示。如果您还使用 tooltip 属性设置了工具提示,则显示工具提示而不是标签文本。

这是默认的 ButtonBase 属性。

此属性是 content 属性的 String 类型外观。此属性为可绑定属性,且它与 content 属性共享分派“contentChange”事件。

content
TrackBase TrackBase 类是具有一个轨道和一个或多个滑块按钮的组件的一个基类,如 Slider 和 ScrollBar。 禁用状态 AIR 1.5 3.0 Flex 4 正常状态 AIR 1.5 3.0 Flex 4 定义可以沿着轨道拖动以增大或减小 value 属性的按钮的外观部件。对 value 属性进行更新将自动更新滑块按钮相对于滑块的位置。 AIR 1.5 3.0 Flex 4 A skin part that defines a button that can be dragged along the track to increase or decrease the value property. 定义某个按钮的外观部件,该按钮在按下时会将 value 属性设置为与轨道上的当前按钮位置相对应的值。 AIR 1.5 3.0 Flex 4 A skin part that defines a button that, when pressed, sets the value property to the value corresponding with the current button position on the track.The <s:TrackBase> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:TrackBase
    Styles
    slideDuration="300"
 
    Events
    change="No default"
    changing="No default"
    thumbDrag="No default"
    thumbPress="No default"
    thumbRelease="No default"
  />
  
]]>
spark.components.supportClasses:Range TrackBase 类是具有一个轨道和一个或多个滑块按钮的组件的一个基类,如 Slider 和 ScrollBar。它声明两个必需的外观部件:thumbtrack。TrackBase 类还为拖动滑块按钮提供代码,它由 Slider 和 ScrollBar 类共享。 spark.components.supportClasses.Sliderspark.components.supportClasses.ScrollBarthumbRelease 释放滑块(即用户在 thumbPress 事件后释放鼠标按钮)时分派。spark.events.TrackBaseEvent.THUMB_RELEASEspark.events.TrackBaseEvent 释放滑块(即用户在 thumbPress 事件后释放鼠标按钮)时分派。 thumbPress 按下滑块(即用户在滑块上按下鼠标按钮)时分派。spark.events.TrackBaseEvent.THUMB_PRESSspark.events.TrackBaseEvent 按下滑块(即用户在滑块上按下鼠标按钮)时分派。 thumbDrag 按下滑块并使用鼠标移动滑块时分派。spark.events.TrackBaseEvent.THUMB_DRAGspark.events.TrackBaseEvent 按下滑块并使用鼠标移动滑块时分派。此事件始终发生在 thumbPress 事件之后。 changeStart 当用户交互开始或动画开始时分派。mx.events.FlexEvent.CHANGE_STARTmx.events.FlexEvent 当用户交互开始或动画开始时分派。 changeEnd 当用户交互结束或动画结束时分派。mx.events.FlexEvent.CHANGE_ENDmx.events.FlexEvent 当用户交互结束或动画结束时分派。 change 当控件的值由于用户交互操作而发生更改时分派。flash.events.Event.CHANGEflash.events.Event 当控件的值由于用户交互操作而发生更改时分派。 TrackBase 构造函数。 构造函数。 pointToValue 将相对于轨道的 x,y 像素位置转换为介于最小值和最大值(包括两者)之间的一个值。介于最小值和最大值(包括两者)之间的一个值。 x相对于轨道原点的位置的 x 坐标。 y相对于轨道原点的位置的 y 坐标。 将相对于轨道的 x,y 像素位置转换为介于最小值和最大值(包括两者)之间的一个值。

TrackBase 子类必须覆盖此方法并执行将它们自己的几何图形考虑在内的转换。例如,一个垂直滑块可能会按如下方式计算值:

      return (y / track.height) (maximum - minimum);
      

默认情况下,此方法返回 minimum

updateSkinDisplayList 设置外观部件(通常为滑块)的边界,这些外观部件的几何图形不是完全由外观的布局指定的。 设置外观部件(通常为滑块)的边界,这些外观部件的几何图形不是完全由外观的布局指定的。

大多数子类覆盖此方法以基于 minimummaximumvalue 属性更新滑块的大小、位置和可见性。

默认情况下,此方法不执行任何操作。

DisplayLayer DisplayLayer 类维护按深度排序的 DisplayObject 的有序列表。flash.events:EventDispatcher DisplayLayer 类维护按深度排序的 DisplayObject 的有序列表。请不要实例化此类,而应使用 GroupDataGroupoverlay 属性。 spark.components.Group.overlayspark.components.DataGroup.overlayDisplayLayer 构造函数。 构造函数。 addDisplayObject 将具有指定深度的 DisplayObject 添加到有序列表中。对象的索引。 displayObject要添加的对象。 depthunknown对象的深度。 将具有指定深度的 DisplayObject 添加到有序列表中。displayObject 在有序列表中的位置基于其深度。在具有较小或相等 depth 值的所有对象之后插入此对象。 getDisplayObjectAt 返回具有指定索引的 DisplayObject。对象。 index对象的索引。 返回具有指定索引的 DisplayObject。 getDisplayObjectDepth 返回指定 DisplayObject 的深度。对象的深度。 displayObject对象。 返回指定 DisplayObject 的深度。 removeDisplayObject 从排序列表中删除指定的 displayObject。已删除的对象。 displayObject对象。 从排序列表中删除指定的 displayObjectnumDisplayObjects DisplayLayer 中的对象数。 DisplayLayer 中的对象数。 SliderBase 通过使用 SliderBase 类,用户可以在滑块轨道的端点之间移动滑块来选择值。 定义显示当前值的已设置格式版本的 dataTip 的外观部件。正在拖动滑块时显示 dataTip。这是动态外观部件且必须为 IFactory 类型。 AIR 1.5 3.0 Flex 4 A skin part that defines a dataTip that displays a formatted version of the current value.The <s:SliderBase> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:SliderBase
    Properties
    dataTipFormatFunction="20"
    dataTipPrecision="2"
    maximum="10"
    showDataTip="true"
 
    Styles
    alignmentBaseline="USE_DOMINANT_BASELINE"
    baselineShift="0.0"
    cffHinting="HORIZONTAL_STEM"
    color="0"
    digitCase="DEFAULT"
    digitWidth="DEFAULT"
    direction="LTR"
    dominantBaseline="AUTO"
    focusAlph="0.55"
    focusColor="0xFFFFFF"
    fontFamily="Arial"
    fontLookup="DEVICE"
    fontSize="12"
    fontStyle="NORMAL"
    fontWeight="NORMAL"
    justificationRule="AUTO"
    justificationStyle="AUTO"
    kerning="AUTO"
    ligatureLevel="COMMON"
    lineHeight="120%"
    lineThrough="false"
    liveDragging="true"
    local="en"
    renderingMode="CFF"
    textAlignLast="START"
    textAlpha="1"
    textDecoration="NONE"
    textJustify="INTER_WORD"
    trackingLeft="0"
    trackingRight="0"
    typographicCase="DEFAULT"
  />
  
]]>
mx.managers:IFocusManagerComponentspark.components.supportClasses:TrackBase 通过使用 SliderBase 类,用户可以在滑块轨道的端点之间移动滑块来选择值。滑块的当前值由滑块端点(对应于滑块的最小值和最大值)之间滑块的相对位置确定。SliderBase 类是 HSlider 和 VSlider 的基类。 spark.components.HSliderspark.components.VSliderSliderBase 构造函数。 构造函数。 updateDataTip 用于在数据提示可见时对其定位。dataTipInstance要更新和定位的 dataTip 实例 initialPosition外观中的 dataTip 的初始位置 用于在数据提示可见时对其定位。子类必须实现此函数。 dataTipPrecision 用于数据提示文本的小数位数。22 用于数据提示文本的小数位数。值 0 表示将所有值舍入为整数。如果已定义 dataTipFormatFunction,则会忽略此值。 showDataTip 如果设置为 true,则在用户交互期间将显示包含滑块当前值的数据提示。truetrue 如果设置为 true,则在用户交互期间将显示包含滑块当前值的数据提示。此外,必须在外观中定义 skinPart、dataTip,才可显示数据提示。 dataTipFormatFunction 格式化数据提示文本的回调函数。undefined 格式化数据提示文本的回调函数。此函数使用单个 Number 作为参数并返回格式化的 String。

此函数包含下列签名:

      funcName(value:Number):Object
      

以下示例采用美元符号作为数据提示文本的前缀,并使用名为“slide”的 SliderBase 控件的 dataTipPrecision 设置该文本格式:

      import mx.formatters.NumberBase;
      function myDataTipFormatter(value:Number):Object { 
          var dataFormatter:NumberBase = new NumberBase(".", ",", ".", ""); 
          return   "$ " + dataFormatter.formatPrecision(String(value), slide.dataTipPrecision); 
      }
      
maximum 表示 value 的最大可能值的数值。10 表示 value 的最大可能值的数值。如果 minimumvalue 的值大于 maximum,则将更改它们以反映新的 maximum pendingValue 释放鼠标按键时滑块将具有的值。0 释放鼠标按键时滑块将具有的值。如果 liveDragging 样式为 true,则此属性还包含在滑块的动画期间设置的临时值;实际值仅在动画结束时进行设置。

如果 liveDragging 样式为 false,则仅在释放鼠标按键时设置滑块的值。正在拖动滑块时,不会更新该值。

即使 liveDragging 为 false,也会在滑块移动时更新此属性。

Skin Skin 类为可设置外观的组件所用的所有外观定义基类。spark.skins:IHighlightBitmapCaptureClientspark.components:Group Skin 类为可设置外观的组件所用的所有外观定义基类。SkinnableComponent 类定义可设置外观的组件的基类。

通常将 skin 类写入 MXML 中,如以下示例所示:

  <?xml version="1.0"?>
  <Skin xmlns="http://ns.adobe.com/mxml/2009">
  
  <Metadata>
          <!-- Specify the component that uses this skin class. -->
          [HostComponent("my.component.MyComponent")]
      </Metadata> 
      
      <states>
          <!-- Specify the states controlled by this skin. -->
      </states>
          
      <!-- Define skin. -->
  
  </Skin>
mx.core.SkinnableComponentSkin 构造函数。 构造函数。 beginHighlightBitmapCapture 在为此外观进行位图捕获之前调用。如果必须重新绘制组件,则为 true。否则为 false 在为此外观进行位图捕获之前调用。默认实现不包含 focusSkinExclusions 数组中的项。 endHighlightBitmapCapture 在为此外观进行位图捕获之后调用。如果必须重新绘制组件,则为 true。否则为 false 在为此外观进行位图捕获之后调用。默认实现将恢复 focusSkinExclusions 数组中的项。 focusSkinExclusions 呈示焦点外框时应排除的项的 ID 列表。 呈示焦点外框时应排除的项的 ID 列表。仅应该排除类型为 DisplayObject 或 GraphicElement 的项。将忽略其他类型的项。
DropDownController DropDownController 类为锚点按钮及其相关联的下拉列表处理鼠标、键盘和焦点交互。flash.events:EventDispatcher DropDownController 类为锚点按钮及其相关联的下拉列表处理鼠标、键盘和焦点交互。此类由下拉组件(如 DropDownList)用于处理因用户交互而打开和关闭下拉列表的操作。 spark.components.DropDownListDropDownController 构造函数。 构造函数。 closeDropDown 关闭下拉列表并分派 DropDownEvent.CLOSE 事件。commit如果为 true,请提交选定的数据项目。 关闭下拉列表并分派 DropDownEvent.CLOSE 事件。 openDropDown 打开下拉列表并分派 DropdownEvent.OPEN 事件。 打开下拉列表并分派 DropdownEvent.OPEN 事件。 processFocusOut 如果下拉列表不再处于焦点,请将其关闭。eventFOCUS_OUT 事件的事件对象。 如果下拉列表不再处于焦点,请将其关闭。 processKeyDown 处理键盘用户交互。如果已识别并处理 keyCode,则返回 trueevent来自 keyboard 事件的事件对象。 处理键盘用户交互。 hitAreaAdditions 要考虑作为下拉列表的点击区域的一部分的显示对象列表。 要考虑作为下拉列表的点击区域的一部分的显示对象列表。在作为包含项列出的任何组件内进行鼠标单击不会自动关闭下拉列表。 closeOnResize 如果为 true,则调整系统管理器会关闭下拉列表。true 如果为 true,则调整系统管理器会关闭下拉列表。对于移动应用程序,您可以将此属性设置为 false,以便在页面方向更改时下拉列表保持打开状态。 isOpen 如果下拉列表已打开,则包含 true。 如果下拉列表已打开,则包含 truerollOverOpenDelay 指定滑过锚点按钮时打开下拉列表要等待的延迟(以毫秒为单位)。NaN 指定滑过锚点按钮时打开下拉列表要等待的延迟(以毫秒为单位)。如果设置为 NaN,则下拉列表会在单击时打开,而不是在滑过时打开。 openButton 对下拉组件的 openButton 外观部件的引用。spark.components.supportClasses:ButtonBase 对下拉组件的 openButton 外观部件的引用。 systemManager 对用于鼠标跟踪的 SystemManager 的引用。 对用于鼠标跟踪的 SystemManager 的引用。如果未指定,则控制器将使用与 openButton 关联的 systemManager。 ButtonBarHorizontalLayout ButtonBarHorizontalLayout 类是专门为 Spark ButtonBar 外观设计的布局。spark.layouts.supportClasses:LayoutBase ButtonBarHorizontalLayout 类是专门为 Spark ButtonBar 外观设计的布局。该布局在水平方向上按照从左到右的顺序布置子代。

该布局尝试将所有子代的大小调整为其首选大小。如果有足够的空间,则会将每个子代设置为其首选大小,并加上在子代之间平均分配的任何额外空间。

如果存在的空间不足以将所有子代调整为其首选大小,则将为小于平均宽度的子代分配其首选大小,剩余的元素将平均减小。

将所有子代设置为父代的高度。

spark.skins.spark.ButtonBarSkinButtonBarHorizontalLayout 构造函数。 构造函数。 gap 布局元素之间的水平空间。0 布局元素之间的水平空间。请注意,仅会在布局元素之间应用该间隙,这样如果只有一个元素,则该间隙不会对布局有任何影响。
ListItemDragProxy ListItemDragProxy 类定义从基于 Spark List 的控件拖动时使用的默认拖动代理。spark.components:Group ListItemDragProxy 类定义从基于 Spark List 的控件拖动时使用的默认拖动代理。 ListItemDragProxy 构造函数。 构造函数。 InteractionState InteractionStateDetector 类的 state 属性的值。Object InteractionStateDetector 类的 state 属性的值。 spark.components.supportClasses.InteractionStateDetectorDOWN 组件应处于 down 状态。down 组件应处于 down 状态。

用户当前正在按着此组件。

OVER 组件应处于 over 状态。over 组件应处于 over 状态。

用户当前正在悬停于此组件上。

UP 组件应处于 up 状态。up 组件应处于 up 状态。

此组件上未发生交互。

ButtonBarBase ButtonBarBase 类定义 ButtonBar、TabBar 及类似子类的常规行为。The <s:ButtonBarBase> tag inherits all of the tag attributes of its superclass and adds no new tag attributes:

  <s:ButtonBarBase/>
  
]]>
spark.components.supportClasses:ListBase ButtonBarBase 类定义 ButtonBar、TabBar 及类似子类的常规行为。此类不添加任何新的 API,但会优化控件的 ItemRenderer 元素的选择、键盘焦点和键盘导航行为。此基类不直接实例化。

通过设置 selectedIndexcaretIndex 属性,单击 ItemRenderer 时会将其选中。如果 requireSelectionfalse,则再次单击会取消选择。如果数据提供程序是 ISelectableList 对象,则也会设置其 selectedIndex

调整 caretIndex 会处理箭头键事件。如果 arrowKeysWrapFocustrue,则 caretIndex 将换行。按空格键将选择位于 caretIndex 的 ItemRenderer。

ButtonBarBase 对象具有焦点且由于键盘动作而到达 caretIndex 时,位于 caretIndex 的 ItemRenderer 的 showsCaret 属性将设置为 true。如果已将 caretIndex 设置为响应鼠标单击的一个副作用,则不设置 showsCaret

ButtonBarButton ItemRenderer 的 allowDeselection 属性设置为 !requireSelection

ButtonBarBase 构造函数。 构造函数。

初始化 Tab 键处理:按 Tab 键选择此组件使其获得焦点,而不是鼠标单击。禁用按 Tab 键选择子代。

iconField 数据提供程序项目中作为图标显示的字段名称。null 数据提供程序项目中作为图标显示的字段名称。iconFunction 属性将覆盖此属性。 iconFunction 用户提供的函数,在每个项目上运行以确定其图标。null 用户提供的函数,在每个项目上运行以确定其图标。iconFunction 属性覆盖 iconField 属性。

您可以提供一个 iconFunction,用于查找合适的字段并返回可显示的图标。

icon 函数仅使用数据提供程序中的某个项目作为唯一参数,并返回一个有效的 BitmapImage 源。

      myIconFunction(item:Object):Object
ListBase ListBase 类是支持选择内容的所有组件的基类。The <s:ListBase> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:ListBase
 
    Properties
    arrowKeysWrapFocus="false"
    labelField="label"
    labelFunction="null"
    requireSelection="false"
    selectedIndex="-1"
    selectedItem="undefined"
    useVirtualLayout="false"
 
    Events
    caretChange="No default"
    change="No default"
    changing="No default"
  />
  
]]>
spark.components:SkinnableDataContainer ListBase 类是支持选择内容的所有组件的基类。

注意:基于 Spark List 的控件(Spark ListBase 类及其子类,如 ButtonBar、ComboBox、DropDownList、List 和 TabBar)不支持将 BasicLayout 类作为 layout 属性的值。不要将 BasicLayout 与基于 Spark List 的控件一起使用。

caretChange 焦点已更改后分派。spark.events.IndexChangeEvent.CARET_CHANGEspark.events.IndexChangeEvent 焦点已更改后分派。 change 所选内容已更改后分派。spark.events.IndexChangeEvent.CHANGEspark.events.IndexChangeEvent 所选内容已更改后分派。当用户与此控件交互时,将分派此事件。

以编程方式更改 selectedIndexselectedItem 属性的值时,该控件并不分派 change 事件,而是分派 valueCommit 事件。

changing 所选内容即将更改时分派。spark.events.IndexChangeEvent.CHANGINGspark.events.IndexChangeEvent 所选内容即将更改时分派。对事件调用 preventDefault() 方法可避免选择内容发生更改。

当用户与此控件交互时,将分派此事件。以编程方式更改 selectedIndexselectedItem 属性的值时,该控件并不分派 changing 事件,而是分派 valueCommit 事件。

itemRollOut 当用户将鼠标指针移出控件中的某个项目时分派此事件。spark.events.ListEvent.ITEM_ROLL_OUTspark.events.ListEvent 当用户将鼠标指针移出控件中的某个项目时分派此事件。 itemRollOver 当用户将鼠标指针滚至控件中的某个项目时分派此方法。spark.events.ListEvent.ITEM_ROLL_OVERspark.events.ListEvent 当用户将鼠标指针滚至控件中的某个项目时分派此方法。 ListBase 构造函数。 构造函数。 adjustSelection 调整选定索引以说明正添加到此组件或正从此组件删除的项目。newIndex新索引。 addfalse如果已将项目添加到组件,则为 true;如果已删除项目,则为 false 调整选定索引以说明正添加到此组件或正从此组件删除的项目。此方法调整选定索引值并分派 valueCommit 事件。它不会分派 change 事件,因为用户交互不会直接生成 change 事件。而且,它不分派 changing 事件或允许取消选择内容。因为已选中相同的项目,所以它也不调用 itemSelected() 方法;已更改的唯一事项是项目的索引。

在下次调用 commitProperties() 方法时,将分派 valueCommit 事件。

调整 selectedIndex 后,将不发送 changechanging 事件。

itemAdded 已将项目添加到此组件时调用。index正在添加的项目的索引。 已将项目添加到此组件时调用。将相应地调整所选内容和与插入标记相关的属性。 itemRemoved 已将项目从此组件删除时调用。index正在删除的项目的索引。 已将项目从此组件删除时调用。将相应地调整所选内容和与插入标记相关的属性。 itemSelected 选中或取消选中项目时调用。index已选中的项目索引。 selected如果选中项目,则为 true;如果取消选中项目,则为 false 选中或取消选中项目时调用。子类必须覆盖此方法才可显示选择内容。 itemShowingCaret 当项目处于其 caret 状态时或不处于该状态时调用。index已置于 caret 状态的项目索引。 showsCaret如果项目处于其 caret 状态,则为 true;如果未处于该状态,则为 false 当项目处于其 caret 状态时或不处于该状态时调用。子类必须覆盖此方法才可显示 caret。 itemToLabel 如果有一个数据项目,则返回呈示器应该显示的正确文本,同时将 labelField 和 labelFunction 属性考虑在内。表示要为呈示器中的数据项目显示的文本的 String。 item数据项目 如果有一个数据项目,则返回呈示器应该显示的正确文本,同时将 labelFieldlabelFunction 属性考虑在内。 NO_SELECTION 表示值“no selection”的静态常量。-1 表示值“no selection”的静态常量。 arrowKeysWrapFocus 如果为 true,则使用箭头键在组件内导航时,如果击中某一端则将折回。false 如果为 true,则使用箭头键在组件内导航时,如果击中某一端则将折回。 caretIndex 当前处于焦点的项目。-1 当前处于焦点的项目。 labelField 数据提供程序项目中作为标签显示的字段名称。"label" 数据提供程序项目中作为标签显示的字段名称。如果 labelField 设置为空字符串 (""),则在数据提供程序中不会使用任何字段来表示标签。labelFunction 属性将覆盖此属性。 labelFunction 用户提供的函数,在每个项目上运行以确定其标签。null 用户提供的函数,在每个项目上运行以确定其标签。labelFunction 属性覆盖 labelField 属性。

您可以提供一个 labelFunction,用于查找合适的字段并返回可显示的字符串。labelFunction 还非常适用于处理格式设置和本地化。

label 函数仅使用数据提供程序中的某个项目作为唯一参数,并返回一个 String。

      myLabelFunction(item:Object):String
requireSelection 如果为 true,则必须始终在控件中选中数据项目。false 如果为 true,则必须始终在控件中选中数据项目。如果该值为 true,则始终将 selectedIndex 属性设置为 0 和 (dataProvider.length - 1) 之间的一个值。

对于大多数子类(除了 TabBar),默认值为 false。在这种情况下,默认值为 true

selectedIndex 选中项目的基于 0 的索引;或者如果未选中项目,则为基于 -1 的索引。-1 选中项目的基于 0 的索引;或者如果未选中项目,则为基于 -1 的索引。设置 selectedIndex 属性会取消选择当前选定的项目并选择指定索引位置的数据项目。

该值始终在 -1 和 (dataProvider.length - 1) 之间。如果从组件删除低于 selectedIndex 的索引位置的项目,则会相应地向下调整选定的索引。

如果已删除选定项目,则将选定索引设置为:

  • -1,如果 requireSelection = false 或没有剩余的项目。
  • 0,如果 requireSelection = true 且至少有一个项目。

当用户通过与控件交互来更改 selectedIndex 属性时,此控件将分派 changechanging 事件。当以编程方式更改 selectedIndex 属性的值时,此控件将分派 valueCommit 事件。

selectedItem 当前已选中的项目。undefined 当前已选中的项目。设置此属性会取消选中当前选定的项目并选择新指定的项目。

selectedItem 设置为不在此组件中的项目会导致为选择任何内容,且会将 selectedItem 设置为 undefined

如果已删除选定项目,则将选定项目设置为:

  • undefined,如果 requireSelection = false 或没有剩余的项目。
  • 第一个项目,如果 requireSelection = true 且至少有一个项目。

当用户通过与控件交互来更改 selectedItem 属性时,此控件将分派 changechanging 事件。当以编程方式更改 selectedItem 属性的值时,此控件将分派 valueCommit 事件。

useVirtualLayout 设置与此控件相关联的布局的 useVirtualLayout 属性的值。false 设置与此控件相关联的布局的 useVirtualLayout 属性的值。如果该布局随后被替换,且此属性的值为 true,则会将新布局的 useVirtualLayout 属性设置为 true
InteractionStateDetector 组件的 helper 类用于帮助确定组件是否应处于 up、over 或 down 状态。flash.events:EventDispatcher 组件的 helper 类用于帮助确定组件是否应处于 up、over 或 down 状态。

当状态改变时,如果应播放转换,则为 playTransitions。

spark.components.supportClasses.InteractionStatechange 状态更改后分派。flash.events.Event.CHANGEflash.events.Event 状态更改后分派。 InteractionStateDetector 构造函数 component 用于检测是否处于 up/over/down 状态的 UIComponent。已将事件侦听器连接到此对象。 构造函数 state 返回组件的状态;可能的值包括:InteractionState.UP、InteractionState.DOWN、InteractionState.OVER 返回组件的状态

可能的值包括:

  • InteractionState.UP
  • InteractionState.DOWN
  • InteractionState.OVER

spark.components.supportClasses.InteractionState;
DropDownListBase DropDownListBase 控件包含下拉列表,用户可从中选择单个值。 DropDownListBase 控件的打开状态的外观状态。 AIR 1.5 3.0 Flex 4 定义下拉列表区域的外观部件。DropDownListBase 打开时,在 dropDown 外观部件之外的任何位置单击将关闭该下拉列表。 AIR 1.5 3.0 Flex 4 A skin part that defines the drop-down list area. 定义锚点按钮的外观部件。 AIR 1.5 3.0 Flex 4 A skin part that defines the anchor button.The <s:DropDownListBase> tag inherits all of the tag attributes of its superclass and adds the following attributes:

  <s:DropDownListBase 
    Styles
    cornerRadius="4"
    dropShadowVisible="true"
 
    Events
    closed="No default"
    open="No default"
  />
  
]]>
spark.components:List DropDownListBase 控件包含下拉列表,用户可从中选择单个值。其功能与 HTML 中 SELECT 表单元素的功能非常相似。

DropDownListBase 控件由锚点按钮和下拉列表构成。使用锚点按钮可打开和关闭下拉列表。

打开下拉列表时:

  • 单击锚点按钮会关闭下拉列表并提交当前选定的数据项目。
  • 在下拉列表之外单击会关闭下拉列表并提交当前选定的数据项目。
  • 在某个数据项目上单击会选中该项目并关闭下拉列表。
  • 如果 requireSelection 属性为 false,则按下 Ctrl 键的同时单击某个数据项目会取消选中该项目并关闭下拉列表。
spark.skins.spark.DropDownListSkinspark.components.supportClasses.DropDownControlleropen 当用户单击锚点按钮以显示下拉列表时分派。spark.events.DropDownEvent.OPENspark.events.DropDownEvent 当用户单击锚点按钮以显示下拉列表时分派。用户使用 Control-Down 打开 dropDown 时也会分派它。 close 当因以下任何原因关闭下拉列表时分派:用户选择下拉列表中的某个项目。在下拉列表外部单击。在显示下拉列表时单击锚点按钮。 spark.events.DropDownEvent.CLOSEspark.events.DropDownEvent 当因以下任何原因关闭下拉列表时分派:用户
  • 选择下拉列表中的某个项目。
  • 在下拉列表外部单击。
  • 在显示下拉列表时单击锚点按钮。
DropDownListBase 构造函数。 构造函数。 closeDropDown 关闭下拉列表并分派 DropDownEvent.CLOSE 事件。commit如果为 true,请提交选定的数据项目。 关闭下拉列表并分派 DropDownEvent.CLOSE 事件。 openDropDown 打开下拉列表并分派 DropdownEvent.OPEN 事件。 打开下拉列表并分派 DropdownEvent.OPEN 事件。 dropDownController 用于处理所有鼠标、键盘和焦点用户交互的 DropDownController 类的实例。spark.components.supportClasses:DropDownController 用于处理所有鼠标、键盘和焦点用户交互的 DropDownController 类的实例。在构造函数中创建 DropDownController 实例之后,Flex 调用 initializeDropDownController() 方法。 isDropDownOpen
SkinnableTextBase 在其外观中包含 IEditableText 的实例以提供文本显示、滚动、选择和编辑等功能的、可设置外观的组件(如 Spark TextInput 和 TextArea)的基类。 带有提示的禁用状态。 AIR 2.5 3.0 Flex 4.5 带有提示的正常状态。 AIR 2.5 3.0 Flex 4.5 已禁用状态。 AIR 1.5 3.0 Flex 4 正常状态。 AIR 1.5 3.0 Flex 4 在指定给此组件的任何外观中可能会存在的标签或其它 IDisplayText。 AIR 1.5 3.0 Flex 4 The Label or other IDisplayText that might be present in any skin assigned to this component. 在指定给此组件的任何外观中可能会存在的 IEditableText。对于 Spark 主题,这是 RichEditableText;对于 Mobile 主题,这是 StyleableStageText。 AIR 1.5 3.0 Flex 4 The IEditableText that may be present in any skin assigned to this component.The <s:SkinnableTextBase> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:SkinnableTextBase
    autoCapitalize="none"  [Mobile theme only]
    autoCorrect="true"  [Mobile theme only]
    displayAsPassword="false"
    editable="true"
    imeMode="null"  [Spark theme only]
    maxChars="0"
    prompt="null"
    restrict="null"
    returnLabelKey="default"  [Mobile theme only]
    selectable="true"
    selectionHighlighting="whenFocused"  [Spark theme only]
    softKeyBoardType="default"  [Mobile theme only]
    text=""
    typicalText="null"  [Spark theme only]
  
    Styles
    borderAlpha="1.0"
    borderColor="0x696969"
    borderVisible="true"
    contentBackgroundAlpha="1.0" 
    contentBackgroundColor="0xFFFFFF"
    focusAlpha="0.55"
    focusColor="0x70B2EE"
    showPromptWhenFocused="true"
 
    Events
    change="No default"
    changing="No default"  [Spark theme only]
    selectionChange="No default"  [Spark theme only]
    textInput="No default"  [Spark theme only]
  />
  
]]>
mx.managers:IFocusManagerComponentmx.core:IIMESupportspark.core:ISoftKeyboardHintClientspark.components.supportClasses:SkinnableComponent 在其外观中包含 IEditableText 的实例以提供文本显示、滚动、选择和编辑等功能的、可设置外观的组件(如 Spark TextInput 和 TextArea)的基类。默认情况下,对于 Spark 主题,IEditableText 是 RichEditableText;对于 Mobile 主题,是 StyleableStageText。StyleableTextField 也可用于 Mobile 主题。 textInput 将要在组件中存在输入击键动作时分派。flash.events.TextEvent.TEXT_INPUTflash.events.TextEvent 将要在组件中存在输入击键动作时分派。

对于 Mobile 主题,不调度此项。

change 在用户编辑操作完成后分派。spark.events.TextOperationEvent.CHANGEspark.events.TextOperationEvent 在用户编辑操作完成后分派。 changing 在用户编辑操作发生前分派。spark.events.TextOperationEvent.CHANGINGspark.events.TextOperationEvent 在用户编辑操作发生前分派。可以更改该操作,或取消该事件以防止该操作被处理。

对于 Mobile 主题,不调度此项。

selectionChange 在 selectionAnchorPosition 和/或 selectionActivePosition 属性因任意原因而更改后分派。mx.events.FlexEvent.SELECTION_CHANGEmx.events.FlexEvent 出于任何原因在 selectionAnchorPosition 和/或 selectionActivePosition 属性已更改后分派。

对于 Mobile 主题,不调度此项。

SkinnableTextBase 构造函数。 构造函数。 appendText text要追加的文本。 spark.components.RichEditableText.appendText()spark.components.supportClasses.StyleableStageText.appendText()insertText text要插入的文本。 spark.components.RichEditableText.insertText()spark.components.supportClasses.StyleableStageText.insertText()selectAll spark.components.RichEditableText.selectAll()spark.components.supportClasses.StyleableStageText.selectAll()selectRange anchorIndex字符位置,用于指定扩展选区时保持固定的选区的未端。 activeIndex字符位置,用于指定扩展选区时移动的选区的未端。 spark.components.RichEditableText.selectRange()spark.components.supportClasses.StyleableStageText.selectRange()autoCapitalize 提示,用于指示应使用的大写行为软键盘。"none" 提示,用于指示应使用的大写行为软键盘。

支持的值在 flash.text.AutoCapitalize 中定义:

  • “none”- 不自动大写
  • “word”- 大写任何空格或标点符号后的第一个字母
  • “sentence”- 大写任何句号后的第一个字母
  • “all”- 大写每个字母

对于 Spark 主题,它不受支持。

flash.text.AutoCapitalize
autoCorrect 提示,用于指示软键盘是否应使用自动更正行为(如果支持)。true 提示,用于指示软键盘是否应使用自动更正行为(如果支持)。

对于 Spark 主题,它不受支持。

displayAsPassword false editable 指定文本是否可编辑。true 指定文本是否可编辑。

有关 Spark 主题,请参阅 spark.components.RichEditableText.editable。

对于 Mobile 主题,请参阅 spark.components.supportClasses.StyleableStageText.editable

spark.components.RichEditableText.editablespark.components.supportClasses.StyleableStageText.editable
enableIME 一个标志,用于指示当组件获得焦点时是否应启用 IME。 一个标志,用于指示当组件获得焦点时是否应启用 IME。

对于 Mobile 主题,它不受支持。

spark.components.RichEditableText.enableIME
imeMode 指定 IME(输入法编辑器)模式。null 指定 IME(输入法编辑器)模式。

有关 Spark 主题,请参阅 spark.components.RichEditableText.imeMode。

对于 Mobile 主题,它不受支持。

spark.components.RichEditableText.imeMode
maxChars 0 prompt 当实际 text 属性为空字符串时要显示的文本。null 当实际 text 属性为空字符串时要显示的文本。

先创建文本控件时将显示提示文本。控件获得焦点时或控件的 text 属性为非空字符串时,提示文本将消失。控件失去焦点时提示文本将重新显示,但仅当未输入文本时(如果文本字段的值为空字符串)。

对于文本控件,如果用户输入文本,但随后又将其删除,则控件失去焦点后,提示文本将重新显示。您还可以通过编程方式将文本控件的 text 属性设置为空字符串使提示文本重新显示。

您可以使用 CSS 更改提示文本的样式。如果控件具有提示文本且未处于禁用状态,normalWithPrompt 伪选择器将定义该样式。如果控件处于禁用状态,将使用 disabledWithPrompt 伪选择器所定义的样式。

以下示例 CSS 更改了作为 SkinnableTextBase 子类的控件(包括 Spark TextInput 和 TextArea 控件)中的提示文本的颜色:

      @namespace s "library://ns.adobe.com/flex/spark";
      s|SkinnableTextBase:normalWithPrompt {
          color: #CCCCFF;
      }
      

restrict null returnKeyLabel 提示,用于指示在软键盘上应使用哪个标签来显示回车键。"default" 提示,用于指示在软键盘上应使用哪个标签来显示回车键。

支持的值在 flash.text.ReturnKeyLabel 中定义:

  • “default”- 默认的图标或标签文本
  • “done”- 表示文本输入完成的图标或标签文本
  • “go”- 表示操作应开始的图标或标签文本
  • “next”- 表示移动到下一字段的图标或标签文本
  • “search”- 表示应搜索输入的文本的图标或标签文本

对于 Spark 主题,它不受支持。

flash.text.ReturnKeyLabel
selectable 一个标志,指示内容是否可选。true 一个标志,指示内容是否可选。在桌面上,用户可以使用鼠标或键盘(如果控件含有键盘焦点)选择内容。在 touch 交互设备上,用户进入到文本组件的选择模式后,就可以使用他们的手指选择文本。

有关 Spark 主题,请参阅 spark.components.RichEditableText.selectable。

对于 Mobile 主题,请参阅 spark.components.supportClasses.StyleableStageText.selectable

spark.components.RichEditableText.selectablespark.components.supportClasses.StyleableStageText.selectable
selectionActivePosition 相对于 text 字符串开头的字符位置,用于指定用箭头键扩展选区时该选区的终点。 相对于 text 字符串开头的字符位置,用于指定用箭头键扩展选区时该选区的终点。

有关 Spark 主题,请参阅 spark.components.RichEditableText.selectionActivePosition。

对于 Mobile 主题,请参阅 spark.components.supportClasses.StyleableStageText.selectionActivePosition

spark.components.RichEditableText.selectionActivePositionspark.components.supportClasses.StyleableStageText.selectionActivePosition
selectionAnchorPosition 相对于 text 字符串开头的字符位置,用于指定用箭头键扩展选区时该选区保持固定的终点。 相对于 text 字符串开头的字符位置,用于指定用箭头键扩展选区时该选区保持固定的终点。

有关 Spark 主题,请参阅 spark.components.RichEditableText.selectionAnchorPosition。

对于 Mobile 主题,请参阅 spark.components.supportClasses.StyleableStageText.selectionAnchorPosition

spark.components.RichEditableText.selectionAnchorPositionspark.components.supportClasses.StyleableStageText.selectionAnchorPosition
selectionHighlighting 确定何时加亮选择的文本。TextSelectionHighlighting.WHEN_FOCUSED 确定何时加亮选择的文本。

有关 Spark 主题,请参阅 spark.components.RichEditableText.selectionHighlighting。

对于 Mobile 主题,它不受支持。

spark.components.RichEditableText.selectionHighlighting
softKeyboardType 提示,用于指示应为此组件显示哪种类型的软键盘。"default" 提示,用于指示应为此组件显示哪种类型的软键盘。

支持的值在 flash.text.SoftKeyboardType 中定义:

  • “default”- 默认键盘
  • “punctuation”- 将键盘包含在标点符号/符号输入模式中
  • “url”- 提供适用于 URL 输入的软键,如一个专用键用于插入“.com”
  • “number”- 将键盘包含在数字键盘模式中
  • “contact”- 将键盘包含在适用于输入联系人信息的模式中
  • “email”- 将键盘包含在电子邮件地址输入模式中,以使输入 @ 符号或“.com”更轻松

对于 Spark 主题,它不受支持。

flash.text.SoftKeyboardType
text 此文本组件所显示的文本。"" 此文本组件所显示的文本。

有关 Spark 主题,请参阅 spark.components.RichEditableText.text。

对于 Mobile 主题,请参阅 spark.components.supportClasses.StyleableStageText#text

spark.components.RichEditableText.textspark.components.supportClasses.StyleableStageText.text
typicalText 用于不实际显示即可确定控件的默认宽度和高度的文本。null 用于不实际显示即可确定控件的默认宽度和高度的文本。

有关 Spark 主题,请参阅 park.components.RichEditableText.typicalText。

对于 Mobile 主题,它不受支持。

spark.components.RichEditableText.typicalText