Next: , Previous: push-button, Up: Basic Types

5.5 The editable-field Widget

Syntax:

     type ::= (editable-field [keyword argument]... [ value ])

The value, if present, is used to initialize the :value property. The value should be a string, which will be inserted in the field. This widget will match all string values.

The following extra properties are recognized:

:size
The width of the editable field.
By default the field will reach to the end of the line.


:value-face
Face used for highlighting the editable field. Default is widget-field-face, see User Interface.


:secret
Character used to display the value. You can set this to, e.g., ?* if the field contains a password or other secret information. By default, this is nil, and the value is not secret.


:valid-regexp
By default the :validate function will match the content of the field with the value of this attribute. The default value is "" which matches everything.


:keymap
Keymap used in the editable field. The default value is widget-field-keymap, which allows you to use all the normal editing commands, even if the buffer's major mode suppresses some of them. Pressing <RET> invokes the function specified by :action.