UnigineEditor
界面概述
资产工作流程
设置和首选项
项目开发
调整节点参数
Setting Up Materials
Setting Up Properties
照明
Landscape Tool
Sandworm (Experimental)
使用编辑器工具执行特定任务
Extending Editor Functionality
编程
基本原理
搭建开发环境
Usage Examples
UnigineScript
C++
C#
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine Tools
GUI
双精度坐标
应用程序接口
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Rendering-Related Classes

Unigine::WidgetWindow Class

Header: #include <UnigineWidgets.h>
Inherits: 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: 2020-06-16