Button

A Button intercepts touch events and sends an action message to a target object when tapped. The Button control can display both text and images. When the button is clicked, it looks as if it is being pushed in and released.


Configure.IT provides you with this control, allowing you to click to provide input to an application. A Button here serves as an interactive component that enables users to communicate with an application. This control receives a touch event and executes the action configured related to the events. It provides options for setting the title, image and appearance properties of a button. By using these properties, you can specify a different appearance for each Button state. You can even define an Action on Button to ease the flow of app and give that faultless handling.




    Keywords:
  • Button control
  • Button click event
  • Button in mobile jquery
  • Back button in mobile

Properties

  • Display
    PARAMETER
    DESCRIPTION
    Button State

    Set the state of Button to either of the following; normal, highlighted, selected or disabled.

    Normal Title

    The normal or default state of a control, that is enabled but neither selected nor highlighted.

    Normal Title Color

    Sets the color for the title to be used for the Normal state.

    Normal Title Shadow Color

    Sets the shadow color for the title to use for the specified state.

    Normal Image

    Sets the Image to use for the Normal state.

    Normal Background Image

    Sets the Background Image to be used for the specified Button state.

    Enabled

    A Boolean property to  indicate whether the gesture recognizer is enabled.

    Selected

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

    Highlighted

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

    Selected Title
    Sets the title to use for the Selected state.
    Highlighted Title
    Sets the title to use for the Highlighted state.
    Disabled Title
    Sets the title to use for the disabled state.
    Disabled Title Color
    Sets the color for the title to use for the disabled state.
    Selected Title Color
    Sets the color for the title to use for the Selected state.
    Highlighted Title Color
    Sets the color for the title to use for the Highlighted state.
    Disabled Title Shadow Color
    Sets the shadow color for the title to use for the disabled state.
    Selected Title Shadow Color
    Sets the shadow color for the title to use for the Selected state.
    Highlighted Title Shadow Color
    Sets the shadow color for the title to use for the Normal state.
    Disabled Image
    Sets the Image to use for the disabled state.
    Selected Image
    Sets the Image to use for the Selected state.
    Highlighted Image
    Set the image to the Object in Highlighted State
    Selected Background Image
    Sets the Background Image to use for the Selected state.
    Highlighted Background Image
    Sets the Background Image to use for the Highlighted state.
    Disabled Background Image
    Sets the Background Image to use for the disabled state.
    Content Horizontal Alignment

    Sets the horizontal alignment for content (text or image or both) of Button.

    Content Vertical Alignment

    Sets the vertical alignment for content (text or image or both) of Button.

    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 Button which ranges from 0 to 1.

    Background Color

    Used to set the background color to the Button.

    Tint Color

    It is used to visually indicate which controls on the Button are active or have an action associated with them.

    Drawable Padding

    Padding is defined as space between the edges of the view and the view's content. Drawable Padding is the padding between the drawables and the text. Sets the padding in pixels, of all four edges.

    Drawable Type

    This is Android specific attribute to use Image with Content(text).


     

  • Object
    PARAMETER
    DESCRIPTION
    Xpos

    Sets the X position of the Button.

    YPos

    Sets the Y position of the Button.

    Width

    Sets the width of the Button.

    Height

    Sets the height of the Button.

    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 Button 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
    Is Toggle Button

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

    Local Image Folder Name

    Sets the image path if image is already downloaded. e.g /Documents/Profile Images/

    Place Holder Image

    Sets dummy image to display while image data is being received from web server.

    Enable Attributed Text
    This property is for enabling attributed string as text on label.
    Transform Angle For Selected State

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

    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.

    Under Line Color

    Underline color will be the color set here and if it is not set then underline will be text color of the control, by default.




  • Display/Text
    PARAMETER
    DESCRIPTION
    Custom Font Name

    Enables HTML in Button. Allows styling of text in Button using HTML code

    Font Family

    Sets the font of the text to be displayed.

    Font Size

    Sets the font size of the text to be displayed.

    Line Break Mode

    The technique to use for wrapping and truncating the Button’s text. You can choose from Word wrap, Character wrap, Clip, Truncate head, Truncate tail and Truncate middle.

  • Custom Border
    PARAMETER
    DESCRIPTION
    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.

    Border Width

    Sets border width for a Button.

    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.

  • 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 Button.

  • Advanced
    PARAMETER
    DESCRIPTION
    Title Shadow Offset Y

    The vertical offset of the shadow used to display the Button’s title. Positive value always extend up from the user's perspective.

    Title Shadow Offset X

    The horizontal offset of the shadow used to display the Button’s title. Positive value always extend to the right from the user's perspective.

    Reverses Title Shadow When Highlighted

    If checked the checkbox, the Button title shadow changes from engrave to emboss appearance when highlighted.

    Shows Touch When Highlighted

    A Boolean value that determines whether tapping the button causes it to glow.

    Adjusts Image When Highlighted

    A Boolean value that determines whether the image changes when the button is highlighted.

    Adjusts Image When Disabled

    A Boolean value that determines whether the image changes when the button is disabled.

    Edge

    Sets the edge inset properties for the content within the button separately. i.e, there are three possible classification of button - Title, Image or Content(both image and title included). Whereas there are 4 edge properties of button which can be set separately for each content type.

    Top Image Edge Insets
    The inset or outset margins for the rectangle surrounding top of the object's image.
    Top Title Edge Insets

    Sets the inset or outset top margin for the button title. A positive value shrinks, or insets, top edge-moving it closer to the center of the button. A negative value expands, or outsets, top edge-moving it away from center of the button.

    Top Content Edge Insets
    The inset or outset margins for the rectangle surrounding top of the object's content.
    Bottom Title Edge Insets

    Sets the inset or outset bottom margin for the button title. A positive value shrinks, or insets, bottom edge-moving it closer to the center of the button. A negative value expands, or outsets, bottom edge-moving it away from center of the button.

    Bottom Image Edge Insets
    The inset or outset margins for the rectangle surrounding bottom of the object's image.
    Bottom Content Edge Insets
    The inset or outset margins for the rectangle surrounding bottom of the object's content.
    Left Image Edge Insets
    The inset or outset margins for the rectangle surrounding left of the object's image.
    Left Title Edge Insets

    Sets the inset or outset left margin for the button title. A positive value shrinks, or insets, left edge-moving it closer to the center of the button. A negative value expands, or outsets, left edge-moving it away from center of the button.

    Left Content Edge Insets
    The inset or outset margins for the rectangle surrounding left of the object's content.
    Right Content Edge Insets
    The inset or outset margins for the rectangle surrounding right of the object's content.
    Right Image Edge Insets
    The inset or outset margins for the rectangle surrounding right of the object's image.
    Right Title Edge Insets

    Sets the inset or outset right margin for the button title. A positive value shrinks, or insets, right edge-moving it closer to the center of the Button. A negative value expands, or outsets, right edge-moving it away from center of the Button.

  • Layout Setting
    PARAMETER
    DESCRIPTION
    Horizontal

    Group of horizontal android default properties.

    Vertical

    Group of vertical android default properties.

    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.

    Center In Parent

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

    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).

    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.

  • Horizontal
    PARAMETER
    DESCRIPTION
    Horizontal Group

    Group of horizontal 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

    marginLeft : Specifies extra space on the left side of this view. This space is outside this view's bounds.  
    marginRight : Specifies extra space on the right 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.

    Apply Horizontal Custom Properties

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

  • 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

    Offset Value defines the extra space value in the 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).

Actions

  • Click

    This event is triggered when user taps on the control. Hence the required Action can be configured on ‘Click’ event.

  • On Captured Screenshot

    This event is triggered on successful of captured screenshot of given view.
    Captured screenshot local image path results can be retrieved as response parameters of this event. Following are the response parameters:-
    ScreenshotImage

  • Barcode Cancel

    This event will be triggered if user cancels the scanning process, which was initiated either using "barcode" action.

  • Image Picked

    This event is triggered when user successfully selects image or video or audio.

  • Animation Completed

    This event will be triggered on completion of animation, which was initiated using either "Add Animation" or "Remove Animation" action, so any actions you want perform on animation completion can be configured in "Animation Completed" event listed in ”ACTION(S)” tab of control on which you configured “Add Animation” or "Remove Animation" action.

  • Video Finished

    This event will be fired on completion of video

  • Barcode Success

    This event is triggered on successful bar code scanning, which was initiated using "barcode" action.

Remarks

  • Toggle button

    Toggle feature is for using button as a check box (ON/OFF). Enable “Is Toggle Button” property for this feature. You need to set “Normal Image”, as an indicator for OFF state and “Selected Image”, as an indicator for ON state.

  • Normal Image / Normal Background Image

    Normal Image property adds an image/icon to button in its normal state. If title is set image will be added next to it. All of which, image and(or) title, are overlaid over the background image. If you set some title to your button too, the image will be drawn next to the title and its position will depend on the title length (and also on the Title Edge Insets / Image Edge Insets/ Content Edge Insets properties to adjust this position).


    Normal Background Image property sets the background image of the Button in its normal state. You have to use this in conjunction with “Button Type” property set to "Custom”.