SystemTrayIcon - Bron voor Adobe ActionScript® 3 (AS3 ) API

Pakket	flash.desktop
Klasse	public class SystemTrayIcon
Overerving	SystemTrayIcon InteractiveIcon Icon EventDispatcher Object

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

De klasse SystemTrayIcon vertegenwoordigt het pictogram voor het type meldingsgebied van de Windows^®-taakbalk (systeemvak).

AIR-profielondersteuning: deze functie wordt ondersteund op desktopbesturingssystemen, maar niet op mobiele apparaten en ook niet op AIR for TV-apparaten. Zie AIR-profielondersteuning voor meer informatie over API-ondersteuning voor meerdere profielen.

Niet alle desktopbesturingssystemen hebben systeemvakpictogrammen. Controleer NativeApplication.supportsSystemTrayIcon om te bepalen of systeemvakpictogrammen door het huidige systeem worden ondersteund.

Een instantie van de klasse SystemTrayIcon kan niet worden gecreëerd. Haal het object dat het systeemvakpictogram voorstelt uit de eigenschap icon van het "globale" NativeApplication-object.

Als systeemvakpictogrammen worden ondersteund, is het pictogram van het type SystemTrayIcon. In andere gevallen is het type van icon een andere subklasse van InteractiveIcon, doorgaans DockIcon.

Belangrijk: Wanneer wordt geprobeerd om een methode van de klasse SystemTrayIcon uit te voeren voor het NativeApplication.icon-object op een besturingssysteem waarvoor AIR geen systeemvakpictogrammen ondersteunt, wordt een runtime-uitzondering gegenereerd.

Verwante API-elementen

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

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		bitmaps : Array [overschrijven] De pictogramafbeelding als een array van objecten BitmapData van verschillende grootten.	SystemTrayIcon
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object
		height : int [overschrijven] [alleen-lezen] De huidige weergegeven hoogte van het pictogram in pixels.	SystemTrayIcon
		menu : NativeMenu Het menu voor de snelkoppeling in het systeemvak.	SystemTrayIcon
		tooltip : String De knopinfo die voor de snelkoppeling in het systeemvak wordt weergegeven.	SystemTrayIcon
		width : int [overschrijven] [alleen-lezen] De weergegeven breedte van het pictogram in pixels.	SystemTrayIcon

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt.	EventDispatcher
		dispatchEvent(event:Event):Boolean Verzendt een gebeurtenis naar de gebeurtenisstroom.	EventDispatcher
		hasEventListener(type:String):Boolean Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis.	EventDispatcher
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	Object
		isPrototypeOf(theClass:Object):Boolean Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.	Object
		propertyIsEnumerable(name:String):Boolean Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Verwijdert een listener uit het object EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		toLocaleString():String Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.	Object
		toString():String Retourneert een tekenreeksrepresentatie van het opgegeven object.	Object
		valueOf():Object Retourneert de primitieve waarde van het opgegeven object.	Object
		willTrigger(type:String):Boolean Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis.	EventDispatcher

Gebeurtenissen

Klik voor meer informatie over gebeurtenissen.

Overerfde gebeurtenissen verbergen

Overerfde gebeurtenissen weergeven

	Overzicht	Gedefinieerd door
activate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt.	EventDispatcher
click	Door dit object SystemTrayIcon verzonden bij een klik met de muisknop.	SystemTrayIcon
deactivate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt.	EventDispatcher
mouseDown	Door dit object SystemTrayIcon verzonden als de muis omlaag wordt bewogen.	SystemTrayIcon
mouseUp	Door dit object SystemTrayIcon verzonden als de muis omhoog wordt bewogen.	SystemTrayIcon
rightClick	Door dit object SystemTrayIcon verzonden bij een klik met de rechtermuisknop.	SystemTrayIcon
rightMouseDown	Door dit object SystemTrayIcon verzonden als de rechtermuisknop omlaag gaat.	SystemTrayIcon
rightMouseUp	Door dit object SystemTrayIcon verzonden als de rechtermuisknop omhoog gaat.	SystemTrayIcon

Openbare constanten

	Constante		Gedefinieerd door
		MAX_TIP_LENGTH : Number = 63 [statisch] De toegestane lengte van de knopinfo voor de snelkoppeling in het systeemvak.	SystemTrayIcon

Eigenschapdetails

bitmaps

eigenschap

bitmaps:Array[overschrijven]

Runtimeversies:

AIR 1.0

De pictogramafbeelding als een array van objecten BitmapData van verschillende grootten.

Wanneer een pictogram in een bepaalde besturingssysteemcontext wordt weergegeven, wordt de bitmap gebruikt in de array die het weergegeven weergaveformaat het meest benadert (en indien nodig geschaald). Veelgebruikte formaten zijn 16x16, 32x32, 48x48, en 128x128. (In de nabije toekomst kunnen voor sommige besturingssysteempictogrammen pictogrammen van 512x512 pixels worden gebruikt.)

In sommige contexten kan het besturingssysteem een standaard besturingssysteempictogram gebruiken als er niets aan de eigenschap bitmaps is toegewezen. In andere contexten wordt geen pictogram weergegeven.

Als u de weergave van het pictogram wilt instellen of wijzigen, wijst u een array van BitmapData-objecten toe aan de eigenschap bitmaps:

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

Het rechtstreeks wijzigen van de array bitmaps heeft geen effect.

Als u de afbeelding van het pictogram wilt wissen, wijst u een lege array toe aan de eigenschap bitmaps.

Opmerking: De bestandsindeling PNG zorgt doorgaans voor de beste alfa-overvloeiing. De indeling GIF ondersteunt alleen transparantie aan of uit (geen overvloeiing). De indeling JPG ondersteunt helemaal geen transparantie.

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

height

eigenschap

height:int [alleen-lezen] [overschrijven]

Runtimeversies:

AIR 1.0

De huidige weergegeven hoogte van het pictogram in pixels.

Sommige pictogramcontexten ondersteunen dynamische grootten. De eigenschap height geeft de hoogte aan van het pictogram dat is gekozen uit de array bitmaps voor de huidige context. De eigenlijke weergavehoogte kan verschillen als het besturingssysteem het pictogram heeft geschaald.

Implementatie
override public function get height():int

tooltip

eigenschap

tooltip:String

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

De knopinfo die voor de snelkoppeling in het systeemvak wordt weergegeven. Als de tekenreeks langer is dan SystemTrayIcon.MAX_TIP_LENGTH, wordt de knopinfo afgebroken.

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

width

eigenschap

width:int [alleen-lezen] [overschrijven]

Runtimeversies:

AIR 1.0

De weergegeven breedte van het pictogram in pixels.

Sommige pictogramcontexten ondersteunen dynamische grootten. De eigenschap width geeft de breedte aan van het pictogram dat is gekozen uit de array bitmaps voor de huidige context. De eigenlijke wergavebreedte kan verschillen als het besturingssysteem het pictogram heeft geschaald.

Implementatie
override public function get width():int

Gebeurtenisdetails

click

Gebeurtenis

Type gebeurtenisobject: flash.events.ScreenMouseEvent
eigenschap ScreenMouseEvent.type = flash.events.ScreenMouseEvent.CLICK

Runtimeversies:

AIR 1.0

Door dit object SystemTrayIcon verzonden bij een klik met de muisknop.

De constante ScreenMouseEvent.CLICK bevat de waarde van de eigenschap type van eenclick-gebeurtenisobject.

Deze gebeurtenis heeft de volgende relevante eigenschappen:

Eigenschap	Waarde
`buttonDown`	`true` wanneer de primaire muisknop wordt ingedrukt; anders `false`.
`ctrlKey`	`true` onder Windows of Linux als de Ctrl-toets actief is. `true` op de Macintosh als de Ctrl-toets of Command-toets actief is. Anders is deze `false`.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`shiftKey`	`true` wanneer de Shift-toets actief is of `false` wanneer deze inactief is.
`commandKey`	`true` op de Macintosh als de Command-toets actief is; `false` als deze inactief is. Altijd `false` onder Windows.
`controlKey`	`true` wanneer de Ctrl- of Control-toets actief is of `false` wanneer deze inactief is.
`screenX`	De horizontale coördinaat waar de gebeurtenis heeft plaatsgevonden in schermcoördinaten.
`screenY`	De verticale coördinaat waar de gebeurtenis heeft plaatsgevonden in schermcoördinaten.
`target`	Het object SystemTrayIcon onder het aanwijsapparaat.

mouseDown

Gebeurtenis

Type gebeurtenisobject: flash.events.ScreenMouseEvent
eigenschap ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_DOWN

Runtimeversies:

AIR 1.0

Door dit object SystemTrayIcon verzonden als de muis omlaag wordt bewogen.

De constante ScreenMouseEvent.MOUSE_DOWN bevat waarde van de eigenschap type van een mouseDown-gebeurtenisobject.

Deze gebeurtenis heeft de volgende relevante eigenschappen:

Eigenschap	Waarde
`buttonDown`	`true` wanneer de primaire muisknop wordt ingedrukt; anders `false`.
`ctrlKey`	`true` onder Windows of Linux als de Ctrl-toets actief is. `true` op de Macintosh als de Ctrl-toets of Command-toets actief is. Anders is deze `false`.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`shiftKey`	`true` wanneer de Shift-toets actief is of `false` wanneer deze inactief is.
`commandKey`	`true` op de Macintosh als de Command-toets actief is; `false` als deze inactief is. Altijd `false` onder Windows.
`controlKey`	`true` wanneer de Ctrl- of Control-toets actief is of `false` wanneer deze inactief is.
`screenX`	De horizontale coördinaat waar de gebeurtenis heeft plaatsgevonden in schermcoördinaten.
`screenY`	De verticale coördinaat waar de gebeurtenis heeft plaatsgevonden in schermcoördinaten.
`target`	Het object SystemTrayIcon onder het aanwijsapparaat.

mouseUp

Gebeurtenis

Type gebeurtenisobject: flash.events.ScreenMouseEvent
eigenschap ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_UP

Runtimeversies:

AIR 1.0

Door dit object SystemTrayIcon verzonden als de muis omhoog wordt bewogen.

De constante ScreenMouseEvent.MOUSE_UP bevat de waarde van de eigenschap type van een mouseUp-gebeurtenisobject.

Deze gebeurtenis heeft de volgende relevante eigenschappen:

Eigenschap	Waarde
`buttonDown`	`true` wanneer de primaire muisknop wordt ingedrukt; anders `false`.
`ctrlKey`	`true` onder Windows of Linux als de Ctrl-toets actief is. `true` op de Macintosh als de Ctrl-toets of Command-toets actief is. Anders is deze `false`.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`shiftKey`	`true` wanneer de Shift-toets actief is of `false` wanneer deze inactief is.
`commandKey`	`true` op de Macintosh als de Command-toets actief is; `false` als deze inactief is. Altijd `false` onder Windows.
`controlKey`	`true` wanneer de Ctrl- of Control-toets actief is of `false` wanneer deze inactief is.
`screenX`	De horizontale coördinaat waar de gebeurtenis heeft plaatsgevonden in schermcoördinaten.
`screenY`	De verticale coördinaat waar de gebeurtenis heeft plaatsgevonden in schermcoördinaten.
`target`	Het object SystemTrayIcon onder het aanwijsapparaat.

rightClick

Gebeurtenis

Type gebeurtenisobject: flash.events.ScreenMouseEvent
eigenschap ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_CLICK

Runtimeversies:

AIR 1.0

Door dit object SystemTrayIcon verzonden bij een klik met de rechtermuisknop.

De constante ScreenMouseEvent.RIGHT_CLICK bevat de waarde van de eigenschap type van een rightClick-gebeurtenisobject.

Deze gebeurtenis heeft de volgende relevante eigenschappen:

Eigenschap	Waarde
`buttonDown`	`true` wanneer de primaire muisknop wordt ingedrukt; anders `false`.
`ctrlKey`	`true` onder Windows of Linux als de Ctrl-toets actief is. `true` op de Macintosh als de Ctrl-toets of Command-toets actief is. Anders is deze `false`.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`shiftKey`	`true` wanneer de Shift-toets actief is of `false` wanneer deze inactief is.
`commandKey`	`true` op de Macintosh als de Command-toets actief is; `false` als deze inactief is. Altijd `false` onder Windows.
`controlKey`	`true` wanneer de Ctrl- of Control-toets actief is of `false` wanneer deze inactief is.
`screenX`	De horizontale coördinaat waar de gebeurtenis heeft plaatsgevonden in schermcoördinaten.
`screenY`	De verticale coördinaat waar de gebeurtenis heeft plaatsgevonden in schermcoördinaten.
`target`	Het object SystemTrayIcon onder het aanwijsapparaat.

rightMouseDown

Gebeurtenis

Type gebeurtenisobject: flash.events.ScreenMouseEvent
eigenschap ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_DOWN

Runtimeversies:

AIR 1.0

Door dit object SystemTrayIcon verzonden als de rechtermuisknop omlaag gaat.

De constante ScreenMouseEvent.RIGHT_MOUSE_DOWN bevat de waarde van de eigenschap type van een rightMouseDown-gebeurtenisobject.

Deze gebeurtenis heeft de volgende relevante eigenschappen:

Eigenschap	Waarde
`buttonDown`	`true` wanneer de primaire muisknop wordt ingedrukt; anders `false`.
`ctrlKey`	`true` onder Windows of Linux als de Ctrl-toets actief is. `true` op de Macintosh als de Ctrl-toets of Command-toets actief is. Anders is deze `false`.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`shiftKey`	`true` wanneer de Shift-toets actief is of `false` wanneer deze inactief is.
`commandKey`	`true` op de Macintosh als de Command-toets actief is; `false` als deze inactief is. Altijd `false` onder Windows.
`controlKey`	`true` wanneer de Ctrl- of Control-toets actief is of `false` wanneer deze inactief is.
`screenX`	De horizontale coördinaat waar de gebeurtenis heeft plaatsgevonden in schermcoördinaten.
`screenY`	De verticale coördinaat waar de gebeurtenis heeft plaatsgevonden in schermcoördinaten.
`target`	Het object SystemTrayIcon onder het aanwijsapparaat.

rightMouseUp

Gebeurtenis

Type gebeurtenisobject: flash.events.ScreenMouseEvent
eigenschap ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_UP

Runtimeversies:

AIR 1.0

Door dit object SystemTrayIcon verzonden als de rechtermuisknop omhoog gaat.

De constante ScreenMouseEvent.RIGHT_MOUSE_UP bevat de waarde van de eigenschap type van een rightMouseUp-gebeurtenisobject.

Deze gebeurtenis heeft de volgende relevante eigenschappen:

Eigenschap	Waarde
`buttonDown`	`true` wanneer de primaire muisknop wordt ingedrukt; anders `false`.
`ctrlKey`	`true` onder Windows of Linux als de Ctrl-toets actief is. `true` op de Macintosh als de Ctrl-toets of Command-toets actief is. Anders is deze `false`.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`shiftKey`	`true` wanneer de Shift-toets actief is of `false` wanneer deze inactief is.
`commandKey`	`true` op de Macintosh als de Command-toets actief is; `false` als deze inactief is. Altijd `false` onder Windows.
`controlKey`	`true` wanneer de Ctrl- of Control-toets actief is of `false` wanneer deze inactief is.
`screenX`	De horizontale coördinaat waar de gebeurtenis heeft plaatsgevonden in schermcoördinaten.
`screenY`	De verticale coördinaat waar de gebeurtenis heeft plaatsgevonden in schermcoördinaten.
`target`	Het object SystemTrayIcon onder het aanwijsapparaat.

Constantedetails

MAX_TIP_LENGTH

Constante

public static const MAX_TIP_LENGTH:Number = 63

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

De toegestane lengte van de knopinfo voor de snelkoppeling in het systeemvak.

Juridische kennisgeving | Online privacybeleid

SystemTrayIcon - AS3

Klassen x

bitmaps

height

menu

tooltip

width

click

mouseDown

mouseUp

rightClick

rightMouseDown

rightMouseUp

MAX_TIP_LENGTH