Shape

Pacchetto	flash.display
Classe	public class Shape
Ereditarietà	Shape DisplayObject EventDispatcher Object
Sottoclassi	FlexShape

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Questa classe viene utilizzata per creare forme leggere utilizzando l'API di disegno di ActionScript. Questa classe include una proprietà graphics, che consente di accedere ai metodi della classe Graphics.

Anche la classe Sprite include una proprietà graphics, oltre ad altre caratteristiche non disponibili nella classe Shape. Ad esempio, un oggetto Sprite è un contenitore di oggetto di visualizzazione, a differenza di un oggetto Shape che non può contenere oggetti di visualizzazione. Per questo motivo, gli oggetti Shape consumano una quantità di memoria inferiore rispetto agli oggetti Sprite che contengono la stessa grafica. Un oggetto Sprite, tuttavia, supporta eventi di input dell'utente, a differenza di un oggetto Shape.

Vedere gli esempi

Altre informazioni

Programmazione degli elementi visivi
Elementi fondamentali della programmazione degli elementi visivi
Classi di visualizzazione di base
Nozioni fondamentali sull'API di disegno

Elementi API correlati

flash.display.Graphics
flash.display.Sprite

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		accessibilityProperties : AccessibilityProperties Le opzioni di accessibilità correnti di questo oggetto di visualizzazione.	DisplayObject
		alpha : Number Indica il valore della trasparenza alfa dell'oggetto specificato.	DisplayObject
		blendMode : String Un valore della classe BlendMode che specifica il metodo di fusione da utilizzare.	DisplayObject
		blendShader : Shader [sola scrittura] Imposta uno shader utilizzato per la fusione dei colori di primo piano e sfondo.	DisplayObject
		cacheAsBitmap : Boolean Se è impostata su true, nella cache dei runtime Flash viene memorizzata una rappresentazione bitmap interna dell'oggetto di visualizzazione.	DisplayObject
		cacheAsBitmapMatrix : Matrix Se il valore è diverso da null, questo oggetto Matrix definisce il modo in cui viene eseguito il rendering di un oggetto di visualizzazione quando cacheAsBitmap è impostato su true.	DisplayObject
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		filters : Array Un array indicizzato che contiene ogni oggetto filtro attualmente associato all'oggetto di visualizzazione.	DisplayObject
		graphics : Graphics [sola lettura] Specifica l'oggetto Graphics che appartiene a questo oggetto Shape, in cui possono essere eseguiti i comandi di disegno vettoriale.	Shape
		height : Number Indica l'altezza dell'oggetto di visualizzazione espressa in pixel.	DisplayObject
		loaderInfo : LoaderInfo [sola lettura] Restituisce un oggetto LoaderInfo contenente informazioni sul caricamento del file al quale questo oggetto di visualizzazione appartiene.	DisplayObject
		mask : DisplayObject L'oggetto di visualizzazione chiamante viene mascherato dall'oggetto mask specificato.	DisplayObject
		metaData : Object Ottiene l’oggetto di metadati dell’istanza DisplayObject se i metadati sono stati memorizzati insieme all’istanza di questo DisplayObject nel file SWF mediante un tag PlaceObject4.	DisplayObject
		mouseX : Number [sola lettura] Indica la coordinata x del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel.	DisplayObject
		mouseY : Number [sola lettura] Indica la coordinata y del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel.	DisplayObject
		name : String Indica il nome dell'istanza dell'oggetto DisplayObject.	DisplayObject
		opaqueBackground : Object Specifica se l'oggetto di visualizzazione è opaco con un determinato colore di sfondo.	DisplayObject
		parent : DisplayObjectContainer [sola lettura] Indica l'oggetto DisplayObjectContainer che contiene questo oggetto di visualizzazione.	DisplayObject
		root : DisplayObject [sola lettura] Nel caso di un oggetto di visualizzazione all'interno di un file SWF caricato, la proprietà principale è l'oggetto di visualizzazione più in alto nella porzione della struttura dell'elenco di visualizzazione rappresentata da quel file SWF.	DisplayObject
		rotation : Number Indica la rotazione dell'istanza DisplayObject, espressa in gradi, rispetto alla posizione originale.	DisplayObject
		rotationX : Number Indica la rotazione dell'asse x dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D.	DisplayObject
		rotationY : Number Indica la rotazione dell'asse y dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D.	DisplayObject
		rotationZ : Number Indica la rotazione dell'asse z dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D.	DisplayObject
		scale9Grid : Rectangle La griglia di modifica in scala attualmente attiva.	DisplayObject
		scaleX : Number Indica la scala orizzontale (percentuale) dell'oggetto applicata dal punto di registrazione.	DisplayObject
		scaleY : Number Indica la scala verticale (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto.	DisplayObject
		scaleZ : Number Indica la scala di profondità (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto.	DisplayObject
		scrollRect : Rectangle I limiti del rettangolo di scorrimento dell'oggetto di visualizzazione.	DisplayObject
		stage : Stage [sola lettura] Lo stage dell'oggetto di visualizzazione.	DisplayObject
		transform : flash.geom:Transform Un oggetto con proprietà relative alla matrice, alla trasformazione del colore e ai limiti di pixel di un oggetto di visualizzazione.	DisplayObject
		visible : Boolean Determina se l'oggetto di visualizzazione è visibile o meno.	DisplayObject
		width : Number Indica la larghezza dell'oggetto di visualizzazione espressa in pixel.	DisplayObject
		x : Number Indica la coordinata x dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale.	DisplayObject
		y : Number Indica la coordinata y dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale.	DisplayObject
		z : Number Indica la posizione della coordinata z lungo l'asse z dell'istanza DisplayObject relativa al contenitore principale 3D.	DisplayObject

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		Shape() Crea un nuovo oggetto Shape.	Shape
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento.	EventDispatcher
		dispatchEvent(event:Event):Boolean Invia un evento nel flusso di eventi.	EventDispatcher
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle Restituisce un rettangolo che definisce l'area dell'oggetto di visualizzazione relativa al sistema di coordinate dell'oggetto targetCoordinateSpace.	DisplayObject
		getRect(targetCoordinateSpace:DisplayObject):Rectangle 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.	DisplayObject
		globalToLocal(point:Point):Point Converte le coordinate dello stage (globali) in quelle (locali) dell'oggetto di visualizzazione per l'oggetto Point.	DisplayObject
		globalToLocal3D(point:Point):Vector3D Converte un punto bidimensionale dalle coordinate dello stage (globali) in quelle (locali) di un oggetto di visualizzazione tridimensionale.	DisplayObject
		hasEventListener(type:String):Boolean Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		hitTestObject(obj:DisplayObject):Boolean 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.	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean Valuta l'oggetto di visualizzazione per stabilire se si sovrappone o si interseca con il punto specificato dai parametri x e y.	DisplayObject
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		local3DToGlobal(point3d:Vector3D):Point Converte un punto tridimensionale delle coordinate (locali) dell'oggetto di visualizzazione tridimensionale in un punto bidimensionale nelle coordinate dello stage (globali).	DisplayObject
		localToGlobal(point:Point):Point Converte le coordinate dell'oggetto di visualizzazione (locali) in quelle dello stage (globali) per l'oggetto Point.	DisplayObject
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Rimuove un listener dall'oggetto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object
		willTrigger(type:String):Boolean Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.	EventDispatcher

Eventi

Fate clic per visualizzare altre informazioni sugli eventi

Nascondi eventi ereditati

Mostra eventi ereditati

	Riepilogo	Definito da
activate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo.	EventDispatcher
added	Inviato quando un oggetto di visualizzazione viene aggiunto all'elenco di visualizzazione.	DisplayObject
addedToStage	Inviato quando un oggetto di visualizzazione viene aggiunto all'elenco di visualizzazione sullo stage, sia direttamente o mediante l'aggiunta di una sottostruttura ad albero che contiene l'oggetto di visualizzazione.	DisplayObject
deactivate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo.	EventDispatcher
enterFrame	[evento di trasmissione] Inviato quando l'indicatore di riproduzione sta entrando in un nuovo fotogramma.	DisplayObject
exitFrame	[evento di trasmissione] Inviato quando l'indicatore di riproduzione sta per uscire dal fotogramma corrente.	DisplayObject
frameConstructed	[evento di trasmissione] Inviato dopo l'esecuzione delle funzioni di costruzione degli oggetti di visualizzazione dei fotogrammi, ma prima dell'esecuzione degli script di fotogramma.	DisplayObject
removed	Inviato quando un oggetto di visualizzazione sta per essere rimosso dall'elenco di visualizzazione.	DisplayObject
removedFromStage	Inviato quando un oggetto di visualizzazione sta per essere rimosso dall'elenco di visualizzazione sullo stage, sia direttamente o mediante la rimozione di una sottostruttura ad albero che contiene l'oggetto di visualizzazione.	DisplayObject
render	[evento di trasmissione] Inviato quando stanno per essere eseguiti l'aggiornamento e il rendering dell'elenco di visualizzazione.	DisplayObject

Descrizione delle proprietà

graphics

proprietà

graphics:Graphics [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Specifica l'oggetto Graphics che appartiene a questo oggetto Shape, in cui possono essere eseguiti i comandi di disegno vettoriale.

Implementazione
public function get graphics():Graphics

Descrizione della funzione di costruzione

()

Funzione di costruzione

public function Shape()

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Crea un nuovo oggetto Shape.

Esempi Come utilizzare questo esempio

ShapeExample.as

L'esempio seguente utilizza la classe ShapeExample per disegnare un cerchio, un rettangolo arrotondato e un quadrato. Questa operazione viene eseguita mediante la procedura seguente:

Dichiarate una proprietà size per utilizzarla in seguito quando si determineranno le dimensioni di ogni forma.
Dichiarate le proprietà che impostano l'arancione come colore di sfondo e il grigio scuro come colore del bordo, che specificano la dimensione del bordo su 0 pixel e il raggio dell'angolo su 9 pixel e che impostano 5 pixel di distanza tra il bordo dello stage e gli altri oggetti.
Utilizzate le proprietà dichiarate in precedenza insieme ai metodi incorporati della classe Graphics per disegnare il cerchio, il rettangolo arrotondato e il quadrato in corrispondenza delle coordinate x = 0, y = 0.
Ridisegnate ognuna delle forme lungo la parte superiore dello stage, partendo da x = 5, y = 5 e con una spaziatura di 5 pixel tra le forme utilizzando il metodo refreshLayout().


package {
    import flash.display.DisplayObject;
    import flash.display.Graphics;
    import flash.display.JointStyle;
    import flash.display.LineScaleMode;
    import flash.display.Shape;
    import flash.display.Sprite;

    public class ShapeExample extends Sprite {
        private var size:uint           = 80;
        private var bgColor:uint       = 0xFFCC00;
        private var borderColor:uint  = 0x666666;
        private var borderSize:uint   = 0;
        private var cornerRadius:uint = 9;
        private var gutter:uint       = 5;

        public function ShapeExample() {
            doDrawCircle();
            doDrawRoundRect();
            doDrawRect();
            refreshLayout();
        }

        private function refreshLayout():void {
            var ln:uint = numChildren;
            var child:DisplayObject;
            var lastChild:DisplayObject = getChildAt(0);
            lastChild.x = gutter;
            lastChild.y = gutter;
            for (var i:uint = 1; i < ln; i++) {
                child = getChildAt(i);
                child.x = gutter + lastChild.x + lastChild.width;
                child.y = gutter;
                lastChild = child;
            }
        }

        private function doDrawCircle():void {
            var child:Shape = new Shape();
            var halfSize:uint = Math.round(size/2);
            child.graphics.beginFill(bgColor);
            child.graphics.lineStyle(borderSize, borderColor);
            child.graphics.drawCircle(halfSize, halfSize, halfSize);
            child.graphics.endFill();
            addChild(child);
        }

        private function doDrawRoundRect():void {
            var child:Shape = new Shape();
            child.graphics.beginFill(bgColor);
            child.graphics.lineStyle(borderSize, borderColor);
            child.graphics.drawRoundRect(0, 0, size, size, cornerRadius);
            child.graphics.endFill();
            addChild(child);
        }

        private function doDrawRect():void {
            var child:Shape = new Shape();
            child.graphics.beginFill(bgColor);
            child.graphics.lineStyle(borderSize, borderColor);
            child.graphics.drawRect(0, 0, size, size);
            child.graphics.endFill();
            addChild(child);
        }
    }
}

Note legali | Informativa sulla privacy online

Shape - AS3

Classi x

graphics

Shape