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