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...
mx.graphics 

LinearGradient  - AS3 Flex

Paketmx.graphics
Klassepublic class LinearGradient
VererbungLinearGradient Inheritance GradientBase Inheritance EventDispatcher Inheritance Object
Implementiert IFill

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Mit der LinearGradient-Klasse können Sie die Füllung eines Grafikelements festlegen, wobei ein Farbverlauf einen allmählichen Farbübergang in der Füllfarbe angibt. Sie fügen eine Reihe von GradientEntry-Objekten dem entries-Array des LinearGradient-Objekts hinzu, um die Farben der Farbverlaufsfüllung zu definieren.

In MXML definieren Sie einen LinearGradient, indem Sie eine Reihe von GradientEntry-Objekten wie in folgendem Beispiel gezeigt hinzufügen:

  <mx:fill>
  	<mx:LinearGradient>
  		<mx:entries>
  			<mx:GradientEntry color="0xC5C551" ratio="0.00" alpha="0.5"/>
  			<mx:GradientEntry color="0xFEFE24" ratio="0.33" alpha="0.5"/>
  			<mx:GradientEntry color="0xECEC21" ratio="0.66" alpha="0.5"/>
  		</mx:entries>
  	</mx:LinearGradient>
  </mx:fill>
  

Sie können einen LinearGradient wie in folgendem Beispiel gezeigt als Füllung eines beliebigen Grafikelements in ActionScript definieren:

  
  <?xml version="1.0"?>
  <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" creationComplete="init()">
  	<mx:Script>
  	import flash.display.Graphics;
  	import flash.geom.Rectangle;
  	import mx.graphics.GradientEntry;
  	import mx.graphics.LinearGradient;
  
  	private function init():void
      {
  		var w:Number = 200;
  		var h:Number = 200;
  
  		var s:Sprite = new Sprite();
  		// Add the new Sprite to the display list.
  		rawChildren.addChild(s);	
  
  		var g:Graphics = s.graphics;
  		g.lineStyle(1, 0x33CCFF, 1.0);
  
  		var fill:LinearGradient = new LinearGradient();
  		
  		var g1:GradientEntry = new GradientEntry(0xFFCC66, 0.00, 0.5);
  		var g2:GradientEntry = new GradientEntry(0x000000, 0.33, 0.5);
  		var g3:GradientEntry = new GradientEntry(0x99FF33, 0.66, 0.5);
    		
   		fill.entries = [ g1, g2, g3 ];
  		fill.angle = 240;
  
   		// Draw a box and fill it with the LinearGradient.
  		g.moveTo(0, 0);
  		fill.begin(g, new Rectangle(0, 0, w, h));
  		g.lineTo(w, 0);
  		g.lineTo(w, h);
  		g.lineTo(0, h);
  		g.lineTo(0, 0);		
  		fill.end(g);
  	}
  	</mx:Script>
  </mx:Application>
  

MXML-SyntaxexpandedMXML-Syntax ausblenden

The <mx:LinearGradient> tag inherits all the tag attributes of its superclass, and adds the following tag attributes:

  <mx:LinearGradient
    Properties
    angle="0"
  />
  

Standard-MXML-Eigenschaftentries

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedangle : Number
Veraltet: Verwenden Sie rotation
Standardmäßig definiert LinearGradientStroke einen Übergang von links nach rechts auf dem Steuerelement.
GradientBase
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 Inheritedentries : Array
Ein Array von GradientEntry-Objekten, die die Füllungsmuster für die Verlaufsfläche definieren.
GradientBase
 InheritedinterpolationMethod : String
Ein Wert aus der InterpolationMethod-Klasse, der festlegt, welche Interpolationsmethode zu verwenden ist.
GradientBase
 Inheritedmatrix : Matrix
Ein Array von für die Matrixtransformation verwendeten Werten.
GradientBase
 Inheritedrotation : Number
Standardmäßig definiert LinearGradientStroke einen Übergang von links nach rechts auf dem Steuerelement.
GradientBase
  scaleX : Number
Die horizontale Skalierung der Farbverlaufstransformation, die die Breite des (nicht gedrehten) Farbverlaufs definiert.
LinearGradient
 InheritedspreadMethod : String
Ein Wert aus der SpreadMethod-Klasse, der festlegt, welche Auftragstärke zu verwenden ist.
GradientBase
 Inheritedx : Number
Der Abstand, um den jeder Punkt entlang der x-Achse verschoben werden soll.
GradientBase
 Inheritedy : Number
Der Abstand, um den jeder Punkt entlang der y-Achse verschoben werden soll.
GradientBase
Geschützte Eigenschaften
 EigenschaftDefiniert von
 InheritedcompoundTransform : mx.geom:CompoundTransform
Enthält die Matrix und die Transformationseigenschaften (x, y und „rotation“).
GradientBase
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
LinearGradient
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
  
begin(target:Graphics, targetBounds:Rectangle, targetOrigin:Point):void
Beginnt den Füllvorgang.
LinearGradient
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
  
end(target:Graphics):void
Beendet den Füllvorgang.
LinearGradient
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 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
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 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
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
Eigenschaftendetails

scaleX

Eigenschaft
scaleX:Number

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die horizontale Skalierung der Farbverlaufstransformation, die die Breite des (nicht gedrehten) Farbverlaufs definiert.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das propertyChange -Ereignis ausgelöst.



Implementierung
    public function get scaleX():Number
    public function set scaleX(value:Number):void
Konstruktordetails

LinearGradient

()Konstruktor
public function LinearGradient()

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Konstruktor.

Methodendetails

begin

()Methode
public function begin(target:Graphics, targetBounds:Rectangle, targetOrigin:Point):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Beginnt den Füllvorgang.

Parameter

target:Graphics — Das auszufüllende Ziel-Graphics-Objekt.
 
targetBounds:Rectangle — Das Rectangle-Objekt, das die Größe der Füllung innerhalb der target definiert. Wenn das Rectangle-Objekt größer als das target-Objekt ist, wird die Füllung abgeschnitten. Wenn das Rectangle-Objekt kleiner als das target-Objekt ist, wird das gesamte target-Objekt ausgefüllt.
 
targetOrigin:Point — Der Punkt, der den Ursprung (0,0) der Form im Koordinatensystem des Ziels definiert.

end

()Methode 
public function end(target:Graphics):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Beendet den Füllvorgang.

Parameter

target:Graphics — Das auszufüllende Graphics-Objekt.





[ 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.