Auto Complete Text View

Auto Complete Text View

Download PDF

Auto Complete Text View

A TextView is a complete text editor. It displays text to the user and optionally allows them to edit it. It can be either single line or multiple lines. Touching a text field places the cursor and automatically displays the keyboard.


With Configure.IT, you can extend the View with the Text View with the ease of auto completion. This control will enable you fetch the content from the data already stored.

    Keywords:
  • auto complete text
  • text view

Properties

  • Custom Border
    PARAMETER
    DESCRIPTION
    Border Width

    Sets border width for a Auto Complete Text View.

    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 Auto Complete Text View.

    Space Between Dashes For Dashed Border

    Helps set the spacing between Dashes for Dashed Border.

    Transform Angle

    Sets angle in degrees to which the Auto Complete Text View which is in its normal state, has to be rotated. Possible values for this property are -360 to 360.

  • CIT Custom Properties
    PARAMETER
    DESCRIPTION
    Allow Data From DataSource Only

    This property is for enabling auto complete text view selection from data source which was populated on "LOAD" or "Auto Complete Text View Editing" events.

    Remove Button Required

    This property specifies if remove button should be shown on selected values or not.

    Enable Single Selection

    This property specifies whether selection should be single selection or not. i.e only one value can be selected at a time if this property is enabled.

    TextView Height

    This property is for setting height of the control is you wish to set the height different from value set in "Height" property.

    Background Image

    This property is for setting background image for the control.

    textView RemoveImage

    This property is for setting image for delete button shown besides the selected value.

    textView DividerImage

    This property is for setting image to be displayed as a separator between two selected values from the list of values.

    textView DividerColor

    This property is for setting color for separator between two selected values from the list of values.

    DropDown Table Background Image

    This property is for setting image to be displayed as background for suggestions Table View of Auto Complete text view control.

    Dropdown Table Separator Image

    This property is for setting image to be displayed as separator for suggestions Table View cells of Auto Complete text view control.

    Dropdown Table BackgroundColor
    This property is for setting background color for suggestions Table View of Auto Complete text view control.
    Place Holder Text
    The string that is displayed when there is no other text in the object.
    Dropdown Table TextColor
    This property is for setting text color for search results displayed on each row of suggestions Table View shown below Auto Complete Text View.
    Dropdown Table Separator Color
    This property is for setting separator color for suggestions Table View cells of Auto Complete text view control.
    Text Field Right View Id

    This property is for setting "Object ID" of control which has to be displayed as overlay view on the right side of the text field.

  • Display/Text
    PARAMETER
    DESCRIPTION
    Font

    Sets text to be displayed on Auto Complete Text View.

    Text Color

    Used to set the color of the Auto Complete Text View.

    Text Alignment

    Used to set the alignment of the Auto Complete Text View.

    Font Family

    Sets the font of the text to be displayed.

    Font Size

    Sets the font size of the text to be displayed.

  • PARAMETER
    DESCRIPTION
    Clears Context Before Drawing
    A Boolean value that determines whether the object's bounds should be automatically cleared before drawing.
  • Advanced
    PARAMETER
    DESCRIPTION
    Clips Subviews

    A Boolean value that determines whether subviews are confined to the bounds of the control.

    Opaque

    A Boolean value that determines whether the object is transparent or not

  • Display
    PARAMETER
    DESCRIPTION
    Delays Content Touches

    A Boolean value that determines whether the Auto Complete Text View delays the handling of touch-down gestures.

    Detection

    The types of data converted to clickable URLs in the Auto Complete Text View’s content.
    Links - Opens the application responsible for handling the URL type and passes it the URL
    Address - Enables address detection.
    Phonenumber -  A Boolean value indicating whether telephone number detection is on.
    Events - Enables calendar events detection.

    Autocapitalization Type

    Sets the Auto-capitalization style for the text object.

    Autocorrection Type

    Sets the Auto-correction style for the text object.

    Keyboard Type

    Choose from the range of available types and set the keyboard style associated with the text object.

    Keyboard Appearance

    The appearance style of the keyboard that is associated with the text object. The appearance can be set as either Default or Alert.

    Return Key Type

    The contents of the “return” key can be set from the various available options as Default, Go, Google, etc. from the drop down.

    Enables Return Key Automatically

    A Boolean value indicating whether the return key is automatically enabled when the text is entered by the user.

    Indicator Style

    Choose the style from the available options for the scroll indicators.

    Shows Horizontal Scroll Indicator

    A Boolean value that controls whether the horizontal scroll is visible.

    Shows Vertical Scroll Indicator

    A Boolean value that controls whether the vertical scroll is visible.

    Scroll Enabled

    A Boolean value to enable or disable scrolling.

    Paging Enabled

    A Boolean value to enable or disable paging.

    Directional Lock Enabled
    A Boolean value that determines whether scrolling is disabled in a particular direction
    Bounces

    A Boolean value to enable or disable bounce.

    Always Bounce Horizontal

    A Boolean value to enable or disable horizontal bounce.

    Always Bounce Vertical

    A Boolean value to enable or disable vertical bounce.

    Content Mode

    A mode used to determine how a view lays out its content when its bounds change.

    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 Auto Complete Text View which ranges from 0 to 1.

    Background Color

    Used to set the background color to the Auto Complete Text 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 Auto Complete Text View.

  • Object
    PARAMETER
    DESCRIPTION
    Xpos

    Sets the X position of the Auto Complete Text View.

    YPos

    Sets the Y position of the Auto Complete Text View.

    Width

    Sets the width of the Auto Complete Text View.

    Height

    Sets the height of the Auto Complete Text View.

    Object ID

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

    Object Parent ID

    Set "Object ID" of Auto Complete Text View 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 on the control.

    Key To DataSource

    Sets “key name to datasource” for a particular part of datasource as Auto Complete Text View datasource.

    Key to Data Index

    Select the Web service key data which will be retrieved as output based on selection.

    Key Name To Data Display

    Sets key corresponding to the value in Auto Complete Text View datasource (response from web service) that has to be displayed in each row of Multiple selection Picker, if picker should have multiple components then this should be comma (,) separated string of keys pointing to values to be displayed in each component.

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

  • 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

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

Actions

  • Load

    This event is triggered on load Text View. Hence any action can be defined [for eg: when a Text View loads like API Call to load data to be shown on cells] This can be configured in "LOAD" event listed under "Action(S)" tab of Text View control.

  • Auto Complete Text View Editing

    This event is triggered when user edits "Auto Complete Text Field" or "Auto Complete Text View" control. So any actions you want perform when user edits "Auto Complete Text Field" or "Auto Complete Text View", like reloading data source of those two controls, can be configured in “Auto Complete Text View Editing” event listed in ”ACTION(S)” tab of "Auto Complete Text Field" or "Auto Complete Text View" control. “currentText” is the response parameter of “Auto Complete Text View Editing”, which is text entered by user in the control.

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

    1)currentText :- Text entered by user in the control

Remarks

  • Key Name To Data and Key To Data Index

    If Auto Complete Text Field’s data comes as an API call response then setting “Key Name To Data” property is mandatory. You need to set “Key Name To Data” property to a key from API response, which points to the value to be shown as suggestions. “Key To Data Index” property gives you the desired output value. In case the values shown in Auto Complete Text Field are repeating, this property will serve the purpose of differentiating/bifurcating. Set a key from API response which gives a value to identify each suggestion uniquely, in “Key To Data Index” property.

  • allow Data from DataSource Only

    This property is for enabling auto complete text field or text view selection from data source which was populated on "LOAD" or "Auto Complete Text View Editing" events. When this option is enabled, user can select only from search results filtered from data source associated with auto complete control; else user can select the manually typed value.

  • Remove Button

    Selected value for suggestions dropdown is added as a token to Auto Complete Text View Control, with a remove button(for removing the selected token when tapped on it). If you do not want remove button you can disable “Remove Button Required” property. You can set image for this remove button using “textView RemoveImage” property.

  • Tokens Divider Image/Color

    Selected value for suggestions dropdown is added as a token to Auto Complete Text View Control.
    Tokens will be divided by a divider, if more than one value is selected. You can customize this divider using “textView DividerImage” or “textView DividerColor” property.