#include <omgui/window.h>
Inherits omgui::TopLevel.
Event Objects:
Events:Public Types | |
typedef omgui::api::Window | api_type |
typedef omgui::event_traits < Window > | event_traits |
typedef WindowInitializer | Initializer |
Public Member Functions | |
void | add_ref () |
Increments the reference count for this Widget. | |
omgui::Connection | connect (event_id event, SlotBase *slot, int priority=SIGNAL_PRIORITY_NORMAL) |
Connects an event using this Widget's object_id. Calls omgui::Manager::connect with supplied arguments. | |
void | destroy () |
Destroys this widget freeing all resources. | |
void | disable () |
void | enable (bool e) |
Enables or disables the widget. Disabled widgets cannot recieve user input. | |
Pointer< omgui::Panel > | get_content_panel () const |
omgui::Size | get_content_size () const |
void * | get_handle () const |
object_id | get_id () const |
api_type * | get_impl () const |
omgui::Size | get_max_content_size () const |
omgui::Size | get_max_size () const |
Returns the maximum size of the Widget. A value of 0 for width or height indicates that there is no maximum size in that direction. | |
Pointer< MenuBar > | get_menu_bar () const |
omgui::Size | get_min_content_size () const |
omgui::Size | get_min_size () const |
Returns the minimum size of the Widget. A value of 0 for width or height indicates that there is no minimum size in that direction. | |
omgui::Size | get_natural_size () const |
Pointer< Panel > | get_parent () const |
Pointer< Window > | get_parent_window () const |
omgui::Point | get_position () const |
omgui::Rect | get_rect () const |
omgui::Size | get_size () const |
string | get_title () const |
string | get_window_placement () const |
void | hide () |
bool | is_enabled () const |
Determines whether or not the widget is enabled. If any of a widget's parents are disabled, the widget is considered disabled. | |
bool | is_hidden () const |
Returns whether or not this Widget has been hidden. | |
bool | is_shown () const |
Returns whether or not the Widget is visible on the screen. If the Widget and all of its parent Widgets are not hidden then the Widget is shown. | |
void | release () |
Decrements the reference count for this Widget. Once the count reaches 0 the Widget will be deleted. | |
Pointer< omgui::Panel > | set_content_panel (const Pointer< omgui::Panel > &p) |
void | set_content_size (const omgui::Size &s) |
Sets the client size of the widget. | |
void | set_max_content_size (const omgui::Size &size) |
Sets the maximum size for the content of this window. That is to say that the content panel of this Window will never be larger than the maximum content size. | |
void | set_max_size (const omgui::Size &s) |
Sets the maximum size of the widget. A value of 0 for width or height indicates that there is no maximum size in that direction. | |
void | set_menu_bar (const Pointer< MenuBar > &menubar) |
void | set_min_content_size (const omgui::Size &size) |
Sets the minimum size for the content of this window. That is to say that the content panel of this Window will never be smaller than the minimum content size. | |
void | set_min_size (const omgui::Size &s) |
Sets the minimum size of the Widget. A value of 0 for width or height indicates that there is no minimum size in that direction. If the Widget's current size is less than the newly specified minimum size, the object will be resized so that its size is equal to the newly specified minimum size. | |
void | set_natural_size (const omgui::Size &s) |
void | set_position (const omgui::Point &p) |
Sets the position of a widget. If the widget is a TopLevel widget, the position value is in screen coordinates, otherwise it is client coordinates. | |
void | set_rect (const omgui::Rect &r) |
Sets both the position and the size of the widget. If the widget is a TopLevel widget, the value is in screen coordinates, otherwise it is client coordinates. | |
void | set_size (const omgui::Size &s) |
Sets the absolute size of this widget. If the widget is a TopLevel widget, the value is in screen coordinates, otherwise it is client coordinates. | |
void | set_title (const string &t) |
Sets the title of the widgets caption. | |
void | set_window_placement (const string &placement) |
void | show (bool show=true, bool focus=true) |
Shows or hides a widget. | |
Static Public Member Functions | |
static Pointer< Window > | create (const Initializer &initializer, object_id id=OBJECT_ID_ANY) |
Protected Member Functions | |
void | initialize (const Initializer &initializer) |
Constructs the native widget using the given initialization data. | |
Window (object_id id, api_type *impl) | |
Window (object_id id) | |
Private Attributes | |
api_type * | m_impl |
Reimplemented from omgui::TopLevel.
typedef omgui::event_traits<Window> omgui::Window::event_traits |
Reimplemented from omgui::Widget.
omgui::Window::Window | ( | object_id | id | ) | [protected] |
void Widget::add_ref | ( | ) | [virtual, inherited] |
omgui::Connection Widget::connect | ( | event_id | event, | |
SlotBase * | slot, | |||
int | priority = SIGNAL_PRIORITY_NORMAL | |||
) | [inherited] |
Connects an event using this Widget's object_id. Calls omgui::Manager::connect with supplied arguments.
Pointer< Window > omgui::Window::create | ( | const Initializer & | initializer, | |
object_id | id = OBJECT_ID_ANY | |||
) | [static] |
Creates a Window with the given object_id. An id of OBJECT_ID_ANY means that the widget will be assigned an autmoatically generated unique id.
void Widget::destroy | ( | ) | [inherited] |
Destroys this widget freeing all resources.
void Widget::disable | ( | ) | [inherited] |
void Widget::enable | ( | bool | e | ) | [inherited] |
Enables or disables the widget. Disabled widgets cannot recieve user input.
Pointer< omgui::Panel > omgui::Window::get_content_panel | ( | ) | const |
Size omgui::TopLevel::get_content_size | ( | ) | const [inherited] |
void * Widget::get_handle | ( | ) | const [inherited] |
object_id omgui::Object::get_id | ( | ) | const [inherited] |
Window::api_type * omgui::Window::get_impl | ( | ) | const |
Reimplemented from omgui::TopLevel.
omgui::Size omgui::Window::get_max_content_size | ( | ) | const |
omgui::Size Widget::get_max_size | ( | ) | const [inherited] |
Returns the maximum size of the Widget. A value of 0 for width or height indicates that there is no maximum size in that direction.
omgui::Size omgui::Window::get_min_content_size | ( | ) | const |
omgui::Size Widget::get_min_size | ( | ) | const [inherited] |
Returns the minimum size of the Widget. A value of 0 for width or height indicates that there is no minimum size in that direction.
omgui::Size Widget::get_natural_size | ( | ) | const [inherited] |
omgui::Point Widget::get_position | ( | ) | const [inherited] |
omgui::Rect Widget::get_rect | ( | ) | const [inherited] |
omgui::Size Widget::get_size | ( | ) | const [inherited] |
string omgui::TopLevel::get_title | ( | ) | const [inherited] |
string omgui::Window::get_window_placement | ( | ) | const |
This function returns a string describing the placement of this Window. It is meant to be used in conjunction with set_window_placement to remember a Window's position over application instances. Save this string somewhere, load it, and use set_window_placement the next time the application runs to put the Window exactly where the user had it the last time they ran the application.
All relevant information relating to window position will be handled by get_window_placement and set_window_placement. This information includes:
void Widget::hide | ( | ) | [inherited] |
void omgui::Window::initialize | ( | const Initializer & | initializer | ) | [protected] |
Constructs the native widget using the given initialization data.
bool Widget::is_enabled | ( | ) | const [inherited] |
Determines whether or not the widget is enabled. If any of a widget's parents are disabled, the widget is considered disabled.
bool Widget::is_hidden | ( | ) | const [inherited] |
Returns whether or not this Widget has been hidden.
If show(true) has been called the Widget is considered not to be hidden. If show(false) or hide() have been called the Widget is considered hidden. A Widget is also considered hidden if it was created without specifying show in its initializer. The hidden state of the parent Widget has no effect on the hidden state of this Widget.
bool Widget::is_shown | ( | ) | const [inherited] |
void Widget::release | ( | ) | [virtual, inherited] |
Decrements the reference count for this Widget. Once the count reaches 0 the Widget will be deleted.
Implements omgui::RefCountable.
Pointer< omgui::Panel > omgui::Window::set_content_panel | ( | const Pointer< omgui::Panel > & | p | ) |
Sets the content panel for this window
void omgui::TopLevel::set_content_size | ( | const omgui::Size & | s | ) | [inherited] |
Sets the client size of the widget.
void omgui::Window::set_max_content_size | ( | const omgui::Size & | size | ) |
Sets the maximum size for the content of this window. That is to say that the content panel of this Window will never be larger than the maximum content size.
If the content panel's size is currently larger than the new maximum content size, the Window will be resized so the content size of the panel is equal to the newly specified maximum content size.
void Widget::set_max_size | ( | const omgui::Size & | s | ) | [inherited] |
Sets the maximum size of the widget. A value of 0 for width or height indicates that there is no maximum size in that direction.
If the Widget's current size is greater than the newly specified maximum size, the object will be resized so that its size is equal to the newly specified maximum size.
void omgui::Window::set_min_content_size | ( | const omgui::Size & | size | ) |
Sets the minimum size for the content of this window. That is to say that the content panel of this Window will never be smaller than the minimum content size.
If the content panel's size is currently smaller than the new minimum content size, the Window will be resized so the content size of the panel is equal to the newly specified minimum content size.
void Widget::set_min_size | ( | const omgui::Size & | s | ) | [inherited] |
Sets the minimum size of the Widget. A value of 0 for width or height indicates that there is no minimum size in that direction. If the Widget's current size is less than the newly specified minimum size, the object will be resized so that its size is equal to the newly specified minimum size.
If a child of this Widget has a minimum size larger than the minimum size of this Widget, the minimum size of this Widget will be effectively equal to the minimum size of that child Widget. This has an important implication for Windows and their content panels. If a Window has a minimum size of X, and a Panel A with minimum size Y > X is specified as the Window's content panel, the minimum content size of the Window is effectively Y. If a new Panel B with minimum size Z < Y is specified as the Window's content panel, the effective minimum content size for the window will be Y.
If an Widget is specified with a minimum size that is larger than the Widgets maximum size, or if a maximum size is later specified which is smaller than an existing minimum size, the minimum size will always take precedence over the maximal size. A minimum size of (100,100) and a maximal size of (50,50) results in a minimum size of (100,100) and a maximum size of (100,100). If the minimum size is later changed to (25,25), the maximum size is again (50,50) and the minimum size is (25,25). This case also applies to Window's and their content panels. A content panel's minimum size always takes precedence over a Window's maximum content size.
void Widget::set_natural_size | ( | const omgui::Size & | s | ) | [inherited] |
Sets the natural size for this widget. The natural size is used by layout managers to determine how large to make widgets which are not expanded. The default natural size has a width and height of 0, which means that an acceptible natural size will be calculated for the width and height. You can override the calculated value by specifying your own value for the width and or height.
void Widget::set_position | ( | const omgui::Point & | p | ) | [inherited] |
Sets the position of a widget. If the widget is a TopLevel widget, the position value is in screen coordinates, otherwise it is client coordinates.
void Widget::set_rect | ( | const omgui::Rect & | r | ) | [inherited] |
Sets both the position and the size of the widget. If the widget is a TopLevel widget, the value is in screen coordinates, otherwise it is client coordinates.
void Widget::set_size | ( | const omgui::Size & | s | ) | [inherited] |
Sets the absolute size of this widget. If the widget is a TopLevel widget, the value is in screen coordinates, otherwise it is client coordinates.
If the size value specified is smaller than the minimum size or larger than the maximum size, the size value actually set will be equal to the minimum size or maximum size respectively.
void omgui::TopLevel::set_title | ( | const string & | t | ) | [inherited] |
Sets the title of the widgets caption.
void omgui::Window::set_window_placement | ( | const string & | placement | ) |
Sets the placement of this Window.
placement | A string describing the placement of this window. This string must have been returned by a previous call to get_window_placement. |
void omgui::TopLevel::show | ( | bool | show = true , |
|
bool | focus = true | |||
) | [inherited] |
Shows or hides a widget.
Reimplemented from omgui::Widget.
api_type* omgui::Window::m_impl [private] |
Reimplemented from omgui::TopLevel.