/[emacs]/emacs/man/widget.texi
ViewVC logotype

Diff of /emacs/man/widget.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.13.2.2 by miles, Tue Oct 14 22:56:25 2003 UTC revision 1.13.2.3 by miles, Fri Nov 21 00:36:13 2003 UTC
# Line 112  supposed to fill out a number of fields, Line 112  supposed to fill out a number of fields,
112  meaning.  The user is not supposed to change or delete any of the text  meaning.  The user is not supposed to change or delete any of the text
113  between the fields.  Examples of forms in Emacs are the @file{forms}  between the fields.  Examples of forms in Emacs are the @file{forms}
114  package (of course), the customize buffers, the mail and news compose  package (of course), the customize buffers, the mail and news compose
115  modes, and the @sc{html} form support in the @file{w3} browser.  modes, and the @acronym{HTML} form support in the @file{w3} browser.
116    
117  @cindex widget library, why use it  @cindex widget library, why use it
118  The advantages for a programmer of using the @code{widget} package to  The advantages for a programmer of using the @code{widget} package to
# Line 739  TYPE ::= (url-link [KEYWORD ARGUMENT]... Line 739  TYPE ::= (url-link [KEYWORD ARGUMENT]...
739  @end example  @end example
740    
741  @findex browse-url-browser-function@r{, and @code{url-link} widget}  @findex browse-url-browser-function@r{, and @code{url-link} widget}
742  When this link is invoked, the @sc{www} browser specified by  When this link is invoked, the @acronym{WWW} browser specified by
743  @code{browse-url-browser-function} will be called with @var{url}.  @code{browse-url-browser-function} will be called with @var{url}.
744    
745  @node info-link, push-button, url-link, Basic Types  @node info-link, push-button, url-link, Basic Types
# Line 1586  in the buffer, and returns a widget obje Line 1586  in the buffer, and returns a widget obje
1586  Function to delete a widget.  The function takes one argument, a widget,  Function to delete a widget.  The function takes one argument, a widget,
1587  and should remove all traces of the widget from the buffer.  and should remove all traces of the widget from the buffer.
1588    
1589    The default value is:
1590    
1591    @defun widget-default-delete widget
1592    Remove @var{widget} from the buffer.
1593    Delete all @code{:children} and @code{:buttons} in @var{widget}.
1594    @end defun
1595    
1596    In most cases you should not change this value, but instead use
1597    @code{:value-delete} to make any additional cleanup.
1598    
1599  @vindex value-create@r{ keyword}  @vindex value-create@r{ keyword}
1600  @item :value-create  @item :value-create
1601  Function to expand the @samp{%v} escape in the format string.  It will  Function to expand the @samp{%v} escape in the format string.  It will
1602  be called with the widget as its argument and should insert a  be called with the widget as its argument and should insert a
1603  representation of the widget's value in the buffer.  representation of the widget's value in the buffer.
1604    
1605    Nested widgets should be listed in @code{:children} or @code{:buttons}
1606    to make sure they are automatically deleted.
1607    
1608  @vindex value-delete@r{ keyword}  @vindex value-delete@r{ keyword}
1609  @item :value-delete  @item :value-delete
1610  Should remove the representation of the widget's value from the buffer.  Should remove the representation of the widget's value from the buffer.
1611  It will be called with the widget as its argument.  It doesn't have to  It will be called with the widget as its argument.  It doesn't have to
1612  remove the text, but it should release markers and delete nested widgets  remove the text, but it should release markers and delete nested widgets
1613  if such have been used.  if these are not listed in @code{:children} or @code{:buttons}.
   
 The following predefined function can be used here:  
   
 @defun widget-children-value-delete widget  
 Delete all @code{:children} and @code{:buttons} in @var{widget}.  
 @end defun  
1614    
1615  @vindex value-get@r{ keyword}  @vindex value-get@r{ keyword}
1616  @item :value-get  @item :value-get

Legend:
Removed from v.1.13.2.2  
changed lines
  Added in v.1.13.2.3

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26