Method XbpCombobox():setEditable() Foundation

Sets whether the edit field of the XbpCombobox object is READONLY.

Syntax
:setEditable( [<lEditable>] ) --> lOldSetting
Parameters
<lEditable>
<lEditable> is a logical value that specifies whether the text contained in the edit field of the XbpCombobox object can be modified. If the value is .T. (true) the value can be changed, otherwise no input is allowed in the edit.
Return

This method returns whether the edit field of the XbpCombobox object was editable before the :setEditable() method was called.

Description

The :setEditable() method determines whether the value in the edit field of an XbpCombobox object can be changed without having to call the :configure() method. Normally, the value in the instance variable :editable defines whether the value in the edit field can be changed. This instance variable must be set before the method :create() is called. To change the editable state after the call to :create(), the :setEditable() method is used. This method should not be confused with the method :disable(), which makes the XbpCombobox object inaccessible. Whenever the edit field is set to 'not editable' using :setEditable(.F.), the value of the combo box, however, can still be changed by selecting an item from the item list. For XbpCombobox objects of type XBPCOMBO_DROPDOWN or XBPCOMBO_DROPDOWNLIST, the element which opens the drop-down list is operational regardless of the editable state. In addition, the value in the edit field can still be selected and copied to the clipboard.

If the edit field of an XbpCombobox object is not editable, the keyboard short cuts for switching between individual items and for opening the drop-down list are inoperational.

Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.