Size

Size specifies the dimensions of the element's background image.

Size of the element's background image is changed in Lycia Theme Designer.

Theme property filter XML code:

Possible values:

a record of integer values in pixels, em, rem, or qch

Associated containers, widgets and theme elements:

BorderPanel CoordPanel GridPanel GroupBox StackPanel ScrollViewer Tab TabPage Table TreeTable

BlobViewer Browser Button Calendar Canvas CheckBox ComboBox FunctionField Label MenuGroup MenuCommand

ProgressBar RadioGroup Slider Spinner TextArea TextField Toolbar ToolbarButton TimeEditField WebComponent

Inheritance diagram:

Associated ui methods:

setSize ↓

getSize

Influence and behavior:

Regardless of whether you use Lycia Theme Designer or ui methods to change the size of the element's background image, you can set it in these units:

• unit is not specified - is supported for compatibility reasons; Lycia will consider it as pixels;
• px - in pixels;
• em - relative to the font size of the element (10 em = 100 times the size of the current font);
• rem - relative to the font size of the root element;
• qch - relative to the character size (10 qch - 10 times the size of the character).

 

In Lycia Theme Designer, size of the element's background image is not specified directly to the Size property but to the placeholder called New Size. New Sizeis an optional ui object (=ui.Size) created to hold the dimensions - width and height - of the element's background image:

To specify the size of the element's background image, you must set its width ans height in px, em, rem, or qch:

property is not set (runtime appearance):

property is set (runtime appearance):

 

At runtime, you can use ui method - <var>.SetSize() - to change the size of the element's background image.

For this purpose, you must

1. define a variable of the ui.Background data type,
2. specify the element's background via <var>.SetBackgroundImage() and <var>.SetBackgroundStyle() methods applied to this variable,
3. apply <var>.SetSize() to this variable,
4. apply the background to the form element by the <var>.setBackground() method:

4gl code sample	MAIN DEFINE lb ui.Label DEFINE bg ui.Background DEFINE sc ui.SystemColor OPEN WINDOW w WITH FORM "background_ui" ATTRIBUTE(BORDER)   LET lb= ui.Label.ForName("lb1")     CALL bg.SetBackgroundImage("qx://application/querix.png")     CALL bg.SetBackgroundStyle("Normal")     CALL bg.SetSize(["50px","50px"])     CALL bg.SetLocation(["175px","100px"]) CALL lb.SetBackground(bg) CALL fgl_getkey() END MAIN
default appearance (in the form)
runtime appearance

Please compare these results to the example program.