RibbonSelectBoxItemOptions Interface

Declares ribbon select box item settings.

Declaration

export interface RibbonSelectBoxItemOptions

Properties

acceptCustomValue Property

Specifies whether the item accepts custom values.

Declaration

acceptCustomValue?: boolean

Property Value

true to accept custom values; otherwise, false.

|

Remarks

Set the acceptCustomValue property to true to allow a user to add new values to the select box. Note that in this case, you should implement the onCustomItemCreating handler to create a new data source entry.

beginGroup Property

Specifies whether an item separator should be displayed before the current item.

Declaration

beginGroup?: boolean

Property Value

true to display a separator before the item; otherwise, false.

|

displayExpr Property

Specifies the data field whose values should be displayed.

Declaration

displayExpr?: string

Property Value

The name of the data field.

|

onCustomItemCreating Property

Specifies a function that is executed when a user adds a custom item.

Declaration

onCustomItemCreating?: any

Property Value

A function that creates a new data source entry.

|

Remarks

When the acceptCustomValue property is set to true , a user is allowed to add new values to the select box. Write the onCustomItemCreating function code to create a new data source entry.

placeholder Property

Specifies the text displayed by the item when its value is empty.

Declaration

placeholder?: string

Property Value

The placeholder text.

|

showClearButton Property

Specifies whether to display the Clear button in the item.

Declaration

showClearButton?: boolean

Property Value

true to display the Clear button; otherwise, false.

|

textOptions Property

Specifies options of the text displayed next to the item.

Declaration

textOptions?: RibbonItemTextOptions

Property Value

An object that contains text options.

|

value Property

Specifies the currently selected value.

Declaration

value?: any

Property Value

The currently selected value.

|

valueExpr Property

Specifies the data field that provides values for the editor items.

Declaration

valueExpr?: string

Property Value

The name of the data field.

|

valueType Property

Specifies the data type of the selected value.

Declaration

valueType?: string

Property Value

The selected value type.

|

width Property

Specifies the item width.

Declaration

width?: any

Property Value

The item width.

|