Unigine::WidgetWindow Class
| Header: | #include <UnigineWidgets.h> |
| Inherits from: | Widget |
This class creates a titled window.
See Also#
- UnigineScript API sample <UnigineSDK>/data/samples/widgets/window_00
- C++ API sample <UnigineSDK>/source/samples/Api/Widgets/WidgetWindow
- C# API sample <UnigineSDK>/source/csharp/samples/Api/Widgets/WidgetWindow
WidgetWindow Class
Members
static WidgetWindowPtr create ( const Ptr<Gui> & gui, const char * str = 0, int x = 0, int y = 0 ) #
Constructor. Creates a window with given parameters and adds it to the specified GUI.Arguments
- const Ptr<Gui> & gui - GUI, to which the new window will belong.
- const char * str - Window title. This is an optional parameter.
- int x - Horizontal space between the widgets in the window and between them and the window border. This is an optional parameter.
- int y - Vertical space between the widgets in the window and between them and the window border. This is an optional parameter.
static WidgetWindowPtr create ( const char * str = 0, int x = 0, int y = 0 ) #
Constructor. Creates a window with given parameters and adds it to the Engine GUI.Arguments
- const char * str - Window title. This is an optional parameter.
- int x - Horizontal space between the widgets in the window and between them and the window border. This is an optional parameter.
- int y - Vertical space between the widgets in the window and between them and the window border. This is an optional parameter.
void setBlendable ( bool blendable ) #
Sets a value indicating if the window can fade in and out when changing to the minimized state and back.Arguments
- bool blendable - 1 to allow fading in and out, 0 to disallow it.
bool isBlendable ( ) const#
Returns a value indicating if the window can fade in and out when changing to the minimized state and back. The default is 0.Return value
1 if the window can fade in and out; otherwise, 0.void setColor ( const Math::vec4 & color ) #
Sets a color for the global color multiplier. The default is equivalent to vec4(1,1,1,1) (white).Arguments
- const Math::vec4 & color - Multiplier color.
Math::vec4 getColor ( ) const#
Returns a color of the global color multiplier.Return value
Multiplier color.void setFloatable ( bool floatable ) #
Sets a value indicating if the window is animated when changing to the minimized state and back.Arguments
- bool floatable - 1 to allow animating the window, 0 not to make it.
bool isFloatable ( ) const#
Returns a value indicating if the window is animated when changing to the minimized state and back. The default is 0.Return value
1 if the window is animated; otherwise, 0.void setMaxHeight ( int height ) #
Sets the maximum height value for the window.Arguments
- int height - Maximum height value.
int getMaxHeight ( ) const#
Returns the maximum height value of the window.Return value
Maximum height value.void setMaxWidth ( int width ) #
Sets the maximum width value for the window.Arguments
- int width - Maximum width value.
int getMaxWidth ( ) const#
Returns the maximum width value of the window.Return value
Maximum width value.void setMoveable ( bool moveable ) #
Sets a value indicating if the window is movable.Arguments
- bool moveable - 1 to set the window as movable; otherwise, 0.
bool isMoveable ( ) const#
Returns a value indicating if the window is movable. The default is 1.Return value
1 if the window is movable; otherwise, 0.void setPadding ( int l, int r, int t, int b ) #
Sets widget paddings for all sides. Padding clears an area around the content of a widget (inside of it).Arguments
- int l - Left-side padding in pixels.
- int r - Right-side padding in pixels.
- int t - Top padding in pixels.
- int b - Bottom padding in pixels.
int getPaddingBottom ( ) const#
Returns the current bottom padding for the widget content.Return value
Bottom padding in pixels.int getPaddingLeft ( ) const#
Returns the current left-side padding for the widget content.Return value
Left-side padding in pixels.int getPaddingRight ( ) const#
Returns the current right-side padding for the widget content.Return value
Right-side padding in pixels.int getPaddingTop ( ) const#
Returns the current top padding for the widget content.Return value
Top padding in pixels.void setSizeable ( bool sizeable ) #
Sets a value indicating if the window is resizeable.Arguments
- bool sizeable - 1 to allow resizing the window, 0 to disallow it.
bool isSizeable ( ) const#
Returns a value indicating if the window is resizeable. The default is 0.Return value
1 if the window is resizeable; otherwise, 0.void setSnapDistance ( int distance ) #
Sets a distance, at which the window snaps to another window or screen edge.Arguments
- int distance - Distance in pixels.
int getSnapDistance ( ) const#
Returns the distance, at which the window snaps to another window or screen edge. The default is 0 (do not snap).Return value
Distance in pixels.void setSpace ( int x, int y ) #
Sets a space between the widgets in the window and between them and the window border.Arguments
- int x - Horizontal space. If a negative value is provided, 0 will be used instead.
- int y - Vertical space. If a negative value is provided, 0 will be used instead.
int getSpaceX ( ) const#
Returns the horizontal space between the widgets in the window and between them and the window border.Return value
Horizontal space.int getSpaceY ( ) const#
Returns the vertical space between the widgets in the window and between them and the window border.Return value
Vertical space.void setText ( const char * text ) #
Sets a window title.Arguments
- const char * text - Window title.
const char * getText ( ) const#
Returns the current window title.Return value
Window title.void setTextAlign ( int align ) #
Sets alignment of the window title.Arguments
- int align - One of the ALIGN_* pre-defined variables.
int getTextAlign ( ) const#
Returns the alignment of the window title.Return value
One of the ALIGN_* pre-defined variables.void setTitleable ( bool titleable ) #
Sets a value indicating if the window is minimized when double-clicking on it. The default is 0.Arguments
- bool titleable - 1 to allow minimization, 0 to disallow it.
bool isTitleable ( ) const#
Returns a value indicating if the window is minimized when double-clicking on it. The default is 0.Return value
1 if the window is minimized when double-clicking on it; otherwise, 0.void setTransform ( const Math::mat4 & transform ) #
Sets the global widget transformation matrix. This 2D matrix can be tilted, rotated, moved or modified in many ways in 3D space.Arguments
- const Math::mat4 & transform - Transformation matrix.
Math::mat4 getTransform ( ) const#
Returns the global widget transformation matrix.Return value
Transformation matrix.void setBackgroundColor ( const Math::vec4 & color ) #
Sets the background color to be used for the widget.Arguments
- const Math::vec4 & color - Four-component vector specifying the color in the RGBA format.
Math::vec4 getBackgroundColor ( ) const#
Returns the current background color used for the widget.Return value
Four-component vector specifying the color in the RGBA format.void setBorderColor ( const Math::vec4 & color ) #
Sets the border color for the widget.Arguments
- const Math::vec4 & color - Four-component vector specifying the color in the RGBA format.
Math::vec4 getBorderColor ( ) const#
Returns the current border color for the widget.Return value
Four-component vector specifying the color in the RGBA format.Last update:
2021-12-13
Help improve this article
Was this article helpful?
(or select a word/phrase and press Ctrl+Enter)