| Pakiet | flash.display |
| Klasa | public final class GraphicsGradientFill |
| Dziedziczenie | GraphicsGradientFill  Object |
| Implementuje | IGraphicsFill, IGraphicsData |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Należy użyć obiektu GraphicsGradientFill z metodą Graphics.drawGraphicsData(). Narysowanie obiektu GraphicsGradientFill jest równoważne wywołaniu metody Graphics.beginGradientFill().
Powiązane elementy interfejsu API
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
| alphas : Array
Tablica wartości alpha, które odpowiadają kolorom z tablicy colors. | GraphicsGradientFill | ||
| colors : Array
Tablica szesnastkowych wartości kolorów RGB, które będą używane w gradiencie. | GraphicsGradientFill | ||
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| focalPointRatio : Number
Liczba kontrolująca położenie ogniskowej gradientu. | GraphicsGradientFill | ||
| interpolationMethod : String
Wartość z klasy InterpolationMethod, określająca którą z wartości należy zastosować. | GraphicsGradientFill | ||
| matrix : Matrix
Matryca transformacji jest zdefiniowana przez klasę Matrix. | GraphicsGradientFill | ||
| ratios : Array
Tablica wskaźników dystrybucji kolorów. | GraphicsGradientFill | ||
| spreadMethod : String
Wartość z klasy SpreadMethod, określająca którą z metod należy zastosować. | GraphicsGradientFill | ||
| type : String
Wartość z klasy GradientType, która określa typ gradientu, jaki ma zostać zastosowany. | GraphicsGradientFill | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
GraphicsGradientFill(type:String = "linear", colors:Array = null, alphas:Array = null, ratios:Array = null, matrix:* = null, spreadMethod:* = pad, interpolationMethod:String = "rgb", focalPointRatio:Number = 0.0)
Tworzy nowy obiekt GraphicsGradientFill. | GraphicsGradientFill | ||
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
|
Zwraca ciąg reprezentujący określony obiekt. | Object | |
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
alphas | właściwość |
public var alphas:Array| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Tablica wartości alpha, które odpowiadają kolorom z tablicy colors. Poprawne wartości należą do zakresu od 0 do 1. Jeśli wartość jest mniejsza niż 0, używana jest wartość 0. Jeśli wartość jest większa niż 1, używana jest wartość 1.
colors | właściwość |
public var colors:Array| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Tablica szesnastkowych wartości kolorów RGB, które będą używane w gradiencie. Na przykład: czerwony ma wartość 0xFF0000, niebieski 0x0000FF itd. Możliwe jest określenie maksymalnie 15 kolorów. Dla każdego koloru należy określić odpowiednią wartość w parametrach alpha i proporcji.
focalPointRatio | właściwość |
public var focalPointRatio:Number| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Liczba kontrolująca położenie ogniskowej gradientu. Wartość 0 ustawia ogniskową w środku. Wartość 1 oznacza, że ogniskowa znajduje się na jednym obrzeżu okręgu gradientu. Wartość -1 oznacza, że ogniskowa znajduje się na innym obrzeżu okręgu gradientu. Wartość mniejsza niż -1 lub większa niż 1 zostaje zaokrąglona odpowiednio do -1 lub 1. Przykład poniżej przedstawia właściwość focalPointRatio ustawioną na 0,75:
interpolationMethod | właściwość |
interpolationMethod:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wartość z klasy InterpolationMethod określająca, którą z wartości należy zastosować. Poprawne wartości: InterpolationMethod.LINEAR_RGB lub InterpolationMethod.RGB
Przykład poniżej przedstawia prosty gradient liniowy między dwoma kolorami (dla parametru spreadMethod ustawiono SpreadMethod.REFLECT). Różne metody interpolacji zmieniają wygląd w następujący sposób:
 |  |
InterpolationMethod.LINEAR_RGB | InterpolationMethod.RGB |
Implementacja
public function get interpolationMethod():String public function set interpolationMethod(value:String):voidPowiązane elementy interfejsu API
matrix | właściwość |
public var matrix:Matrix| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Matryca transformacji jest zdefiniowana przez klasę Matrix. Klasa flash.geom.Matrix zawiera metodę createGradientBox(), która pozwala na odpowiednie zdefiniowanie macierzy do użycia z metodą beginGradientFill().
Powiązane elementy interfejsu API
ratios | właściwość |
public var ratios:Array| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Tablica wskaźników dystrybucji kolorów. Poprawne wartości należą do zakresu od 0 do 255. Ta wartość definiuje procent szerokości, w której kolor jest próbkowany w 100%. Wartość 0 reprezentuje położenie po lewej stronie pola gradientu, zaś wartość 255 reprezentuje położenie po prawej stronie pola gradientu.
Uwaga: Ta wartość reprezentuje położenia w polu gradientu, a nie układu współrzędnych końcowego gradientu, który może być szerszy lub cieńszy od pola gradientu. Należy określić wartość odpowiadającą każdej wartości we właściwości colors.
Przykład: dla gradientu liniowego, który zawiera dwa kolory (niebieski i zielony), poniższy przykład ilustruje umiejscowienie kolorów w formie gradientowej według wartości innych niż znajdujące się w tablicy ratios:
ratios | Gradient |
|---|---|
[0, 127] |  |
[0, 255] |  |
[127, 255] |  |
Wartości w tablicy muszą zwiększać się w sekwencji; przykładowo: [0, 63, 127, 190, 255].
spreadMethod | właściwość |
spreadMethod:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wartość z klasy SpreadMethod, określająca którą z metod należy zastosować. Poprawne wartości to: SpreadMethod.PAD, SpreadMethod.REFLECT lub SpreadMethod.REPEAT.
Przykład poniżej przedstawia prosty gradient liniowy między dwoma kolorami:
import flash.geom.*
import flash.display.*
var fillType:String = GradientType.LINEAR;
var colors:Array = [0xFF0000, 0x0000FF];
var alphas:Array = [1, 1];
var ratios:Array = [0x00, 0xFF];
var matr:Matrix = new Matrix();
matr.createGradientBox(20, 20, 0, 0, 0);
var spreadMethod:String = SpreadMethod.PAD;
this.graphics.beginGradientFill(fillType, colors, alphas, ratios, matr, spreadMethod);
this.graphics.drawRect(0,0,100,100);
W tym przykładzie zastosowano metodę rysowania SpreadMethod.PAD, dzięki czemu wypełnienie gradientu wygląda następująco:
W przypadku zastosowania metody rysowania SpreadMethod.REFLECT wypełnienie gradientu wygląda następująco:
W przypadku zastosowania metody rysowania SpreadMethod.REPEAT wypełnienie gradientu wygląda następująco:
Implementacja
public function get spreadMethod():String public function set spreadMethod(value:String):voidPowiązane elementy interfejsu API
type | właściwość |
type:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Wartość z klasy GradientType, która określa typ gradientu, jaki ma zostać zastosowany. Wartości: GradientType.LINEAR lub GradientType.RADIAL.
Implementacja
public function get type():String public function set type(value:String):voidPowiązane elementy interfejsu API
GraphicsGradientFill | () | Konstruktor |
public function GraphicsGradientFill(type:String = "linear", colors:Array = null, alphas:Array = null, ratios:Array = null, matrix:* = null, spreadMethod:* = pad, interpolationMethod:String = "rgb", focalPointRatio:Number = 0.0)| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Tworzy nowy obiekt GraphicsGradientFill.
Parametrytype:String (default = "linear")GradientType.LINEAR czy GradientType.RADIAL.
| |
colors:Array (default = null) | |
alphas:Array (default = null) | |
ratios:Array (default = null) | |
matrix:* (default = null)createGradientBox(), która pozwala na wygodne ustawienie matrycy do użycia z metodą beginGradientFill().
| |
spreadMethod:* (default = pad)SpreadMethod.PAD, SpreadMethod.REFLECT lub SpreadMethod.REPEAT.
| |
interpolationMethod:String (default = "rgb")InterpolationMethod.LINEAR_RGB lub InterpolationMethod.RGB
| |
focalPointRatio:Number (default = 0.0) |
Powiązane elementy interfejsu API
Tue Jun 12 2018, 12:06 PM Z