diff options
| author | Lars Hansen <larsh@soem.dk> | 2004-08-05 06:19:38 +0000 |
|---|---|---|
| committer | Lars Hansen <larsh@soem.dk> | 2004-08-05 06:19:38 +0000 |
| commit | 8dbc532e462f384899acfa1f17d687a2fdef6400 (patch) | |
| tree | b2326ea42cd75716e6aa1ebb20b5819f010f03ea | |
| parent | 2d8a544976354b3787e4f28f2d97b3ab96f4a052 (diff) | |
| download | emacs-8dbc532e462f384899acfa1f17d687a2fdef6400.tar.gz | |
Update how to separate the editable field of an editable-field widget from other widgets.
(Programming Example): Add text after field.
| -rw-r--r-- | man/ChangeLog | 6 | ||||
| -rw-r--r-- | man/widget.texi | 22 |
2 files changed, 20 insertions, 8 deletions
diff --git a/man/ChangeLog b/man/ChangeLog index a36b0c75fe4..4f2ce160de6 100644 --- a/man/ChangeLog +++ b/man/ChangeLog @@ -1,3 +1,9 @@ +2004-08-05 Lars Hansen <larsh@math.ku.dk> + + * widget.texi (User Interface): Update how to separate the + editable field of an editable-field widget from other widgets. + (Programming Example): Add text after field. + 2004-07-24 Richard M. Stallman <rms@gnu.org> * text.texi (Paragraphs): Update how paragraphs are separated diff --git a/man/widget.texi b/man/widget.texi index 457af8a07bb..7e1d920cc62 100644 --- a/man/widget.texi +++ b/man/widget.texi @@ -213,14 +213,19 @@ middle of another field is prohibited. Editable text fields are created by the @code{editable-field} widget. -An editable field must be surrounded by static text on both sides, that -is, text that does not change in the lifetime of the widget. If the -field extends to the end of the line, the terminating line-feed character -will count as the necessary static text on that end, but you will have -to provide the static text before the field yourself. The -@code{:format} keyword is useful for generating the static text; for -instance, if you give it a value of @code{"Name: %v"}, the "Name: " part -will count as the static text. +@strong{Warning:} In an @code{editable-field} widget, the editable +field must not be adjacent to another widget---that won't work. +You must put some text in between. Either make this text part of +the @code{editable-field} widget itself, or insert it with +@code{widget-insert}. + +The @code{:format} keyword is useful for generating the necessary +text; for instance, if you give it a value of @code{"Name: %v "}, +the @samp{Name: } part will provide the necessary separating text +before the field and the trailing space will provide the +separating text after the field. If you don't include the +@code{:size} keyword, the field will extend to the end of the +line, and the terminating newline will provide separation after. The editing text fields are highlighted with the @code{widget-field-face} face, making them easy to find. @@ -345,6 +350,7 @@ Interface}). (widget-insert "Here is some documentation.\n\nName: ") (widget-create 'editable-field :size 13 + :format "%v " ; Text after the field! "My Name") (widget-create 'menu-choice :tag "Choose" |