1
<section id="prefs-tag-button" xmlns:xi="http://www.w3.org/2001/XInclude">
2
<title><button></title>
4
<para>A simple button. Its representation is a button widget.</para>
9
<imagedata fileref="gfx/prefs-button" format="PNG"/>
15
<section><title>Attributes</title>
17
<informaltable frame="topbot">
24
<entry>Default Value</entry>
25
<entry>Description</entry>
31
<entry valign="top">callback</entry>
32
<entry valign="top">function</entry>
33
<entry valign="top"></entry>
34
<entry valign="top">A callback function which is called every time
35
the button is clicked. The callback takes the name of the bound
36
property and the new value as arguments.</entry>
39
<entry valign="top">enabled</entry>
40
<entry valign="top">boolean</entry>
41
<entry valign="top">true</entry>
42
<entry valign="top">Whether the config item is enabled. Disabled items
43
appear greyed out.</entry>
46
<entry valign="top">help</entry>
47
<entry valign="top">string</entry>
48
<entry valign="top"></entry>
49
<entry valign="top">The tooltip text for the element in the
50
configuration dialog.</entry>
53
<entry valign="top">label</entry>
54
<entry valign="top">string</entry>
55
<entry valign="top"></entry>
56
<entry valign="top">The label text for the element in the
57
configuration dialog.</entry>
68
<section><title>Examples</title>
70
<programlisting><![CDATA[
71
<button label="I am a button. Please click me ;)."
72
help="Just a simple button."
73
callback="my_personal_callback" />