:: Home >>

AW.UI.Button

Button control.

Constructor

 var obj = new AW.UI.Button; 

Hierarchy

Models

controlControl data.
control formatFormatting object.
control imageImage name.
control linkHyperlink URL.
control stateControl's state.
control textDisplayed text.
control tooltipTooltip text.
control valueControl's value.
control visibleControl's visibility.
tabTab index.
tab indexTab index.

Methods

clearClears all models.
clearControlModelClears control model
clearTabModelClears tab model
cloneCreates an object clone.
defineControlPropertyCreates new control property
defineModelCreates get/set methods for the model.
defineTabPropertyCreates new tab property
defineTemplateCreates get/set methods for the template.
elementReturns the reference to the HTML element.
getAttributeReturns the value of the attribute.
getClassReturns the value of the CSS class.
getContentReturns the named HTML fragment.
getControlFormatReturns control format
getControlImageReturns control image
getControlLinkReturns control link
getControlModelReturns control model
getControlPropertyReturns control property
getControlStateReturns control state
getControlTextReturns control text
getControlTooltipReturns control tooltip
getControlValueReturns control value
getControlVisibleReturns control visible
getEventReturns the HTML event handler.
getIdReturns the unique ID of this object.
getModelReturns the external model.
getStyleReturns the value of the CSS style attribute.
getTabIndexReturns tab index
getTabModelReturns tab model
getTabPropertyReturns tab property
getTagReturns the HTML tag name.
getTemplateReturns the template.
initInitializes the object.
mapModelRedirects property requests.
mapTemplateRedirects template requests.
raiseEventRaises AW control event.
refreshUpdates the HTML element.
refreshClassesUpdates the className attribute of the HTML element.
setAttributeSets the value of the attribute.
setClassSets the value of the CSS class.
setContentAdds the static HTML fragment to the object.
setControlFormatSets control format
setControlImageSets control image
setControlLinkSets control link
setControlModelSets control model
setControlPropertySets control property
setControlStateSets control state
setControlTextSets control text
setControlTooltipSets control tooltip
setControlValueSets control value
setControlVisibleSets control visible
setControllerAssigns the controller.
setEventAssigns the HTML event handler.
setIdSets the unique ID for this object.
setModelAssigns the external model.
setPositionSets element position (absolute).
setSizeSets element size.
setStyleSets the value of the CSS style attribute.
setTabIndexSets tab index
setTabModelSets tab model
setTabPropertySets tab property
setTagSets the HTML tag name.
setTemplateAssigns the template.
setTimeoutCalls the function after the specified delay.
toStringConverts object to string.

Events

property change events - property changing/changed
control activation events - control activated/deactivated (focus/blur)
control keyboard events - keypress and special keys
control mouse events - control mouseover, mousedown, click etc.

Examples

Create a button -

var obj = new AW.UI.Button;
obj.setControlText("Button");
obj.setControlImage("favorites");
document.write(obj);

Add button click event handler -

obj.onControlClicked = function(event){
    alert(this.getControlText());
}

Remarks

Changing button height is not possible in xp and aqua skins (as it is linked to fixed-size background images).

Disabled and default states are not yet implemented in AW 2.0

In aqua skin the button color does not change on mouseover (like native Mac OS X button control).

See also

Button control overview

Comments

15 May 08
How to raise a siver-side event? mrhsh (2)
5 Apr 07
Disable and enable button Manoj (1)
14 Mar 07
Disabling a Button on Parent Disabled.... Carlos (2)
8 Jan 07
function with parms problem Andy Steward (1)
14 Aug 06
Image above the text! Manuel Arroz (0)
29 Jul 06
Button with image without text Puzzled? (3)
23 Feb 06
Disabling a button icodeon (1)

Comments will appear on this page and in the main forum.

Documentation:

Recent changes:

2.6.4
2.6.3
2.6.2
2.6.1
2.6.1
2.6.0
2.5.0 - 2.5.6
2.5.6
2.5.0 - 2.5.5
2.5.5