student-ar-fl-controls-ComboBox.ax [swf] flex
Dispatched when the user changes the selection in the @ax-student-ar-fl-controls-ComboBox component or, if the @ax-student-ar-fl-controls-ComboBox component is editable, each time the user enters a keystroke in the text field. @eventType flash.events.Event.CHANGE @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.SelectableList#event:itemRollOver @eventType fl.events.ListEvent.ITEM_ROLL_OVER @includeExample examples/@ax-student-ar-fl-controls-ComboBox.itemRollOver.1.as -noswf
see: #event:itemRollOut @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.SelectableList#event:itemRollOut @eventType fl.events.ListEvent.ITEM_ROLL_OUT
see: #event:itemRollOver @langversion 3.0 @playerversion Flash 9.0.28.0
Dispatched when the drop-down list is dismissed for any reason. @eventType flash.events.Event.CLOSE @includeExample examples/@ax-student-ar-fl-controls-ComboBox.close.1.as -noswf
see: #close()
see: #event:open @langversion 3.0 @playerversion Flash 9.0.28.0
Dispatched if the <code>editable</code> property is set to <code>true</code> and the user presses the Enter key while typing in the editable text field. @eventType fl.events.ComponentEvent.ENTER @langversion 3.0 @playerversion Flash 9.0.28.0
Dispatched when the user clicks the drop-down button to display the drop-down list. Also dispatched when the user clicks the text field, if the @ax-student-ar-fl-controls-ComboBox component is not editable. @eventType flash.events.Event.OPEN @includeExample examples/@ax-student-ar-fl-controls-ComboBox.open.1.as -noswf
see: #event:close
see: #open() @langversion 3.0 @playerversion Flash 9.0.28.0
Dispatched when the user scrolls the drop-down list of the @ax-student-ar-fl-controls-ComboBox component. @eventType fl.events.ScrollEvent.SCROLL @langversion 3.0 @playerversion Flash 9.0.28.0
The space that separates the right edge of the component from the text representing the selected item, in pixels. The button is part of the background skin. @default 24 @langversion 3.0 @playerversion Flash 9.0.28.0
The space that separates the border from the text representing the selected item, in pixels. @default 3 @langversion 3.0 @playerversion Flash 9.0.28.0
The name of the class that provides the background of the @ax-student-ar-fl-controls-ComboBox component. @default @file_upSkin @langversion 3.0 @playerversion Flash 9.0.28.0
The name of the class that provides the background that appears in the @ax-student-ar-fl-controls-ComboBox component when the mouse is over it. @default @file_overSkin @langversion 3.0 @playerversion Flash 9.0.28.0
The name of the class that provides the background that appears in the @ax-student-ar-fl-controls-ComboBox component when the mouse is down. @default @file_downSkin @langversion 3.0 @playerversion Flash 9.0.28.0
The name of the class that provides the background that appears in the @ax-student-ar-fl-controls-ComboBox component when the <code>enabled</code> property of the component is set to <code>false</code>. @default @file_disabledSkin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.SelectableList#style:cellRenderer @default fl.controls.listClasses.CellRenderer @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.containers.BaseScrollPane#style:contentPadding @default 3 @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.SelectableList#style:disabledAlpha @default 0.5 @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:downArrowDisabledSkin @default ScrollArrowDown_disabledSkin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:downArrowDownSkin @default ScrollArrowDown_downSkin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:downArrowOverSkin @default ScrollArrowDown_overSkin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:downArrowUpSkin @default ScrollArrowDown_upSkin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:thumbDisabledSkin @default ScrollThumb_upSkin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:thumbDownSkin @default ScrollThumb_downSkin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:thumbOverSkin @default ScrollThumb_overSkin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:thumbUpSkin @default ScrollThumb_upSkin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:trackDisabledSkin @default ScrollTrack_Skin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:trackDownSkin @default ScrollTrack_Skin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:trackOverSkin @default ScrollTrack_Skin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:trackUpSkin @default ScrollTrack_Skin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:upArrowDisabledSkin @default ScrollArrowUp_disabledSkin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:upArrowDownSkin @default ScrollArrowUp_downSkin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:upArrowOverSkin @default ScrollArrowUp_overSkin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:upArrowUpSkin @default ScrollArrowUp_upSkin @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.ScrollBar#style:thumbIcon @default ScrollBar_thumbIcon @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.BaseButton#style:repeatDelay @default 500 @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.BaseButton#style:repeatInterval @default 35 @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.LabelButton#style:embedFonts @default false @langversion 3.0 @playerversion Flash 9.0.28.0
The @ax-student-ar-fl-controls-ComboBox component contains a drop-down list from which the user can select one value. Its functionality is similar to that of the SELECT form element in HTML. The @ax-student-ar-fl-controls-ComboBox component can be editable, in which case the user can type entries that are not in the list into the TextInput portion of the @ax-student-ar-fl-controls-ComboBox component. @includeExample examples/@fileExample.as
see: List
see: TextInput @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private @langversion 3.0 @playerversion Flash 9.0.28.0
@private @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.core.UIComponent#getStyleDefinition() @includeExample ../core/examples/UIComponent.getStyleDefinition.1.as -noswf
see: fl.core.UIComponent#getStyle() UIComponent.getStyle()
see: fl.core.UIComponent#setStyle() UIComponent.setStyle()
see: fl.managers.StyleManager StyleManager @langversion 3.0 @playerversion Flash 9.0.28.0
@private (internal) @langversion 3.0 @playerversion Flash 9.0.28.0
Creates a new @ax-student-ar-fl-controls-ComboBox component instance. @langversion 3.0 @playerversion Flash 9.0.28.0
Gets or sets a Boolean value that indicates whether the @ax-student-ar-fl-controls-ComboBox component is editable or read-only. A value of <code>true</code> indicates that the @ax-student-ar-fl-controls-ComboBox component is editable; a value of <code>false</code> indicates that it is not. <p>In an editable @ax-student-ar-fl-controls-ComboBox component, a user can enter values into the text box that do not appear in the drop-down list. The text box displays the text of the item in the list. If a @ax-student-ar-fl-controls-ComboBox component is not editable, text cannot be entered into the text box. </p> @default false @includeExample examples/@ax-student-ar-fl-controls-ComboBox.editable.1.as -noswf @langversion 3.0 @playerversion Flash 9.0.28.0
@private (setter) @langversion 3.0 @playerversion Flash 9.0.28.0
Gets or sets the maximum number of rows that can appear in a drop-down list that does not have a scroll bar. If the number of items in the drop-down list exceeds this value, the list is resized and a scroll bar is displayed, if necessary. If the number of items in the drop-down list is less than this value, the drop-down list is resized to accommodate the number of items that it contains. <p>This behavior differs from that of the List component, which always shows the number of rows specified by its <code>rowCount</code> property, even if this includes empty space.</p> @default 5 @includeExample examples/@ax-student-ar-fl-controls-ComboBox.rowCount.1.as -noswf
see: #length @langversion 3.0 @playerversion Flash 9.0.28.0
@private (setter) @langversion 3.0 @playerversion Flash 9.0.28.0
Gets or sets the characters that a user can enter in the text field. If the value of the <code>restrict</code> property is a string of characters, you can enter only characters in the string into the text field. The string is read from left to right. If the value of the <code>restrict</code> property is <code>null</code>, you can enter any character. If the value of the <code>restrict</code> property is an empty string (""), you cannot enter any character. You can specify a range by using the hyphen (-) character. This restricts only user interaction; a script can put any character into the text field. @default null @includeExample examples/@ax-student-ar-fl-controls-ComboBox.restrict.1.as -noswf
see: flash.text.TextField#restrict TextField.restrict @langversion 3.0 @playerversion Flash 9.0.28.0
@private (setter) @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.SelectableList#selectedIndex @default 0 @includeExample examples/@ax-student-ar-fl-controls-ComboBox.selectedIndex.1.as -noswf @includeExample examples/@ax-student-ar-fl-controls-ComboBox.selectedIndex.2.as -noswf
see: #selectedItem @langversion 3.0 @playerversion Flash 9.0.28.0
@private @langversion 3.0 @playerversion Flash 9.0.28.0
Gets or sets the text that the text box contains in an editable @ax-student-ar-fl-controls-ComboBox component. For @ax-student-ar-fl-controls-ComboBox components that are not editable, this value is read-only. @default "" @includeExample examples/@ax-student-ar-fl-controls-ComboBox.text.1.as -noswf @langversion 3.0 @playerversion Flash 9.0.28.0
@private (setter) @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.List#labelField @default "label" @includeExample examples/@ax-student-ar-fl-controls-ComboBox.labelField.1.as -noswf
see: #labelFunction @langversion 3.0 @playerversion Flash 9.0.28.0
@private (setter) @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.List#labelFunction @includeExample examples/List.labelFunction.1.as -noswf @includeExample examples/@ax-student-ar-fl-controls-ComboBox.labelFunction.2.as -noswf
see: #labelField @langversion 3.0 @playerversion Flash 9.0.28.0
@private (setter) @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.List#itemToLabel()
see: #labelField
see: #labelFunction @langversion 3.0 @playerversion Flash 9.0.28.0
Gets or sets the value of the item that is selected in the drop-down list. If the user enters text into the text box of an editable @ax-student-ar-fl-controls-ComboBox component, the <code>selectedItem</code> property is <code>undefined</code>. This property has a value only if the user selects an item or if ActionScript is used to select an item from the drop-down list. If the @ax-student-ar-fl-controls-ComboBox component is not editable, the value of the <code>selectedItem</code> property is always valid. If there are no items in the drop-down list of an editable @ax-student-ar-fl-controls-ComboBox component, the value of this property is <code>null</code>. @default null @includeExample examples/@ax-student-ar-fl-controls-ComboBox.selectedItem.1.as -noswf @includeExample examples/@ax-student-ar-fl-controls-ComboBox.selectedItem.2.as -noswf
see: #selectedIndex @langversion 3.0 @playerversion Flash 9.0.28.0
@private (setter) @langversion 3.0 @playerversion Flash 9.0.28.0
Gets a reference to the List component that the @ax-student-ar-fl-controls-ComboBox component contains. The List subcomponent is not instantiated within the @ax-student-ar-fl-controls-ComboBox until it must be displayed. However, the list is created when the <code>dropdown</code> property is accessed. @langversion 3.0 @playerversion Flash 9.0.28.0
Gets the number of items in the list. This property belongs to the List component but can be accessed from a @ax-student-ar-fl-controls-ComboBox instance. @default 0 @includeExample examples/@ax-student-ar-fl-controls-ComboBox.length.1.as -noswf @includeExample examples/@ax-student-ar-fl-controls-ComboBox.length.2.as -noswf
see: #rowCount @langversion 3.0 @playerversion Flash 9.0.28.0
Gets a reference to the TextInput component that the @ax-student-ar-fl-controls-ComboBox component contains. Use this property to access and manipulate the underlying TextInput component. For example, you can use this property to change the selection of the text box or to restrict the set of characters that can be entered into it. @internal includeExample examples/@ax-student-ar-fl-controls-ComboBox.textField.1.as -noswf @includeExample examples/@ax-student-ar-fl-controls-ComboBox.textField.3.as -noswf @includeExample examples/@ax-student-ar-fl-controls-ComboBox.textField.2.as -noswf @includeExample examples/@ax-student-ar-fl-controls-ComboBox.textField.4.as -noswf @langversion 3.0 @playerversion Flash 9.0.28.0
Gets the label of an item in an editable @ax-student-ar-fl-controls-ComboBox component. For a @ax-student-ar-fl-controls-ComboBox component that is not editable, this property gets the data that the item contains. @includeExample examples/@ax-student-ar-fl-controls-ComboBox.value.1.as -noswf @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.SelectableList#dataProvider
see: fl.data.DataProvider DataProvider @includeExample examples/@ax-student-ar-fl-controls-ComboBox.dataProvider.1.as -noswf @langversion 3.0 @playerversion Flash 9.0.28.0
@private (setter) @langversion 3.0 @playerversion Flash 9.0.28.0
Gets or sets the maximum width of the drop-down list, in pixels. The default value of this property is the width of the @ax-student-ar-fl-controls-ComboBox component (the width of the TextInput instance plus the width of the BaseButton instance). @default 100 @includeExample examples/@ax-student-ar-fl-controls-ComboBox.dropdownWidth.1.as -noswf @includeExample examples/@ax-student-ar-fl-controls-ComboBox.dropdownWidth.2.as -noswf @langversion 3.0 @playerversion Flash 9.0.28.0
@private (setter) @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.SelectableList#addItem()
see: #addItemAt() @langversion 3.0 @playerversion Flash 9.0.28.0
Gets or sets the prompt for the @ax-student-ar-fl-controls-ComboBox component. This prompt is a string that is displayed in the TextInput portion of the @ax-student-ar-fl-controls-ComboBox when the <code>selectedIndex</code> is -1. It is usually a string like "Select one...". If a prompt is not set, the @ax-student-ar-fl-controls-ComboBox component sets the <code>selectedIndex</code> property to 0 and displays the first item in the <code>dataProvider</code> property. @default "" @includeExample examples/@ax-student-ar-fl-controls-ComboBox.prompt.1.as -noswf @includeExample examples/@ax-student-ar-fl-controls-ComboBox.prompt.2.as -noswf @langversion 3.0 @playerversion Flash 9.0.28.0
@private (setter) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected)
@copy fl.controls.SelectableList#addItemAt()
see: #addItem() @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.SelectableList#removeAll() @includeExample examples/@ax-student-ar-fl-controls-ComboBox.removeAll.1.as -noswf
see: #removeItem()
see: #removeItemAt() @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.SelectableList#removeItem()
see: #removeAll()
see: #removeItemAt() @includeExample examples/@ax-student-ar-fl-controls-ComboBox.removeItem.1.as -noswf @langversion 3.0 @playerversion Flash 9.0.28.0
Removes the item at the specified index position. The index locations of items whose indices are greater than the specified index advance in the array by 1. <p>This is a method of the List component that is available from an instance of the @ax-student-ar-fl-controls-ComboBox component.</p>
parameter: index Index of the item to be removed. @throws RangeError The specified index is less than 0 or greater than or equal to the length of the data provider.
see: #removeAll()
see: #removeItem() @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.SelectableList#getItemAt() @includeExample examples/@ax-student-ar-fl-controls-ComboBox.getItemAt.1.as -noswf @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.SelectableList#replaceItemAt() @includeExample examples/@ax-student-ar-fl-controls-ComboBox.replaceItemAt.1.as -noswf @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.SelectableList#sortItems()
see: Array#sort()
see: #sortItemsOn() @includeExample examples/@ax-student-ar-fl-controls-ComboBox.sortItems.1.as -noswf @langversion 3.0 @playerversion Flash 9.0.28.0
@copy fl.controls.SelectableList#sortItemsOn() @includeExample examples/@ax-student-ar-fl-controls-ComboBox.sortItemsOn.1.as -noswf @includeExample examples/@ax-student-ar-fl-controls-ComboBox.sortItemsOn.2.as -noswf
see: Array#sortOn()
see: #sortItems() @langversion 3.0 @playerversion Flash 9.0.28.0
Opens the drop-down list. <p><strong>Note:</strong> Calling this method causes the <code>open</code> event to be dispatched. If the @ax-student-ar-fl-controls-ComboBox component is already open, calling this method has no effect.</p>
see: #close()
see: #event:open @langversion 3.0 @playerversion Flash 9.0.28.0
Closes the drop-down list. <p><strong>Note:</strong> Calling this method causes the <code>close</code> event to be dispatched. If the @ax-student-ar-fl-controls-ComboBox is already closed, calling this method has no effect.</p> @includeExample examples/@ax-student-ar-fl-controls-ComboBox.close.1.as -noswf
see: #open()
see: #event:close @langversion 3.0 @playerversion Flash 9.0.28.0
Gets the string that is displayed in the TextInput portion of the @ax-student-ar-fl-controls-ComboBox component. This value is calculated from the data by using the <code>labelField</code> or <code>labelFunction</code> property. @includeExample examples/@ax-student-ar-fl-controls-ComboBox.selectedLabel.1.as -noswf
see: #labelField
see: #labelFunction @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected)
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
@private (protected) @langversion 3.0 @playerversion Flash 9.0.28.0
(C) Æliens 27/08/2009
You may not copy or print any of this material without explicit permission of the author or the publisher. In case of other copyright issues, contact the author.