Macromedia dreamweaver 8-extending dreamweaver User Manual

Toolbar item tags

227

<checkbutton>

Description

A check button is a button that has a checked or unchecked state and that executes a specific 
command when clicked. When it is checked, it appears pressed in and highlighted. When it is 
not checked, it appears flat. Dreamweaver implements the following states for the check 
button: Mouse-over, Pressed, Mouse-over-while-pressed, and Disabled-while-pressed. The 
handler that is specified by the 

checked

 attribute or the 

isCommandChecked()

 function must 

ensure that clicking the check button causes the button’s state to toggle. 

Attributes

id, {showIf}, image, {disabledImage}, {overImage}, tooltip, {label}, 

{file}, {domRequired}, {enabled}, checked, {update}, command, {arguments}

For a description of each attribute, see 

.

Contents

None.

Container

The 

toolbar

 tag or the 

toolbarset

 tag.

Example

<CHECKBUTTON ID="DW_LiveDebug"

image="Toolbars/images/MM/debugview.gif"
disabledImage="Toolbars/images/MM/globe_dis.gif"
tooltip="Live Debug"
enabled="dw.canLiveDebug()"
checked="dw.getDocumentDOM() != null && dw.getDocumentDOM().getView() == 
'browse'"
command="dw.toggleLiveDebug()"
showIf="dw.canLiveDebug()"
update="onViewChange"/>

<radiobutton>

Description

A radio button is exactly the same as a check button, except that when it is off, it appears as a 
raised button. Dreamweaver implements the following states for the radio button: Mouse-
over, Pressed, Mouse-over-while-pressed, and Disabled-while-pressed. Dreamweaver does not 
enforce mutual exclusion between radio buttons. The handler that the 

checked

 attribute or 

the 

isCommandChecked()

 function specifies must ensure that the checked and unchecked 

states of radio buttons are consistent with each other.