Reference for the Mosaic class Views::Rectangle

Views::Rectangle
AlphaBlended
Color
ColorBL
ColorBR
ColorTL
ColorTR
Embedded
Visible
Core::RectView
Bounds
Core::View
Layout
Owner
StackingPriority
AdjustDrawingArea()
ArrangeView()
ChangeViewState()
CursorHitTest()
Draw()
GetExtent()
GetRoot()
HandleEvent()
MoveView()

SEE ALSO

Using the Rectangle view to fill a rectangular area with solid color or gradient.

The class Views::Rectangle provides a kind of view specialized to draw a filled rectangle. The position and the size of the rectangle are determined by the property Bounds. The color to fill the rectangle is defined by the property Color. Alternatively, the rectangle can be filled with a color gradient specified by the properties ColorTL, ColorTR, ColorBL and ColorBR. For each view's corner different color can be set.

The visibility of the rectangle is controlled by the properties Visible, AlphaBlended and Embedded. In particular the property Embedded can determine whether the corresponding view is limited (== embedded) to the boundary of a sibling Core::Outline view or not. The embedding of views within a Core::Outline allows a kind of sub-groups within the GUI component itself. Very useful for any kind of scrollable lists, menus, etc.

property bool AlphaBlended = true;

The property 'AlphaBlended' determines the drawing mode for the view. Views with disabled alpha-blending will override the affected screen areas. If this mode is enabled, the pixel of the view are combined with the origin screen content by alpha-blending.

property color Color = #FFFFFFFF;

The property 'Color' controls the color of the entire rectangle. Thus this property is useful if no gradients are desired. The resulting colors can additionally be modulated by the values specified in the properties ColorTL, ColorTR, ColorBL and ColorBR.

property color ColorBL = #FFFFFFFF;

The property 'ColorBL' stores the color at the bottom-left corner of the rectangle's Bounds area. This color value can additionally be modulated by the common color value stored in the property Color.

property color ColorBR = #FFFFFFFF;

The property 'ColorBR' stores the color at the bottom-right corner of the rectangle's Bounds area. This color value can additionally be modulated by the common color value stored in the property Color.

property color ColorTL = #FFFFFFFF;

The property 'ColorTL' stores the color at the top-left corner of the rectangle's Bounds area. This color value can additionally be modulated by the common color value stored in the property Color.

property color ColorTR = #FFFFFFFF;

The property 'ColorTR' stores the color at the top-right corner of the rectangle's Bounds area. This color value can additionally be modulated by the common color value stored in the property Color.

property bool Embedded = false;

The property 'Embedded' controls how the view should appear and behave within its superior Owner. If this property == 'true', the affected view will be embedded (limited) to the boundary of a preceding Core::Outline sibling view. This is as if the view had been embedded within this outline. Beside the appearance limitation of the outline boundary, the outline also provides more sophisticated arrangement mechanisms and the content scrolling. It is therefore useful to create scrollable menus or lists.

If this property is 'false', the view is considered as a regular view of its Owner - it doesn't belong to any outline.

property bool Visible = true;

The property 'Visible' determines the visibility state of the view. Invisible views will not appear on the screen. Whether a view is really visible depends on the visibility of its Owner and the position of the view within the owners boundary area.