control image

Sets or retrieves the image (icon) displayed in the control. The image name should be defined in the stylesheet and linked to the actual image file with the css rules.

See how to include additional images in your stylesheet.

Syntax

var value = obj.getControlImage(); 
obj.setControlImage(value);        

obj.onControlImageChanging = function(value){...}; 
obj.onControlImageChanged = function(value){...}; 
obj.onControlImageError = function(value){...}; 

Defined in

control model

Examples

Button, checkbox, combo, group, input, label and link controls can display a small image/icon -

Input (textbox)

var obj = new AW.UI.Input;
obj.setControlImage("favorites"); // show 'favorites' icon
obj.setControlText("Some text");
document.write(obj);

<script> var obj = new AW.UI.Input; obj.setControlImage("favorites"); // show 'favorites' icon obj.setControlText("Some text"); document.write(obj); </script>

Button

var obj = new AW.UI.Button;
obj.setControlImage("search"); // show 'search' icon
obj.setControlText("Search");
document.write(obj);

<script> var obj = new AW.UI.Button; obj.setControlImage("search"); // show 'search' icon obj.setControlText("Search"); document.write(obj); </script>

See also

Overview: using images
Control properties: text, link, tooltip