ActionScript® 3.0 — dokumentacja dla platformy Adobe® Flash®
Strona główna  |  Ukryj listę pakietów i klas |  Pakiety  |  Klasy  |  Nowości  |  Indeks  |  Dodatki  |  Dlaczego język angielski?
Filtry: Pobieranie danych z serwera...
Pobieranie danych z serwera...
flash.display 

Shape  - AS3

Pakietflash.display
Klasapublic class Shape
DziedziczenieShape Inheritance DisplayObject Inheritance EventDispatcher Inheritance Object
Podklasy FlexShape

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Ta klasa umożliwia tworzenie lekkich kształtów za pomocą graficznego interfejsu API języka ActionScript. Klasa Shape zawiera właściwość graphics, która umożliwia dostęp do metod klasy Graphics.

Klasa Sprite zawiera również właściwość graphics oraz inne funkcje niedostępne dla klasy Shape. Na przykład obiekt Sprite jest kontenerem obiektów wyświetlanych, zaś obiekt Shape nie (nie może też zawierać podrzędnych obiektów wyświetlanych). Z tego powodu obiekty Shape pochłaniają mniej pamięci niż obiekty Sprite, które zawierają te same elementy graficzne. Jednak obiekt Sprite obsługuje zdarzenia interakcji ze strony użytkownika, natomiast obiekt Shape ich nie obsługuje.

Wyświetl przykłady

Powiązane elementy interfejsu API



Właściwości publiczne
 WłaściwośćZdefiniowane przez
 InheritedaccessibilityProperties : AccessibilityProperties
Bieżące opcje dostępności tego obiektu wyświetlanego.
DisplayObject
 Inheritedalpha : Number
Wartość przezroczystości alfa określonego obiektu.
DisplayObject
 InheritedblendMode : String
Wartość z klasy BlendMode określająca, jakiego trybu mieszania należy użyć.
DisplayObject
 InheritedblendShader : Shader
[tylko do zapisu] Ustawia moduł cieniujący, który jest używany do mieszania pierwszego planu oraz tła.
DisplayObject
 InheritedcacheAsBitmap : Boolean
Jeśli ustawiono wartość true, środowisko wykonawcze Flash buforuje wewnętrzną reprezentację bitmapy obiektu wyświetlanego.
DisplayObject
 Inherited    cacheAsBitmapMatrix : Matrix
W przypadku wartości innej niż null ten obiekt Matrix definiuje sposób renderowania obiektu wyświetlanego, gdy cacheAsBitmap jest ustawione na true.
DisplayObject
 Inheritedconstructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.
Object
 Inheritedfilters : Array
Indeksowana tablica zawierająca wszystkie filtry aktualnie skojarzone z obiektem wyświetlanym.
DisplayObject
  graphics : Graphics
[tylko do odczytu] Określa obiekt Graphics należący do tego obiektu Shape, w ramach którego można stosować polecenia dotyczące rysunków wektorowych.
Shape
 Inheritedheight : Number
Wysokość obiektu ekranowego w pikselach.
DisplayObject
 InheritedloaderInfo : LoaderInfo
[tylko do odczytu] Zwraca obiekt LoaderInfo zawierający informacje o ładowaniu pliku, do którego należy ten obiekt wyświetlany.
DisplayObject
 Inheritedmask : DisplayObject
Wywoływany obiekt wyświetlany jest maskowany przez określony obiekt maski.
DisplayObject
 InheritedmetaData : Object
Pobiera obiekt metadanych wystąpienia klasy DisplayObject, jeśli metadane są przechowywane razem z tym wystąpieniem klasy DisplayObject w pliku SWF, korzystając ze znacznika PlaceObject4.
DisplayObject
 InheritedmouseX : Number
[tylko do odczytu] Określa współrzędną x myszy lub urządzenia wejściowego użytkownika w pikselach.
DisplayObject
 InheritedmouseY : Number
[tylko do odczytu] Określa współrzędną y myszy lub urządzenia wejściowego użytkownika w pikselach.
DisplayObject
 Inheritedname : String
Nazwa instancji obiektu DisplayObject.
DisplayObject
 InheritedopaqueBackground : Object
Określa, czy przy konkretnym kolorze tła obiekt wyświetlany jest nieprzejrzysty.
DisplayObject
 Inheritedparent : DisplayObjectContainer
[tylko do odczytu] Odnosi się do obiektu DisplayObjectContainer, który zawiera obiekt wyświetlany.
DisplayObject
 Inheritedroot : DisplayObject
[tylko do odczytu] Dla obiektu wyświetlanego w załadowanym pliku SWF główną właściwość stanowi obiekt wyświetlany na samym szczycie na liście wyświetlania w postaci struktury drzewa, którą reprezentuje plik SWF.
DisplayObject
 Inheritedrotation : Number
Określa wielkość obrotu instancji obiektu DisplayObject (w kątach).
DisplayObject
 InheritedrotationX : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi x — od pozycji początkowej względem nadrzędnego kontenera 3D.
DisplayObject
 InheritedrotationY : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi y — od pozycji początkowej względem nadrzędnego kontenera 3D.
DisplayObject
 InheritedrotationZ : Number
Wskazuje kąt obrotu (w stopniach) instancji DisplayObject wokół osi z — od pozycji początkowej względem nadrzędnego kontenera 3D.
DisplayObject
 Inheritedscale9Grid : Rectangle
Aktualnie stosowana siatka skalowania.
DisplayObject
 InheritedscaleX : Number
Wskazuje skalę poziomą (procent) obiektu względem punktu odniesienia.
DisplayObject
 InheritedscaleY : Number
Wskazuje skalę pionową (procent) obiektu względem punktu odniesienia.
DisplayObject
 InheritedscaleZ : Number
Wskazuje skalę głębokości (procent) obiektu względem punktu odniesienia.
DisplayObject
 InheritedscrollRect : Rectangle
Granice obszaru przewijania obiektu wyświetlanego.
DisplayObject
 Inheritedstage : Stage
[tylko do odczytu] Stół montażowy obiektu wyświetlanego.
DisplayObject
 Inheritedtransform : flash.geom:Transform
Obiekt z właściwościami dotyczącymi matrycy obiektu wyświetlanego, transformacji kolorów oraz granic pikseli.
DisplayObject
 Inheritedvisible : Boolean
Decyduje, czy obiekt wyświetlany jest widoczny, czy nie.
DisplayObject
 Inheritedwidth : Number
Szerokość obiektu ekranowego w pikselach.
DisplayObject
 Inheritedx : Number
Oznacza współrzędną x instancji obiektu DisplayObject w lokalnym układzie współrzędnych nadrzędnego obiektu DisplayObjectContainer.
DisplayObject
 Inheritedy : Number
Oznacza współrzędną y instancji obiektu DisplayObject w lokalnym układzie współrzędnych nadrzędnego obiektu DisplayObjectContainer.
DisplayObject
 Inheritedz : Number
Wskazuje współrzędną wzdłuż osi Z instancji DisplayObject względem nadrzędnego kontenera 3D.
DisplayObject
Metody publiczne
 MetodaZdefiniowane przez
  
Tworzy nowy obiekt Shape.
Shape
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu.
EventDispatcher
 Inherited
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.
EventDispatcher
 Inherited
getBounds(targetCoordinateSpace:DisplayObject):Rectangle
Zwraca prostokąt definiujący obszar obiektu wyświetlanego (w układzie współrzędnych obiektu targetCoordinateSpace).
DisplayObject
 Inherited
getRect(targetCoordinateSpace:DisplayObject):Rectangle
Zwraca prostokąt definiujący granice obiektu wyświetlanego w układzie współrzędnych określonych przez parametr targetCoordinateSpace (z wyłączeniem konturów kształtów).
DisplayObject
 Inherited
Konwertuje obiekt punktowy ze współrzędnych obiektu Stage (globalne) do współrzędnych obiektu wyświetlanego (lokalne).
DisplayObject
 Inherited
Konwertuje punkt dwuwymiarowy ze współrzędnych stołu wymiarowego (globalnych) na współrzędne trójwymiarowego obiektu wyświetlanego (lokalne).
DisplayObject
 Inherited
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.
EventDispatcher
 Inherited
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.
Object
 Inherited
Wyznacza prostokąt ograniczający obiekt wyświetlany w celu sprawdzenia, czy zachodzi on lub przecina się z prostokątem ograniczającym obiektu wyświetlanego obj.
DisplayObject
 Inherited
hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean
Analizuje obiekt wyświetlany w celu ustalenia czy nakłada się on lub przecina punkt określony przez parametry x i y.
DisplayObject
 Inherited
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.
Object
 Inherited
Konwertuje punkt trójwymiarowy trójwymiarowego obiektu wyświetlanego (lokalnego) na punkt dwuwymiarowy we współrzędnych stołu montażowego (globalnych).
DisplayObject
 Inherited
Konwertuje obiekt punktowy ze współrzędnych obiektu wyświetlanego (lokalne) do współrzędnych obiektu Stage (globalne).
DisplayObject
 Inherited
Wskazuje, czy określona właściwość istnieje i jest przeliczalna.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Usuwa detektor z obiektu EventDispatcher.
EventDispatcher
 Inherited
Ustawia dostępność właściwości dynamicznej używanej w pętlach.
Object
 Inherited
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.
Object
 Inherited
Zwraca ciąg reprezentujący określony obiekt.
Object
 Inherited
Zwraca pierwotną wartość dla określonego obiektu.
Object
 Inherited
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.
EventDispatcher
Zdarzenia
 Zdarzenie Podsumowanie Zdefiniowane przez
 Inherited[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny.EventDispatcher
 InheritedWywoływane, gdy obiekt wyświetlany jest dodawany do listy wyświetlania.DisplayObject
 InheritedWywoływane, gdy obiekt wyświetlany jest dodawany do listy wyświetlania na scenie — albo bezpośrednio, albo wskutek dodania poddrzewa zawierającego obiekt wyświetlany.DisplayObject
 Inherited[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.EventDispatcher
 Inherited[zdarzenie broadcast] Wywoływane, gdy głowica odtwarzania przechodzi do nowej klatki.DisplayObject
 Inherited[zdarzenie broadcast] Wywoływane, gdy głowica odtwarzania kończy odtwarzanie bieżącej klatki.DisplayObject
 Inherited[zdarzenie broadcast] Wywoływane po zadziałaniu konstruktorów obiektów wyświetlanych klatek, ale przed działaniem skryptów klatek.DisplayObject
 InheritedDysponowana, gdy obiekt ekranowy ma być usunięty z listy wyświetlania.DisplayObject
 InheritedDysponowana, gdy obiekt ekranowy ma być usunięty z listy wyświetlania na scenie — albo bezpośrednio, albo wskutek usunięcia poddrzewa zawierającego obiekt ekranowy.DisplayObject
 Inherited[zdarzenie broadcast] Wywoływane, gdy lista wyświetlania ma być aktualizowana lub renderowana.DisplayObject
Szczegół właściwości

graphics

właściwość
graphics:Graphics  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Określa obiekt Graphics należący do tego obiektu Shape, w ramach którego można stosować polecenia dotyczące rysunków wektorowych.



Implementacja
    public function get graphics():Graphics
Konstruktor Szczegół

Shape

()Konstruktor
public function Shape()

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Tworzy nowy obiekt Shape.

ShapeExample.as

Poniższy przykład ilustruje sposób wykorzystania klasy ShapeExample w celu narysowania okręgu, zaokrąglonego prostokąta oraz kwadratu. Zadanie to jest realizowane przez wykonanie następujących kroków:
  1. Deklaruje właściwość size do późniejszego użytku przy określaniu rozmiaru każdej figury.
  2. Należy zadeklarować właściwości w celu ustawienia tła na kolor pomarańczowy, barwę obramowania na kolor szary, rozmiar obramowania na 0 pikseli, promień kąta na 9 pikseli oraz ustawić przestrzeń pomiędzy krawędzią stołu montażowego i innych obiektów na 5 pikseli.
  3. Należy wykorzystać właściwości zadeklarowane w poprzednich krokach wraz z wbudowanymi metodami klasy Graphics w celu narysowania okręgu, zaokrąglonego prostokąta oraz kwadratu na współrzędnych x = 0, y = 0.
  4. Należy przerysować figury wzdłuż górnej części stołu montażowego, rozpoczynając na współrzędnych x = 5, y = 5, przy 5-pikselowej przerwie między figurami przy wykorzystaniu metody 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);
        }
    }
}




[ X ]Dlaczego język angielski?
Treść dokumentacji języka ActionScript 3.0 wyświetlana w języku angielskim

Niektóre części dokumentacji języka ActionScript 3.0 nie są przetłumaczone na poszczególne języki. Gdy element nie jest przetłumaczony na dany język, jest wyświetlany tekst angielski. Na przykład opis klasy ga.controls.HelpBox nie jest przetłumaczony na żaden dodatkowy język. Z tego powodu polska wersja dokumentacji zawiera opis klasy ga.controls.HelpBox w języku angielskim.