| Paket | mx.core |
| Klass | public class SpriteAsset |
| Arv | SpriteAsset  FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Implementerar | IFlexAsset, IFlexDisplayObject, IBorder, ILayoutDirectionElement |
| Underklasser | DefaultDragImage |
| Språkversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
The vector graphic image that you're embedding can be in an SVG file. You can also embed a sprite symbol that is in a SWF file produced by Flash. In both cases, the MXML compiler autogenerates a class that extends SpriteAsset to represent the embedded vector graphic image.
You don't generally have to use the SpriteAsset class directly when you write a Flex application. For example, you can embed a sprite symbol from a SWF file and display it in an Image control by writing the following:
<mx:Image id="logo" source="@Embed(source='Assets.swf', symbol='Logo')"/>
Or use it as the application's background image in CSS syntax by writing the following:
<fx:Style>
@namespace mx "library://ns.adobe.com/flex/mx"
mx|Application {
backgroundImage: Embed(source="Assets.swf", symbol='Logo')
}
<fx:Style/>
without having to understand that the MXML compiler has created a subclass of BitmapAsset for you.
However, it may be useful to understand what is happening
at the ActionScript level.
To embed a vector graphic image in ActionScript, you declare a variable
of type Class, and put [Embed] metadata on it.
For example, you embed a sprite symbol from a SWF file like this:
[Bindable] [Embed(source="Assets.swf", symbol="Logo")] private var logoClass:Class;
The MXML compiler notices that the Logo symbol in Assets.swf
is a sprite, autogenerates a subclass of the SpriteAsset class
to represent it, and sets your variable to be a reference to this
autogenerated class.
You can then use this class reference to create instances of the
SpriteAsset using the new operator, and use APIs
of the Sprite class on them:
var logo:SpriteAsset = SpriteAsset(new logoClass()); logo.rotation=45;
However, you rarely need to create SpriteAsset instances yourself
because image-related properties and styles can simply be set to an
image-producing class, and components will create image instances
as necessary.
For example, to display this vector graphic image in an Image control,
you can set the Image's source property to
logoClass.
In MXML you could do this as follows:
<mx:Image id="logo" source="{logoClass}"/>
Dölj ärvda publika egenskaper
Visa ärvda publika egenskaper| Egenskap | Definieras med | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
Den aktuella hjälpmedelsimplementeringen (AccessibilityImplementation) för den här InteractiveObject-instansen. | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
De nuvarande hjälpmedelsalternativen för det här visningsobjektet. | DisplayObject | |
| alpha : Number
Anger det angivna objektets alfagenomskinlighetsvärde. | DisplayObject | |
| blendMode : String
Ett värde från klassen BlendMode som anger vilket blandningsläge som ska användas. | DisplayObject | |
| blendShader : Shader [lässkyddad]
Ställer in en skuggning som används för blandning av förgrund och bakgrund. | DisplayObject | |
| borderMetrics : EdgeMetrics [skrivskyddad]
Returns an EdgeMetrics object for the border that has four properties:
left, top, right,
and bottom. | SpriteAsset | ||
| buttonMode : Boolean
Anger knappläge för den här spriten. | Sprite | |
| cacheAsBitmap : Boolean
Om det är true, sparar Flash-miljöerna en intern bitmappsrepresentation av visningsobjektet i cache-minnet. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Om detta inte är null definierar det här Matrix-objektet hur ett visningsobjekt återges när cacheAsBitmap har värdet true. | DisplayObject | |
| constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | |
| contextMenu : NativeMenu
Anger vilken snabbmeny som är associerad med det här objektet. | InteractiveObject | |
| doubleClickEnabled : Boolean
Anger om det här objektet tar emot doubleClick-händelser. | InteractiveObject | |
| dropTarget : DisplayObject [skrivskyddad]
Anger det visningsobjekt som spriten dras över, eller som spriten släpptes på. | Sprite | |
| filters : Array
En indexerad array som innehåller varje filterobjekt som är associerat med visningsobjektet. | DisplayObject | |
| focusRect : Object
Anger om det här objektet visar en fokusram. | InteractiveObject | |
| graphics : Graphics [skrivskyddad]
Anger det Graphics-objekt som tillhör denna sprite där kommandon för vektorritning kan göras. | Sprite | |
| height : Number
Anger visningsobjektets höjd i pixlar. | DisplayObject | |
| hitArea : Sprite
Utser en annan sprite som ska fungera som träffområde för en sprite. | Sprite | |
| layoutDirection : String
Specifies the desired layout direction for an element: one of LayoutDirection.LTR
(left to right), LayoutDirection.RTL (right to left), or null (inherit). | SpriteAsset | ||
| loaderInfo : LoaderInfo [skrivskyddad]
Returnerar ett LoaderInfo-objekt som innehåller information om hur filen som visningsobjektet tillhör ska läsas in. | DisplayObject | |
| mask : DisplayObject
Det anropande visningsobjektet maskeras av det angivna visningsobjektet. | DisplayObject | |
| measuredHeight : Number [skrivskyddad]
The measured height of this object. | SpriteAsset | ||
| measuredWidth : Number [skrivskyddad]
The measured width of this object. | SpriteAsset | ||
| metaData : Object
Erhåller metadataobjektet för instansen DisplayObject om metadata har lagrats tillsammans med instansen för detta DisplayObject i SWF-filen via en PlaceObject4-tagg. | DisplayObject | |
| mouseChildren : Boolean
Avgör om objektets underordnade objekt är aktiverade för en mus eller annan användarindataenhet (eller inte). | DisplayObjectContainer | |
| mouseEnabled : Boolean
Anger om det här objektet tar emot musmeddelanden eller annan indata från användaren. | InteractiveObject | |
| mouseX : Number [skrivskyddad]
Anger x-koordinaten för musens eller användarens indataenhets position i pixlar. | DisplayObject | |
| mouseY : Number [skrivskyddad]
Anger y-koordinaten för musens eller användarens indataenhets position i pixlar. | DisplayObject | |
| name : String
Anger instansnamnet för DisplayObject. | DisplayObject | |
| needsSoftKeyboard : Boolean
Anger om ett virtuellt tangentbord (t.ex. ett skärmtangentbord) ska visas när den här InteractiveObject-instansen är i fokus. | InteractiveObject | |
| numChildren : int [skrivskyddad]
Returnerar antalet underordnade objekt det här objektet har. | DisplayObjectContainer | |
| opaqueBackground : Object
Anger om visningsobjektet är ogenomskinligt med en viss bakgrundsfärg. | DisplayObject | |
| parent : DisplayObjectContainer [skrivskyddad]
Anger DisplayObjectContainer-objektet som innehåller visningsobjektet. | DisplayObject | |
| root : DisplayObject [skrivskyddad]
För ett visningsobjekt i en inläst SWF-fil är rotegenskapen det översta visningsobjektet i den del av visningslistans trädstruktur som representeras av den SWF-filen. | DisplayObject | |
| rotation : Number
Anger DisplayObject-instansens rotation i grader från den ursprungliga orienteringen. | DisplayObject | |
| rotationX : Number
Anger x-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren. | DisplayObject | |
| rotationY : Number
Anger y-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren. | DisplayObject | |
| rotationZ : Number
Anger z-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren. | DisplayObject | |
| scale9Grid : Rectangle
Det skalningsrutnät som används för närvarande. | DisplayObject | |
| scaleX : Number
Anger vågrät skala (i procent) för objektet utifrån dess registreringspunkt. | DisplayObject | |
| scaleY : Number
Anger lodrät skala (i procent) för objektet utifrån dess registreringspunkt. | DisplayObject | |
| scaleZ : Number
Anger djupskala (procent) för objektet utifrån dess registreringspunkt. | DisplayObject | |
| scrollRect : Rectangle
Visningsobjektets gränser för rullningsrektangeln. | DisplayObject | |
| softKeyboard : String
Kontrollerar utseendet på skärmtangentbordet. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Definierar det område som ska behållas på skärmen när skärmtangentbordet visas (ej tillgängligt på iOS). | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Styr ljudet i den här spriten. | Sprite | |
| stage : Stage [skrivskyddad]
Visningsobjektets scen. | DisplayObject | |
| tabChildren : Boolean
Avgör om objektets underordnade objekt är tabbaktiverade. | DisplayObjectContainer | |
| tabEnabled : Boolean
Anger om det här objektet inkluderas i tabbordningen. | InteractiveObject | |
| tabIndex : int
Anger tabbordningen för objekt i en SWF-fil. | InteractiveObject | |
| textSnapshot : flash.text:TextSnapshot [skrivskyddad]
Returnerar ett TextSnapshot-objekt för den här DisplayObjectContainer-instansen. | DisplayObjectContainer | |
| transform : flash.geom:Transform
Ett objekt med egenskaper som gäller ett visningsobjekts matris, färgomformning och pixelgränser. | DisplayObject | |
| useHandCursor : Boolean
Ett booleskt värde som anger om den pekande handen (handpekaren) ska visas när pekaren passerar över en sprite, vars buttonMode-egenskap är true. | Sprite | |
| visible : Boolean
Om visingsobjektet är synligt eller inte. | DisplayObject | |
| width : Number
Anger visningsobjektets bredd i pixlar. | DisplayObject | |
| x : Number
Anger x-koordinaten för DisplayObject-instansen i förhållande till de lokala koordinaterna för den överordnade DisplayObjectContainer. | DisplayObject | |
| y : Number
Anger y-koordinaten för DisplayObject-instansen i förhållande till de lokala koordinaterna för den överordnade DisplayObjectContainer. | DisplayObject | |
| z : Number
Anger z-koordinatens position längs DisplayObject-instansens z-axel i förhållande till den överordnade 3D-behållaren. | DisplayObject | |
| Metod | Definieras med | ||
|---|---|---|---|
Constructor. | SpriteAsset | ||
|
Lägger till en underordnad DisplayObject-instans i den här DisplayObjectContainer-instansen. | DisplayObjectContainer | |
|
Lägger till en underordnad DisplayObject-instans i den här DisplayObjectContainer-instansen. | DisplayObjectContainer | |
| 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 | |
|
Anger om säkerhetsrestriktionerna kan göra att visningsobjekt utelämnas från listan som returneras när metoden DisplayObjectContainer.getObjectsUnderPoint() anropas med den angivna punkten. | DisplayObjectContainer | |
|
Avgör om det angivna visningsobjektet är underordnat DisplayObjectContainer-instansen eller själva instansen. | DisplayObjectContainer | |
|
Skickar en händelse till händelseflödet. | EventDispatcher | |
|
Returnerar en rektangel som definierar visningsområdets område i relation till targetCoordinateSpace-objektets koordinatsystem. | DisplayObject | |
|
Returnerar den underordnade visningsobjektsinstansen som finns vid det angivna indexvärdet. | DisplayObjectContainer | |
|
Returnerar det underordnade visningsobjektet som har ett visst namn. | DisplayObjectContainer | |
|
Returnerar indexpositionen för en underordnad DisplayObject-instans. | DisplayObjectContainer | |
|
Returnerar en array med objekt som ligger under den angivna punkten och är underordnade (eller indirekt underordnade) den här DisplayObjectContainer-instansen. | DisplayObjectContainer | |
|
Returnerar en rektangel som definierar visningsområdets gräns, baserat på koordinatsystemet som definieras av targetCoordinateSpace-parametern, exklusive eventuella linjer i former. | DisplayObject | |
|
Konverterar punktobjektet från scenens (globala) koordinater till visningsobjektets (lokala) koordinater. | DisplayObject | |
|
Konverterar en tvådimensionell punkt från scenens (globala) koordinater till ett tredimensionellt visningsobjekts (lokala) koordinater. | DisplayObject | |
|
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. | EventDispatcher | |
|
Anger om det finns en egenskap angiven för ett objekt. | Object | |
|
Utvärderar begränsningsramen för visningsobjektet för att kontrollera om den överlappar eller korsar begränsningsramen för obj-visningsobjektet. | DisplayObject | |
|
Utvärderar visningsobjektet för att avgöra om det överlappar eller korsar den punkt som anges av x- och y-parametrarna. | DisplayObject | |
An element must call this method when its layoutDirection changes or
when its parent's layoutDirection changes. | SpriteAsset | ||
|
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | |
|
Konverterar en tredimensionell punkt för det tredimensionella visningsobjektets (lokala) koordinater till en tvådimensionell punkt i scenens (globala) koordinater. | DisplayObject | |
|
Konverterar punktobjektet från visningsobjektets (lokala) koordinater till scenens (globala) koordinater. | DisplayObject | |
Moves this object to the specified x and y coordinates. | SpriteAsset | ||
|
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | |
|
Tar bort den angivna underordnade DisplayObject-instansen från listan med underordnade för DisplayObjectContainer-instansen. | DisplayObjectContainer | |
|
Tar bort ett underordnat DisplayObject från den angivna indexpositionen i den underordnade listan i DisplayObjectContainer. | DisplayObjectContainer | |
|
Tar bort alla child-DisplayObject-instanser från listan med underordnade för DisplayObjectContainer-instansen. | DisplayObjectContainer | |
|
Tar bort en avlyssnare från EventDispatcher-objektet. | EventDispatcher | |
|
Visar ett virtuellt tangentbord. | InteractiveObject | |
Sets the actual size of this object. | SpriteAsset | ||
|
Ändrar positionen för ett befintligt underordnat objekt i behållaren för visningsobjekt. | DisplayObjectContainer | |
|
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | |
|
Gör att användaren kan dra angiven sprite. | Sprite | |
|
Låter användaren dra angiven sprite på en beröringsaktiverad enhet. | Sprite | |
|
Stoppar rekursivt tidslinjekörning av alla filmklipp vars rot är detta objekt. | DisplayObjectContainer | |
|
Avslutar metoden startDrag(). | Sprite | |
|
Avslutar metoden startTouchDrag(), som används med beröringsaktiverade enheter. | Sprite | |
|
Byter z-ordningen (framifrån och bakåt-ordning) för de två underordnade objekten. | DisplayObjectContainer | |
|
Byter z-ordningen (framifrån och bakåt-ordning) för underordnade objekt vid de två angivna indexpositionerna i listan med underordnade objekt. | DisplayObjectContainer | |
|
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | |
| [åsidosätt]
Returns a string indicating the location of this object
within the hierarchy of DisplayObjects in the Application. | FlexSprite | |
|
Returnerar det angivna objektets primitiva värde. | Object | |
|
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 | |
borderMetrics | egenskap |
borderMetrics:EdgeMetrics [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Returns an EdgeMetrics object for the border that has four properties:
left, top, right,
and bottom.
The value of each property is equal to the thickness of one side
of the border, in pixels.
Implementering
public function get borderMetrics():EdgeMetricslayoutDirection | egenskap |
layoutDirection:String| Språkversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.1 |
| Körningsmiljöversioner: | Flash Player 10, AIR 1.5 |
Specifies the desired layout direction for an element: one of LayoutDirection.LTR (left to right), LayoutDirection.RTL (right to left), or null (inherit). This property is typically backed by an inheriting style. If null, the layoutDirection style will be set to undefined. Classes like GraphicElement, which implement ILayoutDirectionElement but do not support styles, must additionally support a null value for this property which means the layoutDirection must be inherited from its parent.
Implementering
public function get layoutDirection():String public function set layoutDirection(value:String):voidmeasuredHeight | egenskap |
measuredHeight:Number [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
The measured height of this object.
This is typically hard-coded for graphical skins
because this number is simply the number of pixels in the graphic.
For code skins, it can also be hard-coded
if you expect to be drawn at a certain size.
If your size can change based on properties, you may want
to also be an ILayoutManagerClient so a measure()
method will be called at an appropriate time,
giving you an opportunity to compute a measuredHeight.
Implementering
public function get measuredHeight():NumbermeasuredWidth | egenskap |
measuredWidth:Number [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
The measured width of this object.
This is typically hard-coded for graphical skins
because this number is simply the number of pixels in the graphic.
For code skins, it can also be hard-coded
if you expect to be drawn at a certain size.
If your size can change based on properties, you may want
to also be an ILayoutManagerClient so a measure()
method will be called at an appropriate time,
giving you an opportunity to compute a measuredHeight.
Implementering
public function get measuredWidth():NumberSpriteAsset | () | Konstruktor |
public function SpriteAsset()| Språkversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Constructor.
invalidateLayoutDirection | () | metod |
public function invalidateLayoutDirection():void| Språkversion: | ActionScript 3.0 |
| Produktversion: | Flex 4.1 |
| Körningsmiljöversioner: | Flash Player 10, AIR 1.5 |
An element must call this method when its layoutDirection changes or when its parent's layoutDirection changes. If they differ, this method is responsible for mirroring the element’s contents and for updating the element’s post-layout transform so that descendants inherit a mirrored coordinate system. IVisualElements typically implement mirroring by using postLayoutTransformOffsets to scale the X axis by -1 and to translate the x coordinate of the origin by the element's width. The net effect of this "mirror" transform is to reverse the direction in which the X axis increases without changing the element's location relative to its parent's origin.
move | () | metod |
public function move(x:Number, y:Number):void| Språkversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Moves this object to the specified x and y coordinates.
Parametrar
x:Number — The new x-position for this object.
| |
y:Number — The new y-position for this object.
|
setActualSize | () | metod |
public function setActualSize(newWidth:Number, newHeight:Number):void| Språkversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Sets the actual size of this object.
This method is mainly for use in implementing the
updateDisplayList() method, which is where
you compute this object's actual size based on
its explicit size, parent-relative (percent) size,
and measured size.
You then apply this actual size to the object
by calling setActualSize().
In other situations, you should be setting properties
such as width, height,
percentWidth, or percentHeight
rather than calling this method.
Parametrar
newWidth:Number — The new width for this object.
| |
newHeight:Number — The new height for this object.
|
Tue Jun 12 2018, 01:40 PM Z