Container

Description

class Tinman.Engine.GUI.Container

Derived from

Component abstract

Extended by

AnimationGui sealed
BookmarksGui sealed
CameraPathGui sealed
DataGrid sealed
DefaultVisibleCheckGui sealed
DocumentBrowser sealed
GraphicsContextChooserGui sealed
HeightmapSampleGui sealed
LightingGui sealed
MapCoordinatesGui sealed
MeshBufferGui sealed
MeshDynamicGui sealed
Panel sealed
ProfilerGui sealed
QuantityEditor sealed
RootContainer sealed
ShadowMappingGui sealed
TerrainBufferGui sealed
TerrainLayerListGui sealed
TerrainViewGui sealed
ValueIncrementer sealed
WidgetDialog

Base class for containers that can have child components.

The following default Layout settings are defined for Container objects:

Public / Constants

Class

public static readonly attribute Class → (StyleClass)

The style class for Container.

Public / Constructors

Container

public constructor Container → ()

Creates a new instance of Container.

Public / Methods

Child​Add

2 overloads

public virtual method ChildAdd1 → (1)

component in : Component own

[not-null]
The child component.

Adds a child component to this container, using its current layout settings.

Use this method if you have configured the layout settings of component in earlier (see Component.LayoutInfo) and want those to be used when adding component in as a child of this container.

public virtual method ChildAdd2 → (2)

component in : Component own

[not-null]
The child component.

layout in : Layout

The layout settings to use; will replace Component.LayoutInfo. Unspecified settings will be taken from Component.LayoutDefault. Usually, you may want to start with Layout.At1 in order to create a new Layout value.

Adds a child component to this container, using the given layout settings.

This is the usual way of constructing a hierarchy of components: create new components, adjust their default layout settings and put into the layout grid of the parent container.

Use this method if the current layout settings of component in shall be discarded (e.g. it is a newly created Component object with zero layout settings).

Child​Any

[Pure]
public virtual method ChildAny → (1)

onlyVisible in : bool

true to test for non-hidden (see ComponentState.Hidden) children only, false to test for existing children.

returns → bool

true if there are one or more children (according to onlyVisible in), false if not.

Checks if this container has any children.

Child​Bounds

2 overloads

public method ChildBounds1 → (1)

component in : Component

[not-null]
The child (or descendant) component.

returns → Box2I

The bounds of component in, relative to this container.

Returns the bounds of the given child (or descendant) in this container.

public method ChildBounds2 → (2)

component in : Component

[not-null]
The child (or descendant) component.

bounds in : Box2I

The bounds, relative to component in.

returns → Box2I

The bounds of component in, relative to this container.

Translate the given child (or descendant) bounds so that they are relative to this container.

Child​Remove

public virtual method ChildRemove → (1)

component in : Component

[not-null]
The child component.

Removes a child component from this container.

Child​Remove​All

public method ChildRemoveAll → ()

Removes all child components from this container.

Validate​Layout

public method ValidateLayout → ()

Validates the layout of this component.

Public / Attributes

Actual​Layout​Insets

public attribute ActualLayoutInsets → (get)

value : Edging

The actual layout insets.

The actual layout insets, as computed by ComputeLayoutInsets.

Client​Area

public virtual attribute ClientArea → (get)

value : Box2I

The client area.

Returns the client area of this container.

Client​Area​Corners

public virtual attribute ClientAreaCorners → (get)

value : Pair<Corner, int32>

The round corners of this containers client rectangle.

Containers with a round client rectangle can override this property in order to return proper information.

Components

public virtual attribute Components → (get)

value : IVectorConst<Component>

[not-null]
The list of child components.

Returns the list of child components.

Layout​Insets

public attribute LayoutInsets → (get,set)

value : Edging

The edge insets.

The insets of this container.

See also

Component.LayoutInfo

Protected / Methods

Compute​Layout​Insets

protected virtual method ComputeLayoutInsets → ()

returns → Edging

The actual insets value.

Computes the actual insets of this component.

The default implementation returns LayoutInsets. Subclasses can perform additional computations here.

Subclasses must call Component.InvalidateLayout with LayoutAction.ComputeLayoutGridExtend to notify when ComputeLayoutInsets returns a different value.

Layout​Grid​Bounds

[Pure]
protected method LayoutGridBounds → (4)

x in : int32

Grid X-coordinate of top-left cell.

y in : int32

Grid Y-coordinate of top-left cell.

width opt : int32 = 1

The range width, in cells. If less the zero, the range will span all remaining columns, starting at x in.

height opt : int32 = 1

The range height, in cells. If less the zero, the range will span all remaining rows, starting at y in.

returns → Box2I

The pixel bounds of the given cell range.

Returns the layout bounds of the given layout grid cell range.

Protected / Attributes

Focused

protected attribute Focused → (get)

value : Component

The focused child component or null if none.

Returns the currently focused child component.

gui​Updating

protected attribute guiUpdating → (BeginEnd)

Helper object that can be used to avoid re-entrance problems with event notification calls while updating the GUI from code.

Layout​Grid​Extends

protected attribute LayoutGridExtends → (get)

value : Box2I

The coordinate ranges of the layout grid cells.

Returns the layout grid cell extend.