boost::ui::combo_box Class Reference

Widget to select one or more strings and edit it. More...

Inheritance diagram for boost::ui::combo_box:

Public Member Functions
combo_box &	text (const uistring &txt)
	Sets text into the editor.
uistring	text () const
	Returns text from the editor.
	combo_box (widget &parent)
	Creates empty combo box widget.
combo_box &	create (widget &parent)
	Creates empty combo box widget.
	combo_box (widget &parent, const uistring &text)
	Creates combo box widget without options and with initial text.
combo_box &	create (widget &parent, const uistring &text)
	Creates combo box widget without options and with initial text.
	combo_box (widget &parent, const std::vector< uistring > &options)
	Creates combo box widget with options and without initial text.
combo_box &	create (widget &parent, const std::vector< uistring > &options)
	Creates combo box widget with options and without initial text.
template<class Iterator >
	combo_box (widget &parent, Iterator first, Iterator last)
	Creates combo box widget with options and without initial text.
template<class Iterator >
combo_box &	create (widget &parent, Iterator first, Iterator last)
	Creates combo box widget with options and without initial text.
template<class Range >
	combo_box (widget &parent, const Range &r)
	Creates combo box widget with options and without initial text.
template<class Range >
combo_box &	create (widget &parent, const Range &r)
	Creates combo box widget with options and without initial text.
template<class T >
	combo_box (widget &parent, std::initializer_list< T > list)
	Creates combo box widget with options and without initial text.
template<class T >
combo_box &	create (widget &parent, std::initializer_list< T > list)
	Creates combo box widget with options and without initial text.
	combo_box (widget &parent, const uistring &text, const std::vector< uistring > &options)
	Creates combo_box widget with options and initial text.
combo_box &	create (widget &parent, const uistring &text, const std::vector< uistring > &options)
	Creates combo_box widget with options and initial text.
template<class Range >
	combo_box (widget &parent, const uistring &text, const Range &r)
	Creates combo_box widget with options and initial text.
template<class Range >
combo_box &	create (widget &parent, const uistring &text, const Range &r)
	Creates combo_box widget with options and initial text.
template<class T >
	combo_box (widget &parent, const uistring &text, std::initializer_list< T > list)
	Creates combo_box widget with options and initial text.
template<class T >
combo_box &	create (widget &parent, const uistring &text, std::initializer_list< T > list)
	Creates combo_box widget with options and initial text.
template<class F , class ... Args>
combo_box &	on_select (F &&f, Args &&... args)
	Connects item selection handler.
template<class F , class ... Args>
combo_box &	on_select_event (F &&f, Args &&... args)
	Connects item selection handler.
Public Member Functions inherited from boost::ui::strings_box
uistring	at (size_type pos) const
	Returns specified element with bounds checking. More...
uistring	operator[] (size_type pos) const
	Retuns specified element.
bool	empty () const
	Checks whether the container has options.
size_type	size () const
	Returns the number of options.
void	clear ()
	Clears the contents.
void	push_back (const uistring &value)
	Appends the given string value to the end.
strings_box &	select (size_type pos)
	Selects specified element.
strings_box &	assign (const std::vector< uistring > &options)
	Replaces the contents of the container.
strings_box &	assign (size_type count, const value_type &value)
	Replaces the contents of the container.
template<class Iterator >
strings_box &	assign (Iterator first, Iterator last)
	Replaces the contents of the container.
template<class Range >
strings_box &	assign (const Range &r)
	Replaces the contents of the container.
template<class T >
strings_box &	assign (std::initializer_list< T > list)
	Replaces the contents of the container.
strings_box &	append (const std::vector< uistring > &options)
	Appends contents to the end.
strings_box &	append (size_type count, const value_type &value)
	Appends contents to the end.
template<class Iterator >
strings_box &	append (Iterator first, Iterator last)
	Appends contents to the end.
template<class Range >
strings_box &	append (const Range &r)
	Appends contents to the end.
template<class T >
strings_box &	append (std::initializer_list< T > list)
	Appends contents to the end.
Public Member Functions inherited from boost::ui::widget
ui::layout::item	layout ()
	Returns layout::item with this widget.
widget &	resize (coord_type width, coord_type height)
	Changes widget size to specified values.
coord_type	x () const
	Returns x coordinate relative to the parent widget client area.
coord_type	y () const
	Returns y coordinate relative to the parent widget client area.
coord_type	width () const
	Returns widget width.
coord_type	height () const
	Returns widget height.
point	pos () const
	Returns widget position relative to the parent widget client area.
size	dimensions () const
	Returns widget size.
rect	bounds () const
	Returns widget bounds in client coordinates.
widget &	enable (bool do_enable=true)
	Enables widget if do_enable is true, disables otherwise.
widget &	disable ()
	Disables widget.
bool	is_enabled () const
	Returns true if widget is enabled, false otherwise.
widget &	show (bool do_show=true)
	Shows widget if do_show is true, hides otherwise.
widget &	hide ()
	Hides widget.
bool	is_shown () const
	Returns true if widget is shown on screen, false otherwise.
widget &	tooltip (const uistring &text)
	Sets tooltip text. More...
uistring	tooltip () const
	Returns tooltip text.
widget &	font (const ui::font &f)
	Sets font.
ui::font	font () const
	Returns font.
bool	native_valid () const noexcept
	Returns true only if native widget was created.
widget &	append (const widget &w)
	Creates native widget and appends it to this widget.
widget &	operator<< (const widget &w)
	Creates native widget and appends it to this widget.
widget &	move (coord_type x, coord_type y)
	Moves widget to specified position.
widget &	move (const point &pos)
	Moves widget to specified position.
template<class F , class ... Args>
widget &	on_resize (F &&f, Args &&... args)
	Connects widget resize handler.
template<class F , class ... Args>
widget &	on_key_press (F &&f, Args &&... args)
	Connects keyboard event handler.
template<class F , class ... Args>
widget &	on_key_press_event (F &&f, Args &&... args)
	Connects keyboard event handler.
template<class F , class ... Args>
widget &	on_key_down (F &&f, Args &&... args)
	Connects keyboard event handler.
template<class F , class ... Args>
widget &	on_key_down_event (F &&f, Args &&... args)
	Connects keyboard event handler.
template<class F , class ... Args>
widget &	on_key_up (F &&f, Args &&... args)
	Connects keyboard event handler.
template<class F , class ... Args>
widget &	on_key_up_event (F &&f, Args &&... args)
	Connects keyboard event handler.
template<class F , class ... Args>
widget &	on_left_mouse_down (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_left_mouse_down_event (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_left_mouse_up (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_left_mouse_up_event (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_right_mouse_down (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_right_mouse_down_event (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_right_mouse_up (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_right_mouse_up_event (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_middle_mouse_down (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_middle_mouse_down_event (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_middle_mouse_up (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_middle_mouse_up_event (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_left_mouse_double_click (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_left_mouse_double_click_event (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_right_mouse_double_click (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_right_mouse_double_click_event (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_middle_mouse_double_click (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_middle_mouse_double_click_event (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_mouse_move (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_mouse_move_event (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_mouse_drag (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_mouse_drag_event (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_mouse_enter (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_mouse_enter_event (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_mouse_leave (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_mouse_leave_event (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_context_menu (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_context_menu_event (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_mouse_wheel (F &&f, Args &&... args)
	Connects mouse event handler.
template<class F , class ... Args>
widget &	on_mouse_wheel_event (F &&f, Args &&... args)
	Connects mouse event handler.
native_handle_type	native_handle ()
	Returns the implementation-defined underlying widget handle.
const native_handle_type	native_handle () const
	Returns the implementation-defined underlying widget handle.

Additional Inherited Members
Public Types inherited from boost::ui::strings_box
typedef uistring	value_type
	String type.
typedef index_type	size_type
	Integral type.
Public Types inherited from boost::ui::widget
typedef void *	native_handle_type
	Implementation-defined widget type.
Static Public Attributes inherited from boost::ui::strings_box
static const size_type	npos = nindex
	Invalid index.

Detailed Description

Widget to select one or more strings and edit it.

Usage example:

ui::combo_box combo_box = ui::combo_box(parent,
    "Initial text",
    { "Option 1", "Option 2", "Option 3" })
    .on_select_event([&](ui::index_event& e)
    {
        ui::log::info() << "Selected option index: " << e.index()
                        << ", text: "                << combo_box.text();
    });

See also

Combo box (Wikipedia)

---

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

• boost/ui/combo_box.hpp