OptionButton

Inherits: Button < BaseButton < Control < CanvasItem < Node < Object

Category: Core

Brief Description

Button control that provides selectable options when pressed.

Member Functions

void add_icon_item ( Texture texture, String label, int id )
void add_item ( String label, int id=null )
void add_separator ( )
void clear ( )
int get_item_count ( ) const
Texture get_item_icon ( int idx ) const
int get_item_id ( int idx ) const
Variant get_item_metadata ( int idx ) const
String get_item_text ( int idx ) const
int get_selected ( ) const
int get_selected_id ( ) const
Variant get_selected_metadata ( ) const
bool is_item_disabled ( int idx ) const
void remove_item ( int idx )
void select ( int idx )
void set_item_disabled ( int idx, bool disabled )
void set_item_icon ( int idx, Texture texture )
void set_item_id ( int idx, int id )
void set_item_metadata ( int idx, Variant metadata )
void set_item_text ( int idx, String text )

Signals

  • item_selected ( int ID )

This signal is emitted when the current item was changed by the user. ID of the item selected is passed as argument (if no IDs were added, ID will be just the item index).

Description

OptionButton is a type button that provides a selectable list of items when pressed. The item selected becomes the “current” item and is displayed as the button text.

Member Function Description

Add an item, with a “texture” icon, text “label” and (optionally) id. If no “id” is passed, “id” becomes the item index. New items are appended at the end.

  • void add_item ( String label, int id=null )

Add an item, with text “label” and (optionally) id. If no “id” is passed, “id” becomes the item index. New items are appended at the end.

  • void add_separator ( )

Add a separator to the list of items. Separators help to group items. Separator also takes up an index and is appended at the end.

  • void clear ( )

Clear all the items in the OptionButton.

  • int get_item_count ( ) const

Return the amount of items in the OptionButton.

Return the icon of the item at index “idx”.

  • int get_item_id ( int idx ) const

Return the ID of the item at index “idx”.

Return the text of the item at index “idx”.

  • int get_selected ( ) const

Return the current item index

  • int get_selected_id ( ) const
  • Variant get_selected_metadata ( ) const
  • bool is_item_disabled ( int idx ) const
  • void remove_item ( int idx )
  • void select ( int idx )

Select an item by index and make it the current item.

  • void set_item_disabled ( int idx, bool disabled )

Set the icon of an item at index “idx”.

  • void set_item_id ( int idx, int id )

Set the ID of an item at index “idx”.

  • void set_item_metadata ( int idx, Variant metadata )
  • void set_item_text ( int idx, String text )

Set the text of an item at index “idx”.