IFlexDisplayObject  - AS3 Flex

Le opzioni di accessibilità correnti di questo oggetto di visualizzazione. Se modificate la proprietà accessibilityProperties o qualunque campo in accessibilityProperties, dovete chiamare il metodo Accessibility.updateProperties() per rendere attive le modifiche.

Nota: per un oggetto creato nell'ambiente di creazione di Flash, il valore di accessibilityProperties è precompilato con le informazioni eventualmente immesse nel pannello Accessibilità per quell'oggetto.

Indica il valore della trasparenza alfa dell'oggetto specificato. I valori validi sono quelli compresi tra 0 (completamente trasparente) e 1 (completamente opaco). Il valore predefinito è 1. Gli oggetti di visualizzazione con alpha impostato su 0 sono attivi, anche se invisibili.

Un valore della classe BlendMode che specifica il metodo di fusione da utilizzare. Una bitmap può essere disegnata internamente in due modi. Se disponete di un metodo di fusione abilitato o di una maschera di ritaglio esterna, la bitmap viene disegnata aggiungendo una forma quadrata con riempimento bitmap al renderer dei vettori. Se tentate di impostare questa proprietà su un valore non valido, i runtime di Flash impostano il valore su BlendMode.NORMAL.

La proprietà blendMode influisce su ogni pixel dell'oggetto di visualizzazione. Ciascun pixel è composto da tre colori costituenti (rosso, verde e blu) e ciascuno di essi presenta un valore compreso tra 0x00 e 0xFF. Flash Player o Adobe AIR confronta ogni colore costituente di un pixel del clip filmato con il colore corrispondente del pixel sullo sfondo. Ad esempio, se blendMode è impostato su BlendMode.LIGHTEN, il valore rosso dell'oggetto di visualizzazione viene confrontato da Flash Player o Adobe AIR con il valore rosso dello sfondo, e il più chiaro dei due viene utilizzato come valore per la componente rossa del colore visualizzato.

Nella tabella seguente sono descritte le impostazioni blendMode. La classe BlendMode definisce i valori di stringa utilizzabili. Le illustrazioni riportate nella tabella mostrano i valori blendMode applicati a un oggetto di visualizzazione circolare (2) sovrapposto a un altro oggetto di visualizzazione (1).

Costante BlendMode	Illustrazione	Descrizione
BlendMode.NORMAL		L'oggetto di visualizzazione appare in primo piano rispetto allo sfondo. I valori di pixel dell'oggetto di visualizzazione sostituiscono quelli dello sfondo. Se l'oggetto di visualizzazione è trasparente, lo sfondo è visibile.
BlendMode.LAYER		Forza la creazione di un gruppo di trasparenza per l'oggetto di visualizzazione. In altri termini, l'oggetto di visualizzazione viene pre-composto in un buffer temporaneo prima di essere ulteriormente elaborato. Questa operazione avviene automaticamente se l'oggetto di visualizzazione viene preventivamente memorizzato nella cache mediante la funzionalità di caching bitmap oppure se si tratta di un contenitore di oggetto di visualizzazione che include almeno un oggetto secondario con un'impostazione blendMode diversa da BlendMode.NORMAL. Non è supportato nel rendering GPU.
BlendMode.MULTIPLY		Moltiplica il valore dei colori costituenti dell'oggetto di visualizzazione per quelli del colore di sfondo, quindi li normalizza dividendo per 0xFF, ottenendo colori più scuri. Questa impostazione viene comunemente utilizzata per ombre ed effetti di profondità. Ad esempio, se un colore costituente (come il rosso) di un singolo pixel dell'oggetto di visualizzazione e il colore corrispondente del pixel sullo sfondo hanno entrambi valore 0x88, il risultato moltiplicato sarà 0x4840. Dividendo per 0xFF, per quel colore costituente si ottiene il risultato 0x48, vale a dire una tonalità più scura di quella del colore dell'oggetto di visualizzazione o dello sfondo.
BlendMode.SCREEN		Moltiplica il complemento (opposto) del colore dell'oggetto di visualizzazione per il complemento del colore di sfondo, ottenendo un effetto di decolorazione. Questa impostazione è comunemente utilizzata per le luci o per rimuovere aree nere dall'oggetto di visualizzazione.
BlendMode.LIGHTEN		Seleziona il più chiaro dei colori costituenti dell'oggetto di visualizzazione e dei colori dello sfondo (i colori con i valori più alti). Viene generalmente utilizzata per la sovrimpressione di caratteri. Ad esempio, se l'oggetto di visualizzazione ha un pixel con valore RGB 0xFFCC33 e il pixel di sfondo ha un valore RGB 0xDDF800, il valore RGB risultante per il pixel visualizzato è 0xFFF833 (perché 0xFF > 0xDD, 0xCC < 0xF8 e 0x33 > 0x00 = 33). Non è supportato nel rendering GPU.
BlendMode.DARKEN		Seleziona il più scuro dei colori costituenti dell'oggetto di visualizzazione e dei colori dello sfondo (i colori con i valori più bassi). Viene generalmente utilizzata per la sovrimpressione di caratteri. Ad esempio, se l'oggetto di visualizzazione ha un pixel con valore RGB 0xFFCC33 e il pixel di sfondo ha un valore RGB 0xDDF800, il valore RGB risultante per il pixel visualizzato è 0xDDCC00 (perché 0xFF > 0xDD, 0xCC < 0xF8 e 0x33 > 0x00 = 33). Non è supportato nel rendering GPU.
BlendMode.DIFFERENCE		Confronta i colori costituenti dell'oggetto di visualizzazione con quelli dello sfondo e sottrae il più scuro dei valori dei due colori costituenti dal più chiaro. Viene generalmente utilizzata per ottenere colori più brillanti. Ad esempio, se l'oggetto di visualizzazione ha un pixel con un valore RGB di 0xFFCC33 e il pixel di sfondo ha un valore RGB di 0xDDF800, il valore RGB risultante per il pixel visualizzato è 0x222C33, perché 0xFF - 0xDD = 0x22, 0xF8 - 0xCC = 0x2C, e 0x33 - 0x00 = 0x33.
BlendMode.ADD		Aggiunge i valori dei colori costituenti dell'oggetto di visualizzazione a quelli dei colori dello sfondo, applicando un valore ceiling di 0xFF. Questa impostazione è generalmente utilizzata per animare una dissolvenza di schiarimento tra due oggetti. Ad esempio, se l'oggetto di visualizzazione ha un pixel con un valore RGB di 0xAAA633 e il pixel di sfondo ha un valore RGB di 0xDD2200, il valore RGB risultante per il pixel visualizzato è 0xFFC833 (perché 0xAA + 0xDD > 0xFF, 0xA6 + 0x22 = 0xC8 e 0x33 + 0x00 = 0x33).
BlendMode.SUBTRACT		Sottrae i valori dei colori costituenti dell'oggetto di visualizzazione da quelli del colore di sfondo, applicando un valore floor pari a 0. Questa impostazione è generalmente utilizzata per animare una dissolvenza di scurimento tra due oggetti. Ad esempio, se l'oggetto di visualizzazione ha un pixel con valore RGB 0xAA2233 e il pixel di sfondo ha un valore RGB 0xDDA600, il valore RGB risultante per il pixel visualizzato è 0x338400 (perché 0xDD - 0xAA = 0x33, 0xA6 - 0x22 = 0x84 e 0x00 - 0x33 < 0x00).
BlendMode.INVERT		Inverte lo sfondo.
BlendMode.ALPHA		Applica il valore alfa di ciascun pixel dell'oggetto di visualizzazione allo sfondo. La proprietà blendMode dell'oggetto di visualizzazione principale deve essere impostata su BlendMode.LAYER. Ad esempio, nell'illustrazione a fianco, l'oggetto di visualizzazione principale, che è uno sfondo bianco, ha un valore blendMode = BlendMode.LAYER. Non è supportato nel rendering GPU.
BlendMode.ERASE		Elimina lo sfondo in base al valore alfa dell'oggetto di visualizzazione. La proprietà blendMode dell'oggetto di visualizzazione principale deve essere impostata su BlendMode.LAYER. Ad esempio, nell'illustrazione a fianco, l'oggetto di visualizzazione principale, che è uno sfondo bianco, ha un valore blendMode = BlendMode.LAYER. Non è supportato nel rendering GPU.
BlendMode.OVERLAY		Regola il colore di ogni pixel in base al livello di scuro dello sfondo. Se lo sfondo è più chiaro del grigio al 50%, i colori dell'oggetto di visualizzazione e dello sfondo vengono retinati, ottenendo un colore più chiaro. Se lo sfondo è più scuro del grigio al 50%, i colori vengono moltiplicati, producendo un colore più scuro. Questa impostazione viene generalmente utilizzata per gli effetti di ombreggiatura. Non è supportato nel rendering GPU.
BlendMode.HARDLIGHT		Regola il colore di ogni pixel in base al livello di scuro dell'oggetto di visualizzazione. Se l'oggetto di visualizzazione è più chiaro del grigio al 50%, i suoi colori e quelli dello sfondo vengono retinati, ottenendo un colore più chiaro. Se l'oggetto di visualizzazione è più scuro del grigio al 50%, i colori vengono moltiplicati, producendo un colore più scuro. Questa impostazione viene generalmente utilizzata per gli effetti di ombreggiatura. Non è supportato nel rendering GPU.
BlendMode.SHADER	N/D	Regola il colore utilizzando una routine dello shader personalizzata. Lo shader utilizzato è specificato come istanza Shader assegnata alla proprietà blendShader. L'impostazione della proprietà blendShader di un oggetto di visualizzazione su un'istanza Shader, imposta automaticamente la proprietà blendMode dell'oggetto di visualizzazione su BlendMode.SHADER. Se impostate la proprietà blendMode su BlendMode.SHADER senza impostare prima la proprietà blendShader, la proprietà blendMode verrà invece impostata su BlendMode.NORMAL. Non è supportato nel rendering GPU.

Se è impostata su true, nella cache dei runtime Flash viene memorizzata una rappresentazione bitmap interna dell'oggetto di visualizzazione. In questo modo, possono essere migliorate le prestazioni degli oggetti di visualizzazione con contenuto vettoriale complesso.

Tutti i dati vettoriali di un oggetto di visualizzazione con una bitmap memorizzata nella cache vengono disegnati sulla bitmap anziché nella vista principale. Se cacheAsBitmapMatrix è null o non supportato, la bitmap viene quindi copiata nella vista principale sotto forma di pixel non allungati né ruotati, agganciati ai limiti dei pixel più vicini. I pixel vengono mappati 1 a 1 con l'oggetto principale. Se i limiti della bitmap cambiano, questa viene ricreata anziché essere allungata.

Se cacheAsBitmapMatrix è diverso da null e supportato, l'oggetto viene disegnato sulla bitmap fuori schermo utilizzando quella matrice e vengono utilizzati i risultati estesi e/o ruotati di tale rendering per disegnare l'oggetto nella visualizzazione principale.

Non viene creata alcuna bitmap interna, a meno che la proprietà cacheAsBitmap sia impostata su true.

Il rendering non viene modificato dopo l'impostazione della proprietà cacheAsBitmap su true, tuttavia l'oggetto di visualizzazione esegue automaticamente l'aggancio ai pixel. La velocità dell'animazione può essere notevolmente aumentata, a seconda della complessità del contenuto vettoriale.

La proprietà cacheAsBitmap viene impostata automaticamente su true ogni volta che si applica un filtro a un oggetto di visualizzazione (quando l'array filter dell'oggetto non è vuoto); e se a un oggetto di visualizzazione è applicato un filtro, la proprietà cacheAsBitmap risulta true anche se viene impostata su false. Se tutti i filtri di un oggetto di visualizzazione vengono rimossi, l'impostazione cacheAsBitmap ritorna all'ultimo valore impostato.

Un oggetto di visualizzazione non utilizza una bitmap anche se la proprietà cacheAsBitmap è impostata su true e, al contrario, esegue il rendering dai dati vettoriali nei seguenti casi:

• La bitmap è troppo grande. In AIR 1.5 e Flash Player 10, la dimensione massima di un'immagine bitmap è di 8.191 pixel in larghezza o altezza, mentre il numero totale di pixel non può essere superiore a 16.777.215. (Quindi, se un'immagine bitmap ha una larghezza di 8.191 pixel, può avere solo una lunghezza di 2.048 pixel.) In Flash Player 9 e versioni precedenti, la limitazione è di 2.880 pixel in altezza e 2.880 pixel in larghezza.
• L'allocazione della bitmap fallisce (errore di memoria esaurita).

L'uso della proprietà cacheAsBitmap è più adatto ai clip filmato che includono contenuto statico e non vengono modificati in scala e ruotati frequentemente. Con questo tipo di clip filmato, la proprietà cacheAsBitmap può consentire miglioramenti delle prestazioni in caso di conversione di un clip filmato (quando ne viene modificata la posizione di x e y).

Un array indicizzato che contiene ogni oggetto filtro attualmente associato all'oggetto di visualizzazione. Il pacchetto flash.filters contiene diverse classi che definiscono dei filtri speciali.

I filtri possono essere applicati mediante Flash Professional in fase di progettazione o in fase di runtime utilizzando codice ActionScript. Per applicare un filtro utilizzando codice ActionScript, dovete creare una copia temporanea dell'intero array filters, modificare l'array temporaneo, quindi riassegnarne il valore all'array filters. Non è possibile aggiungere direttamente un nuovo oggetto filtro all'array filters.

Per aggiungere un filtro utilizzando ActionScript, procedete nel modo seguente (si presuppone che l'oggetto di visualizzazione di destinazione sia denominato myDisplayObject):

1. Create un nuovo oggetto filtro mediante il metodo di costruzione della classe di filtri scelta.
2. Assegnate il valore dell'array myDisplayObject.filters a un array temporaneo, ad esempio un array denominato myFilters.
3. Aggiungete il nuovo oggetto filtro all'array temporaneo myFilters.
4. Assegnate il valore dell'array temporaneo all'array myDisplayObject.filters.

Se l'array filters è undefined, non occorre utilizzare un array temporaneo. Potete, invece, assegnare direttamente un valore letterale di array contenente uno o più oggetti filtro personalizzati. Nel primo esempio della sezione Esempi viene aggiunto un filtro ombra esterna mediante del codice che gestisce array filters sia definiti che non definiti.

Per modificare un oggetto filtro esistente, dovete utilizzare una tecnica che consente di modificare una copia dell'array filters:

1. Assegnate il valore dell'array filters a un array temporaneo, denominato ad esempio myFilters.
2. Modificate la proprietà mediante l'array temporaneo myFilters. Ad esempio, per impostare la proprietà quality del primo filtro dell'array, potete utilizzare il codice seguente: myFilters[0].quality = 1;
3. Assegnate il valore dell'array temporaneo all'array filters.

Al momento del caricamento, se un oggetto di visualizzazione è associato a un filtro, l'oggetto viene contrassegnato in modo che sia memorizzato automaticamente nella cache come bitmap trasparente. Da questo punto in avanti, a condizione che all'oggetto di visualizzazione sia associato un elenco di filtri valido, il lettore memorizza l'oggetto di visualizzazione nella cache come bitmap. Questa bitmap di origine viene utilizzata come immagine di origine per gli effetti filtro. Ogni oggetto di visualizzazione dispone in genere di due bitmap: una con l'oggetto di visualizzazione di origine non filtrato originale e l'altra per l'immagine finale dopo l'applicazione del filtro. L'immagine finale viene utilizzata al momento del rendering. Se l'oggetto di visualizzazione non viene modificato, l'immagine finale non richiede alcun aggiornamento.

Il pacchetto flash.filters contiene classi specifiche per i filtri. Ad esempio, per creare un filtro DropShadow, potete scrivere il seguente codice:

     import flash.filters.DropShadowFilter
     var myFilter:DropShadowFilter = new DropShadowFilter (distance, angle, color, alpha, blurX, blurY, quality, inner, knockout)
     

L'operatore is può essere utilizzato per determinare il tipo di filtro assegnato a ogni posizione di indice nell'array filter. Ad esempio, il codice seguente mostra come determinare la posizione del primo filtro dell'array filters che corrisponde al tipo DropShadowFilter:

     import flash.text.TextField;
     import flash.filters.*;
     var tf:TextField = new TextField();
     var filter1:DropShadowFilter = new DropShadowFilter();
     var filter2:GradientGlowFilter = new GradientGlowFilter();
     tf.filters = [filter1, filter2];
     
     tf.text = "DropShadow index: " + filterPosition(tf, DropShadowFilter).toString(); // 0
     addChild(tf)
     
     function filterPosition(displayObject:DisplayObject, filterClass:Class):int {
         for (var i:uint = 0; i < displayObject.filters.length; i++) {
             if (displayObject.filters[i] is filterClass) {
                 return i;
             }
         }
         return -1;
     }
     

Nota: poiché non è possibile aggiungere direttamente un nuovo oggetto filter all'array DisplayObject.filters, il codice seguente non ha alcun effetto sull'oggetto di visualizzazione target denominato myDisplayObject:

     myDisplayObject.filters.push(myDropShadow);
     

Indica l'altezza dell'oggetto di visualizzazione espressa in pixel. L'altezza viene calcolata in base ai limiti del contenuto dell'oggetto di visualizzazione. Quando impostate la proprietà height, la proprietà scaleY viene impostata di conseguenza, come illustrato nel codice seguente:

    var rect:Shape = new Shape();
    rect.graphics.beginFill(0xFF0000);
    rect.graphics.drawRect(0, 0, 100, 100);
    trace(rect.scaleY) // 1;
    rect.height = 200;
    trace(rect.scaleY) // 2;

Ad eccezione degli oggetti TextField e Video, un oggetto di visualizzazione senza contenuto (quale uno sprite vuoto) presenta un'altezza pari a 0, anche se si tenta di impostare height su un valore differente.

Restituisce un oggetto LoaderInfo contenente informazioni sul caricamento del file al quale questo oggetto di visualizzazione appartiene. La proprietà loaderInfo viene definita solo per l'oggetto di visualizzazione principale di un file SWF o per una bitmap caricata (non invece per una bitmap disegnata con ActionScript). Per trovare l'oggetto loaderInfo associato con il file SWF che contiene un oggetto di visualizzazione denominato myDisplayObject, utilizzate myDisplayObject.root.loaderInfo.

Un file SWF di grandi dimensioni può monitorare il processo di scaricamento chiamando this.root.loaderInfo.addEventListener(Event.COMPLETE, func).

L'oggetto di visualizzazione chiamante viene mascherato dall'oggetto mask specificato. Per fare in modo che la mascheratura funzioni quando lo stage viene ridimensionato, l'oggetto di visualizzazione mask deve trovarsi in una parte attiva dell'elenco di visualizzazione. L'oggetto mask vero e proprio non viene disegnato. Impostate mask su null per rimuovere la maschera.

Per poter ridimensionare un oggetto mask, quest'ultimo deve essere incluso nell'elenco di visualizzazione. Allo stesso modo, per poter trascinare un oggetto Sprite mask (chiamandone il metodo startDrag()), l'oggetto deve trovarsi nell'elenco di visualizzazione. Per chiamare il metodo startDrag() per un oggetto Sprite mask basato su un evento mouseDown inviato dallo sprite, impostare la proprietà buttonMode dello sprite su true.

Quando gli oggetti di visualizzazione sono memorizzati nella cache impostando la proprietà cacheAsBitmap su true e la proprietà cacheAsBitmapMatrix su un oggetto Matrix, sia l'oggetto mask che l'oggetto di visualizzazione devono fare parte della medesima bitmap memorizzata nella cache. Di conseguenza, se l'oggetto di visualizzazione è memorizzato nella cache, la maschera dovrà essere un elemento secondario dell'oggetto di visualizzazione. Se un elemento antenato dell'oggetto di visualizzazione è memorizzato nella cache all'interno dell'elenco di visualizzazione, la maschera dovrà essere un elemento secondario di tale elemento o un suo discendente. Se nella cache sono memorizzati più antenati dell'oggetto mask, tale oggetto dovrà essere un discendente del contenitore memorizzato nell'elenco di visualizzazione nella posizione più vicina all'oggetto mask.

Nota: non potete utilizzare un singolo oggetto mask per mascherare più di un oggetto di visualizzazione chiamante. Quando assegnate mask a un secondo oggetto di visualizzazione, esso viene rimosso come maschera del primo oggetto e la proprietà maskdi quell'oggetto diventa null.

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.

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.

Indica la coordinata x del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel.

Nota: per un DisplayObject che è stato ruotato, la coordinata x restituita corrisponderà a quella dell'oggetto non ruotato.

Indica la coordinata y del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel.

Nota: per un DisplayObject che è stato ruotato, la coordinata y restituita corrisponderà a quella dell'oggetto non ruotato.

Indica il nome dell'istanza dell'oggetto DisplayObject. L'oggetto può essere identificato nell'elenco degli elementi secondari del contenitore dell'oggetto di visualizzazione principale chiamando il metodo getChildByName() di tale contenitore.

Specifica se l'oggetto di visualizzazione è opaco con un determinato colore di sfondo. Una bitmap trasparente contiene i dati del canale alfa e viene disegnata in modo trasparente. Una bitmap opaca non ha un canale alfa e il suo rendering viene eseguito più rapidamente. Se la bitmap è opaca, è possibile specificarne il colore di sfondo.

Se viene impostato un valore numerico, la superficie è opaca (non trasparente) con il colore di sfondo RGB specificato dal numero. Se viene impostato su null (il valore predefinito), l'oggetto di visualizzazione ha uno sfondo trasparente.

La proprietà opaqueBackground viene utilizzata principalmente con la proprietà cacheAsBitmap per ottimizzare il rendering. Per gli oggetti di visualizzazione nei quali la proprietà cacheAsBitmap è impostata su true, l'impostazione di opaqueBackground può migliorare le prestazioni del rendering.

Per l'area dello sfondo opaco non viene eseguita la corrispondenza quando si chiama il metodo hitTestPoint() con il parametro shapeFlag impostato su true.

L'area dello sfondo opaco non risponde agli eventi del mouse.

Indica l'oggetto DisplayObjectContainer che contiene questo oggetto di visualizzazione. Utilizzate la proprietà parent per specificare un percorso relativo per gli oggetti di visualizzazione che si trovano sopra l'oggetto di visualizzazione corrente nella gerarchia dell'elenco di visualizzazione.

Potete utilizzare parent per spostarsi verso l'alto di più livelli nell'elenco di visualizzazione, come illustrato di seguito:

     this.parent.parent.alpha = 20;
     

Nel caso di un oggetto di visualizzazione all'interno di un file SWF caricato, la proprietà root è l'oggetto di visualizzazione più in alto nella porzione della struttura dell'elenco di visualizzazione rappresentata da quel file SWF. Per un oggetto Bitmap che rappresenta un file di immagine caricato, la proprietà root è lo stesso oggetto Bitmap. Per l'istanza della classe principale del primo file SWF caricato, la proprietà root è lo stesso oggetto di visualizzazione. La proprietà root dell'oggetto Stage è lo stesso oggetto Stage. La proprietà root viene impostata su null per ciascun oggetto di visualizzazione che non è stato aggiunto all'elenco di visualizzazione, a meno che non sia stato aggiunto a un contenitore di oggetto di visualizzazione che è esterno all'elenco di visualizzazione ma è un elemento secondario dell'oggetto di visualizzazione di primo livello in un file SWF caricato.

Ad esempio, se si crea un nuovo oggetto Sprite chiamando il metodo di costruzione Sprite(), la sua proprietà root è null finché l'oggetto non viene aggiunto all'elenco di visualizzazione (o a un contenitore di oggetto di visualizzazione che è esterno all'elenco di visualizzazione ma è un elemento secondario dell'oggetto di visualizzazione di primo livello in un file SWF caricato).

Per un file SWF caricato, anche se l'oggetto Loader utilizzato per caricare il file potrebbe non essere incluso nell'elenco di visualizzazione, l'oggetto di visualizzazione di primo livello del file SWF ha la proprietà root impostata su se stesso. La proprietà root dell'oggetto Loader non viene impostata finché l'oggetto non viene impostato come elemento secondario di un oggetto di visualizzazione per il quale tale proprietà è impostata.

Indica la rotazione dell'istanza DisplayObject, espressa in gradi, rispetto alla posizione originale. I valori da 0 a 180 rappresentano la rotazione oraria, quelli da 0 a -180 la rotazione antioraria. I valori esterni a questo intervallo vengono aggiunti o sottratti a 360 per ottenere un valore interno all'intervallo. Ad esempio, l'istruzione my_video.rotation = 450 è uguale a my_video.rotation = 90.

La griglia di modifica in scala attualmente attiva. Se è impostata su null, l'intero oggetto di visualizzazione viene modificato in scala normalmente quando viene applicata una trasformazione in scala.

Quando definite la proprietà scale9Grid, l'oggetto di visualizzazione viene suddiviso in una griglia di nove aree, in base al rettangolo scale9Grid che definisce l'area centrale della griglia. Le altre otto aree della griglia sono le seguenti:

• L'angolo superiore sinistro fuori del rettangolo
• L'area sopra il rettangolo
• L'angolo superiore destro fuori del rettangolo
• L'area a sinistra del rettangolo
• L'area a destra del rettangolo
• L'angolo inferiore sinistro fuori del rettangolo
• L'area sotto il rettangolo
• L'angolo inferiore destro fuori del rettangolo

Le otto aree esterne al centro (definito dal rettangolo) sono paragonabili alla cornice di un quadro alla quale vengono applicate regole speciali per la modifica in scala.

Quando impostate la proprietà scale9Grid e modificate in scala un oggetto di visualizzazione, tutto il testo e i gradienti vengono modificati in scala normalmente; tuttavia, per altri tipi di oggetti valgono le regole seguenti:

• Il contenuto dell'area centrale viene modificato in scala normalmente.
• Il contenuto presente negli angoli non viene modificato in scala.
• Il contenuto dell'area superiore e dell'area inferiore viene modificato in scala solo in senso orizzontale. Il contenuto dell'area sinistra e dell'area destra viene modificato in scala solo in senso verticale.
• Tutti i riempimenti (bitmap, video e con gradiente) vengono allungati per adattarne le forme.

Se un oggetto di visualizzazione viene ruotato, tutte le successive modifiche in scala sono normali e la proprietà scale9Grid viene ignorata.

Considerate, ad esempio, il seguente oggetto di visualizzazione e un rettangolo applicato come proprietà scale9Grid dell'oggetto di visualizzazione:

L'oggetto di visualizzazione.

Il rettangolo rosso mostra la proprietà scale9Grid.

Quando l'oggetto di visualizzazione viene modificato in scala o allungato, gli oggetti contenuti nel rettangolo vengono modificati in scala normalmente, mentre quelli all'esterno vengono modificati in base alle regole di scale9Grid:

Modificato in scala al 75%:
Modificato in scala al 50%:
Modificato in scala al 25%:
Allungato orizzontalmente del 150%:

Un uso comune per l'impostazione di scale9Grid consiste nel definire un oggetto di visualizzazione da utilizzare come componente, nel quale aree dei bordi mantengano la stessa larghezza quando il componente viene modificato in scala.

Indica la scala orizzontale (percentuale) dell'oggetto applicata dal punto di registrazione. Il punto di registrazione predefinito è (0,0). 1.0 equivale a una scala del 100%.

La modifica in scala del sistema di coordinate locale modifica i valori delle proprietà x e y, che sono definiti in pixel interi.

Indica la scala verticale (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto. Il punto di registrazione predefinito è (0,0). 1.0 equivale a una scala del 100%.

La modifica in scala del sistema di coordinate locale modifica i valori delle proprietà x e y, che sono definiti in pixel interi.

I limiti del rettangolo di scorrimento dell'oggetto di visualizzazione. L'oggetto di visualizzazione viene ritagliato in base alle dimensioni definite dal rettangolo, e scorre all'interno del rettangolo quando si modificano le proprietà x e y dell'oggetto scrollRect.

Le proprietà dell'oggetto Rectangle scrollRect utilizzano lo spazio di coordinate dell'oggetto di visualizzazione e vengono modificate in scala allo stesso modo dell'oggetto di visualizzazione. I contorni degli angoli della finestra ritagliata sull'oggetto di visualizzazione di scorrimento costituiscono l'origine dell'oggetto di visualizzazione (0,0) e il punto definito dalla larghezza e dall'altezza del rettangolo. Non sono centrati intorno all'origine, bensì la utilizzano per definire l'angolo superiore sinistro dell'area. Lo scorrimento di un oggetto di visualizzazione scorrevole viene sempre eseguito a incrementi di pixel interi.

Potete scorrere un oggetto a sinistra e a destra impostando la proprietà x dell'oggetto Rectangle scrollRect. Per farlo scorrere verso l'alto e verso il basso, impostate la proprietà y dell'oggetto Rectangle scrollRect. Se l'oggetto di visualizzazione viene ruotato di 90 gradi e fatto scorrere verso sinistra e destra, lo scorrimento avviene in realtà verso l'alto e verso il basso.

Tenete presente che le modifiche apportate alla proprietà scrollRect vengono elaborate solo quando avviene il rendering dell'oggetto. Pertanto, metodi quali localToGlobal potrebbero non produrre il risultato previsto se chiamati immediatamente dopo la modifica di scrollRect.

Nota: a partire da Flash Player 11.4/AIR 3.4, i valori negativi per la larghezza o l’altezza del rettangolo vengono sostituiti con 0.

Lo stage dell'oggetto di visualizzazione. Un'applicazione del runtime Flash dispone di un unico oggetto Stage. Ad esempio, se create e caricate più oggetti di visualizzazione nell'elenco di visualizzazione, la proprietà stage di ciascuno di essi fa riferimento allo stesso oggetto Stage (anche se l'oggetto appartiene a un file SWF caricato).

Se un oggetto di visualizzazione non viene aggiunto all'elenco di visualizzazione, la sua proprietà stage viene impostata su null.

Un oggetto con proprietà relative alla matrice, alla trasformazione del colore e ai limiti di pixel di un oggetto di visualizzazione. Le proprietà specifiche matrix, colorTransform e tre proprietà di sola lettura (concatenatedMatrix, concatenatedColorTransform e pixelBounds) sono descritte nella voce relativa alla classe Transform.

Ognuna delle proprietà dell'oggetto di trasformazione è, essa stessa, un oggetto. Questo concetto è importante, poiché il solo modo per impostare nuovi valori per gli oggetti matrix o colorTransform consiste nel creare un nuovo oggetto e copiarlo nella proprietà transform.matrix o transform.colorTransform.

Ad esempio, per aumentare il valore tx della matrice di un oggetto di visualizzazione, dovete creare una copia dell'intero oggetto matrice, quindi copiare il nuovo oggetto nella proprietà matrix dell'oggetto di trasformazione:

    var myMatrix:Matrix = myDisplayObject.transform.matrix;  
    myMatrix.tx += 10; 
    myDisplayObject.transform.matrix = myMatrix;  
    

Non è possibile impostare direttamente la proprietà tx. Il codice seguente non ha effetto su myDisplayObject:

    myDisplayObject.transform.matrix.tx += 10;
    

Potete inoltre copiare un intero oggetto di trasformazione e assegnarlo alla proprietà di trasformazione di un altro oggetto di visualizzazione. Ad esempio, il codice seguente copia l'intero oggetto di trasformazione da myOldDisplayObj a myNewDisplayObj:

L'oggetto di visualizzazione ottenuto, myNewDisplayObj, presenta ora gli stessi valori dell'oggetto di visualizzazione precedente (myOldDisplayObj) per la matrice, la trasformazione del colore e i limiti dei pixel.

Nota: i dispositivi AIR per TV utilizzano l'accelerazione hardware, se disponibile, per le trasformazioni di colore.

Determina se l'oggetto di visualizzazione è visibile o meno. Gli oggetti di visualizzazione che non sono visibili vengono disabilitati. Ad esempio, se visible=false per un'istanza InteractiveObject, non è possibile fare clic sull'istanza.

Indica la larghezza dell'oggetto di visualizzazione espressa in pixel. La larghezza viene calcolata in base ai limiti del contenuto dell'oggetto di visualizzazione. Quando impostate la proprietà width, la proprietà scaleX viene impostata di conseguenza, come illustrato nel codice seguente:

    var rect:Shape = new Shape();
    rect.graphics.beginFill(0xFF0000);
    rect.graphics.drawRect(0, 0, 100, 100);
    trace(rect.scaleX) // 1;
    rect.width = 200;
    trace(rect.scaleX) // 2;

Ad eccezione degli oggetti TextField e Video, un oggetto di visualizzazione senza contenuto (quale uno sprite vuoto) presenta una larghezza pari a 0, anche se si tenta di impostare width su un valore differente.

Indica la coordinata x dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale. Se è all'interno di un DisplayObjectContainer che presenta delle trasformazioni, l'oggetto utilizza il sistema di coordinate locali del DisplayObjectContainer in cui è racchiuso. Pertanto, se DisplayObjectContainer viene ruotato di 90 gradi in senso antiorario, l'elemento secondario di DisplayObjectContainer eredita un sistema di coordinate che è ruotato di 90 gradi in senso antiorario. Le coordinate dell'oggetto sono relative alla posizione del punto di registrazione.

Indica la coordinata y dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale. Se è all'interno di un DisplayObjectContainer che presenta delle trasformazioni, l'oggetto utilizza il sistema di coordinate locali del DisplayObjectContainer in cui è racchiuso. Pertanto, se DisplayObjectContainer viene ruotato di 90 gradi in senso antiorario, l'elemento secondario di DisplayObjectContainer eredita un sistema di coordinate che è ruotato di 90 gradi in senso antiorario. Le coordinate dell'oggetto sono relative alla posizione del punto di registrazione.

Restituisce un rettangolo che definisce l'area dell'oggetto di visualizzazione relativa al sistema di coordinate dell'oggetto targetCoordinateSpace. Osservate il codice seguente, che mostra come il rettangolo restituito può variare a seconda del parametro targetCoordinateSpace passato al metodo:

     var container:Sprite = new Sprite();
     container.x = 100;
     container.y = 100;
     this.addChild(container);
     var contents:Shape = new Shape();
     contents.graphics.drawCircle(0,0,100);
     container.addChild(contents);
     trace(contents.getBounds(container));
      // (x=-100, y=-100, w=200, h=200)
     trace(contents.getBounds(this));
      // (x=0, y=0, w=200, h=200)
     

Nota: utilizzate i metodi localToGlobal() e globalToLocal() rispettivamente per convertire le coordinate locali dell'oggetto di visualizzazione nelle coordinate di visualizzazione e viceversa.

Il metodo getBounds() è simile a getRect(); tuttavia, il rettangolo restituito dal metodo getBounds() include gli eventuali tratti presenti sulle forme, a differenza di quello restituito da getRect(). Per un esempio, vedete la descrizione del metodo getRect().

Parametri

Restituisce un rettangolo che definisce i bordi dell'oggetto di visualizzazione in base al sistema di coordinate definito dal parametro targetCoordinateSpace, esclusi gli eventuali tratti presenti sulle forme. I valori restituiti dal metodo getRect() sono gli stessi o minori di quelli restituiti da getBounds().

Nota: utilizzate localToGlobal() e globalToLocal() rispettivamente per convertire le coordinate locali dell'oggetto di visualizzazione nelle coordinate dello stage e viceversa.

Parametri

Converte le coordinate dello stage (globali) in quelle (locali) dell'oggetto di visualizzazione per l'oggetto point.

Per utilizzare questo metodo, create innanzi tutto un'istanza della classe Point. I valori x e y che assegnate rappresentano le coordinate globali perché sono relativi all'origine (0,0) dell'area di visualizzazione principale. Quindi, passate l'istanza Point come parametro al metodo globalToLocal(). Il metodo restituisce un nuovo oggetto Point con valori x e y relativi all'origine dell'oggetto di visualizzazione anziché dello stage.

Parametri

Valuta il riquadro di delimitazione dell'oggetto di visualizzazione per verificare se si sovrappone o si interseca con il riquadro di delimitazione dell'oggetto di visualizzazione obj.

Parametri

Valuta l'oggetto di visualizzazione per stabilire se si sovrappone o si interseca con il punto specificato dai parametri x e y. I parametri x e y specificano un punto nello spazio di coordinate dello stage, non il contenitore dell'oggetto di visualizzazione (a meno che tale contenitore non sia lo stage).

Parametri

Converte le coordinate dell'oggetto di visualizzazione (locali) in quelle dello stage (globali) per l'oggetto point.

Questo metodo consente di convertire qualsiasi coppia di coordinate x e y da valori relativi all'origine (0,0) di un determinato oggetto di visualizzazione (coordinate locali) a valori relativi all'origine dello stage (coordinate globali).

Per utilizzare questo metodo, create innanzi tutto un'istanza della classe Point. I valori x e y che assegnate rappresentano le coordinate locali perché sono relativi all'origine dell'oggetto di visualizzazione.

Quindi, passate l'istanza Point creata al metodo localToGlobal() come parametro. Il metodo restituisce un nuovo oggetto Point con valori x e y relativi all'origine dello stage anziché dell'oggetto di visualizzazione.

Parametri

Moves this object to the specified x and y coordinates.

Parametri

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.

Parametri