IconManager
| By Rich Tretola | September 12, 2008 |  Print This Page
|
 (No Ratings Yet) Loading ... | 387 views |
Alerting the user with a visual alert of the application icon is common in the world of desktop application but other than the bounce functionality on Mac, it is not currently part of the AIR api. This class will allow you to call an alert method which will cycle through 2 sets of icons which will display a flashing icon to the user.
- private var i:IconManager = new IconManager(defaultSysDockIconBitmaps);
Constructor arguments
sysDockIconBitmaps:Array - An array of bitMapData which should represent the 16, 32, 48, and 128 icon sizes. *required
alteredSysDockIconBitmaps:Array - An alternate array of bitMapData which should represent alert set of 16, 32, 48, and 128 icon sizes. If this is not passed in an alternate set will be created by applying a ColorMatrixFilter to the sysDockIconBitmaps.
methods
startAlert(message:String=”",alertType:String=”") - This method starts the icon alert. This method has two optional arguments, the first is a message that will appear as the toolTip of the systemTrayIcon within the Windows environment. The second will define the NotificationType for the icon within the Mac OS. If undefined the default will be to bounce the icon once. If NotificationType.CRITICAL is passed in, the icon will bounce until the user interacts with it.
stopAlert() - will stop an active alert
Sample including only the default set of icons within the IconManager constructor and both optional arguments within the startAlert method. This example is set on a 3 second delay so that if you are on a Mac, you can change focus to a different operating system window before the bounce starts. The bounce will not run if the application is currently the main application in focus.
- <?xml version="1.0" encoding="utf-8"?>
- <mx:WindowedApplication xmlns:mx="http://www.adobe.com/2006/mxml"
- width="200" height="100">
- <mx:Script>
- <![CDATA[
- import com.everythingflex.air.managers.IconManager;
- [Embed(source="assets/icons/AIRApp_16.png")]
- private var Icon16:Class;
- private var bitmap16:Bitmap = new Icon16();
- [Embed(source="assets/icons/AIRApp_32.png")]
- private var Icon32:Class;
- private var bitmap32:Bitmap = new Icon32();
- [Embed(source="assets/icons/AIRApp_48.png")]
- private var Icon48:Class;
- private var bitmap48:Bitmap = new Icon48();
- [Embed(source="assets/icons/AIRApp_128.png")]
- private var Icon128:Class;
- private var bitmap128:Bitmap = new Icon128();
- private var defaultSysDockIconBitmaps:Array = [bitmap16.bitmapData,
- bitmap32.bitmapData,
- bitmap48.bitmapData,
- bitmap128.bitmapData];
- private var i:IconManager = new IconManager(defaultSysDockIconBitmaps);
- private var timer:Timer;
- private function testAlert():void{
- timer = new Timer(3000,1);
- timer.addEventListener(TimerEvent.TIMER_COMPLETE,timerComplete);
- timer.start();
- }
- private function timerComplete(event:TimerEvent):void{
- /**
- * set toolTip to 'ALERT! ALERT!' (Windows Only)
- * set NotificationType to CRITICAL (Mac Only)
- */
- i.startAlert('ALERT! ALERT!',NotificationType.CRITICAL);
- }
- ]]>
- </mx:Script>
- <mx:Button click="testAlert()" label="Start Alert"
- horizontalCenter="0" verticalCenter="0"/>
- </mx:WindowedApplication>
