Form Control Properties - Label

Contents Hide

 

Font

Use the Font property to specify the font, style and size of the form controls.

The default font for BrightBuilder is Arial 12 Plain. Set the default font for all your controls in your project with the Default Font project property.

For more information on Font property, read Changing Fonts in the How To document.

Enabled

Form controls can be enabled or disabled on initial execution with the Enabled property. With this property it is possible to disable for example, a button until data has been changed in an edit control, then use a control action property to call an expression to enable the button.

Set the Enabled property by selecting True from the drop down list.

Visible

You can use the Visible property to show or hide a control on a form. Set this property to True if you want the form control to be visible upon execution. Select False to hide the control and use an expression in a form or form action to make the control visible after a certain criteria or user input.

Tab Order

The Tab Order property accepts an integer to specify a control’s place in the tab order of a form. The first control in the tab order must have a Tab Order of 1 to initiate the tab orders.

Tab order  - order in which the TAB key iterates through components.

Caption

The Caption property is used to provide helpful information to the user through captions on objects in various views:

  • Form captions are the text that appears in the title bar of the executable form.

  • Label, Button, Radio box, Check box and Group box captions specify the text that appears in the control.

The Caption property is a string input. For controls, set this property in the Properties view in the Component panel. Form captions can be set in the Properties view of the Explorer window.

If the caption to a control or form is not specified, BrightBuilder will assign the default name of the object as its caption.

Alignment

Select the type of text alignment in a label and edit control.

  1. Open the form in the Source Editor window

  2. Select the control in the form Layout tab; the Component panel will display the control properties.

  3. In the Alignment property box, click Left, Centre or Right. Changes will automatically be reflected in the form layout.

Action – Click

Use the Action – Click property of the button, radio button and check box controls to execute an expression or open a form when the control has been clicked. A click even can occur when the user presses the left-mouse button or the ENTER key when the control is on focus.

Colour

This property enables the background and text colour of the edit and label controls. 

Set the Colour – Background and/or Colour – Text properties to the colour required then simply set the Colour property to true to enable and display the colours specified.

Set the Colour property by selecting True from the drop down list.

Colour - Background

Colour - Background property allows specification of a background colour for the label, edit and scribble controls. 

Select the background colour by clicking on the customizer button to display the Colour - Background property editor like the one below:

 

Select the desired colour from the property editor window, it is also possible to change the HSB, RGB, AWT Swing and System Palette. Then click OK to continue.

Scribble background colour will automatically be enabled once the Colour – Background property has been set.

Enable the background colour for the edit and label by selecting True in the Colour property.

Colour - Text

Use the Colour  - Text property to change the text colour for the label and edit control.

To change the text colour, click on the customise button to display the following dialog:

Select the desired colour and click OK.

Make sure to enable the text colour by selecting True in the Colour property. .

Underline

Determines whether or not a label's caption is rendered with or without an underline. Default is off; false.

Web Link

This is a property for web based label controls. Tapping on a label with this property defined will open the URL specified in a new window.