comparison man/widget.texi @ 89961:3fd4a5c21153

Revision: [e-mail]--gnu-2004/emacs--unicode--0--patch-29 Merge from [e-mail]--2004/emacs--multi-tty--0, emacs--cvs-trunk--0 Patches applied: * [e-mail]--2004/emacs--multi-tty--0--patch-224 Added sorted-doc to backup regex in lib-src. * [e-mail]--gnu-2004/emacs--cvs-trunk--0--patch-479 - [e-mail]--gnu-2004/emacs--cvs-trunk--0--patch-482 Update from CVS * [e-mail]--gnu-2004/emacs--cvs-trunk--0--patch-483 Build-in-place tweak * [e-mail]--gnu-2004/emacs--cvs-trunk--0--patch-484 - [e-mail]--gnu-2004/emacs--cvs-trunk--0--patch-485 Update from CVS

89960:d79ab6afded5

For example, capitalizing all text from the middle of one field to the
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.

The editing text fields are highlighted with the
@code{widget-field-face} face, making them easy to find.

@deffn Face widget-field-face

    (erase-buffer))
  (remove-overlays)
  (widget-insert "Here is some documentation.\n\nName: ")
  (widget-create 'editable-field
		 :size 13
		 "My Name")
  (widget-create 'menu-choice
		 :tag "Choose"
		 :value "This"
		 :help-echo "Choose me, please!"

89961:3fd4a5c21153

For example, capitalizing all text from the middle of one field to the
middle of another field is prohibited.

Editable text fields are created by the @code{editable-field} widget.

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

@deffn Face widget-field-face

    (erase-buffer))
  (remove-overlays)
  (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"
		 :value "This"
		 :help-echo "Choose me, please!"