ListBox is a container for com.spvessel.spacevil.ListArea (scrollable container for other elements with ability of selection) and scroll bars. More...

Inherits com.spvessel.spacevil.Prototype.

Inherited by com.spvessel.spacevil.TreeView.

Public Member Functions
void	setScrollStep (int step)
	Setting scroll movement step. More...

int	getScrollStep ()
	Getting scroll movement step. More...

int	getSelection ()
	Getting index of selected item. More...

void	setSelection (int index)
	Select item by index. More...

void	unselect ()
	Unselect selected item. More...

void	setSelectionVisible (boolean value)
	Enable or disable selection ability of ListArea. More...

boolean	isSelectionVisible ()
	Returns True if selection ability of ListArea is enabled otherwise returns False. More...

void	disableMenu (boolean value)
	Setting the navigation context menu to disable or enable. More...

ListArea	getArea ()
	Getting list area of ListBox. More...

VisibilityPolicy	getVScrollBarPolicy ()
	Getting vertical scroll bar visibility policy. More...

void	setVScrollBarPolicy (VisibilityPolicy policy)
	Setting vertical scroll bar visibility policy. More...

VisibilityPolicy	getHScrollBarPolicy ()
	Getting horizontal scroll bar visibility policy. More...

void	setHScrollBarPolicy (VisibilityPolicy policy)
	Setting horizontal scroll bar visibility policy. More...

	ListBox ()
	Default ListBox constructor. More...

void	setWidth (int width)
	Setting item width. More...

void	setHeight (int height)
	Setting item height. More...

void	addItem (InterfaceBaseItem item)
	Adding item to the list area of ListBox. More...

void	insertItem (InterfaceBaseItem item, int index)
	Insert item into the list area of ListBox by index. More...

boolean	removeItem (InterfaceBaseItem item)
	Removing the specified item from the list area of ListBox. More...

void	clear ()
	Removing all items from the list area of ListBox. More...

void	updateElements ()
	Updating all ListBox inner items. More...

void	initElements ()
	Initializing all elements in the ListBox. More...

List< InterfaceBaseItem >	getListContent ()
	Getting content of the list area of ListBox. More...

void	setListContent (List< InterfaceBaseItem > content)
	Adding all elements in the list area of ListBox from the given list. More...

InterfaceBaseItem	getSelectedItem ()
	Getting selected item. More...

SelectionItem	getWrapper (InterfaceBaseItem item)
	Getting wrapper of item. More...

void	setStyle (Style style)
	Setting style of the ButtonCore. More...

Public Member Functions inherited from com.spvessel.spacevil.Prototype
	Prototype ()
	Default constructor of Prototype class. More...

void	release ()
	Method to describe disposing item's resources if the item was removed. More...

void	setHandler (CoreWindow handler)
	Setting the window to which the item will belong. More...

CoreWindow	getHandler ()
	Getting the window to which the item belongs. More...

String	getToolTip ()
	Getting tooltip text of the item. More...

void	setToolTip (String text)
	Setting tooltip text of the item. More...

Prototype	getParent ()
	Getting the parent of the item. More...

void	setParent (Prototype parent)
	Setting the parent of the item. More...

Spacing	getSpacing ()
	Getting indents between children of a container type item. More...

void	setSpacing (Spacing spacing)
	Setting indents between children of a container type item. More...

void	setSpacing (int horizontal, int vertical)
	Setting indents between children of a container type item. More...

Indents	getPadding ()
	Getting indents of an item for offset its children. More...

void	setPadding (Indents padding)
	Setting indents of an item to offset its children. More...

void	setPadding (int left, int top, int right, int bottom)
	Setting indents of an item to offset its children. More...

Indents	getMargin ()
	Getting the indents of an item to offset itself relative to its container. More...

void	setMargin (Indents margin)
	Setting the indents of an item to offset itself relative to its container. More...

void	setMargin (int left, int top, int right, int bottom)
	Setting the indents of an item to offset itself relative to its container. More...

void	setBorder (Border border)
	Setting border of an item's shape. More...

void	setBorderFill (Color fill)
	Setting the border color of an item's shape. More...

Color	getBorderFill ()
	Getting the border color oa an item's shape. More...

void	setBorderFill (int r, int g, int b)
	Setting the border color of an item's shape in byte RGB format. More...

void	setBorderFill (int r, int g, int b, int a)
	Setting the border color of an item's shape in byte RGB format. More...

void	setBorderFill (float r, float g, float b)
	Setting the border color of an item's shape in float RGB format. More...

void	setBorderFill (float r, float g, float b, float a)
	Setting the border color of an item's shape in float RGBA format. More...

void	setBorderRadius (CornerRadius radius)
	Setting radius of the border's corners. More...

void	setBorderRadius (int radius)
	Setting border radius with the same values for each corner of the rectangle object. More...

CornerRadius	getBorderRadius ()
	Getting border radiuses. More...

void	setBorderThickness (int thickness)
	Setting border thickness of an item's shape. More...

int	getBorderThickness ()
	Getting border thickness of an item's shape. More...

List< float[]>	getTriangles ()
	Getting triangles of item's shape. More...

void	setTriangles (List< float[]> triangles)
	Setting triangles as item's shape. More...

void	makeShape ()
	Making default item's shape. More...

void	setBackground (Color color)
	Setting background color of an item's shape. More...

void	setBackground (int r, int g, int b)
	Setting background color of an item's shape in byte RGB format. More...

void	setBackground (int r, int g, int b, int a)
	Setting background color of an item in byte RGBA format. More...

void	setBackground (float r, float g, float b)
	Setting background color of an item in float RGB format. More...

void	setBackground (float r, float g, float b, float a)
	Setting background color of an item in float RGBA format. More...

Color	getBackground ()
	Getting background color of an item. More...

void	setItemName (String name)
	Setting the name of the item. More...

String	getItemName ()
	Getting the name of the item. More...

void	setMinWidth (int width)
	Setting the minimum width limit. More...

int	getMinWidth ()
	Getting the minimum width limit. More...

int	getWidth ()
	Getting item width. More...

void	setMaxWidth (int width)
	Setting the maximum width limit. More...

int	getMaxWidth ()
	Getting the maximum width limit. More...

void	setMinHeight (int height)
	Setting the minimum height limit. More...

int	getMinHeight ()
	Getting the minimum height limit. More...

int	getHeight ()
	Getting item height. More...

void	setMaxHeight (int height)
	Setting the maximum height limit. More...

int	getMaxHeight ()
	Getting the maximum height limit. More...

void	setSize (int width, int height)
	Setting item size (width and height). More...

Size	getSize ()
	Getting current item size. More...

void	setMinSize (int width, int height)
	Setting minimum item size limit (width and height limits). More...

Size	getMinSize ()
	Getting current item minimum size limit. More...

void	setMaxSize (int width, int height)
	Setting maximum item size limit (width and height limits). More...

Size	getMaxSize ()
	Getting current item maximum size limit. More...

void	setAlignment (List< ItemAlignment > alignment)
	Setting an alignment of an item's shape relative to its container. More...

void	setAlignment (ItemAlignment... alignment)
	Setting an alignment of an item's shape relative to its container. More...

List< ItemAlignment >	getAlignment ()
	Getting an alignment of an item's shape relative to its container. More...

void	setSizePolicy (SizePolicy width, SizePolicy height)
	Setting the size policy of an item's shape. More...

void	setWidthPolicy (SizePolicy policy)
	Setting width policy of an item's shape. More...

SizePolicy	getWidthPolicy ()
	Getting width policy of an item's shape.Can be FIXED (shape not changes its size) or EXPAND (shape is stretched to all available space). More...

void	setHeightPolicy (SizePolicy policy)
	Setting height policy of an item's shape. More...

SizePolicy	getHeightPolicy ()
	Getting height policy of an item's shape.Can be FIXED (shape not changes its size) or EXPAND (shape is stretched to all available space). More...

void	setPosition (int x, int y)
	Setting item position. More...

void	setX (int x)
	Setting X coordinate of the left-top corner of a shape. More...

int	getX ()
	Getting X coordinate of the left-top corner of a shape. More...

void	setY (int y)
	Setting Y coordinate of the left-top corner of a shape. More...

int	getY ()
	Getting Y coordinate of the left-top corner of a shape. More...

void	setConfines ()
	Setting the confines of the item relative to its parent's size and position. More...

void	setConfines (int x0, int x1, int y0, int y1)
	Setting the confines of the item relative to its parent's size and position. More...

Style	getCoreStyle ()
	Getting the core (only appearance properties without inner styles) style of an item. More...

boolean	isShadowDrop ()
	Getting the shadow visibility status of an item. More...

void	setShadowDrop (boolean value)
	Setting the shadow visibility status of an item. More...

void	setShadowRadius (int radius)
	Setting the specified blur radius of the shadow. More...

int	getShadowRadius ()
	Getting the shadow blur raduis. More...

Color	getShadowColor ()
	Getting shadow color. More...

void	setShadowColor (Color color)
	Setting shadow color. More...

Position	getShadowPos ()
	Getting the offset of the shadow relative to the position of the item. More...

int[]	getShadowExtension ()
	Getting the values of shadow extensions in pixels. More...

void	setShadowExtension (int wExtension, int hExtension)
	Setting the values of shadow extensions in pixels. More...

void	setShadow (int radius, int x, int y, Color color)
	Setting the shadow with specified blur radius, axis shifts, shadow color. More...

void	addItemState (ItemStateType type, ItemState state)
	Adding visual state for an item. More...

void	removeItemState (ItemStateType type)
	Removing visual state of an item by type. More...

void	removeAllItemStates ()
	Removing all item visual states. More...

ItemState	getState (ItemStateType type)
	Getting item visual state by its type. More...

List< InterfaceBaseItem >	getItems ()
	Getting list of the Prototype's inner items (children). More...

void	addItems (InterfaceBaseItem... items)
	Adding sequence of items into the container (this). More...

void	update (GeometryEventType type, int value)
	Updating an item size or/and position. More...

boolean	isDrawable ()
	Getting the drawable (visibility) status of an item. More...

void	setDrawable (boolean value)
	Setting the drawable (visibility) status of an item. More...

boolean	isVisible ()
	Setting the visibility status of an item. More...

void	setVisible (boolean value)
	Setting the visibility status of an item. More...

boolean	isPassEvents ()
	Getting boolean value to know if this item can pass further any input events (mouse, keyboard and etc.). More...

boolean	isPassEvents (InputEventType e)
	Getting boolean value to know if this item can pass further the specified type of input events (mouse, keyboard and etc.). More...

List< InputEventType >	getPassEvents ()
	Getting all allowed input events. More...

List< InputEventType >	GetBlockedEvents ()
	Getting all blocked input events. More...

void	setPassEvents (boolean value)
	Setting on or off so that this item can pass further any input events (mouse, keyboard and etc.). More...

void	setPassEvents (boolean value, InputEventType e)
	Setting on or off so that this item can pass further the specified type of input events (mouse, keyboard and etc.). More...

void	setPassEvents (boolean value, List< InputEventType > events)
	Setting on or off so that this item can pass further the specified types of input events (mouse, keyboard and etc.). More...

void	setPassEvents (boolean value, InputEventType... events)
	Setting on or off so that this item can pass further the specified types of input events (mouse, keyboard and etc.). More...

boolean	isDisabled ()
	Returns True if this item is disabled (non-interactive) otherwise returns False. More...

void	setDisabled (boolean value)
	Setting this item disabled (become non-interactive) or enabled. More...

boolean	isMouseHover ()
	Returns True if this item is hovered otherwise returns False. More...

void	setMouseHover (boolean value)
	Setting this item hovered (mouse cursor located within item's shape). More...

boolean	isMousePressed ()
	Returns True if mouse is pressed on this item (mouse cursor located within item's shape and any of the mouse button is pressed) otherwise False. More...

void	setMousePressed (boolean value)
	Setting True if you want that mouse is pressed on this item (mouse cursor located within item's shape and any of the mouse button is pressed) otherwise False. More...

boolean	isFocused ()
	Returns True if this item gets focus otherwise False. More...

void	setFocus ()
	Setting focus on this item if it is focusable. More...

void	setContent (List< InterfaceBaseItem > content)
	Setting content for this item. More...

Figure	isCustomFigure ()
	Getting the custom shape if it is set. More...

void	setCustomFigure (Figure figure)
	Setting the custom shape to replace the default rectangle shape. More...

ItemHoverRule	getHoverRule ()
	Getting the hovering rule of this item. More...

void	setHoverRule (ItemHoverRule rule)
	Setting the hovering rule for this item. More...

CursorImage	getCursor ()
	Getting the mouse cursor image of this item. More...

void	setCursor (EmbeddedCursor cursor)
	Setting mouse cursor image for this item from embedded cursors. More...

void	setCursor (CursorImage cursor)
	Setting mouse cursor image for this item. More...

void	setCursor (BufferedImage bitmap)
	Creating and setting mouse cursor image for this item from specified bitmap image. More...

void	setCursor (BufferedImage bitmap, int width, int height)
	Creating and setting mouse cursor image for this item from specified scaled bitmap image. More...

Public Attributes
BlankItem	menu = new BlankItem()
	Interactive item to show the navigation context menu. More...

VerticalScrollBar	vScrollBar = new VerticalScrollBar()
	Vertical scroll bar of ListBox. More...

HorizontalScrollBar	hScrollBar = new HorizontalScrollBar()
	Horizontal scroll bar of ListBox. More...

Public Attributes inherited from com.spvessel.spacevil.Prototype
EventCommonMethodState	eventResize = new EventCommonMethodState()
	Event that is invoked when an item is resizing. More...

EventCommonMethodState	eventDestroy = new EventCommonMethodState()
	Event that is invoked when an item is destroyed (removed). More...

EventMouseMethodState	eventMouseHover = new EventMouseMethodState()
	Event that is invoked when mouse cursor enters inside an item area. More...

EventMouseMethodState	eventMouseLeave = new EventMouseMethodState()
	Event that is invoked when mouse cursor leaves inside an item area. More...

EventMouseMethodState	eventMouseClick = new EventMouseMethodState()
	Event that is invoked when mouse click (release) on an item. More...

EventMouseMethodState	eventMouseDoubleClick = new EventMouseMethodState()
	Event that is invoked when mouse double click on an item. More...

EventMouseMethodState	eventMousePress = new EventMouseMethodState()
	Event that is invoked when mouse press on an item. More...

EventMouseMethodState	eventMouseDrag = new EventMouseMethodState()
	Event that is invoked when mouse drag on an item. More...

EventMouseMethodState	eventMouseDrop = new EventMouseMethodState()
	Event that is invoked when mouse drop on an item. More...

EventMouseMethodState	eventScrollUp = new EventMouseMethodState()
	Event that is invoked when mouse wheel scrolls up on an item. More...

EventMouseMethodState	eventScrollDown = new EventMouseMethodState()
	Event that is invoked when mouse wheel scrolls down on an item. More...

EventKeyMethodState	eventKeyPress = new EventKeyMethodState()
	Event that is invoked when key of keyboard is pressed. More...

EventKeyMethodState	eventKeyRelease = new EventKeyMethodState()
	Event that is invoked when key of keyboard is released. More...

EventInputTextMethodState	eventTextInput = new EventInputTextMethodState()
	Event that is invoked when typing text on the keyboard. More...

boolean	isFocusable = true
	Item's focusable property. More...

Additional Inherited Members
Protected Member Functions inherited from com.spvessel.spacevil.Prototype
void	updateState ()
	Updating Prototype's state according to its ItemStateType. More...

void	setFocused (boolean value)

boolean	getHoverVerification (float xpos, float ypos)

int[]	getConfines ()

void	setState (ItemStateType state)

Detailed Description

ListBox is a container for com.spvessel.spacevil.ListArea (scrollable container for other elements with ability of selection) and scroll bars.

ListBox controls scrolling, resizing and other actions of com.spvessel.spacevil.ListArea.

Contains list area, scroll bars, menu button, navigation context menu.

Supports all events except drag and drop.

Constructor & Destructor Documentation

◆ ListBox()

com.spvessel.spacevil.ListBox.ListBox ( )

Default ListBox constructor.

Member Function Documentation

◆ addItem()

void com.spvessel.spacevil.ListBox.addItem ( InterfaceBaseItem item )

Adding item to the list area of ListBox.

Parameters

item	Item as com.spvessel.spacevil.Core.InterfaceBaseItem.

Reimplemented from com.spvessel.spacevil.Prototype.

Reimplemented in com.spvessel.spacevil.TreeView.

◆ clear()

void com.spvessel.spacevil.ListBox.clear ( )

Removing all items from the list area of ListBox.

Reimplemented from com.spvessel.spacevil.Prototype.

Reimplemented in com.spvessel.spacevil.TreeView.

◆ disableMenu()

void com.spvessel.spacevil.ListBox.disableMenu ( boolean value )

Setting the navigation context menu to disable or enable.

Parameters

value True: if you want to disable navigation context menu. False: if you want to enable navigation context menu.

◆ getArea()

ListArea com.spvessel.spacevil.ListBox.getArea ( )

Getting list area of ListBox.

Returns: List area as com.spvessel.spacevil.ListArea.

◆ getHScrollBarPolicy()

VisibilityPolicy com.spvessel.spacevil.ListBox.getHScrollBarPolicy ( )

Getting horizontal scroll bar visibility policy.

Returns: Visibility policy as com.spvessel.spacevil.Flags.VisibilityPolicy.

◆ getListContent()

List<InterfaceBaseItem> com.spvessel.spacevil.ListBox.getListContent ( )

Getting content of the list area of ListBox.

Returns: List of items as List<com.spvessel.spacevil.Core.InterfaceBaseItem>

◆ getScrollStep()

int com.spvessel.spacevil.ListBox.getScrollStep ( )

Getting scroll movement step.

Returns: Scroll step.

◆ getSelectedItem()

InterfaceBaseItem com.spvessel.spacevil.ListBox.getSelectedItem ( )

Getting selected item.

Returns: Selected item as com.spvessel.spacevil.Core.InterfaceBaseItem.

◆ getSelection()

int com.spvessel.spacevil.ListBox.getSelection ( )

Getting index of selected item.

Returns: Index of selected item.

◆ getVScrollBarPolicy()

VisibilityPolicy com.spvessel.spacevil.ListBox.getVScrollBarPolicy ( )

Getting vertical scroll bar visibility policy.

Returns: Visibility policy as com.spvessel.spacevil.Flags.VisibilityPolicy.

◆ getWrapper()

SelectionItem com.spvessel.spacevil.ListBox.getWrapper ( InterfaceBaseItem item )

Getting wrapper of item.

Parameters

item	Item as com.spvessel.spacevil.Core.InterfaceBaseItem.

Returns: Wrapper of given item as com.spvessel.spacevil.SelectionItem.

◆ initElements()

void com.spvessel.spacevil.ListBox.initElements ( )

Initializing all elements in the ListBox.

Notice: This method is mainly for overriding only. SpaceVIL calls this method if necessary and no need to call it manually.

Reimplemented from com.spvessel.spacevil.Prototype.

Reimplemented in com.spvessel.spacevil.TreeView.

◆ insertItem()

void com.spvessel.spacevil.ListBox.insertItem	(	InterfaceBaseItem	item,
		int	index
	)

Insert item into the list area of ListBox by index.

Parameters

item	Item as com.spvessel.spacevil.Core.InterfaceBaseItem.
index	Index of insertion.

Reimplemented from com.spvessel.spacevil.Prototype.

◆ isSelectionVisible()

boolean com.spvessel.spacevil.ListBox.isSelectionVisible ( )

Returns True if selection ability of ListArea is enabled otherwise returns False.

Returns: True: selection ability of ListArea is enabled. False: selection ability of ListArea is disabled.

◆ removeItem()

boolean com.spvessel.spacevil.ListBox.removeItem ( InterfaceBaseItem item )

Removing the specified item from the list area of ListBox.

Parameters

item	Item as com.spvessel.spacevil.Core.InterfaceBaseItem.

Returns: True: if the removal was successful. False: if the removal was unsuccessful.

Reimplemented from com.spvessel.spacevil.Prototype.

Reimplemented in com.spvessel.spacevil.TreeView.

◆ setHeight()

void com.spvessel.spacevil.ListBox.setHeight ( int height )

Setting item height.

If the value is greater/less than the maximum/minimum value of the height, then the height becomes equal to the maximum/minimum value.

Parameters

height Height of the item.

Reimplemented from com.spvessel.spacevil.Prototype.

◆ setHScrollBarPolicy()

void com.spvessel.spacevil.ListBox.setHScrollBarPolicy ( VisibilityPolicy policy )

Setting horizontal scroll bar visibility policy.

Default: com.spvessel.spacevil.Flags.VisibilityPolicy.AS_NEEDED.

Parameters

policy Visibility policy as com.spvessel.spacevil.Flags.VisibilityPolicy.

◆ setListContent()

void com.spvessel.spacevil.ListBox.setListContent ( List< InterfaceBaseItem > content )

Adding all elements in the list area of ListBox from the given list.

Parameters

content List of items as List<com.spvessel.spacevil.Core.InterfaceBaseItem>

Reimplemented in com.spvessel.spacevil.TreeView.

◆ setScrollStep()

void com.spvessel.spacevil.ListBox.setScrollStep ( int step )

Setting scroll movement step.

Parameters

step	Scroll step.

◆ setSelection()

void com.spvessel.spacevil.ListBox.setSelection ( int index )

Select item by index.

Parameters

index Index of selection.

◆ setSelectionVisible()

void com.spvessel.spacevil.ListBox.setSelectionVisible ( boolean value )

Enable or disable selection ability of ListArea.

Parameters

value True: if you want selection ability of ListArea to be enabled. False: if you want selection ability of ListArea to be disabled.

◆ setStyle()

void com.spvessel.spacevil.ListBox.setStyle ( Style style )

Setting style of the ButtonCore.

Inner styles: "area", "vscrollbar", "hscrollbar", "menu".

Parameters

style Style as com.spvessel.spacevil.Decorations.Style.

Reimplemented from com.spvessel.spacevil.Prototype.

Reimplemented in com.spvessel.spacevil.TreeView.

◆ setVScrollBarPolicy()

void com.spvessel.spacevil.ListBox.setVScrollBarPolicy ( VisibilityPolicy policy )

Setting vertical scroll bar visibility policy.

Default: com.spvessel.spacevil.Flags.VisibilityPolicy.AS_NEEDED.

Parameters

policy Visibility policy as com.spvessel.spacevil.Flags.VisibilityPolicy.

◆ setWidth()

void com.spvessel.spacevil.ListBox.setWidth ( int width )

Setting item width.

If the value is greater/less than the maximum/minimum value of the width, then the width becomes equal to the maximum/minimum value.

Parameters

width Width of the item.

Reimplemented from com.spvessel.spacevil.Prototype.

◆ unselect()

void com.spvessel.spacevil.ListBox.unselect ( )

Unselect selected item.

◆ updateElements()

void com.spvessel.spacevil.ListBox.updateElements ( )

Updating all ListBox inner items.

Reimplemented in com.spvessel.spacevil.TreeView.

Member Data Documentation

◆ hScrollBar

HorizontalScrollBar com.spvessel.spacevil.ListBox.hScrollBar = new HorizontalScrollBar()

Horizontal scroll bar of ListBox.

◆ menu

BlankItem com.spvessel.spacevil.ListBox.menu = new BlankItem()

Interactive item to show the navigation context menu.

◆ vScrollBar

VerticalScrollBar com.spvessel.spacevil.ListBox.vScrollBar = new VerticalScrollBar()

Vertical scroll bar of ListBox.

The documentation for this class was generated from the following file:

ListBox.java

Public Member Functions

Public Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ListBox()

Member Function Documentation

◆ addItem()

◆ clear()

◆ disableMenu()

◆ getArea()

◆ getHScrollBarPolicy()

◆ getListContent()

◆ getScrollStep()

◆ getSelectedItem()

◆ getSelection()

◆ getVScrollBarPolicy()

◆ getWrapper()

◆ initElements()

◆ insertItem()

◆ isSelectionVisible()

◆ removeItem()

◆ setHeight()

◆ setHScrollBarPolicy()

◆ setListContent()

◆ setScrollStep()

◆ setSelection()

◆ setSelectionVisible()

◆ setStyle()

◆ setVScrollBarPolicy()

◆ setWidth()

◆ unselect()

◆ updateElements()

Member Data Documentation

◆ hScrollBar

◆ menu

◆ vScrollBar