boost::ui::window Class Reference

Abstract top level widget that hosts other widgets. More...

Inheritance diagram for boost::ui::window:

Public Member Functions
window &	title (const uistring &title)
	Sets title. More...
uistring	title () const
	Returns title.
void	show_modal ()
	Shows an application-modal dialog. More...
bool	close ()
	Initiates window close. Returns false if operation was vetoed.
template<class F , class ... Args>
window &	on_close (F &&f, Args &&... args)
	Connects window close handler.
template<class F , class ... Args>
window &	on_close_event (F &&f, Args &&... args)
	Connects window close handler.
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::widget
typedef void *	native_handle_type
	Implementation-defined widget type.

Detailed Description

Abstract top level widget that hosts other widgets.

Usage examples:

class my_dialog : public ui::dialog
{
public:
    my_dialog() : ui::dialog("Dialog example")
    {
        ui::button(*this, "&Close this dialog")
            .on_press(&my_dialog::on_close, this);
    }
 
private:
    void on_close()
    {
        close();
    }
};
 
void run_dialog()
{
    my_dialog().show_modal();
}

class my_frame : public ui::frame
{
    typedef my_frame this_type;
 
public:
    my_frame() : ui::frame("Frame example")
    {
        ui::button(*this, "&Close this frame")
            .on_press(&this_type::on_close, this);
 
        menu_bar()
            << ( ui::menu("&File")
                << ui::menu::item("&Quit")
                    .on_press(&this_type::on_close, this)
            )
            ;
 
        status_bar().text("Ready");
    }
 
private:
    void on_close()
    {
        close();
    }
};
 
void run_frame()
{
    my_frame().show_modal();
}

See also

Window (Wikipedia)

Member Function Documentation

show_modal()

void boost::ui::window::show_modal

(

)

Shows an application-modal dialog.

See also

Modal window (Wikipedia)

title()

window& boost::ui::window::title

(

const uistring &

title

)

Sets title.

See also

Title bar (Wikipedia)

---

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

• boost/ui/window.hpp