Attached Label in ClaySys AppForms

ClaySys AppForms V1.0

Introduction

Each and every data capture control that is placed in a form needs a description to guide the user to enter the valid data. ClaySys AppForms has come up with a feature to have the label attached to the control itself. This will help the person designing the form to have more control of the labels. There are many advantages of using the attached label when you will have to control the behaviour of the control from the rules or changing the layout of the control, etc.

Properties of the Attached Label

The properties of an attached label remains the same for all the control in ClaySys AppForms.

1. Show Label

This property is to decide if the user would like to display or hide the attached label for the control.

The default value for this property will be false. You will have to enable this property to display the attached label.

This property accepts a Boolean value, so when you use this property in the rule you will have to pass either True or False.

The syntax of using this property in the rules is,

ControlName.Label.ShowLabel = true

2. Label Text

This property is to enter the text that needs to be displayed in the label.

The default value for this property will be “New Label”.

This property accepts a string value, so when you use this property in the rule you can use any string in quotes (“”)

The syntax of using this property in the rules is

ControlName.Label.Text = “Sample Text”

3. Label Position

This property is to decide the position of the label. You can place the label to the left, right, top or bottom side of the control.

The default value for this property will be Left.

This property accepts the four positions as a string value, so when you use this property in the rule you can pass the position value with quotes.

The syntax of using this property in the rules is

ControlName.Label.Position = “top”

4. Label Width

This property is to change the width of the label. The control and the label has separate width, so these will add up to the complete control display width.

The default value for this property will be 80.

This property accepts a numeric value, so when you use this property in the rule you can directly pass a numeric value without quotes.

The syntax of using this property in the rules is

ControlName.Label.Style.Width = 100

5. Label Height

This property is to change the height of the label. The control and the label has separate height, so these will add up to the complete control display height if you use the position as top or bottom.

The default value for this property will be 23.

This property accepts a numeric value, so when you use this property in the rule you can directly pass a numeric value without quotes.

The syntax of using this property in the rules is

ControlName.Label. Style .Height = 100

6. Text Alignment

This property is to change the alignment of the text displayed in the label.

The default value for this property will be Left.

This property accepts the alignment as a string value, so when you use this property in the rule you can directly pass the position value with quotes.

The syntax of using this property in the rules is

ControlName.Label.Style.TextAllignment = “Right”

7. Margin

This property is to change the margin of the label. This property accepts the margin of all four sides. These values are separated by a coma(,).

The default value for this property will be 0, 0, 0, 0.

This property accepts the margin as a string value, so when you use this property in the rule you can directly pass the margin value with quotes.

The syntax of using this property in the rules is

ControlName.Label.Style.Margin = “10, 0, 0, 0”

8. Font

This property is to change the font style of the text displayed in the label.

The default value for this property will be Verdana.

This property accepts the font as a string value, so when you use this property in the rule you can directly pass the font value with quotes.

The syntax of using this property in the rules is

ControlName.Label.Style.Font = “Arial”

9. Font Size

This property is to change the font size of the text displayed in the label.

The default value for this property will be 11.

This property accepts the font size as a numeric value, so when you use this property in the rule you can directly pass the font size value without quotes.

The syntax of using this property in the rules is

ControlName.Label.Style.FontSize = “15”

10. Bold

This property is to make the text displayed in the label as Bold.

The default value for this property will be false.

This property accepts the Bold as a boolean value, so when you use this property in the rule you have to pass true or false.

The syntax of using this property in the rules is

ControlName.Label.Style.Bold = true

11. Italic

This property is to make the text displayed in the label as Italic.

The default value for this property will be false.

This property accepts the Italic as a boolean value, so when you use this property in the rule you have to pass true or false.

The syntax of using this property in the rules is

ControlName.Label.Style.Italic = true

12. Underline

This property is to make the text displayed in the label as underlined.

The default value for this property will be false.

This property accepts the underline as a boolean value, so when you use this property in the rule you have to pass true or false.

The syntax of using this property in the rules is

ControlName.Label.Style.Underline = true

13. Font Color

This property is to change the font color of the text displayed in the label.

The default value for this property will be Black.

This property accepts the font color as a string value, so when you use this property in the rule you can directly pass the font color value with or without quotes. This property accepts both Hexa code and named colors.

The syntax of using this property in the rules is

ControlName.Label.Style.FontColor = “#0000FF”

14. BackGround Color

This property is to change the background color of the label.

The default value for this property will be Transparent.

This property accepts the background color as a string value, so when you use this property in the rule you can directly pass the background color value with or without quotes. This property accepts both Hexa code and named colors. Transparent can also be used if you don’t want any background color for the label.

The syntax of using this property in the rules is

ControlName.Label.Style.BackGroundColor = “#0000FF”