Mercurial > hg > xemacs-beta
diff man/widget.texi @ 20:859a2309aef8 r19-15b93
Import from CVS: tag r19-15b93
author | cvs |
---|---|
date | Mon, 13 Aug 2007 08:50:05 +0200 |
parents | 0293115a14e9 |
children | 8fc7fe29b841 |
line wrap: on
line diff
--- a/man/widget.texi Mon Aug 13 08:49:44 2007 +0200 +++ b/man/widget.texi Mon Aug 13 08:50:05 2007 +0200 @@ -1,6 +1,6 @@ \input texinfo.tex -@c $Id: widget.texi,v 1.1 1997/02/02 04:58:52 steve Exp $ +@c $Id: widget.texi,v 1.2 1997/02/09 23:52:13 steve Exp $ @c %**start of header @setfilename widget @@ -15,7 +15,7 @@ @comment node-name, next, previous, up @top The Emacs Widget Library -Version: 1.20 +Version: 1.30 @menu * Introduction:: @@ -627,10 +627,21 @@ Face used for highlighting the editable field. Default is @code{widget-field-face}. +@item :secret +Character used to display the value. You can set this to e.g. @code{?*} +if the field contains a password or other secret information. By +default, the value is not secret. + +@item :valid-regexp +By default the @code{:validate} function will match the content of the +field with the value of this attribute. The default value is @code{""} +which matches everything. + @item :keymap -Keymap used in the editable field. @code{widget-keymap} will allow you -to use normal editing commands, even if these has been suppressed in the -current buffer. +Keymap used in the editable field. The default value is +@code{widget-field-keymap}, which allows you to use all the normal +editing commands, even if the buffers major mode supress some of them. +Pressing return activates the function specified by @code{:activate}. @item :hide-front-space @itemx :hide-rear-space @@ -660,7 +671,8 @@ @subsection The @code{text} Widget This is just like @code{editable-field}, but intended for multiline text -fields. +fields. The default @code{:keymap} is @code{widget-text-keymap}, which +does not rebind the return key. @node menu-choice, radio-button-choice, text, Basic Types @comment node-name, next, previous, up @@ -1089,8 +1101,8 @@ @comment node-name, next, previous, up @section Properties -You can examine or set this value by using the widget object that was -returned by @code{widget-create}. +You can examine or set the value of a widget by using the widget object +that was returned by @code{widget-create}. @defun widget-value widget Return the current value contained in @var{widget}. @@ -1129,6 +1141,13 @@ Non-nil if @var{widget} has a value (even nil) for property @var{property}. @end defun +Occasionally it can be useful to know which kind of widget you have, +i.e. the name of the widget type you gave when the widget was created. + +@defun widget-name widget +Return the name of @var{widget}, a symbol. +@end defun + @node Defining New Widgets, Widget Wishlist., Widget Properties, Top @comment node-name, next, previous, up @section Defining New Widgets @@ -1238,24 +1257,13 @@ @section Wishlist. @itemize @bullet -@item -In general, we need @strong{much} better support for keyboard -operations. +@item +A Smalltalk style widget browser. -@itemize - @item It should be possible to add or remove items from a list with @kbd{C-k} and @kbd{C-o} (suggested by @sc{rms}). -@item -@kbd{C-k} should kill to end of field or end of line, whatever come -first. - -@item -Commands to move to the beginning/end of a field. - -@end itemize - @item The @samp{[INS]} and @samp{[DEL]} buttons should be replaced by a single dash (@samp{-}). The dash should be a button that, when activated, ask @@ -1271,9 +1279,7 @@ There should be support for browsing the widget documentation. @item -There should be a way to specify that @key{RET} in a field will call the -@code{:activate} function. This should be used by widgets such as -@code{file} and @code{symbol} prompt with completion. +Widgets such as @code{file} and @code{symbol} should prompt with completion. @item The @code{menu-choice} tag should be prettier, something like the abbreviated @@ -1282,7 +1288,7 @@ @item The functions used in many widgets, like @code{widget-item-convert-widget}, should not have names that are -specific to the first widget where I used them. +specific to the first widget where I happended to use them. @item Unchecked items in a @code{radio-button-choice} or @code{checklist}