Unigine::WidgetMenuBar Class

WidgetMenuBar Class

Members

getNumItems() const#

Return value

Current number of items in the menu bar.

getSpaceY() const#

Return value

Current vertical space between menu items and menu borders, in pixels.

getSpaceX() const#

Return value

Current horizontal space between menu items and menu borders, in pixels.

void setSelectionColor ( const Math::vec4& color ) #

Arguments

• const Math::vec4& color - The color in the RGBA format.

Math::vec4 getSelectionColor() const#

Return value

Current color in the RGBA format.

---

static WidgetMenuBarPtr create ( const Ptr<Gui> & gui, int x = 0, int y = 0 ) #

Constructor. Creates an empty menu bar and adds it to the specified GUI.

Arguments

• const Ptr<Gui> & gui - GUI, to which the menu bar will belong.
• int x - Offset along the X axis.
• int y - Offset along the Y axis.

static WidgetMenuBarPtr create ( int x = 0, int y = 0 ) #

Constructor. Creates an empty menu bar and adds it to the Engine GUI.

Arguments

• int x - Offset along the X axis.
• int y - Offset along the Y axis.

void setItemData ( int item, const char * str ) #

Sets the text data for the item with the specified number. The data can be used as a text identifier of the item (instead of using the item number).

Arguments

• int item - Item number in range from 0 to the total number of menu bar items.
• const char * str - Item text data to be set.

const char * getItemData ( int item ) const#

Returns the text data of the item with the specified number. The data can be used as a text identifier of the item (instead of using the item number).

Arguments

• int item - Item number in range from 0 to the total number of items.

Return value

Item text data.

void setItemEnabled ( int item, bool enabled ) #

Sets an enabled flag for the item.

Arguments

• int item - Item number in range from 0 to the total number of items.
• bool enabled - true to enable the item; false - to disable it.

bool isItemEnabled ( int item ) const#

Returns a value indicating if the given item is enabled.

Arguments

• int item - Item number in range from 0 to the total number of menu bar items.

Return value

true if the item is enabled; otherwise - false.

void setItemMenu ( int item, const Ptr<WidgetMenuBox> & menu ) #

Sets a menu for a given item.

Arguments

• int item - Item number in range from 0 to the total number of menu bar items.
• const Ptr<WidgetMenuBox> & menu - Menu box.

Ptr<WidgetMenuBox> getItemMenu ( int item ) const#

Returns the menu of a given item.

Arguments

• int item - Item number in range from 0 to the total number of menu bar items.

Return value

Menu box.

void setItemSpace ( int item, int space ) #

Sets a space between the given menu item and the next item located to the right.

Arguments

• int item - Item number in range from 0 to the total number of menu bar items.
• int space - Space to set, in pixels.

int getItemSpace ( int item ) const#

Returns the space between the given menu item and the next item located to the right.

Arguments

• int item - Item number in range from 0 to the total number of menu bar items.

Return value

Space between items, in pixels.

void setItemText ( int item, const char * str ) #

Sets a title for a given item.

Arguments

• int item - Item number in range from 0 to the total number of menu bar items.
• const char * str - Menu title.

const char * getItemText ( int item ) const#

Returns the title of a given item.

Arguments

• int item - Item number in range from 0 to the total number of menu bar items.

Return value

Item title.

void setSpace ( int x, int y ) #

Sets a space between menu items and between menu items and menu borders.

Arguments

• int x - Horizontal space, in pixels. If a negative value is provided, 0 will be used instead.
• int y - Vertical space, in pixels. If a negative value is provided, 0 will be used instead.

int addItem ( const char * str ) #

Adds an empty menu with a given title.

Arguments

• const char * str - Menu title.

Return value

Number of the added menu.

int addItem ( const char * str, const Ptr<WidgetMenuBox> & menu ) #

Adds the specified submenu (MenuBox) with a given title.

Arguments

• const char * str - Menu title.
• const Ptr<WidgetMenuBox> & menu - Submenu (MenuBox).

Return value

Number of the added menu.

void clear ( ) #

Removes all menus from the menu bar.

void removeItem ( int item ) #

Removes a given item from the menu bar.

Arguments

• int item - Item number in range from 0 to the total number of menu bar items.