Reference for the Mosaic class Views::Border
The class Views::Border provides a kind of view specialized to draw a rectangular border. The position and the size of the border are determined by the property Bounds. The border is drawn with the thickness defined in the property Width. The corners of the displayed border can be rounded. For this purpose the property Radius can be used. Alternatively, the rounding for the corners can be configured individually by using the properties RadiusTL, RadiusTR, RadiusBR and RadiusBL.
The color to draw the border is defined by the property Color. Alternatively, the border can be drawn 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 border 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 border. 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 border'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 border'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 border'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 border'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 int32 Radius = 0;
The property 'Radius' determines the radius for all four corners of a rounded border. If the value is equal or less than 0, no rounded corners are displayed resulting in an ordinary border with sharp corners. Please note, the resulting radius is limited to half the shortest edge of the view.
This property is useful to configure all four corners at once so all of them are equally rounded. To configure individual radius for the corners use the properties RadiusTL, RadiusTR, RadiusBR and RadiusBL.
property int32 RadiusBL = 0;
The property 'RadiusBL' determines an individual radius for the bottom-left corner of a rounded border. If the value is equal or less than 0, the bottom-left corner is not rounded unless there is a value specified in the common property Radius.
Please note, if there is also a value specified in the property Radius, the resulting radius for the bottom-left corner is the sum of the values found in the property Radius and in the property RadiusBL. Furthermore, the resulting radius is limited to half the shortest edge of the view.
property int32 RadiusBR = 0;
The property 'RadiusBR' determines an individual radius for the bottom-right corner of a rounded border. If the value is equal or less than 0, the bottom-right corner is not rounded unless there is a value specified in the common property Radius.
Please note, if there is also a value specified in the property Radius, the resulting radius for the bottom-right corner is the sum of the values found in the property Radius and in the property RadiusBR. Furthermore, the resulting radius is limited to half the shortest edge of the view.
property int32 RadiusTL = 0;
The property 'RadiusTL' determines an individual radius for the top-left corner of a rounded border. If the value is equal or less than 0, the top-left corner is not rounded unless there is a value specified in the common property Radius.
Please note, if there is also a value specified in the property Radius, the resulting radius for the top-left corner is the sum of the values found in the property Radius and in the property RadiusTL. Furthermore, the resulting radius is limited to half the shortest edge of the view.
property int32 RadiusTR = 0;
The property 'RadiusTR' determines an individual radius for the top-right corner of a rounded border. If the value is equal or less than 0, the top-right corner is not rounded unless there is a value specified in the common property Radius.
Please note, if there is also a value specified in the property Radius, the resulting radius for the top-right corner is the sum of the values found in the property Radius and in the property RadiusTR. Furthermore, the resulting radius is limited to half the shortest edge of the view.
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.
property int32 Width = 1;
The property 'Width' stores the width in pixel of the border edges.