Combobox
The Control
The Combobox Control displays a drop down list of the values you have specified in the value provider, and allows the user to either select one or multiple values.
Actions
When the Combobox Control is selected in the Central pane, the Actions section on the ribbon is updated to display the following items:
Move Down This action is applicable to controls that are immediate children of Container Controls. When pressed, it moves the selected control below its current position (shifting the below control above it).
Move Up This action is applicable to controls that are immediate children of Container Controls. When pressed, it moves the selected control above its current position (shifting the above control below it).
Convert To Changes the type of the selected control to another one maintaining all properties that are common to both Control Types (style, font, value, etc). Depending on the selected control type, different options are available. For example, the table container c
Events
Occurs when the control's value is being evaluated
Args: (form: pf.Form, args: pf.IEventArgs)
Occurs before the control's value formatting
Args: (form: pf.Form, args: pf.IItemFormatEventArgs)
Occurs when the control's lookup has loaded.
Args: (form: pf.Form, args: pf.ILookupLoadedEventArgs)
Occurs when the control's lookup has started to load.
Args: (form: pf.Form, args: pf.IEventArgs)
Formats the result item as it appears in the result drom down list
Args: (form: pf.Form, args: pf.IItemFormatEventArgs)
Occurs after the Value of a control has changed.
Args: (form: pf.Form, args: pf.IValueChangedEventArgs)
This event is being called, each time the user changes the value.
Args: (form: pf.Form, args: pf.IValueChangedEventArgs)
Occurs before the Value of a control changes. You can cancel the change by setting args.Cancel to true.
Args: (form: pf.Form, args: pf.IValueChangingEventArgs)
Occurs after the value provider retrieved data for this control.
Args: (form: pf.Form, args: pf.IEventArgs)
Properties
Appearance
Gets or sets a color that describes the background of a control
The float CSS property places an element on the left or right side of its container, allowing text and inline elements to wrap around it.
Changes the font weight of the control, to either regular when not selected or bold when selected.
This font-style property allows you to make text appear italicized (i.e. sloped, or slanted)
Changes the font size of the control.
Sets the foreground color of the control.
Here you can specify what text should be displayed when no value has been selected in the input field.
The text-align property specifies the horizontal alignment of the text displayed
Sets what will be displayed in a tooltip when the user hovers over the control.
Behavior
Dislays a button, which when pressed clears the control's value.
When selected, a user may select multiple times the same item from the list.
When selected, the user may add on the spot additional values which are not in the predefined provided list.
Gets or sets if the ValueChange event triggers the ValueChange event of the parent form.
Specifies whether this control should be disabled when form is offline.
Specifies whether this control should be hidden when form is offline.
Specifies whether this control is required when form is offline.
Sets the item visible or not during initialization
Data Binding
This is a free text field, where one can enter comments or other notes. Comments are only visible in the designer.
Gets or sets the code that returns the default value for this control.
The name which will hold the control's stored value
Allows you to change the value returned by the control (when GetValue() is called).
Allows you to change the value set to the actual control (when SetValue(value) is called).
Layout
Sets the margin applied to the control, that is, the spacing between the control and the cell borders.
Sets the maximum height.
Sets the maximum width.
Sets the minimum height.
Sets the minimum width.
Sets the padding of the control
Miscellaneous
Specify the conditions under which the control will be enabled/disabled.
Specify the conditions under which the control will be visible/hidden