mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-11-27 07:37:33 +00:00
Code Issues Releases Activity

Update how to separate the editable field of an editable-field widget from other widgets.

Browse Source 
(Programming Example): Add text after field.
This commit is contained in:
Lars Hansen 2004-08-05 06:19:38 +00:00
parent 2d8a544976
commit 8dbc532e46
2 changed files with 20 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
man/ChangeLog
View File

@ -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

22
man/widget.texi
View File

@ -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"