<doc>

<legacy_id>2168</legacy_id>

<name>button</name>

<type>object</type>

<syntax>

</syntax>

<library></library>

<objects>

</objects>

<synonyms>

</synonyms>

<classification>

<category>Objects &amp; Messages</category>

</classification>

<references>

<keyword tag="templateButton">templateButton Keyword</keyword>

</references>

<history>

<introduced version="1.0">Added.</introduced>

</history>

<platforms>

<mac/>

<windows/>

<linux/>

<ios/>

<android/>

</platforms>

<classes>

<desktop/>

<server/>

<web/>

<mobile/>

</classes>

<security>

</security>

<summary>A <keyword tag="control">control</keyword> that is clickable.</summary>

<examples>

<example>set the hilite of button "Warning" to false</example>

<example>if the number of this card is 1 then hide button "Previous"</example>

</examples>

<description>

<p>Use the <b>button</b> <glossary tag="object type">object type</glossary> to create a clickable <keyword tag="button">button</keyword>, a <glossary tag="tabbed button">tabbed window</glossary>, or a <keyword tag="menu">menu</keyword>.</p><p/><p><b>Comments:</b></p><p>Button objects can be push buttons, checkboxes, radio buttons, or menus, depending on the setting of their <b>style</b> <glossary tag="property">property</glossary>.</p><p/><p>A button whose <b>style</b> is set to "menu" can be a <command tag="popup">popup</command> or <glossary tag="contextual menu">contextual menu</glossary>, pulldown menu, option menu, <glossary tag="tabbed button">tabbed button</glossary>, or <glossary tag="combo box">combo box</glossary>, depending on the setting of its <property tag="menuMode">menuMode</property> <glossary tag="property">property</glossary>.</p><p/><p>A button is contained in a card, group, or background. Buttons cannot contain other objects.</p><p/><p>The button object has a number of properties and messages associated with it. To see a list of messages that can be sent to a button as a result of user actions or internal LiveCode events, open the "LiveCode Language Dictionary" page of the main Documentation window, ensure that the button column is visible and use sort and filter to bring the relevant entries to the top.</p><p/><p><b>Note:</b> A standard button is rendered by the operating system, not LiveCode. Changing certain properties of such a button will cause the button to stop honouring the native theme. Properties that affect the button's colour and border may cause this issue.</p>

</description>

</doc>