Skip to content

Interface: IFormCellProxy

A designer-facing interface that provides access to a formcell control.

It is passed to rules to provide access to a formcell control for application specific customizations.

In addition it provides access to the IControlProxy interface.

Hierarchy

Summary

Properties

Class Properties

Inherited Properties

Methods

Class Methods

Inherited Methods

Properties

searchString

▸ searchString: string

Returns the user provided search string for a ListPicker FormCell


visible

▸ visible: boolean

Property for viewing and setting the current visible state of the control.

Methods

clearFocus

▸ clearFocus(): void

Clear focus and close keyboard

Returns: void


createAttachmentEntry

▸ createAttachmentEntry(attachmentPath: string, entitySet: string, property: string, readLink: string, service: string, encodeURI?: boolean = true): any

Create an object for attachment entry Note: This function is for iOS & Android only

Parameters:

Name Type Description
attachmentPath string the path for the attachment file
entitySet string entity set name
property string the property of the entity set
readLink string readlink string
service string service name
encodeURI? boolean = true whether the URI need to be encoded, default value is true

Returns: any

an object with all information for the attachment entry or undefined if the attachment is invalid


dataQueryBuilder

▸ dataQueryBuilder(query: string): DataQueryBuilder

Factory method to construct an instance of DataQueryBuilder

Parameters:

Name Type Description
query string the query string

Returns: DataQueryBuilder


getCaption

▸ getCaption(): string

Returns the Caption property value defined for the control.

Overrides IControlProxy.getCaption

Returns: string


getCollection

▸ getCollection(): object[]

Get collection of ListPicker Formcell, SegmentedControl Formcell, and Filter Formcell based on the DisplayValue and ReturnValue

Returns: object[]


getEditable

▸ getEditable(): boolean

Returns the Editable property value defined for the control.

Returns: boolean


getEnable()

▸ getEnable(): boolean

Returns the Enabled property value defined for the control.

Returns: boolean

Deprecated

  • use getEnabled()

getEnabled

▸ getEnabled(): boolean

Returns the Enabled property value defined for the control.

Returns: boolean


getHelperText

▸ getHelperText(): string

Returns the HelperText property value defined for the control.

Returns: string


getRequiredIndicator

▸ getRequiredIndicator(): string

Returns the RequiredIndicator property value defined for the FormCell's control. Returns a String.

Returns: string


getRequiredIndicatorStyle

▸ getRequiredIndicatorStyle(): string

Returns the Styles.RequiredIndicator property value defined for the FormCell's control.

Returns: string


getTargetSpecifier

▸ getTargetSpecifier(): IFormCellTargetProxy

Gets target specifier for this FormCell control

Returns: IFormCellTargetProxy


getValidation

▸ getValidation(): IFormCellValidationProxy

Returns the FormCellValidationProxy for the control

Returns: IFormCellValidationProxy


getVisible

▸ getVisible(): boolean

Gets the control's visible state.

Returns: boolean

returns true if the control is visible otherwise false.


reset

▸ reset(): Promise<any>

Reset the FormCell control. The function will resolve the FormCell's properties and redraw it The OnValueChange event of the FormCell control will not be triggered after resetting

Returns: Promise<any>


setCaption

▸ setCaption(caption: string): Promise<any>

Sets the Caption property of the FormCell's control.

Parameters:

Name Type Description
caption string value to set.

Returns: Promise<any>


setEditable

▸ setEditable(isEditable: boolean): Promise<any>

Sets the Editable property of the FormCell's control.

Overrides IControlProxy.setEditable

Parameters:

Name Type Description
isEditable boolean true if this form cell is editable. False otherwise.

Returns: Promise<any>


setEnable()

▸ setEnable(isEnabled: boolean): Promise<any>

Sets the Enabled property of the FormCell's control.

Parameters:

Name Type Description
isEnabled boolean true enables and false disables.

Returns: Promise<any>

Deprecated

  • use setEnabled(isEnabled: boolean)

setEnabled

▸ setEnabled(isEnabled: boolean): Promise<any>

Sets the Enabled property of the FormCell's control.

Parameters:

Name Type Description
isEnabled boolean true enables and false disables.

Returns: Promise<any>


setFocus

▸ setFocus(keyboardVisibility: string): void

Set focus to the formcell (support Title Formcell / SimpleProperty Formcell / Note Formcell)

Parameters:

Name Type Description
keyboardVisibility string This parameter allows you to either show or hide the on-screen keyboard (setting applies only to Android devices, iOS devices will ignore this setting). Available values: - Auto (Default value. Show the on-screen keyboard only if there is no physical or bluetooth keyboard attached to the device) - AlwaysShow - AlwaysHide

Returns: void


setHelperText

▸ setHelperText(helperText: string): Promise<any>

Sets the HelperText property of the FormCell's control.

Parameters:

Name Type Description
helperText string value to set.

Returns: Promise<any>


setRequiredIndicator

▸ setRequiredIndicator(indicator: string | Boolean): Promise<any>

Sets the RequiredIndicator property of the FormCell's control. Can be either Boolean or a Character. Defaults to an asterisk * if a string longer than one character is passed in.

Parameters:

Name Type Description
indicator string | Boolean value to set.

Returns: Promise<any>


setRequiredIndicatorStyle

▸ setRequiredIndicatorStyle(requiredIndicatorStyle: string): Promise<any>

Sets the Styles.RequiredIndicator property of the FormCell's control.

Parameters:

Name Type
requiredIndicatorStyle string

Returns: Promise<any>


setTargetSpecifier

▸ setTargetSpecifier(target: IFormCellTargetProxy, redraw?: boolean): Promise<any>

Set the target specifier for this FormCell control.

Parameters:

Name Type Description
target IFormCellTargetProxy
redraw? boolean whether to redraw formcell

Returns: Promise<any>

Throws

if target is incomplete