Label

Kalipso - Developing - Form - Controls - Type - Label

A label is a portion of text that can be added to a Form. You can change the Label’s Text in runtime. A Label can interact with the user through its Events. You should use this Control if you just want to present some text to the user. To add a Label, open in the Design Area, a previously created Form and then select the “Label” button on the Controls Toolbar of Main Window. Value - Its value is the displayed Text.

For the control in question, when opening its properties, the following window appears:

Depending on the control chosen, the properties are different.

Properties

Tab - General

Common

• Name - Name of the Control. This Name will be used to identify the Control throughout the Project. The name of the Control can only contain letters, digits or underscore (_).

• Text - Text to be displayed in the Control.

• Description - Not applicable to this control.

• Plane - Plane of the Form where the Control should be created. Check the Planes chapter for more information.

• Visible - With this option selected, the control is (or is not) visible.

• Enabled - With this option selected, the control is (or is not) enabled. It may be visible (previous option), but it may not be enabled. In this case an event associated with the control is not executed

Layout

• X - x position of the Control from left

• Y - y position of the Control from top

• Width - Width of the Control.

• Height - Height of the Control

In relation to all these layout options, it is possible to set this value in runtime via the “Set Property” Action. You can also retrieve this value in runtime via the “Get Property” Action.

Style

Appearance

• Background - Background color of the Control. You can set the color for the background.

• Opacity - Set the percentage of opacity for the background.

You can set this value is runtime via the “Set Property” Action. You can retrieve this value in runtime via the “Get Property” Action.

On the right side of the Style section, you can choose templates with pre-defined styles or configurable ones. By clicking on this option, the following style possibilities for the label appear:

• Styles

  • None

  • Header Title

  • Body Title

  • Base

  • Button

  • Caption

  • Inverted

  • Strong

  • SubHeaderTitle

Text

• Font – Font of the displayed Text

• Size – Font size of the displayed Text

• Font Color – Font color of the displayed Text and/or select the code in the color picker.

In the font color you can set this value is runtime via the “Set Property” Action. You can retrieve this value in runtime via the “Get Property” Action.

• Text Position – Position of the Text inside the Control

On Windows CE/Mobile vertical alignment is not available for single line Labels.

• Wrap – When active, if the Text doesn't fit the Control in width, it's automatically "broken" into several lines.

• Ellipsis - When the text is larger than the area of the label the app shows an ellipsis (...) to indicate that there more text that can't be displayed.

Border

• Border – To set or remove the frame around the Control. When choosing this option, the application allows the following types of border:

  • No – No border is displayed

  • Default - A frame is displayed around the Control

  • Customized Rectangle -

  • Customized Circle -

• Line - Set the color of the line or select the code in the color picker.

• Thickness – Thickness of the frame to be drawn around the Control

• Rounded Corners – Allows to specify how the corners of the frame drawn around the Control should be drawn.

  • No - The corners of the frame drawn around the Control will be 90 degrees (rectangle)

  • Rounded Tops - Instead of drawing each corner, a semicircle is drawn in each top (left and right)

  • Specify Radius - Allows you to specify the radius of the semicircle to be draw in each corner of the Control

• Radius - Radius of the semicircle to be draw in each corner of the Control

• Borders - Choose which line of borders you want to add (left, right, top, bottom, all around).

You can activate or deactivate the Border through “Set Property” Action. You can know if it's active or not in runtime via the “Get Property” Action.

Tab - Actions

For each control, actions can be associated. For this, with the control selected, it is possible to access this tab and associate an action to the control. For more information on the actions available and how to use them click here.

Shortcuts

• F2 - Actions

• F3 - General Properties