Label

"Label" is a component which displays read-only text. It is generally a static control where the user can only tap on the Label and cannot change it’s content. A label is usually used to identify a nearby text box or other widget.

Configure.IT brings you this dynamic Label with distinct exclusive Actions and a range of Properties which can be implemented. You can use this control to draw one or multiple lines of static text, such as those which you may use to identify other parts of your user interface. In Configure.IT, Labels are also used to show hyperlink and attributed text with a tap, justifying its vigorous characteristic.

    Keywords:
  • Label
  • Label Control
  • iOS Label
  • Android Label
  • Read only Text
  • Label maker
  • Label parameter

Properties

  • Display
    PARAMETER
    DESCRIPTION
    Enabled
    A Boolean property that indicates whether the gesture recognizer is enabled.
    Highlighted

    A Boolean value to indicate whether the receiver should be highlighted.

    User Interaction Enabled

    Enables the Interaction with user, i.e. control responds when user taps on it.

    Alpha

    Used to set the transparency to the Label which ranges from 0 to 1.

    Highlighted Color

    Lets you enable highlighting the Text color for label in highlighted state.

    Background Color

    Used to set the background color to the Label.

  • Display/Text
    PARAMETER
    DESCRIPTION
    Text

    Sets text to be displayed on Label.

    Text Color

    Used to set the color of the Text.

    Font Family

    Sets the font of the text to be displayed.

    Font Size

    Sets the font size of the text to be displayed.

    Text Alignment

    Used to set the alignment of the text.

    Number Of Lines

    Used to set the number of lines for the text.

    Line Break Mode
    The technique to use for wrapping and truncating the label’s text.
    Adjusts Font Size To Fit

    Enabling this property lets you adjust the font size as per the dimensions of the Label.

    Minimum Font Size
    The size of the smallest permissible font with which to draw the text.
    Shadow Color
    Used to set the shadow color to the text.
    Custom Font Name

    Sets custom font name (special font, not available in default fonts) for text to be displayed in Label.

    Shadow Offset X

    Used to set the shadow offset (measured in points) in X-direction for the text.

    Shadow Offset Y

    Used to set the shadow offset (measured in points) in Y-direction for the text.

  • Custom Border
    PARAMETER
    DESCRIPTION
    Border Width

    Sets border width for a Label.

    Border Corner Radius

    Sets radius with which control's rounded corners should be drawn. Setting this property will enable  control appear with rounded corners.

    Border Color

    Sets the border color for a control. Works only if "Border Width" property is set to a value more than 0. Default would be black color.

    Dash Width For Dashed Border

    Sets width of each dash in dashed border pattern for a control.

    Space Between Dashes For Dashed Border

    Helps set the spacing between Dashes for Dashed Border.

    Transform Angle

    Sets angle in degrees to which control in its normal state has to be rotated. Possible values for this property are -360 to 360.

  • Object
    PARAMETER
    DESCRIPTION
    Xpos

    Sets the X position of the Label.

    YPos

    Sets the Y position of the Label.

    Width

    Sets the width of the Label.

    Height

    Sets the height of the Label.

    Object ID

    Sets unique identifier for the control. Control can be referenced with the name, set in this property for configuration.

    Object Parent ID

    Set "Object ID" of Label  which contains this control or can serve as parent

    Key Name To Data

    Sets the web service key from data received from web server, which corresponds to the value to be displayed in the control.

  • CIT Custom Properties
    PARAMETER
    DESCRIPTION
    Enable Marquee effect on Label

    Enables Marquee effect on Label, i.e makes text scroll across the screen.

    Enable Html Label

    Enables HTML in label. Allows styling of text in Label using HTML code.

    Enable Dynamic Height

    Boolean to allow dynamic height, based on its text content.

    Enable Dynamic Width

    Boolean to allow dynamic width, based on its text content.

    Enable Underline

    Enables underline for the text displayed on Label or button. Underline color will be the color set in "Under Line Color" property and if it is not set then underline will be text color of the control, by default.

    Enable Emoji

    Lets you enable emoticons on Label. Set emoji unicode as Label text to display emoticons.

    Enable Attributed Text

    Enables attributed string as text on Label.

    Text scrolling speed on Label

    Sets the scrolling speed of text on Label. Works only if "Enable Marquee effect on Label" property is enabled.

    Line Spacing

    Determines the amount of vertical space between the lines of text in a paragraph. Works only if "Enable Html Label" property is enabled.


     

  • Advanced
    PARAMETER
    DESCRIPTION
    Adjusts Letter Spacing To FitWidth

    As per the width, letters are adjusted along with the spacing.

    Label Text Vertical Alignment

    Used to set text alignment vertically i.e. Top, Bottom or Center.

  • Vertical
    PARAMETER
    DESCRIPTION
    Vertical Group

    Group of vertical android default properties.

    Reference Type

    These are the android default properties to set selected view with respect of other view.

    Reference Value

    Reference object that is used for positioning selected object.

    Offset Type

    marginTop : Specifies extra space on the top side of this view. This space is outside this view's bounds.  
    marginBottom : Specifies extra space on the bottom side of this view. This space is outside this view's bounds.

    Offset Value

    Value defines the extra space value in pixel.

    Center Vertical

    This property centers the child vertically with respect to the bounds of its parent view.

    Apply Vertical Custom Properties

    If any of the vertical layout setting parameter(s) are selected then this value is selected to indicate user applied vertical custom layout setting parameter(s).

  • Horizontal
    PARAMETER
    DESCRIPTION
    Horizontal Group

    Group of horizontal android default properties.

    Reference Type

    Reference type is the the default property to set selected view with respect to other view.

    Reference Value

    Reference object that is used for positioning selected object.

    Offset Type

    marginTop : Specifies extra space on the top side of this view. This space is outside this view's bounds.  
    marginBottom :
    Specifies extra space on the bottom side of this view. This space is outside this view's bounds.

    Offset Value

    Offset Value defines the extra space value in the pixel.

    Center Horizontal

    This property centers the child horizontally with respect to the bounds of its parent view.

  • Display/AdvanceText
    PARAMETER
    DESCRIPTION
    Hide

    Hiding an element can be done by checking ‘Hide’. This property lets you hide the control.


    Advance - Sets auto resizing with respect to superview, for Label.

  • Layout Setting
    PARAMETER
    DESCRIPTION
    Horizontal

    Group of horizontal android default properties.

    Vertical

    Group of vertical android default properties.

    Layout Width

    Sets the width of the view
    match_parent/fill_parent :Takes the width as its parent view
    wrap_content : Takes the width as its content’s width

    Layout Height

    Sets the height of the view
    match_parent/fill_parent : Takes the height as its parent view
    wrap_content : Takes the height as its content’s height

    Left

    The padding is expressed in pixels for the left, top, right and bottom parts of the view. Padding can be used to offset the content of the view by a specific amount of pixels.

    For instance, a Left value of 2 will push the view's content by 2 pixels to the right of the left edge.

    Right

    For instance, a Right value of 2 will push the view's content by 2 pixels to the left of the right edge.

    Top

    For instance, a Top value of 2 will push the view's content by 2 pixels to the bottom of the top edge.

    Bottom

    For instance, a Bottom value of 2 will push the view's content by 2 pixels to the top of the bottom edge.

    Apply Custom Properties

    If any of the layout setting parameter(s) are selected then this value is selected to indicate user applied custom layout setting parameter(s).

    Center In Parent

    This property centers the child vertically with respect to the bounds of its parent view.

    Default Min Height

    The height of the view cannot be less than the given value.
    If user select “Default Min Height”  then android default value is taken otherwise it takes 0dp.

    Default Min Width

    The width of the view cannot be less than the given value.
    If user select “Default Min Width” then android default value is taken otherwise it takes 0dp.

Actions

  • Single Finger Single Tap

    Fired when Label is tapped once with a single finger.

  • On Single Finger Long Press

    Fired when there is an elongated press on Label with single finger.

  • On Single Finger Swipe Down

    Fired when Label is swiped down with single finger.

  • On Single Finger Swipe Left

    Fired when Label is swiped left with single finger.

  • On Single Finger Swipe Right

    Fired when Label is swiped right with single finger.

  • On Single Finger Swipe Up

    Fired when Label is swiped up with single finger.

  • Single Finger Double Tap

    Fired when Label is tapped twice with a single finger.

  • Single Finger Triple Tap

    Fired when label is tapped thrice with a single finger.

  • Link Clicked

    Fired when a hyperlink is clicked in the HTML text displayed in label.

  • On Double Finger Long Press

    Fired when there is an elongated press on Label with two fingers.

  • Action Sheet selected

    This event is triggered when user taps a button on action sheet, which was presented using “Show ActionSheet” action, so any actions you want perform when action sheet button is tapped can be configured in “Action Sheet selected” event listed in ”ACTION(S)” tab of the control on which you have configured “Show ActionSheet” action. “seletedButtonIndex” is the response parameter of “Action Sheet selected” which indicates which button is tapped by user. Add condition for checking value of “seletedButtonIndex” response parameter value in order to configure actions for each button of action sheet separately.

    Following are the response parameter for "Action Sheet selected" event :-

    1)selectedButtonIndex :- Index of the tapped button

    2)selectedButtonTitle :- Title of the tapped button

  • Calendar Event Added or Edited

    This event is triggered when calendar event is successfully added or edited using o“Add or edit event” action, so any actions you want to perform on success can be configured in “Calendar Event Added Or Edited” event listed in ”ACTION(S)” tab of the control on which you have configured “Add or edit event” action. Response parameter for “Calendar Event Added Or Edited” event is "event_identifier" of event added or edited.

    Following are the response parameters for this event :-

    1) event_identifier :- Identifier of added or edited event

  • On Double Finger Swipe Down

    Fired when Label is swiped down with two fingers.

  • On Double Finger Swipe Left

    Fired when Label is swiped left with two fingers.

  • On Double Finger Swipe Right

    Fired when Label is swiped right with two fingers.

  • On Double Finger Swipe Up

    Fired when Label is swiped up with two fingers.

  • On Double Finger Pan

    Fired when Label is panned (sweeped) with two fingers.

  • Double Finger Double Tap

    Fired when Label is tapped twice with two fingers.

  • Double Finger Single Tap

    Fired when Label is tapped once with two fingers.

  • Double Finger Triple Tap

    Fired when Label is tapped thrice with two fingers.

Remarks

  • Attributed Text

    This features lets you apply sets of attributes (font, color, size) to individual characters or range of characters in label text string. This feature is useful when you want to highlight a part of label text using different color and(or) font style. For enabling this feature enable “Enable Attributed Text” property. You are required to set text with proper syntax for this to work. For example :-   “<font  color="#c5c5c5" face="EngraversGothic BT">text1</font>”,  “<font  color="#FF0000" face=“Helvetica Neue”>text1</font>   <font  color="#c5c5c5" face=“Helvetica Neue Bold”>text2</font>”

  • Marquee effect

    Marquee animation can be added to Label control by enabling “ Enable Marquee effect on Label” property. This lets label text to scroll across the screen.

  • HTML

    Label text can be formatted using HTML. This can be done by enabling “Enable Html Label” property. Make sure the text you set to the label is a valid HTML code. If HTML code has a href tag i.e, link, it is clickable and an event “Link Clicked” will be fired. Here you can configure actions you want to perform when user clicks the link.

  • Dynamic Height

    Configure.IT provides you with this unique feature which lets Label’s height to be set in run time based on its text content. This feature can be added to Label by enabling “Enable Dynamic Height” property. If dynamic height label resides in table cell and you want to set the height of the cell depending upon the label’s height then, you need to enable “Dynamic Height Enable In Cell” property and set “Dynamic Cell Base ID” property of Table Cell to dynamic height Label.

  • Dynamic Width

    We have dynamic width feature which lets Label’s width to be set in run time based on its text content. This feature can be added to Label by enabling “ Enable Dynamic Width” property.

  • Emojis

    This feature lets you display emoticons on Label. You need to a have a valid unicode as Label’s text to display emoticons on it. E.g, \U0001F431, ue024 U+1F550 U+1F550. This can be enabled by enabling “Enable Emoji” property.

  • 2 lines/ multiple lines

    For displaying label text in 2 or more lines you need to use “Number Of Lines” property. If you want number of lines should be set according to text content of label then set “Number Of Lines” property to o.