pf.ComboBox

pf.ComboBox

ComboBox


Properties

AdditionalFields

AllowClear

AllowDuplicates

AllowUserValues

AutoEvaluateText

BackColor

BackupValue

BackupValueSet

Border

BorderRadius

BoxShadow

BubbleChangeEvent

ClassName

ClearView

ClientFilterResults

Comments

CssClear

Cursor

DefaultValueProvider

DetailContainer

DetailDataItem

DropDownAutoWidth

Enabled

EnabledFormula

EqualityComparer

ExtraStyle

Float

FontBold

FontFamily

FontItalics

FontSize

ForeColor

FriendlyName

GroupFieldName

Height

HiddenElement

IgnoreControlDependencies

LookupDisplayField

LookupValueField

LookupValuesProvider

ManualDependencies

ManualEnabledState

ManualVisibleState

Margin

MaxHeight

MaxSelectionCount

MaxWidth

Metadata

MetadataText

MinFilterLength

MinHeight

MinWidth

MinimumResultsForSearch

Multiple

Name

OfflineStaticLookupProvider

Opacity

Overlay

OverlayOpacity

Padding

Parent

ParentExtraStyle

ParentHorizontalAlignment

ParentVerticalAlignment

Placeholder

PrintExtraStyle

Printable

QueryTimeout

Required

ReturnValueField

Serializable

ShowClearAllValuesButton

Sorted

StaticValue

SuspendChangeEvent

Tag

TargetDataItem

TargetDataItemFieldName

TargetFieldName

TextAlign

TextSearchMode

Tooltip

TooltipConfiguration

UID

ValidationGroup

ValueConverter

ValueFormatter

ValueProviders

VerticalAlignment

VisibilityFormula

Visible

Width

AllDesignTimeSettings

CachedComboHeight

TargetFieldNamePropertyName

Methods

AddClass

AddClassName

AddManualDependency

ApplyBackupValue

ApplyDefaultValue

ClearAsReadonly

Clone

Close

Destroy

EvaluateValue

FixHeight

GetActualHeight

GetActualHeightHidden

GetActualWidth

GetAllChildrenControls

GetAsyncLoadedControls

GetBackColor

GetBorder

GetBorderRadius

GetBoxShadow

GetChild

GetChildren

GetClassName

GetControl

GetControlAsync

GetControlById

GetControlByTargetFieldName

GetControlByTargetFieldNameAsync

GetControlValue

GetControlsById

GetCssClear

GetCursor

GetDependencies

GetDisplayValue

GetExtraStyle

GetFloat

GetFontBold

GetFontFamily

GetFontItalic

GetFontSize

GetForeColor

GetHeight

GetLookupProvider

GetMargin

GetMaxHeight

GetMaxWidth

GetMinHeight

GetMinWidth

GetNumberFormattedValue

GetNumericValue

GetOffsetTop

GetOpacity

GetOverlay

GetOverlayOpacity

GetPadding

GetParentActualHeight

GetParentActualWidth

GetParentControl

GetParentForm

GetParentFormOrSelf

GetPrintExtraStyle

GetPrintValue

GetRootControl

GetRootForm

GetTextAlign

GetTooltip

GetTooltipConfiguration

GetValue

GetValuePath

GetVerticalAlignment

GetVisible

GetWidth

GroupResults

HasChild

HasClass

IsEnabled

IsLoaded

IsRequired

IsVisible

LoadLookupValues

Open

RemoveClass

RemoveClassName

ScrollIntoView

Select

SetAllowDuplicates

SetAsReadonly

SetBackColor

SetBorder

SetBorderRadius

SetBoxShadow

SetClassName

SetClientFilterResults

SetControlValue

SetCssClear

SetCursor

SetEnabled

SetEnabledRecursive

SetExtraStyle

SetFloat

SetFontBold

SetFontFamily

SetFontItalics

SetFontSize

SetForeColor

SetHeight

SetLoaded

SetLookupProvider

SetMargin

SetMaxHeight

SetMaxWidth

SetMetadataText

SetMinFilterLength

SetMinHeight

SetMinWidth

SetMultiple

SetOpacity

SetOverlay

SetOverlayOpacity

SetPadding

SetPrintExtraStyle

SetQueryTimeout

SetRequired

SetReturnValueField

SetStaticData

SetTextAlign

SetTextSearchMode

SetTooltip

SetTooltipConfiguration

SetValue

SetVerticalAlignment

SetVisible

SetWidth

ShouldAddGlobalCssClass

SupportsUserEdit

SwitchClass

ToNormalMode

ToNormalModePrintable

ToPrintMode

ToPrintModePrintable

ToViewMode

ToggleClass

WaitForAsyncControlsToLoad

WithAllowDuplicates

WithClientFilterResults

WithMinFilterLength

WithMultiple

WithOnItemFormat

WithOnResultItemFormat

WithQueryTimeout

WithReturnValueField

WithTextSearchMode

_LoadData

_SetData

toJSON

ComboBoxEqualityComparer

CreatePropertiesFromHtmlAttributes

FromJSON

FromJSON2

Events

OnBeginEvaluateValue

OnControlAdded

OnLoaded

OnLookupLoaded

OnLookupLoading

OnOpening

OnSelecting

OnUnselecting

OnValueChangedFromUI

OnValueLoaded

Properties


AdditionalFields

: string[]



AllowClear

: boolean
= true

Allows the user to clear the selection



AllowDuplicates

: boolean
= false

Defines if the combobox allows the user to select the same value multiple times
It this is done, a unique identifier will be automatically created for the duplicate items



AllowUserValues

: boolean
= false

Allows the user to enter own values



AutoEvaluateText

: boolean

Inherited from BaseControl.AutoEvaluateText



BackColor

: string

Sets the background color for the control
Used during control initialization

Inherited from BaseControl.BackColor

Example
var c = new pf.TextBox({BackColor: "gray"});


BackupValue

: any

Inherited from LookupDataControl.BackupValue



BackupValueSet

: boolean

Inherited from LookupDataControl.BackupValueSet



Border

: string

Sets the border for the control
Used during control initialization

Inherited from BaseControl.Border

Example
var c = new pf.Label({Border: "1px solid #aaa"});


BorderRadius

: string

Sets the border radius for the control
Used during control initialization

Inherited from BaseControl.BorderRadius

Example
var c = new pf.TextBox({BorderRadius: "3px"});


BoxShadow

: string

Defines the css box-shadow for the control
Used during control initialization

Inherited from BaseControl.BoxShadow

Example
var c = new pf.TextBox({BoxShadow: "inset 0px 1px 0px #fff"});


BubbleChangeEvent

: boolean
= false

Defines if the OnValueChange event of the control will trigger the OnValueChange event of the parent form

Inherited from DataControl.BubbleChangeEvent

Example
var c = new pf.TextBox({BubbleChangeEvent: true});


ClassName

: string

Sets the css class name for the control
Used during control initialization

Inherited from BaseControl.ClassName

Example
var c = new pf.TextBox({ClassName: "navbar"});


ClearView

: boolean



ClientFilterResults

: boolean



Comments

: string

Inherited from BaseControl.Comments



CssClear

: string

Defines the css clear for the control
Used during control initialization

Inherited from BaseControl.CssClear

Example
var c = new pf.TextBox({CssClear: "both"});


Cursor

: string

Sets the cursor for the control
Used during control initialization
Corresponds to the css cursor object, so available values are all css values (crosshair, default, grab, pointer, text, etc)

Inherited from BaseControl.Cursor

Example
var c = new pf.TextBox({Cursor: "pointer"});


DefaultValueProvider

: any

Includes source code that should return the default value for this control
The default value will be set in the control when the ApplyDefaultValue method is called

Inherited from DataControl.DefaultValueProvider

Example
var c = new pf.TextBox({DefaultValueProvider: "return new Date();"});


DetailContainer

: any

This property holds the control that contains the parent form of the control
in cases that the form is created dynamically.
For example, when a listbox control generates each row, a new form is created for each row of the listbox.
Each control holds a reference of the parent listbox in the "DetailContainer" property.
This enables the control to perform actions using data outside of its form environment.

Inherited from BaseControl.DetailContainer

Example
 
// Access the value of a control in the root form
// the OnClick event of a button inside a listbox row
var parentListbox = args.Sender.DetailContainer;
var rootForm = parentListbox.GetParentForm();
var value = rootForm.GetControl("Date").GetValue();


DetailDataItem

: any

This property holds a reference to the object from a listbox datasource used to create the current row.
It is available in all controls inside a listbox row

Inherited from BaseControl.DetailDataItem



: boolean
= false

Sets that the combobox dropdown will auto size according to content width



Enabled

: boolean
= true

Sets if the control is enabled or not
Used during control initialization

Inherited from BaseControl.Enabled

Example
var c = new pf.TextBox({Enabled: false});


EnabledFormula

: string

Defines a javascript formula that will define when the control is enabled
The formula is automatically re-evaluated each time a control that is referenced in the formula changes its value

Inherited from BaseControl.EnabledFormula

Example
var formula = "form.GetControl(\"activeCheckbox\").GetValue()";
var c = new pf.Button({EnabledFormula: formula});
Example
// Formula
form.GetControl("checkbox").GetValue() && form.GetControl("Name") != ""


EqualityComparer

:

Inherited from DataControl.EqualityComparer



ExtraStyle

: string

Sets any extra css styles to the control
Used during control initialization

Inherited from BaseControl.ExtraStyle

Example
var c = new pf.Label({ExtraStyle: "margin-left:20px;background-color:#ccc"});


Float

: string

Defines the css float for the control
Used during control initialization

Inherited from BaseControl.Float

Example
var c = new pf.TextBox({Float: "right"});


FontBold

: boolean
= false

Sets if the control font is bold
Used during control initialization

Inherited from BaseControl.FontBold

Example
var c = new pf.Label({FontBold: true});


FontFamily

: string

Sets the font family for the control
Used during control initialization

Inherited from BaseControl.FontFamily

Example
var c = new pf.Label({FontFamily: "Arial"});


FontItalics

: boolean
= false

Sets if the control font style is italic
Used during control initialization

Inherited from BaseControl.FontItalics

Example
var c = new pf.Label({FontItalics: true});


FontSize

: string

Sets the font-size for the control
Used during control initialization

Inherited from BaseControl.FontSize

Example
var c = new pf.Label({FontSize: "20px"});


ForeColor

: string

Sets the foreground color for the control
Used during control initialization

Inherited from BaseControl.ForeColor

Example
var c = new pf.TextBox({ForeColor: "blue"});


FriendlyName

: string

Inherited from DataControl.FriendlyName



GroupFieldName

: string

Defines the property from the data source that will be used to group items



Height

: string

Sets the height for the control
Used during control initialization.

Inherited from BaseControl.Height

Example
var c = new pf.ListBox({Height: "150px"});


HiddenElement

: HTMLElement



IgnoreControlDependencies

: string

Inherited from BaseControl.IgnoreControlDependencies



LookupDisplayField

: string
=

Defines the property of the data source items that represents the display field for each item
Used during control initialization

Inherited from LookupDataControl.LookupDisplayField

Example
var cmb = new pf.ComboBox({LookupValueField: "Id", LookupDisplayField: "Name"});


LookupValueField

: string
=

Defines the property of the data source items that represents the unique identifier for each item
Used during control initialization

Inherited from LookupDataControl.LookupValueField

Example
var cmb = new pf.ComboBox({LookupValueField: "Id", LookupDisplayField: "Name"});


LookupValuesProvider

: IDataProvider

Inherited from LookupDataControl.LookupValuesProvider



ManualDependencies

: any

Inherited from BaseControl.ManualDependencies



ManualEnabledState

: boolean

Inherited from BaseControl.ManualEnabledState



ManualVisibleState

: boolean

Inherited from BaseControl.ManualVisibleState



Margin

: string

Sets the css margin for the control
Used during control initialization

Inherited from BaseControl.Margin

Example
var c = new pf.Label({Margin: "10px"});


MaxHeight

: string

Sets the maximum height for the control
Used during control initialization

Inherited from BaseControl.MaxHeight

Example
var c = new pf.ListBox({MaxHeight: "300px"});


MaxSelectionCount

: number
= null (no limit is applied)

Defines the maximum number of items the user may select in a multi-select enabled combobox



MaxWidth

: string

Sets the maximum width for the control
Used during control initialization

Inherited from BaseControl.MaxWidth

Example
var c = new pf.TextBox({MaxWidth: "200px"});


Metadata

: string

Inherited from BaseControl.Metadata



MetadataText

: string

Inherited from BaseControl.MetadataText



MinFilterLength

: number
= 0

Defines how may characters the user must provide to trigger search
Zero means that no input is required

Example
var cmb = new pf.ComboBox({MinFilterLength: 2});


MinHeight

: string

Sets the minimum height for the control
Used during control initialization

Inherited from BaseControl.MinHeight

Example
var c = new pf.Button({MinHeight: "20px"});


MinWidth

: string

Sets the minimum width for the control
Used during control initialization

Inherited from BaseControl.MinWidth

Example
var c = new pf.Button({MinWidth: "40px"});


MinimumResultsForSearch

: string



Multiple

: boolean
= false

Defines if the combobox will allow the user to select multiple values

Example
var cmb = new pf.ComboBox({Multiple: true});


Name

: string

The name of the control

Inherited from BaseControl.Name



OfflineStaticLookupProvider

: boolean

Inherited from LookupDataControl.OfflineStaticLookupProvider



Opacity

: string

Sets the opacity for the control
Used during control initialization

Inherited from BaseControl.Opacity

Example
var c = new pf.Label({Text: "My Label", Opacity: "0.4"});


Overlay

: boolean

Inherited from BaseControl.Overlay



OverlayOpacity

: string

Inherited from BaseControl.OverlayOpacity



Padding

: string

Sets the padding for the control
Used during control initialization

Inherited from BaseControl.Padding

Example
var c = new pf.Label({HtmlElement: "div", Padding: "10px"});


Parent

: IControl

Inherited from BaseControl.Parent



ParentExtraStyle

: string

Inherited from BaseControl.ParentExtraStyle



ParentHorizontalAlignment

: string

Inherited from BaseControl.ParentHorizontalAlignment



ParentVerticalAlignment

: string

Inherited from BaseControl.ParentVerticalAlignment



Placeholder

: string

The text placeholder
Used during control initialization

Example
var cmb = new pf.ComboBox({Placeholder: "Please select a value"});


PrintExtraStyle

: string

Inherited from BaseControl.PrintExtraStyle



Printable

: boolean

Inherited from BaseControl.Printable



QueryTimeout

: number
= 0 (ms)

Defines the time (in milliseconds) the control will wait for user input before triggering search for results

Example
var cmb = new pf.ComboBox({QueryTimeout: 2000};


Required

: boolean

Defines if the data control must contain a value
This is used when calling the Validate method of the parent form object
Used during control initialization

Inherited from DataControl.Required



ReturnValueField

: boolean



Serializable

: boolean
= true

Indicates if the control should be serialized in the designer
For controls that are created dynamically during runtime, the user may set this property to true to avoid them being serialized

Inherited from BaseControl.Serializable



ShowClearAllValuesButton

: boolean
= false

Defines if a clear button will be available (used when the combobox accepts multiple selection)



Sorted

: boolean
= false

Defines if the item data will be automatically sorted by using the LookupDisplayField



StaticValue

: any

Inherited from DataControl.StaticValue



SuspendChangeEvent

: boolean
= false

Suspends the control from firing the OnValueChanged event

Inherited from DataControl.SuspendChangeEvent



Tag

: any

An object that can be used as a placeholder of dynamic properties a user may set to a control during runtime

Inherited from BaseControl.Tag



TargetDataItem

: any

Inherited from DataControl.TargetDataItem



TargetDataItemFieldName

: string

Inherited from DataControl.TargetDataItemFieldName



TargetFieldName

: string

Inherited from DataControl.TargetFieldName

Example
// Create a new form
var form = new pf.Form();
// Add a simple container in the form body
var container = new pf.SimpleContainer();
form.AddControl(container);
// Create 3 textboxes with different TargetFieldName properties
var textID = new pf.TextBox({TargetFieldName: "ID"});
var textName = new pf.TextBox({TargetFieldName: "Name"});
var textType = new pf.TextBox({TargetFieldName: "Type"});
// Add the textboxes in the container
container.AddControl(textID);
container.AddControl(textName);
container.AddControl(textType);
var value = form.GetValue();
// Returns something like : {ID: "my id", Name: "my name", Type: "my type"}


TextAlign

: string

Defines the css text alignment for the control
Used during control initialization

Inherited from BaseControl.TextAlign

Example
var c = new pf.TextBox({TextAlign: "center"});


TextSearchMode

: TextSearchModes



Tooltip

: string

Sets the tooltip for the control

Inherited from BaseControl.Tooltip

Example
var c = new pf.TextBox({Tooltip: "The address of the customer"});


TooltipConfiguration

: ITooltipOptions

Inherited from BaseControl.TooltipConfiguration



UID

: string
= A new GUID is generated for each control

A unique identifier for the control
Used during control initialization

Inherited from BaseControl.UID



ValidationGroup

: string

Inherited from DataControl.ValidationGroup



ValueConverter

: DynamicUserFunction

Inherited from DataControl.ValueConverter



ValueFormatter

: DynamicUserFunction

Inherited from DataControl.ValueFormatter



ValueProviders

: IDataProvider[]

Inherited from DataControl.ValueProviders



VerticalAlignment

: string

Inherited from BaseControl.VerticalAlignment



VisibilityFormula

: string

Defines a javascript formula that will define when the control is visible
The formula is automatically re-evaluated each time a control that is referenced in the formula changes its value

Inherited from BaseControl.VisibilityFormula

Example
var formula = "form.GetControl(\"activeCheckbox\").GetValue()";
var c = new pf.Button({VisibilityFormula: formula});
Example
// Formula
form.GetControl("checkbox").GetValue() && form.GetControl("Name") != ""


Visible

: boolean
= true

Sets if the control is visible or not
Used during control initialization

Inherited from BaseControl.Visible

Example
var c = new pf.TextBox({Visible: false});


Width

: string

Sets the width of the control
Used during control initialization

Inherited from BaseControl.Width

Example
var c = new pf.TextBox({Width: "100px"});


AllDesignTimeSettings

: IDesignTimeSettings



CachedComboHeight

: number



TargetFieldNamePropertyName

: string

Inherited from DataControl.TargetFieldNamePropertyName


Methods


AddClass

(className: string[])
: void
Inherited from BaseControl.AddClass




AddClassName

(cls: string)
: void
Adds a css class to a control

Inherited from BaseControl.AddClassName

Example
form.GetControl("Title").AddClassName("active");



AddManualDependency

(name: string, dep: IControlDependency)
: void
Inherited from BaseControl.AddManualDependency




ApplyBackupValue

()
: void
Inherited from LookupDataControl.ApplyBackupValue




ApplyDefaultValue

(value: any)
: void
Applies a default value for the data control

Inherited from DataControl.ApplyDefaultValue




ClearAsReadonly

(exceptions: string[])
: void
Inherited from BaseControl.ClearAsReadonly




Clone

()
: BaseControl
Inherited from BaseControl.Clone




Close

()
: void



Destroy

()
: void



EvaluateValue

(options: any, callback: any)
: void
For data controls that have value data providers set, calling this method forces a re-execution
of value provider(s). Value provider conditions will be re-evaluated

Inherited from DataControl.EvaluateValue




FixHeight

()
: void



GetActualHeight

()
: number



GetActualHeightHidden

()
: number



GetActualWidth

()
: number
Inherited from BaseControl.GetActualWidth




GetAllChildrenControls

()
:
Returns all children controls for this control

Inherited from BaseControl.GetAllChildrenControls

Example
var children = c.GetAllChildrenControls();



GetAsyncLoadedControls

()
:
Inherited from BaseControl.GetAsyncLoadedControls




GetBackColor

()
: string
Inherited from BaseControl.GetBackColor




GetBorder

()
: string
Inherited from BaseControl.GetBorder




GetBorderRadius

()
: string
Inherited from BaseControl.GetBorderRadius




GetBoxShadow

()
: string
Inherited from BaseControl.GetBoxShadow




GetChild

(name: string)
: IControl
Returns the first child control (direct child) that has a specific name
Search is case sensitive

Inherited from BaseControl.GetChild

Example
var control = container.GetChild("TitleTextBox");



GetChildren

()
:
Inherited from DataControl.GetChildren




GetClassName

()
: string
Inherited from BaseControl.GetClassName




GetControl

(name: string)
: IControl
Returns the first child control (recursively) that has a specific name
Search is case sensitive

Inherited from BaseControl.GetControl

Example
var control = container.GetControl("TitleTextBox");



GetControlAsync

(name: string, callback: , maxTime: number)
: void
Searches for a child control asynchronously in cases that child controls are loaded at a later stage.
This could happen when dynamic loading Template controls.
Default time is 3000 (ms)

Inherited from BaseControl.GetControlAsync

Example
form.GetControlAsync("clientId", function(control) {
if (control) control.SetEnabled(false);
}, 2000);



GetControlById

(id: string)
: IControl
Returns the first child control (recursively) that has a specific UID

Inherited from BaseControl.GetControlById

Example
var control = container.GetControlById("ID1");



GetControlByTargetFieldName

(name: string)
: IDataControl
Returns a control by its TargetFieldName property

Inherited from BaseControl.GetControlByTargetFieldName

Example
var c = form.GetControlByTargetFieldName("CustomerType");



GetControlByTargetFieldNameAsync

(name: string, callback: , maxTime: number)
: void
Inherited from BaseControl.GetControlByTargetFieldNameAsync




GetControlValue

()
: any



GetControlsById

(uid: string)
:
Returns child controls (recursively) that have a specific UID

Inherited from BaseControl.GetControlsById

Example
var controls = container.GetControlsById("ID1");



GetCssClear

()
: string
Inherited from BaseControl.GetCssClear




GetCursor

()
: string
Inherited from BaseControl.GetCursor




GetDependencies

(name: string)
: IControlDependency
Inherited from BaseControl.GetDependencies




GetDisplayValue

()
: any
Inherited from DataControl.GetDisplayValue




GetExtraStyle

()
: string
Inherited from BaseControl.GetExtraStyle




GetFloat

()
: string
Inherited from BaseControl.GetFloat




GetFontBold

()
: boolean
Inherited from BaseControl.GetFontBold




GetFontFamily

()
: string
Inherited from BaseControl.GetFontFamily




GetFontItalic

()
: boolean
Inherited from BaseControl.GetFontItalic




GetFontSize

()
: string
Inherited from BaseControl.GetFontSize




GetForeColor

()
: string
Inherited from BaseControl.GetForeColor




GetHeight

()
: string
Returns the height of the control

Inherited from BaseControl.GetHeight




GetLookupProvider

()
: IDataProvider
Inherited from LookupDataControl.GetLookupProvider




GetMargin

()
: string
Returns the css margin of the control

Inherited from BaseControl.GetMargin




GetMaxHeight

()
: string
Inherited from BaseControl.GetMaxHeight




GetMaxWidth

()
: string
Inherited from BaseControl.GetMaxWidth




GetMinHeight

()
: string
Inherited from BaseControl.GetMinHeight




GetMinWidth

()
: string
Inherited from BaseControl.GetMinWidth




GetNumberFormattedValue

(value: number, format: string, decimals: number, min: number, max: number)
: string
Inherited from DataControl.GetNumberFormattedValue




GetNumericValue

()
: number
Returns the value of a data control converted to a number or zero is no conversion can be performed

Inherited from DataControl.GetNumericValue

Example
var amount = form.GetControl("Amount").GetNumericValue() * 100;



GetOffsetTop

()
: number
Inherited from BaseControl.GetOffsetTop




GetOpacity

()
: string
Inherited from BaseControl.GetOpacity




GetOverlay

()
: boolean
Inherited from BaseControl.GetOverlay




GetOverlayOpacity

()
: string
Inherited from BaseControl.GetOverlayOpacity




GetPadding

()
: string
Returns the css padding of the control

Inherited from BaseControl.GetPadding




GetParentActualHeight

()
: number
Inherited from BaseControl.GetParentActualHeight




GetParentActualWidth

()
: number
Inherited from BaseControl.GetParentActualWidth




GetParentControl

(name: string)
: IControl
Inherited from BaseControl.GetParentControl




GetParentForm

()
: Form
Returns the parent form object

Inherited from BaseControl.GetParentForm

Example
var parent = c.GetParentForm();



GetParentFormOrSelf

()
: Form
Returns the parent form object or self if the referenced control is a Form object

Inherited from BaseControl.GetParentFormOrSelf

Example
var parent = c.GetParentFormOrSelf();



GetPrintExtraStyle

()
: string
Inherited from BaseControl.GetPrintExtraStyle




GetPrintValue

()
: string



GetRootControl

()
: any
Returns the root Html element for this control

Inherited from BaseControl.GetRootControl




GetRootForm

()
: Form
Inherited from BaseControl.GetRootForm




GetTextAlign

()
: string
Inherited from BaseControl.GetTextAlign




GetTooltip

()
: string
Inherited from BaseControl.GetTooltip




GetTooltipConfiguration

()
: ITooltipOptions
Inherited from BaseControl.GetTooltipConfiguration




GetValue

(path: string)
: any



GetValuePath

(path: string, sep: string)
: any
When the returned value is a complex type, GetValuePath evaluates the provided path

Inherited from DataControl.GetValuePath

Example
// Get the value from a control that returns a single object (like a combobox)
var value = form.GetControl("Country");
// returns {ID: 1, Name: "UK"}
var result = form.GetControl("Country").GetValuePath("Name");
// returns "UK"
var result = form.GetControl("Country").GetValuePath("ID");
// returns "1"
Example
// Get the value from a control that returns multiple objects (like a combobox with miltiple selection enabled)
var value = form.GetControl("Countries");
// returns [{ID: 1, Name: "UK"},{ID: 2, Name: "France"}]
var result = form.GetControl("Counties").GetValuePath("Name", ", ");
// returns "UK, France"
var result = form.GetControl("Counties").GetValuePath("ID", ";");
// returns "1;2"



GetVerticalAlignment

()
: string
Inherited from BaseControl.GetVerticalAlignment




GetVisible

()
: boolean
Inherited from BaseControl.GetVisible




GetWidth

()
: string
Inherited from BaseControl.GetWidth




GroupResults

(data: any[])
:



HasChild

(c: BaseControl)
: boolean
Inherited from BaseControl.HasChild




HasClass

(className: string)
: boolean
Returns true if the control has a specific class

Inherited from BaseControl.HasClass




IsEnabled

()
: boolean
Inherited from BaseControl.IsEnabled




IsLoaded

()
: boolean
Inherited from BaseControl.IsLoaded




IsRequired

()
: boolean
Returns if the control is required

Inherited from DataControl.IsRequired




IsVisible

()
: boolean
Inherited from BaseControl.IsVisible




LoadLookupValues

(additionalSpecs: any[], force: boolean, callback: any)
: void



Open

()
: void



RemoveClass

(className: string[])
: void
Inherited from BaseControl.RemoveClass




RemoveClassName

(cls: string)
: void
Removes a css class from a control

Inherited from BaseControl.RemoveClassName

Example
form.GetControl("Title").RemoveClassName("active");



ScrollIntoView

()
: void
Inherited from BaseControl.ScrollIntoView




Select

(fieldName: string, fieldValue: any, clear: boolean)
: void
Used to select an item in the combobox, only knowing one of its field values
To do that, the data of the combobox lookup provider must be pre-loaded
This may happen if a static data provider is selected or the data are preloaded (using the Preload property of the data provider)

Example
combobox.Select("ID", "23");



SetAllowDuplicates

(allowDuplicates: boolean)
: void
Enabled or disables duplicate values in the combobox (if multiple selection is enabled)

Example
form.GetControl("combo1").SetAllowDuplicates(true);



SetAsReadonly

(exceptions: string[])
: void
Disables all children controls

Inherited from BaseControl.SetAsReadonly




SetBackColor

(color: string)
: void



SetBorder

(border: string)
: void
Sets the css border for the control

Inherited from BaseControl.SetBorder

Example
form.GetControl("Name").SetBorder("1px solid #aaa");



SetBorderRadius

(radius: string)
: void
Sets the css border radius for the control

Inherited from BaseControl.SetBorderRadius

Example
form.GetControl("Name").SetBorderRadius("3px");



SetBoxShadow

(value: string)
: void
Sets the css box dhadow for the control

Inherited from BaseControl.SetBoxShadow

Example
form.GetControl("Name").SetBoxShadow("inset 0px 1px 0px #fff");



SetClassName

(cls: string)
: void
Sets the css class for a control

Inherited from BaseControl.SetClassName

Example
form.GetControl("Title").SetClassName("active");



SetClientFilterResults

(clientFilterResults: boolean)
: void



SetControlValue

(value: any)
: boolean



SetCssClear

(clear: string)
: void
Sets the css clear for the control

Inherited from BaseControl.SetCssClear

Example
form.GetControl("Name").SetCssClear("both");



SetCursor

(cursor: string)
: void
Sets the css cursor for the control

Inherited from BaseControl.SetCursor

Example
form.GetControl("Name").SetCursor("pointer");



SetEnabled

(enable: boolean)
: void



SetEnabledRecursive

(enabled: any, exceptions: string[])
: void
Inherited from BaseControl.SetEnabledRecursive




SetExtraStyle

(style: string)
: void
Sets extra css styles to the control

Inherited from BaseControl.SetExtraStyle

Example
form.GetControl("Name").SetExtraStyle("margin-top:10px;clear:both;");



SetFloat

(cssFloat: string)
: void
Sets the css float for the control

Inherited from BaseControl.SetFloat

Example
form.GetControl("Name").SetFloat("right");



SetFontBold

(bold: boolean)
: void
Sets the font-bold property for the control

Inherited from BaseControl.SetFontBold

Example
form.GetControl("Name").SetFontBold(true);



SetFontFamily

(family: string)
: void
Sets the font family for the control

Inherited from BaseControl.SetFontFamily

Example
form.GetControl("Name").SetFontFamily("Arial");



SetFontItalics

(italics: boolean)
: void
Sets the font style for the control

Inherited from BaseControl.SetFontItalics

Example
form.GetControl("Name").SetFontItalics(true);



SetFontSize

(size: string)
: void
Sets the font size for the control

Inherited from BaseControl.SetFontSize

Example
form.GetControl("Name").SetFontSize("14px");



SetForeColor

(color: string)
: void



SetHeight

(height: string)
: void
Sets the height of the control

Inherited from BaseControl.SetHeight

Example
form.GetControl("Name").SetHeight("20px");



SetLoaded

()
: void
Inherited from BaseControl.SetLoaded




SetLookupProvider

(provider: IDataProvider)
: void
Inherited from LookupDataControl.SetLookupProvider




SetMargin

(margin: string)
: void
Sets the css margin for the control

Inherited from BaseControl.SetMargin

Example
form.GetControl("Name").SetMargin("10px 20px");
Example
form.GetControl("Name").SetMargin("10px");
Example
form.GetControl("Name").SetMargin("10px 20px 30px 40px");



SetMaxHeight

(height: string)
: void
Sets the maximum height for the control

Inherited from BaseControl.SetMaxHeight

Example
form.GetControl("Name").SetMaxHeight("200px");



SetMaxWidth

(width: string)
: void
Sets the maximum width for the control

Inherited from BaseControl.SetMaxWidth

Example
form.GetControl("Name").SetMaxWidth("200px");



SetMetadataText

(metadataText: string)
: void
Inherited from BaseControl.SetMetadataText




SetMinFilterLength

(minFilterLength: number)
: void
Sets the minimum filter length

Example
form.GetControl("combo1").SetMinFilterLength(3);



SetMinHeight

(height: string)
: void
Sets the minimum height for the control

Inherited from BaseControl.SetMinHeight

Example
form.GetControl("Name").SetMinHeight("200px");



SetMinWidth

(width: string)
: void
Sets the minimum width for the control

Inherited from BaseControl.SetMinWidth

Example
form.GetControl("Name").SetMinWidth("50px");



SetMultiple

(multiple: boolean)
: void



SetOpacity

(op: string)
: void
Sets the opacity for the control

Inherited from BaseControl.SetOpacity

Example
form.GetControl("Name").SetOpacity("0.6");



SetOverlay

(set: boolean)
: void
Inherited from BaseControl.SetOverlay




SetOverlayOpacity

(opacity: string)
: void
Inherited from BaseControl.SetOverlayOpacity




SetPadding

(padding: string)
: void
Sets the css padding for the control

Inherited from BaseControl.SetPadding

Example
form.GetControl("Name").SetPadding("10px 20px");
Example
form.GetControl("Name").SetPadding("10px");
Example
form.GetControl("Name").SetPadding("10px 20px 30px 40px");



SetPrintExtraStyle

(style: string)
: void
Inherited from BaseControl.SetPrintExtraStyle




SetQueryTimeout

(queryTimeoutInMs: number)
: void
Sets the query timeout for user input before the control triggers result search




SetRequired

(required: any)
: void
Sets the control Required property

Inherited from DataControl.SetRequired




SetReturnValueField

(returnValueField: boolean)
: void



SetStaticData

(items: any[])
: void



SetTextAlign

(align: string)
: void
Sets the css text alignment for the control

Inherited from BaseControl.SetTextAlign

Example
form.GetControl("Name").SetTextAlign("center");



SetTextSearchMode

(textSearchMode: TextSearchModes)
: void



SetTooltip

(tooltip: string, options: any)
: void
Sets a tooltip for the control

Inherited from BaseControl.SetTooltip

Example
form.GetControl("Address").SetTooltip("This is the address field");



SetTooltipConfiguration

(value: ITooltipOptions)
: void
Inherited from BaseControl.SetTooltipConfiguration




SetValue

(value: any)
: void
Sets a value for the data control

Inherited from DataControl.SetValue

Example
form.GetControl("CustomerCombo").SetValue({ID: "1", Name: "CustomerA"});
form.GetControl("checkbox").SetValue(true);
form.GetControl("label1").SetValue("My label text");



SetVerticalAlignment

(align: string)
: void
Inherited from BaseControl.SetVerticalAlignment




SetVisible

(visible: boolean)
: void
Hides or shows a control

Inherited from BaseControl.SetVisible

Example
form.GetControl("Title").SetVisible(false);



SetWidth

(width: string)
: void
Sets the width for the control

Inherited from BaseControl.SetWidth

Example
form.GetControl("Name").SetWidth("100%");



ShouldAddGlobalCssClass

()
: boolean
Inherited from BaseControl.ShouldAddGlobalCssClass




SupportsUserEdit

()
: boolean
Inherited from DataControl.SupportsUserEdit




SwitchClass

(condition: boolean, classNames: string[])
: void
Inherited from BaseControl.SwitchClass




ToNormalMode

()
: void
Inherited from BaseControl.ToNormalMode




ToNormalModePrintable

()
: boolean
Inherited from BaseControl.ToNormalModePrintable




ToPrintMode

()
: void
Inherited from BaseControl.ToPrintMode




ToPrintModePrintable

()
: boolean
Inherited from BaseControl.ToPrintModePrintable




ToViewMode

()
: void
Inherited from BaseControl.ToViewMode




ToggleClass

(classNames: string[])
: void
Inherited from BaseControl.ToggleClass




WaitForAsyncControlsToLoad

(callback: any)
: void
Inherited from BaseControl.WaitForAsyncControlsToLoad




WithAllowDuplicates

(allowDuplicates: boolean)
: this



WithClientFilterResults

(clientFilterResults: boolean)
: this



WithMinFilterLength

(minFilterLength: number)
: this



WithMultiple

(multiple: boolean)
: this



WithOnItemFormat

(h: HandlerFn)
: this



WithOnResultItemFormat

(h: HandlerFn)
: this



WithQueryTimeout

(queryTimeoutInMs: number)
: this



WithReturnValueField

(returnValueField: boolean)
: this



WithTextSearchMode

(textSearchMode: TextSearchModes)
: this



_LoadData

(query: , force: boolean)
: void



_SetData

(query: any)
: void



toJSON

()
: any



ComboBoxEqualityComparer

(item1: any, item2: any)
: boolean



CreatePropertiesFromHtmlAttributes

(c: BaseControl, el: HTMLElement)
: any
Inherited from BaseControl.CreatePropertiesFromHtmlAttributes




FromJSON

(def: any)
: ComboBox



FromJSON2

(r: ComboBox, def: any)
: ComboBox


Events


OnBeginEvaluateValue

(form: pf.Form, args: IEventArgs (Parent: any, Sender: any))
:
Inherited from DataControl.OnBeginEvaluateValue




OnControlAdded

(form: pf.Form, args: IControlAddedEventArgs (Control: any, Parent: any, Sender: any))
:
Inherited from BaseControl.OnControlAdded




OnLoaded

(form: pf.Form, args: IEventArgs (Parent: any, Sender: any))
:
Inherited from BaseControl.OnLoaded




OnLookupLoaded

(form: pf.Form, args: ILookupLoadedEventArgs (Data: , Parent: any, Sender: any))
:
Inherited from LookupDataControl.OnLookupLoaded




OnLookupLoading

(form: pf.Form, args: IEventArgs (Parent: any, Sender: any))
:
Inherited from LookupDataControl.OnLookupLoading




OnOpening

(form: pf.Form, args: IEventArgs (Parent: any, Sender: any))
:



OnSelecting

(form: pf.Form, args: IGenericEventArgs (Data: T, Parent: any, Sender: any))
:



OnUnselecting

(form: pf.Form, args: IGenericEventArgs (Data: T, Parent: any, Sender: any))
:



OnValueChangedFromUI

(form: pf.Form, args: IValueChangedEventArgs (Parent: any, PreviousValue: any, Sender: any, Value: any))
:
Inherited from DataControl.OnValueChangedFromUI




OnValueLoaded

(form: pf.Form, args: IEventArgs (Parent: any, Sender: any))
:
Inherited from DataControl.OnValueLoaded