| 包 | mx.controls |
| 类 | public class VSlider |
| 继承 | VSlider  Slider UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
滑块可能允许使用其最小值和最大值之间的连续范围内的值，也可能限制为最小值和最大值之间采用特定间隔的值。它可能沿轨道按指定间隔显示刻度线。这些刻度线与允许的滑块值无关。滑块还可以使用数据提示显示其当前值。
VSlider 具有垂直方向。滑块轨道从下往上扩展，而标签和刻度线位于轨道的左右两侧。
VSlider 控件具备下列默认特征：
| 特征 | 说明 |
|---|---|
| 默认大小 | 高度为 250 个像素，宽度足以容纳滑块及任何关联标签 |
| 最小大小 | 无 |
| 最大大小 | 无 |
隐藏 MXML 语法The <mx:VSlider> tag inherits all of the tag attributes
of its superclass, and adds the following tag attribute:
显示 MXML 语法
<mx:VSlider
Styles
dataTipPlacement="top"
/>
另请参见
| 方法 | 定义方 | ||
|---|---|---|---|
VSlider() 构造函数。 | VSlider | ||
 | 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | |
| 将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | EventDispatcher | |
| 指示安全限制是否会导致出现以下情况：在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。 | DisplayObjectContainer | |
| 排队稍后调用的函数。 | UIComponent | |
| 删除此组件实例中的样式属性。 | UIComponent | |
| 确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。 | DisplayObjectContainer | |
| 将 Point 对象由内容坐标转换为全局坐标。 | UIComponent | |
| 将 Point 对象由内容坐标转换为本地坐标。 | UIComponent | |
| 返回标识此容器中的子项的一组属性。 | UIComponent | |
| 在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。 | UIComponent | |
| 在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。 | UIComponent | |
| 返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。 | UIComponent | |
| 将事件调度到事件流中。 | UIComponent | |
| 在此组件周围显示或隐藏焦点指示符。 | UIComponent | |
| drawRoundRect(x:Number, y:Number, width:Number, height:Number, cornerRadius:Object = null, color:Object = null, alpha:Object = null, gradientMatrix:Matrix = null, gradientType:String = "linear", gradientRatios:Array = null, hole:Object = null):void 通过编程方式在此外观的 Graphics 对象中绘制一个矩形。 | UIComponent | |
| 停止在组件上播放效果实例时，由效果实例调用。 | UIComponent | |
| 开始在组件上播放效果实例时，由效果实例调用。 | UIComponent | |
| 结束组件上当前播放的所有效果。 | UIComponent | |
| 将数据绑定到此 UIComponent 对象。 | UIComponent | |
| 打印完成后调用。 | UIComponent | |
| 在指定的索引位置提供自动化对象。 | UIComponent | |
| 返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | |
| 返回位于指定索引处的子显示对象实例。 | DisplayObjectContainer | |
| 返回具有指定名称的子显示对象。 | DisplayObjectContainer | |
| 返回 DisplayObject 的 child 实例的索引位置。 | DisplayObjectContainer | |
| 查找此 UIComponent 实例的类型选择器。 | UIComponent | |
| 返回一个约束布局值，这与获取此组件的约束样式的方式类似。 | UIComponent | |
| 确定是使用显式高度还是测量高度的一种简便方法 | UIComponent | |
| 确定是使用显式宽度还是测量宽度的一种简便方法 | UIComponent | |
| 获取当前具有焦点的对象。 | UIComponent | |
| 返回对象的数组，这些对象位于指定点下，并且是该 DisplayObjectContainer 实例的子项（或孙子项，依此类推）。 | DisplayObjectContainer | |
| 返回一个矩形，该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。 | DisplayObject | |
| 返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目；如果此 Repeater 未重复，则返回 null。 | UIComponent | |
| 获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | UIComponent | |
| 返回给定索引处的滑块对象。 | Slider | |
| 将 Point 对象由全局坐标转换为内容坐标。 | UIComponent | |
| 将 point 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。 | DisplayObject | |
| 将二维点从舞台（全局）坐标转换为三维显示对象的（本地）坐标。 | DisplayObject | |
| 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
|
指示对象是否已经定义了指定的属性。 | Object | |
| 计算显示对象，以确定它是否与 obj 显示对象重叠或相交。 | DisplayObject | |
| 计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | |
| 返回一个框 Matrix，在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。 | UIComponent | |
| 初始化此组件的内部结构。 | UIComponent | |
| 初始化用于跟踪此组件的重复实例的各个属性。 | UIComponent | |
| 标记组件，以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。 | UIComponent | |
| 标记组件，以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。 | UIComponent | |
| 标记组件，以便在稍后屏幕更新期间调用该组件的 measure() 方法。 | UIComponent | |
|
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
| 将三维显示对象的（本地）坐标的三维点转换为舞台（全局）坐标中的二维点。 | DisplayObject | |
| 将 Point 对象由本地坐标转换为内容坐标。 | UIComponent | |
| 将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。 | DisplayObject | |
| 测量指定的 HTML 文本（该文本中可能包含 <font> 和 <b> 等 HTML 标记），假定该文本显示在单行 UITextField（使用由此 UIComponent 的样式确定的 UITextFormat）中。 | UIComponent | |
| 测量指定的文本，假定该文本显示在单行 UITextField（使用由此 UIComponent 的样式确定的 UITextFormat）中。 | UIComponent | |
| 将组件移动到其父项内的指定位置。 | UIComponent | |
| 将样式更改传播到子项。 | UIComponent | |
| 如果 owner 属性链从 child 指向此 UIComponent，则返回 true。 | UIComponent | |
| 当在父项中添加或删除 UIComponent 对象时由 Flex 调用。 | UIComponent | |
| 准备 IFlexDisplayObject 用于打印。 | UIComponent | |
|
指示指定的属性是否存在、是否可枚举。 | Object | |
| 为此组件构建或重新构建 CSS 样式缓存；如果 recursive 参数为 true，还会为此组件的所有后代执行同样的操作。 | UIComponent | |
| 针对每个效果事件，将 EffectManager 注册为一个事件侦听器。 | UIComponent | |
| 从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。 | DisplayObjectContainer | |
| 从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。 | DisplayObjectContainer | |
| 从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
| 重放指定的事件。 | UIComponent | |
| 使用提供的 ID 解析子项。 | UIComponent | |
| [静态] 在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | |
| 调整对象大小。 | UIComponent | |
| 更改现有子项在显示对象容器中的位置。 | DisplayObjectContainer | |
| 设置一个布局约束值的方式，与设置此组件的约束样式的方式相同。 | UIComponent | |
| 设置当前状态。 | UIComponent | |
| 设置此组件的焦点。 | UIComponent | |
|
设置循环操作动态属性的可用性。 | Object | |
| 对此组件实例设置样式属性。 | UIComponent | |
| 此方法可设置滑块的值，并更新显示。 | Slider | |
| 当 visible 属性发生更改时调用。 | UIComponent | |
| 允许用户拖动指定的 Sprite。 | Sprite | |
| 结束 startDrag() 方法。 | Sprite | |
| 检测对样式属性的更改。 | UIComponent | |
| 首次初始化组件样式时，Flex 会调用 stylesInitialized() 方法。 | UIComponent | |
| [静态] 阻止对使用 callLater() 排队的方法进行背景处理，直到调用 resumeBackgroundProcessing() 为止。 | UIComponent | |
| 交换两个指定子对象的 Z 轴顺序（从前到后顺序）。 | DisplayObjectContainer | |
| 在子级列表中两个指定的索引位置，交换子对象的 Z 轴顺序（前后顺序）。 | DisplayObjectContainer | |
| 返回一个字符串，用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。 | FlexSprite | |
| 验证子项的位置和大小，并绘制其它可视内容。 | UIComponent | |
| 验证并更新此对象的属性和布局，如果需要的话重绘对象。 | UIComponent | |
| 由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。 | UIComponent | |
| 如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法，随后在测量时调用了 validateSize() 方法，则验证组件的度量大小。 | UIComponent | |
| 处理分配给此组件的验证程序调度的 valid 和 invalid 事件。 | UIComponent | |
|
返回指定对象的原始值。 | Object | |
| 返回一个框 Matrix，在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。 | UIComponent | |
| 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。 | EventDispatcher | |
| 样式 | 说明 | 定义方 | ||
|---|---|---|---|---|
| 类型: String CSS 继承: no 从内容区域的上边缘到控件的基线位置的垂直距离（以像素为单位）。如果设置此样式，则组件的基线锚定在其内容区域的上边缘；调整组件容器大小后，这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（ 默认值为 | UIComponent | ||
| 类型: uint 格式: Color CSS 继承: no 边框黑色部分的颜色。. | Slider | ||
| 类型: String CSS 继承: no 从组件的下边缘到其内容区域的下边缘的垂直距离（以像素为单位）。如果设置此样式，则组件的下边缘锚定在其内容区域的下边缘；调整组件容器大小后，这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（ 默认值为 | UIComponent | ||
| 类型: Number 格式: Length CSS 继承: no 数据提示相对于滑块的偏移量（以像素为单位）。与 HSlider 和 VSlider 控件的 dataTipPlacement 样式属性结合使用。. | Slider | ||
dataTipPlacement | 类型: String CSS 继承: no 相对于滑块的数据提示位置。可能值为 "left"、"right"、"top" 和 "bottom"。
默认值为 "left". | VSlider | ||
| 类型: int CSS 继承: no 用于数据提示文本的小数位数。值 0 表示将所有值舍入为整数。. | Slider | ||
| 类型: String CSS 继承: no 用于数据提示的样式声明名称。. | Slider | ||
| 类型: uint 格式: Color CSS 继承: yes 验证失败时，组件加亮部分的颜色。验证失败时，Flex 还会将组件的 borderColor 样式设置为 errorColor。. | UIComponent | ||
| 类型: Array CSS 继承: no 指定用于组件背景填充的 alpha 透明度值，您应将其设置为包含两个或四个数值的 Array。元素 0 和元素 1 指定 alpha 渐变的开始和结束值。如果存在元素 2 和元素 3，则当鼠标移动到组件时将使用这两个值取代元素 0 和元素 1。全局默认值为 [ 0. | Slider | ||
| 类型: Array 格式: Color CSS 继承: no 指定用于着色组件背景填充的颜色。您应该将其设置为一个 Array，包含用于指定 RGB 颜色的两个或四个 uint 值。元素 0 和元素 1 指定颜色渐变的开始和结束值。如果存在元素 2 和元素 3，则当鼠标移动到组件时将使用这两个值取代元素 0 和元素 1。要设置具有均匀外观的控件，请将元素 0 和 1 以及元素 2 和 3 设置相同的颜色，默认值为 [ 0xFFFFFF, 0xCCCCCC, 0xFFFFFF, 0xEEEEEE ]。 部分组件（如 ApplicationControlBar 容器）具有不同的默认值。对于 ApplicationControlBar 容器，此默认值为 | Slider | ||
| 类型: String CSS 继承: no 焦点矩形使用的混合模式。有关详细信息，请参阅 flash. | UIComponent | ||
| 类型: Class CSS 继承: no 用于绘制焦点矩形的外观。. | UIComponent | ||
| 类型: Number 格式: Length CSS 继承: no 焦点矩形轮廓的粗细，以像素为单位。. | UIComponent | ||
| 类型: String CSS 继承: no 从组件内容区域的中心到组件中心的水平距离（以像素为单位）。如果设置此样式，则组件的中心锚定在其内容区域的中心；调整组件容器大小后，这两个中心将保持它们的水平间距。 此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（ 默认值为 | UIComponent | ||
| 类型: Boolean CSS 继承: no 反转滑块的方向。如果为 true，则会反转滑块。. | Slider | ||
| 类型: Number 格式: Length CSS 继承: no 标签相对于轨道的 y 位置偏移（如果方向是水平的）或 x 位置偏移（如果方向是垂直的）。. | Slider | ||
| 类型: String CSS 继承: no 用于滑块标签的样式名称。. | Slider | ||
| 类型: String CSS 继承: no 从组件内容区域的左边缘到组件左边缘的水平距离（以像素为单位）。如果设置此样式，则组件的左边缘锚定在其内容区域的左边缘；调整组件容器大小后，这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（ 默认值为 | UIComponent | ||
| 类型: String CSS 继承: no 从组件的右边缘到其内容区域的右边缘的水平距离（以像素为单位）。如果设置此样式，则组件的右边缘锚定在其内容区域的右边缘；调整组件容器大小后，这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（ 默认值为 | UIComponent | ||
| 类型: Boolean CSS 继承: no 指定是否启用滑块间（或单个滑块和轨道的开始端之间）的轨道亮显效果。. | Slider | ||
| 类型: Number 格式: Time CSS 继承: no 在轨道上单击以移动滑块时，滑动动画持续的时间（以毫秒为单位）。. | Slider | ||
| 类型: Function CSS 继承: no 在轨道上单击以移动滑块时，滑动动画使用的补间函数。. | Slider | ||
| 类型: uint 格式: Color CSS 继承: yes 组件的主题颜色。此属性控制加亮内容的外观、选中组件时的外观和其它相似的形象化提示，但是它对此组件的常规边框和背景颜色不起作用。虽然可以使用任意有效的颜色值，但首选值为 haloGreen、haloBlue、haloOrange 和 haloSilver。 | UIComponent | ||
| 类型: Class CSS 继承: no 滑块处于禁用状态时的外观。. | Slider | ||
| 类型: Class CSS 继承: no 滑块处于按下状态时的外观。. | Slider | ||
| 类型: Number 格式: Length CSS 继承: no 滑块相对于轨道的 y 位置偏移（如果方向是水平的）或 x 位置偏移（如果方向是垂直的）。. | Slider | ||
| 类型: Class CSS 继承: no 滑块处于经过状态时的外观。. | Slider | ||
| 类型: Class CSS 继承: no 滑块的默认外观。. | Slider | ||
| 类型: Class CSS 继承: no 滑块处于弹起状态时的外观。. | Slider | ||
| 类型: uint 格式: Color CSS 继承: no 刻度线的颜色。可以是十六进制颜色值或已知颜色的字符串名。. | Slider | ||
| 类型: Number 格式: Length CSS 继承: no 刻度线的长度（以像素为单位）。如果 direction 为 Direction. | Slider | ||
| 类型: Number 格式: Length CSS 继承: no 刻度线相对于轨道的 y 位置偏移（如果方向是水平的）或 x 位置偏移（如果方向是垂直的）。. | Slider | ||
| 类型: Number 格式: Length CSS 继承: no 刻度线的粗细（以像素为单位）。如果方向是水平的，则调整刻度线的宽度。如果方向是垂直的，则调整高度。. | Slider | ||
| 类型: String CSS 继承: no 从控件内容区域的上边缘到组件上边缘的垂直距离（以像素为单位）。如果设置此样式，则组件的上边缘锚定在其内容区域的上边缘；调整其容器大小后，这两个边缘将保持其间距。 此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（ 默认值为 | UIComponent | ||
| 类型: Array 格式: Color CSS 继承: no 轨道的颜色（由两种颜色组成的数组）。您可以使用同一种颜色两次，以实现纯色轨道。 可将此属性与 | Slider | ||
| 类型: Class CSS 继承: no 滑块轨道处于选定状态时的外观。. | Slider | ||
| 类型: Number 格式: Length CSS 继承: no 轨道边距的大小（以像素为单位）。如果为 undefined，则轨道边距取决于第一个标签和最后一个标签的长度。如果给定了某个值，则 Flex 会尝试使标签适应可用空间。. | Slider | ||
| 类型: Class CSS 继承: no 滑块轨道的外观。. | Slider | ||
| 类型: String CSS 继承: no 从组件内容区域的中心到组件中心的垂直距离（以像素为单位）。如果设置此样式，则组件的中心锚定在其内容区域的中心；调整其容器大小后，这两个中心将保持其垂直间距。 此样式仅在 Canvas 容器中的组件上，或在 Panel 或 Application 容器（ 默认值为 | UIComponent | ||
| VSlider | () | 构造函数 |
public function VSlider()构造函数。
<?xml version="1.0"?>
<!-- Simple example to demonstrate the VSlider control. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
<mx:Script>
<![CDATA[
private var imageWidth:Number=0;
private var imageHeight:Number=0;
// Event handler function to change the image size.
private function changeSize():void
{
phoneImage.width=uint(imageWidth*hSlider.value/100);
phoneImage.height=uint(imageHeight*hSlider.value/100);
}
]]>
</mx:Script>
<mx:Panel id="panel" title="VSlider Control Example"
height="100%" width="100%"
layout="horizontal"
paddingTop="10" paddingBottom="10" paddingLeft="10" paddingRight="10">
<mx:HBox width="50%">
<mx:Image id="phoneImage" source="@Embed('assets/Nokia_6630.png')"
creationComplete="imageWidth=phoneImage.width; imageHeight=phoneImage.height;" />
</mx:HBox>
<mx:VBox horizontalAlign="center">
<mx:Label color="blue" text="Drag the slider to resize the image."/>
<mx:VSlider id="hSlider"
dataTipPlacement="top"
minimum="0" maximum="100" value="100"
tickColor="black"
snapInterval="1" tickInterval="10"
labels="['0%','100%']"
allowTrackClick="true"
liveDragging="true"
change="changeSize();"/>
</mx:VBox>
</mx:Panel>
</mx:Application>