DropDown - HaxeUI API Docs

class

DropDown

package haxe.ui.components

haxe.ui.core.Component

↪ haxe.ui.core.InteractiveComponent

↪ haxe.ui.components.Button

↪ haxe.ui.components.DropDown

Known Subclasses:

ColorPickerPopup

Properties

behaviour

bindable

clonable

dataSource:DataSource<:Dynamic>

behaviour

bindable

clonable

dropDownOpen:Bool

behaviour

bindable

clonable

dropdownHeight:Null<Float>

behaviour

bindable

clonable

dropdownSize:Null<Int>

behaviour

bindable

clonable

dropdownWidth:Null<Float>

behaviour

bindable

clonable

handlerStyleNames:String

clonable

itemRenderer:ItemRenderer

behaviour

bindable

clonable

searchField:Component

behaviour

bindable

clonable

searchPrompt:String

behaviour

bindable

clonable

searchable:Bool

behaviour

bindable

clonable

selectedIndex:Int

behaviour

bindable

clonable

selectedItem::Dynamic

behaviour

bindable

clonable

type:String

behaviour

bindable

clonable

virtual:Bool

Inherited from Button

behaviour

bindable

clonable

componentGroup:String

behaviour

bindable

clonable

easeInRepeater:Bool

Whether this button will ease in to specified repeatInterval

behaviour

bindable

clonable

icon:Variant

The image resource to use as the buttons icon

behaviour

bindable

clonable

remainPressed:Bool

Whether the buttons state should remain pressed even when the mouse has left its bounds

behaviour

bindable

clonable

repeatInterval:Int

How often this button will dispatch multiple click events while the the mouse is
pressed within it, in milliseconds. Default is 100.

behaviour

bindable

clonable

repeater:Bool

Whether this button will dispatch multiple click events while the the mouse is pressed within it

behaviour

bindable

clonable

selected:Bool

Whether this button is toggled or not (only relevant if toggle = true)

behaviour

bindable

clonable

toggle:Bool

Whether this button should behave as a toggle button or not
(a button that behaves like a switch, being either on/off)

Inherited from InteractiveComponent

Inherited from Component

animatable:Bool

Whether this component is allowed to animate or not.

componentAnimation:Animation

The currently running animation.

componentTabIndex:Int

read-only

cssName:String

dragInitiator:Component

dragOptions:

draggable:Bool

When set to true, this component should be drag&drop-able.

read-only

isComponentSolid:Bool

Whether this component has a non-visible graphic added/drawn onto it or not.

native:Null<Bool>

When enabled, HaxeUI will try to use a native version of this component.

read-only

screen:Screen

The Screen object this component is displayed on.

styleSheet:StyleSheet

userData::Dynamic

Can be used to store specific data relating to the component, or other things in your application.

read-only

className:String

read-only

actualComponentHeight:Float

The component's true height on screen.

May differ from componentHeight if Toolkit.scaleY != 1

read-only

actualComponentWidth:Float

The component's true width on screen.

May differ from componentWidth if Toolkit.scaleX != 1

componentClipRect:Rectangle

When set to a non-null value, restricts the component's "rendering zone"
to only render inside the bounds of the given rectangle, effectively "clipping" the component.

read-only

hasScreen:Bool

Whether this component, or one if it's parents, has a screen.

read-only

isComponentClipped:Bool

Whether this component has a non-null clipping rectangle or not.

read-only

isComponentOffscreen:Bool

true if this component's area intersects with the screen, false otherwise.

clipRect is not taken into consideration - that means, if a clipRect turns a component from being
visible on screen to being invisible on screen, isComponentOffScreen should still be false.

Methods

override

cloneComponent():DropDown

hideDropDown():Variant

showDropDown():Variant

Inherited from Button

Inherited from InteractiveComponent

Inherited from Component

override

cloneComponent():Component

Gets a complete copy of this component.

Returns

A new component, similar to this one.

containsComponent(child:Component):Bool

Returns true if the given component is a child of this component, false otherwise.

Parameters

child:Component

The child component to check against.

Returns

Is the child component a child of this component?

disposeComponent():Void

Removes this component from memory.

Calling methods/using fields on this component after calling disposeComponent
is undefined behaviour, and could result in a null pointer exception/x is null exceptions.

fadeIn(onEnd:():Void = null, show:Bool = true):Void

Applies a fade effect which turns this component from invisible to visible.

Parameters

onEnd:():Void = null	A function to dispatch when the fade completes
show:Bool = true	When enabled, ensures that this component is actually visible when the fade completes.

fadeOut(onEnd:():Void = null, hide:Bool = true):Void

Applies a fade effect which turns this component from visible to invisible.

Parameters

onEnd:():Void = null	A function to dispatch when the fade completes
show:Bool = true	When enabled, ensures that this component is actually invisible when the fade completes.

findComponents<T>(styleName:String = null, type:Class<T> = null, maxDepth:Int = 5):Array<T>

Finds all components with a specific style in this components display tree.

Parameters

styleName:String = null	The style name to search for
type:Class<T> = null	The component class you wish to cast the result to (defaults to null, which means casting to the default, Component type).
maxDepth:Int = 5	how many children "deep" should the search go to find components. defaults to 5.

Returns

An array of the found components.

findComponentsUnderPoint<T>(screenX:Float, screenY:Float, type:Class<T> = null):Array<Component>

Lists components under a specific point in global, screen coordinates.

Note: this function will return *every single* components at a specific point,
even if they have no backgrounds, or haven't got anything drawn onto them.

Parameters

screenX:Float	The global, on-screen x position of the point to check for components under
screenY:Float	The global, on-screen y position of the point to check for components under
type:Class<T> = null	Used to filter all components that aren't of a specific type. null by default, which means no filter is applied.

Returns

An array of all components that overlap the "global" position (x, y)

hasComponentUnderPoint<T>(screenX:Float, screenY:Float, type:Class<T> = null):Bool

Finds out if there is a component under a specific point in global coordinates.

Parameters

screenX:Float	The global, on-screen x position of the point to check for components under
screenY:Float	The global, on-screen y position of the point to check for components under
type:Class<T> = null	Used to filter all components that aren't of a specific type. null by default, which means no filter is applied.

Returns

true if there is a component that overlaps the global position (x, y), false otherwise.

lockLayout(recursive:Bool = false):Void

ready():Void

Tells the framework this component is ready to render

*Note*: this is called internally by the framework

setComponentIndex(child:Component, index:Int):Component

Sets the index of child under this component, essentially moving it forwards/backwards.

Parameters

child:Component	The child to set the index of.
index:Int	the index to set to.

Returns

the child component.

unlockLayout(recursive:Bool = false):Void

walkComponents(callback::Component->Bool):Void

Iterates over the children components and calls callback() on each of them, recursively.
The children's children are also included in the walking, and so are those children's children...

Parameters

callback::Component->Bool

a callback that receives one component, and returns whether the walking should continue or not.

pauseEvent(type:String, recursive:Bool = false):Void

resumeEvent(type:String, recursive:Bool = false):Void