.. _DropDownList: ================================================ DropDownList ================================================ Description ----------- Displays a single visible item. When you click the control, a list drops down or pops up, and allows you to select one of the other items in the list. Drop-down lists can have nonselectable separator items for visually separating groups of related items, as in a menu. You can specify the items on creation of the list object, or afterward using the list object?s?add()?method. You can remove items programmatically with the list object?s remove() and removeAll() methods. Calls the?onChange()?callback if the item selection is changed or if its?notify()?method is called. Properties ^^^^^^^^^^ +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`active` readonly | True if this element is active. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`alignment` readonly | The alignment style for this element. If defined, this value overrides the alignChildren setting for the parent container. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`bounds` readonly | The boundaries of the element, in parent-relative coordinates. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`children` readonly | An array of child elements. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`enabled` readonly | True if this element is enabled. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`graphics` readonly | The graphics object that can be used to customize the element's appearance, in response to the?onDraw()?event. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`helpTip` readonly | The help text that is displayed when the mouse hovers over the element. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`indent` readonly | The number of pixels to indent the element during automatic layout. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`itemSize` readonly | The width and height in pixels of each item in the list. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`items` readonly | The array of choice items displayed in the drop-down or pop-up list. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`location` readonly | The upper left corner of this element relative to its parent. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`maximumSize` readonly | The maximum height and width to which the element can be resized. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`minimumSize` readonly | The minimum height and width to which the element can be resized. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`parent` readonly | The parent element. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`preferredSize` readonly | The preferred size, used by layout managers to determine the best size for each element. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`properties` readonly | An object that contains one or more creation properties of the container (properties used only when the element is created). | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`selection` readonly | The currently selected list item. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`shortcutKey` readonly | The key sequence that invokes the?onShortcutKey()?callback for this element (in Windows only). | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`size` readonly | The current dimensions of this element. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`type` readonly | The element type; "dropdownlist". | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`visible` readonly | True if this element is shown, false if it is hidden. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`window` readonly | The window that this element belongs to. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ | :ref:`windowBounds` readonly | The bounds of this element relative to the top-level parent window. | +-----------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------+ Methods ^^^^^^^ +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------+ | :ref:`add` readonly | Adds an item or separator to the choices in this list. | +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------+ | :ref:`addEventListener` readonly | Registers an event handler for a particular type of event occuring in this element. | +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------+ | :ref:`dispatchEvent` readonly | Simulates the occurrence of an event in this target. | +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------+ | :ref:`find` readonly | Retrieves an item object from the list that has a given text label. | +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------+ | :ref:`hide` readonly | Hides this element. | +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------+ | :ref:`notify` readonly | Sends a notification message, simulating the specified user interaction event. | +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------+ | :ref:`remove` readonly | Removes a child item from the list. | +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------+ | :ref:`removeAll` readonly | Removes all child items from the list. | +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------+ | :ref:`removeEventListener` readonly | Unregisters an event handler for a particular type of event occuring in this element. | +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------+ | :ref:`show` readonly | Shows this element. | +-----------------------------------------------------------------------+---------------------------------------------------------------------------------------+ Events ^^^^^^ +-----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+ | :ref:`onActivate` readonly | An event-handler callback function, called when the element acquires the keyboard focus. | +-----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+ | :ref:`onChange` readonly | An event-handler callback function, called when the content of the element has been changed | +-----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+ | :ref:`onDeactivate` readonly | An event-handler callback function, called when the element loses the keyboard focus. | +-----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+ | :ref:`onDraw` readonly | An event-handler callback function, called when the window is about to be drawn. | +-----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+ | :ref:`onShortcutKey` readonly | An event-handler callback function, called when the element's?shortcutKey?sequence is typed in the active window. | +-----------------------------------------------------------+-------------------------------------------------------------------------------------------------------------------+ .. container:: hide .. toctree:: :hidden: :maxdepth: 1 DropDownList/items.rst DropDownList/itemSize.rst DropDownList/selection.rst DropDownList/active.rst DropDownList/shortcutKey.rst DropDownList/graphics.rst DropDownList/visible.rst DropDownList/bounds.rst DropDownList/location.rst DropDownList/maximumSize.rst DropDownList/minimumSize.rst DropDownList/preferredSize.rst DropDownList/size.rst DropDownList/windowBounds.rst DropDownList/alignment.rst DropDownList/children.rst DropDownList/properties.rst DropDownList/enabled.rst DropDownList/helpTip.rst DropDownList/indent.rst DropDownList/parent.rst DropDownList/window.rst DropDownList/type.rst DropDownList/add.rst DropDownList/find.rst DropDownList/remove.rst DropDownList/removeAll.rst DropDownList/notify.rst DropDownList/show.rst DropDownList/hide.rst DropDownList/addEventListener.rst DropDownList/removeEventListener.rst DropDownList/dispatchEvent.rst DropDownList/onActivate.rst DropDownList/onDeactivate.rst DropDownList/onChange.rst DropDownList/onShortcutKey.rst DropDownList/onDraw.rst