Switch to: V11V10V9V8V7V6V5

Form Editor - ComboBox - Field Help

Form Editor - ComboBox - Field

The ComboBox - Field control is a combined button and popup list.

A ComboBox - Field provides a means of presenting a list of options to the user in a way that takes up the minimum amount of screen space.

A combobox is a selection control that displays the current item, and can pop up a list of selectable items. A combobox may be editable, allowing the user to modify each item in the list.

This control is bound to the table field and allows the user to edit its value. The current value of the combobox is taken right from the field and each change is applied immediately to the field.

Available values are defined by the Items property using the special editor.

Properties

Form Editor - ComboBox - Field Properties

  • Data Mode – Defines how the control value change is applied to the field:
    • Inherited – The mode is inherited from the parent form
    • Add – The value is intended for a new record
    • Edit – The value is assigned to the field, but not committed
    • Edit And Commit – The value is assigned to the field and committed
    • ReadOnly – The value can't be changed
    • Filter – The value is used to filter data by the bound field, the filter must be applied manually using the applyFilters method.
    • Filter And Accept – The value is used to filter data by the bound field, filter applied automatically.
  • Name – The name of the control.
  • Field – The bound field.
  • Items – The list of items to choose from.
  • Tooltip – The tooltip text.
  • Editable – This property holds whether the combo box can be edited by the user.
  • Enabled – Defines whether the control is enabled or not.

Slots

  • currentTextChanged – This slot is called whenever currentText changes. The new value is passed in a first argument.
  • editTextChanged – This slot is called when the text in the combobox's line edit control is changed. The new text is passed in a first argument.
  • needUpdate – This slot is called when the form elements should be updated, for example, on the change of the current record.

Layout Item

  • Alignment – Defines both the horizontal and vertical alignment.
  • Expand Horizontal – If ON the control is expanded horizontally.
  • Expand Vertical – If ON the control is expanded vertically.

Size

  • Width – The width of the control.
  • Height – The height of the control (Disabled).