ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.display 

GraphicsGradientFill  - AS3

Paketflash.display
Klassepublic final class GraphicsGradientFill
VererbungGraphicsGradientFill Inheritance Object
Implementiert IGraphicsFill, IGraphicsData

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Legt eine Farbverlaufsfüllung fest.

Verwenden Sie ein GraphicsGradientFill-Objekt mit der Graphics.drawGraphicsData()-Methode. Das Zeichnen eines GraphicsGradientFill-Objekts entspricht dem Aufrufen der Graphics.beginGradientFill()-Methode.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  alphas : Array
Ein Array mit Alphawerten für die entsprechenden Farben im colors-Array.
GraphicsGradientFill
  colors : Array
Ein Array mit den im Farbverlauf zu verwendenden RGB-Hexadezimalfarbwerten.
GraphicsGradientFill
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  focalPointRatio : Number
Eine Zahl, die die Position des Farbverlaufsbrennpunkts steuert.
GraphicsGradientFill
  interpolationMethod : String
Ein Wert aus der InterpolationMethod-Klasse, der festlegt, welcher Wert zu verwenden ist.
GraphicsGradientFill
  matrix : Matrix
Eine Transformationsmatrix, wie sie in der Matrix-Klasse definiert ist.
GraphicsGradientFill
  ratios : Array
Ein Array von Farbverteilungsverhältnissen.
GraphicsGradientFill
  spreadMethod : String
Ein Wert aus der SpreadMethod-Klasse, der festlegt, welche Auftragstärke zu verwenden ist.
GraphicsGradientFill
  type : String
Ein Wert aus der GradientType-Klasse, der angibt, welcher Farbverlaufstyp verwendet wird.
GraphicsGradientFill
Öffentliche Methoden
 MethodeDefiniert von
  
GraphicsGradientFill(type:String = "linear", colors:Array = null, alphas:Array = null, ratios:Array = null, matrix:* = null, spreadMethod:* = pad, interpolationMethod:String = "rgb", focalPointRatio:Number = 0.0)
Erstellt ein neues GraphicsGradientFill-Objekt.
GraphicsGradientFill
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails

alphas

Eigenschaft
public var alphas:Array

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Ein Array mit Alphawerten für die entsprechenden Farben im colors-Array. Gültig sind Werte zwischen 0 und 1. Ist der Wert kleiner als 0, wird 0 verwendet. Ist der Wert größer als 1, wird 1 verwendet.

colors

Eigenschaft 
public var colors:Array

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Ein Array mit den im Farbverlauf zu verwendenden RGB-Hexadezimalfarbwerten. Rot beispielsweise hat den Wert 0xFF0000, Blau den Wert 0x0000FF usw. Sie können bis zu 15 Farben angeben. Definieren Sie für jede Farbe einen entsprechenden Wert in den Eigenschaften „alphas“ und „ratios“.

focalPointRatio

Eigenschaft 
public var focalPointRatio:Number

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Eine Zahl, die die Position des Farbverlaufsbrennpunkts steuert. Mit dem Wert 0 wird der Brennpunkt auf die Mitte gesetzt. Der Wert 1 bedeutet, dass der Brennpunkt an einem Rand des Farbverlaufskreises liegt. Der Wert -1 setzt den Brennpunkt an den anderen Rand es Farbverlaufskreises. Werte, die kleiner als -1 oder größer als 1 sind, werden auf -1 bzw. 1 gerundet. Im folgenden Beispiel ist focalPointRatio z. B. auf 0,75 gesetzt:

Radialer Farbverlauf mit focalPointRatio-Wert von 0,75

interpolationMethod

Eigenschaft 
interpolationMethod:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Ein Wert aus der InterpolationMethod-Klasse, der festlegt, welcher Wert zu verwenden ist. Gültige Werte sind: InterpolationMethod.LINEAR_RGB und InterpolationMethod.RGB

Das folgende Beispiel zeigt einen einfachen linearen Farbverlauf zwischen zwei Farben (wobei der spreadMethod-Parameter auf SpreadMethod.REFLECT gesetzt ist). Die verschiedenen Interpolationsmethoden haben die folgenden Auswirkungen auf die Darstellung des Farbverlaufs:

Linearer Farbverlauf mit InterpolationMethod.LINEAR_RGB Linearer Farbverlauf mit InterpolationMethod.RGB
InterpolationMethod.LINEAR_RGBInterpolationMethod.RGB



Implementierung
    public function get interpolationMethod():String
    public function set interpolationMethod(value:String):void

Verwandte API-Elemente

matrix

Eigenschaft 
public var matrix:Matrix

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Eine Transformationsmatrix, wie sie in der Matrix-Klasse definiert ist. Die flash.geom.Matrix-Klasse umfasst eine createGradientBox()-Methode, mit der Sie die Matrix zur Verwendung mit der beginGradientFill()-Methode festlegen können.

Verwandte API-Elemente

ratios

Eigenschaft 
public var ratios:Array

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Ein Array von Farbverteilungsverhältnissen. Gültig sind Werte zwischen 0 und 255. Dieser Wert gibt den Breitenanteil an, in dem die Farbe mit 100 % gesampelt wird. Der Wert 0 repräsentiert die linke Position im Farbverlaufsfeld, der Wert 255 repräsentiert die rechte.

Hinweis: Dieser Wert repräsentiert Positionen im Farbverlaufsfeld, nicht im Koordinatenraum des endgültigen Farbverlaufs, der breiter oder schmaler als das Farbverlaufsfeld sein kann. Geben Sie für jeden Wert in der colors-Eigenschaft einen entsprechenden Wert an.

Die folgende Abbildung zeigt für einen linearen Verlauf mit den zwei Farben blau und grün die Farbplatzierung im Verlauf basierend auf den verschiedenen Werten im ratios-Array:

ratiosGradient
[0, 127]Linearer Farbverlauf blau-grün mit ratios-Werten von 0 und 127
[0, 255]Linearer Farbverlauf blau-grün mit ratios-Werten von 0 und 255
[127, 255]Linearer Farbverlauf blau-grün mit ratios-Werten von 127 und 255

Die Werte im Array müssen sich sequenziell erhöhen. Beispiel: [0, 63, 127, 190, 255].

spreadMethod

Eigenschaft 
spreadMethod:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Ein Wert aus der SpreadMethod-Klasse, der festlegt, welche Auftragstärke zu verwenden ist. Gültige Werte sind: SpreadMethod.PAD, SpreadMethod.REFLECT und SpreadMethod.REPEAT.

Das folgende Beispiel zeigt einen einfachen linearen Farbverlauf zwischen zwei Farben:

     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);
     

Dieses Beispiel verwendet SpreadMethod.PAD als Methode für die Auftragstärke, und der Farbverlauf sieht folgendermaßen aus:

Linearer Farbverlauf mit SpreadMethod.PAD

Mit der Auftragstärke SpreadMethod.REFLECT sieht die Farbverlaufsfüllung folgendermaßen aus:

Linearer Farbverlauf mit SpreadMethod.REFLECT

Mit der Auftragstärke SpreadMethod.REPEAT sieht die Farbverlaufsfüllung folgendermaßen aus:

Linearer Farbverlauf mit SpreadMethod.REPEAT



Implementierung
    public function get spreadMethod():String
    public function set spreadMethod(value:String):void

Verwandte API-Elemente

type

Eigenschaft 
type:String

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Ein Wert aus der GradientType-Klasse, der angibt, welcher Farbverlaufstyp verwendet wird. Zulässige Werte sind GradientType.LINEAR und GradientType.RADIAL.



Implementierung
    public function get type():String
    public function set type(value:String):void

Verwandte API-Elemente

Konstruktordetails

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)

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Erstellt ein neues GraphicsGradientFill-Objekt.

Parameter
type:String (default = "linear") — Ein Wert aus der GradientType-Klasse, mit dem angegeben wird, welcher Farbverlaufstyp verwendet werden soll: GradientType.LINEAR oder GradientType.RADIAL.
 
colors:Array (default = null) — Ein Array mit hexadezimalen RGB-Farbwerten, die im Farbverlauf verwendet werden (beispielsweise 0xFF0000 für Rot, 0x0000FF für Blau usw.). Sie können bis zu 15 Farben angeben. Definieren Sie für jede Farbe einen entsprechenden Wert in den Parametern „alphas“ und „ratios“.
 
alphas:Array (default = null) — Ein Array mit Alphawerten für die entsprechenden Farben im Array „colors“. Gültig sind Werte von 0 bis 1. Ist der Wert kleiner als 0, wird 0 verwendet. Ist der Wert größer als 1, wird 1 verwendet.
 
ratios:Array (default = null) — Ein Array mit Farbverteilungsverhältnissen. Zulässig sind Werte zwischen 0 und 255. Dieser Wert gibt den Breitenanteil an, in dem die Farbe mit 100 % gesampelt wird. Der Wert 0 stellt die linke Position im Farbverlaufsfeld dar, 255 die rechte.
 
matrix:* (default = null) — Eine Transformationsmatrix, wie sie von der flash.geom.Matrix-Klasse definiert wird. Die flash.geom.Matrix-Klasse umfasst eine createGradientBox()-Methode, mit der Sie die Matrix zur Verwendung mit der beginGradientFill()-Methode auf einfache Weise festlegen können.
 
spreadMethod:* (default = pad) — Ein Wert aus der SpreadMethod-Klasse, der festlegt, welche Auftragstärke zu verwenden ist: SpreadMethod.PAD, SpreadMethod.REFLECT oder SpreadMethod.REPEAT.
 
interpolationMethod:String (default = "rgb") — Ein Wert der InterpolationMethod-Klasse, der festlegt, welcher Wert verwendet werden soll: InterpolationMethod.LINEAR_RGB oder InterpolationMethod.RGB.
 
focalPointRatio:Number (default = 0.0) — Eine Zahl, die die Position des Farbverlaufsbrennpunkts steuert. Mit dem Wert 0 wird der Brennpunkt auf die Mitte gesetzt. Der Wert 1 bedeutet, dass der Brennpunkt an einem Rand des Farbverlaufskreises liegt. Der Wert -1 bedeutet, dass der Brennpunkt am anderen Rand des Farbverlaufskreises liegt. Werte, die kleiner als -1 oder größer als 1 sind, werden auf -1 bzw. 1 gerundet.

Verwandte API-Elemente





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.