ButtonArray

Inherits: Control < CanvasItem < Node < Object

Inherited By: HButtonArray, VButtonArray

Category: Core

Brief Description

Array of Buttons.

Member Functions

void	add_button ( String text, String tooltip=”” )
void	add_icon_button ( Texture icon, String text=””, String tooltip=”” )
void	clear ( )
void	erase_button ( int button_idx )
int	get_button_count ( ) const
Texture	get_button_icon ( int button_idx ) const
String	get_button_text ( int button_idx ) const
String	get_button_tooltip ( int button_idx ) const
int	get_hovered ( ) const
int	get_selected ( ) const
bool	is_flat ( ) const
void	set_button_icon ( int button_idx, Texture icon )
void	set_button_text ( int button_idx, String text )
void	set_button_tooltip ( int button_idx, String text )
void	set_flat ( bool enabled )
void	set_selected ( int button_idx )

Signals

• button_selected ( int button_idx )

A button has been selected, its index is given as the argument.

Numeric Constants

• ALIGN_BEGIN = 0 — Align buttons at the beginning.
• ALIGN_CENTER = 1 — Align buttons in the middle.
• ALIGN_END = 2 — Align buttons at the end.
• ALIGN_FILL = 3 — Spread the buttons, but keep them small.
• ALIGN_EXPAND_FILL = 4 — Spread the buttons, but expand them.

Description

Array of Buttons. A ButtonArray is useful to have an array of buttons laid out vertically or horizontally. Only one button can be selected, and is referenced by its index in the array (first button is 0, second button is 1, etc.).

This is useful e.g. for joypad-friendly interfaces and option menus.

Member Function Description

void add_button ( String text, String tooltip=”” )

Append a new button to the array, with the specified text.

void add_icon_button ( Texture icon, String text=””, String tooltip=”” )

Append a new button to the array, with the specified icon and text.

void clear ( )

Remove all buttons from the array.

void erase_button ( int button_idx )

Remove the specified button in the array.

int get_button_count ( ) const

Return the amount of buttons in the array.

Texture get_button_icon ( int button_idx ) const

Return the icon of the specified button.

String get_button_text ( int button_idx ) const

Return the text of the specified button.

String get_button_tooltip ( int button_idx ) const

int get_hovered ( ) const

Return the index of the currently hovered button in the array.

int get_selected ( ) const

Return the index of the currently selected button in the array.

bool is_flat ( ) const

void set_button_icon ( int button_idx, Texture icon )

Set the icon of the specified button.

void set_button_text ( int button_idx, String text )

Define the text of the specified button.

void set_button_tooltip ( int button_idx, String text )

void set_flat ( bool enabled )

void set_selected ( int button_idx )

Select a button in the array based on the given index.