SystemTrayIcon - API-referens för Adobe ActionScript® 3 (AS3 )

Paket	flash.desktop
Klass	public class SystemTrayIcon
Arv	SystemTrayIcon InteractiveIcon Icon EventDispatcher Object

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Klassen SystemTrayIcon representerar en aktivitetsfältsikon i meddelandefältet i Windows^®.

Stöd för AIR-profiler: Den här funktionen stöds på operativsystem för datorer, men inte på mobilenheter eller enheter med AIR for TV. På sidan om stöd för AIR-profiler hittar du mer information om API-stöd för flera profiler.

Alla operativsystem har inte aktivitetsfältsikoner. Kontrollera NativeApplication.supportsSystemTrayIcon för att se om aktivitetsfältsikoner stöds på det aktuella systemet.

Det går inte att skapa någon instans av SystemTrayIcon-klassen. Hämta det objekt som representerar aktivitetsfältsikonen från icon-egenskapen i NativeApplication-objektet.

Om aktivitetsfältsikoner stöds kommer ikonen att vara av typen SystemTrayIcon. I annat fall är typen för icon en annan subklass av InteractiveIcon (vanligtvis DockIcon).

Viktigt! Försök att anropa en SystemTrayIcon-klassmetod i NativeApplication.icon-objektet på ett operativsystem där AIR inte stöder aktivitetsfältsikoner genererar ett körningsfel.

Relaterade API-element

flash.desktop.NativeApplication.icon
flash.desktop.NativeApplication.supportsSystemTrayIcon
flash.desktop.DockIcon

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		bitmaps : Array [åsidosätt] Ikonbilden som en array med BitmapData-objekt i olika storlekar.	SystemTrayIcon
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object
		height : int [åsidosätt] [skrivskyddad] Ikonens aktuella visningshöjd i pixlar.	SystemTrayIcon
		menu : NativeMenu Aktivitetsfältsikonens meny.	SystemTrayIcon
		tooltip : String Den knappbeskrivning som visas för aktivitetsfältsikonen.	SystemTrayIcon
		width : int [åsidosätt] [skrivskyddad] Ikonens aktuella visningsbredd i pixlar.	SystemTrayIcon

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser.	EventDispatcher
		dispatchEvent(event:Event):Boolean Skickar en händelse till händelseflödet.	EventDispatcher
		hasEventListener(type:String):Boolean Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse.	EventDispatcher
		hasOwnProperty(name:String):Boolean Anger om det finns en egenskap angiven för ett objekt.	Object
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Tar bort en avlyssnare från EventDispatcher-objektet.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		toLocaleString():String Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.	Object
		toString():String Returnerar det angivna objektets strängbeteckning.	Object
		valueOf():Object Returnerar det angivna objektets primitiva värde.	Object
		willTrigger(type:String):Boolean Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen.	EventDispatcher

Händelser

Klicka för mer information om händelser

Dölj ärvda händelser

Visa ärvda händelser

	Sammanfattning	Definieras med
activate	[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt.	EventDispatcher
click	Skickas av det här SystemTrayIcon-objektet vid klick med musen.	SystemTrayIcon
deactivate	[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt.	EventDispatcher
mouseDown	Skickas av det här SystemTrayIcon-objektet vid mus ned.	SystemTrayIcon
mouseUp	Skickas av det här SystemTrayIcon-objektet vid mus upp.	SystemTrayIcon
rightClick	Skickas av det här SystemTrayIcon-objektet vid högerklick med musen.	SystemTrayIcon
rightMouseDown	Skickas av det här SystemTrayIcon-objektet vid höger musknapp ned.	SystemTrayIcon
rightMouseUp	Skickas av det här SystemTrayIcon-objektet vid höger musknapp upp.	SystemTrayIcon

Publika konstanter

	Konstant		Definieras med
		MAX_TIP_LENGTH : Number = 63 [statisk] Tillåten längd för aktivitetsfältsikonens knappbeskrivning.	SystemTrayIcon

Egenskapsdetaljer

bitmaps

egenskap

bitmaps:Array[åsidosätt]

Körningsmiljöversioner:

AIR 1.0

Ikonbilden som en array med BitmapData-objekt i olika storlekar.

När en ikon visas i ett visst operativsystemsammanhang används den bitmap i arrayen som bäst matchar visningsstorleken (bilden skalas vid behov). Vanliga storlekar är 16 x 16, 32 x 32, 48 x 48 och 128 x 128. (Ikoner med 512 x 512 pixlar kan snart komma att användas i vissa operativsystemikoner.)

I vissa fall kan operativsystemet använda en standardsystemikon om inget värde har tilldelats egenskapen bitmaps. I andra fall visas ingen ikon alls.

Om du vill ange eller ändra ikonens utseende tilldelar du en array av BitmapData-objekt till egenskapen bitmaps:

     icon.bitmaps = new Array(icon16x16.bitmapData, icon128x128.bitmapData);

Om du ändrar bitmaps-arrayen direkt har detta ingen effekt.

Om du vill ta bort ikonbilden anger du bitmaps-egenskapen till en tom array.

Obs! När bildfilerna för en ikon läses in ger PNG-formatet oftast bäst alfablandning. GIF-formatet har bara stöd för genomskinlighet eller ingen genomskinlighet (blandning saknas). JPG-formatet saknar helt stöd för genomskinlighet.

Implementering
override public function get bitmaps():Array
override public function set bitmaps(value:Array):void

height

egenskap

height:int [skrivskyddad] [åsidosätt]

Körningsmiljöversioner:

AIR 1.0

Ikonens aktuella visningshöjd i pixlar.

Vissa ikonsammanhang har stöd för dynamiska storlekar. height anger ikonens höjd, som hämtas från bitmaps-matrisen för det aktuella sammanhanget. Den verkliga visningshöjden kan vara en annan, om operativsystemet har skalat ikonen.

Implementering
override public function get height():int

tooltip

egenskap

tooltip:String

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Den knappbeskrivning som visas för aktivitetsfältsikonen. Om strängen är längre än SystemTrayIcon.MAX_TIP_LENGTH trunkeras beskrivningen.

Implementering
public function get tooltip():String
public function set tooltip(value:String):void

width

egenskap

width:int [skrivskyddad] [åsidosätt]

Körningsmiljöversioner:

AIR 1.0

Ikonens aktuella visningsbredd i pixlar.

Vissa ikonsammanhang har stöd för dynamiska storlekar. width anger ikonens bredd, som hämtas från bitmaps-matrisen för det aktuella sammanhanget. Den verkliga visningsbredden kan vara en annan, om operativsystemet har skalat ikonen.

Implementering
override public function get width():int

Händelsedetaljer

click

Händelse

Typ av händelseobjekt: flash.events.ScreenMouseEvent
egenskap ScreenMouseEvent.type = flash.events.ScreenMouseEvent.CLICK

Körningsmiljöversioner:

AIR 1.0

Skickas av det här SystemTrayIcon-objektet vid klick med musen.

ScreenMouseEvent.CLICK-konstanten definierar värdet på type-egenskapen i ett click-händelseobjekt.

Den här händelsen har följande relevanta egenskaper:

Egenskap	Värde
`buttonDown`	`true` om den primära musknappen trycks ned, annars `false`.
`ctrlKey`	`true` i Windows eller Linux om Ctrl-tangenten är aktiv. `true` om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars `false`.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`shiftKey`	`true` om skifttangenten är aktiverad eller `false` om den är inaktiverad.
`commandKey`	`true` om Kommando-tangenten är aktiv i Mac och `false` om den är inaktiv. Alltid `false` i Windows.
`controlKey`	`true` om Ctrl-tangenten är aktiv och `false` om den är inaktiv.
`screenX`	Den vågräta koordinat som händelsen inträffade vid i skärmkoordinater.
`screenY`	Den lodräta koordinat som händelsen inträffade vid i skärmkoordinater.
`target`	SystemTrayIcon-objektet under pekdonet.

mouseDown

Händelse

Typ av händelseobjekt: flash.events.ScreenMouseEvent
egenskap ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_DOWN

Körningsmiljöversioner:

AIR 1.0

Skickas av det här SystemTrayIcon-objektet vid mus ned.

ScreenMouseEvent.MOUSE_DOWN-konstanten definierar värdet på type-egenskapen i ett mouseDown-händelseobjekt.

Den här händelsen har följande relevanta egenskaper:

Egenskap	Värde
`buttonDown`	`true` om den primära musknappen trycks ned, annars `false`.
`ctrlKey`	`true` i Windows eller Linux om Ctrl-tangenten är aktiv. `true` om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars `false`.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`shiftKey`	`true` om skifttangenten är aktiverad eller `false` om den är inaktiverad.
`commandKey`	`true` om Kommando-tangenten är aktiv i Mac och `false` om den är inaktiv. Alltid `false` i Windows.
`controlKey`	`true` om Ctrl-tangenten är aktiv och `false` om den är inaktiv.
`screenX`	Den vågräta koordinat som händelsen inträffade vid i skärmkoordinater.
`screenY`	Den lodräta koordinat som händelsen inträffade vid i skärmkoordinater.
`target`	SystemTrayIcon-objektet under pekdonet.

mouseUp

Händelse

Typ av händelseobjekt: flash.events.ScreenMouseEvent
egenskap ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_UP

Körningsmiljöversioner:

AIR 1.0

Skickas av det här SystemTrayIcon-objektet vid mus upp.

ScreenMouseEvent.MOUSE_UP-konstanten definierar värdet på type-egenskapen i ett mouseUp-händelseobjekt.

Den här händelsen har följande relevanta egenskaper:

Egenskap	Värde
`buttonDown`	`true` om den primära musknappen trycks ned, annars `false`.
`ctrlKey`	`true` i Windows eller Linux om Ctrl-tangenten är aktiv. `true` om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars `false`.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`shiftKey`	`true` om skifttangenten är aktiverad eller `false` om den är inaktiverad.
`commandKey`	`true` om Kommando-tangenten är aktiv i Mac och `false` om den är inaktiv. Alltid `false` i Windows.
`controlKey`	`true` om Ctrl-tangenten är aktiv och `false` om den är inaktiv.
`screenX`	Den vågräta koordinat som händelsen inträffade vid i skärmkoordinater.
`screenY`	Den lodräta koordinat som händelsen inträffade vid i skärmkoordinater.
`target`	SystemTrayIcon-objektet under pekdonet.

rightClick

Händelse

Typ av händelseobjekt: flash.events.ScreenMouseEvent
egenskap ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_CLICK

Körningsmiljöversioner:

AIR 1.0

Skickas av det här SystemTrayIcon-objektet vid högerklick med musen.

ScreenMouseEvent.RIGHT_CLICK-konstanten definierar värdet på type-egenskapen i ett rightClick-händelseobjekt.

Den här händelsen har följande relevanta egenskaper:

Egenskap	Värde
`buttonDown`	`true` om den primära musknappen trycks ned, annars `false`.
`ctrlKey`	`true` i Windows eller Linux om Ctrl-tangenten är aktiv. `true` om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars `false`.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`shiftKey`	`true` om skifttangenten är aktiverad eller `false` om den är inaktiverad.
`commandKey`	`true` om Kommando-tangenten är aktiv i Mac och `false` om den är inaktiv. Alltid `false` i Windows.
`controlKey`	`true` om Ctrl-tangenten är aktiv och `false` om den är inaktiv.
`screenX`	Den vågräta koordinat som händelsen inträffade vid i skärmkoordinater.
`screenY`	Den lodräta koordinat som händelsen inträffade vid i skärmkoordinater.
`target`	SystemTrayIcon-objektet under pekdonet.

rightMouseDown

Händelse

Typ av händelseobjekt: flash.events.ScreenMouseEvent
egenskap ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_DOWN

Körningsmiljöversioner:

AIR 1.0

Skickas av det här SystemTrayIcon-objektet vid höger musknapp ned.

ScreenMouseEvent.RIGHT_MOUSE_DOWN-konstanten definierar värdet på type-egenskapen i ett rightMouseDown-händelseobjekt.

Den här händelsen har följande relevanta egenskaper:

Egenskap	Värde
`buttonDown`	`true` om den primära musknappen trycks ned, annars `false`.
`ctrlKey`	`true` i Windows eller Linux om Ctrl-tangenten är aktiv. `true` om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars `false`.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`shiftKey`	`true` om skifttangenten är aktiverad eller `false` om den är inaktiverad.
`commandKey`	`true` om Kommando-tangenten är aktiv i Mac och `false` om den är inaktiv. Alltid `false` i Windows.
`controlKey`	`true` om Ctrl-tangenten är aktiv och `false` om den är inaktiv.
`screenX`	Den vågräta koordinat som händelsen inträffade vid i skärmkoordinater.
`screenY`	Den lodräta koordinat som händelsen inträffade vid i skärmkoordinater.
`target`	SystemTrayIcon-objektet under pekdonet.

rightMouseUp

Händelse

Typ av händelseobjekt: flash.events.ScreenMouseEvent
egenskap ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_UP

Körningsmiljöversioner:

AIR 1.0

Skickas av det här SystemTrayIcon-objektet vid höger musknapp upp.

ScreenMouseEvent.RIGHT_MOUSE_UP-konstanten definierar värdet på type-egenskapen i ett rightMouseUp-händelseobjekt.

Den här händelsen har följande relevanta egenskaper:

Egenskap	Värde
`buttonDown`	`true` om den primära musknappen trycks ned, annars `false`.
`ctrlKey`	`true` i Windows eller Linux om Ctrl-tangenten är aktiv. `true` om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars `false`.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`shiftKey`	`true` om skifttangenten är aktiverad eller `false` om den är inaktiverad.
`commandKey`	`true` om Kommando-tangenten är aktiv i Mac och `false` om den är inaktiv. Alltid `false` i Windows.
`controlKey`	`true` om Ctrl-tangenten är aktiv och `false` om den är inaktiv.
`screenX`	Den vågräta koordinat som händelsen inträffade vid i skärmkoordinater.
`screenY`	Den lodräta koordinat som händelsen inträffade vid i skärmkoordinater.
`target`	SystemTrayIcon-objektet under pekdonet.

Konstantdetaljer

MAX_TIP_LENGTH

Konstant

public static const MAX_TIP_LENGTH:Number = 63

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Tillåten längd för aktivitetsfältsikonens knappbeskrivning.

Juridiska meddelanden | Onlinesekretesspolicy

SystemTrayIcon - AS3

Klasser x

bitmaps

height

menu

tooltip

width

click

mouseDown

mouseUp

rightClick

rightMouseDown

rightMouseUp

MAX_TIP_LENGTH