| Package | qnx.ui.buttons |
| Class | public class IconButton |
| Inheritance | IconButton  Button SkinnableComponent UIComponent flash.display.MovieClip |
IconButton class enables you to place an image at the center of a button:
See also
| Method | Defined By | ||
|---|---|---|---|
Constructs an IconButton instance. | IconButton | ||
 | destroy():void
Call this method when you want to have your object collected by the garbage collector. | UIComponent | |
| drawNow():void
Calls the draw() method. | UIComponent | |
| invalidate(property:String, invalidateNow:Boolean = false):void
Marks the property as invalid and the draw() method is called on the next frame or the next render, whichever comes first. | UIComponent | |
setIcon(image:Object):void
Sets the icon for the button. | IconButton | ||
| setPosition(x:Number, y:Number):void
Sets the x and y position of the component. | UIComponent | |
| setSize(w:Number, h:Number):void
Sets the width and height of the component. | UIComponent | |
| setSkin(cellSkin:Object):void
Set the skin object on the component for it to render. | SkinnableComponent | |
| IconButton | () | Constructor |
Hide Inherited Public Properties
Show Inherited Public Propertiespublic function IconButton()
Constructs an IconButton instance.
| setIcon | () | method |
public function setIcon(image:Object):voidSets the icon for the button. The icon is positioned in the center of the button.
The setIcon takes a path to an image (relative to your application file), a Bitmap instance,
or a BitmapData instance. In the following example, a path to an image in the source project is passed into the
setIcon method.
myIconButton = new IconButton();
myIconButton.setIcon("assets/icon.gif");
In the following example, an image is embedded in a class called Settings. The Settings object is
instantiated as the argument for the setIcon() method.
[Embed(source="assets/settings.png")]
public static var Settings:Class;
myIconButton.setIcon( new Settings() );
Parameters
image:Object — The icon to be set. A String representing the URL to an external image, a Bitmap instance,
or a BitmapData instance.
|
In the following example, a .gif is placed on an IconButton instance. The LocaleManager
class's getCurrentLocale() method is called to reference an image in the resource folder of the current
locale.
package
{
import flash.display.Sprite;
import flash.filesystem.File;
import qnx.ui.buttons.IconButton;
import qnx.ui.buttons.Button;
import qnx.locale.LocaleManager;
[SWF(height="600", width="1024", frameRate="30",
backgroundColor="#FFFFFF")]
public class buttontest extends Sprite
{
private var myIconButton:IconButton;
public function buttontest()
{
initializeIconButton();
}
private function initializeIconButton():void
{
myIconButton = new IconButton();
myIconButton.setIcon("locale/" +
LocaleManager.localeManager.getCurrentLocale() +
"/icon.gif");
myIconButton.width = 100;
myIconButton.setPosition(30, 30);
this.addChild(myIconButton);
}
}
}