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.text.engine 

GraphicElement  - AS3

Paketflash.text.engine
Klassepublic final class GraphicElement
VererbungGraphicElement Inheritance ContentElement Inheritance Object

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

Die GraphicElement-Klasse repräsentiert ein Grafikelement in einem TextBlock- oder GroupElement-Objekt. Weisen Sie ein GraphicElement-Objekt der content-Eigenschaft eines TextBlock-Objekts zu, um eine Grafik oder ein Bild mit TextBlock.createTextLine() anzuzeigen. Weisen Sie es einem GroupElement-Objekt zu, um es mit anderen Grafik- und Textelementen zu kombinieren.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedelementFormat : ElementFormat
Das ElementFormat-Objekt, das für das Element verwendet wird.
ContentElement
  elementHeight : Number
Die Höhe in Pixel, die in der Zeile für die Grafik reserviert ist.
GraphicElement
  elementWidth : Number
Die Breite in Pixel, die in der Zeile für die Grafik reserviert ist.
GraphicElement
 InheritedeventMirror : EventDispatcher
Das EventDispatcher-Objekt, das Kopien von jedem Ereignis erhält, das für auf diesem content-Element basierende gültige Textzeilen ausgelöst wurde.
ContentElement
  graphic : DisplayObject
Das DisplayObject, das als Grafik für das GraphicElement verwendet werden soll.
GraphicElement
 InheritedgroupElement : GroupElement
[schreibgeschützt] Das GroupElement-Objekt, das dieses Element enthält, oder null, falls es sich nicht in einer Gruppe befindet.
ContentElement
 InheritedrawText : String
[schreibgeschützt] Eine Kopie des Texts in diesem Element, einschließlich aller U+FDEF-Zeichen.
ContentElement
 Inheritedtext : String
[schreibgeschützt] Eine Kopie des Texts in diesem Element, ausschließlich aller U+FDEF-Zeichen, die Grafikelemente im String repräsentieren.
ContentElement
 InheritedtextBlock : flash.text.engine:TextBlock
[schreibgeschützt] Der TextBlock, zu dem dieses Element gehört.
ContentElement
 InheritedtextBlockBeginIndex : int
[schreibgeschützt] Der Index, den das erste Zeichen dieses Elements im Textblock belegt.
ContentElement
 InheritedtextRotation : String
Die Drehung, die auf das Element als Einheit angewendet werden soll.
ContentElement
 InheriteduserData : *
Ermöglicht einer Anwendung, beliebige Daten mit dem Element zu verknüpfen.
ContentElement
Öffentliche Methoden
 MethodeDefiniert von
  
GraphicElement(graphic:DisplayObject = null, elementWidth:Number = 15.0, elementHeight:Number = 15.0, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")
Erstellt eine neue GraphicElement-Instanz.
GraphicElement
 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

elementHeight

Eigenschaft
elementHeight:Number

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

Die Höhe in Pixel, die in der Zeile für die Grafik reserviert ist. Für das Skalieren der Grafik ist der Aufrufer zuständig.

Der Standardwert ist 15,0.



Implementierung
    public function get elementHeight():Number
    public function set elementHeight(value:Number):void

elementWidth

Eigenschaft 
elementWidth:Number

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

Die Breite in Pixel, die in der Zeile für die Grafik reserviert ist. Für das Skalieren der Grafik ist der Aufrufer zuständig.

Der Standardwert ist 15,0.



Implementierung
    public function get elementWidth():Number
    public function set elementWidth(value:Number):void

graphic

Eigenschaft 
graphic:DisplayObject

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

Das DisplayObject, das als Grafik für das GraphicElement verwendet werden soll.

Der Standardwert ist null.

Wenn das GraphicElement Teil einer Textzeile wird, wird die Grafik als untergeordnetes Element der Zeile hinzugefügt. Durch das Festlegen der Grafik wird die alte Grafik aus der Zeile entfernt und die neue hinzugefügt.



Implementierung
    public function get graphic():DisplayObject
    public function set graphic(value:DisplayObject):void
Konstruktordetails

GraphicElement

()Konstruktor
public function GraphicElement(graphic:DisplayObject = null, elementWidth:Number = 15.0, elementHeight:Number = 15.0, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")

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

Erstellt eine neue GraphicElement-Instanz.

Der Registrierungspunkt der Grafik wird an der oberen linken Ecke des Bereichs ausgerichtet, der durch elementHeight, elementWidth und elementFormat.baselineShift definiert ist. Die Grafik wird nicht skaliert, um mit der Größe des Bereichs übereinzustimmen. Wenn das GraphicElement einen eventMirror hat, wird die Größe und Position des sich ergebenden Spiegelbereichs durch die elementWidth- und die elementHeight-Eigenschaft und nicht durch die Grafik bestimmt. Bei Verwendung eines Loaders wird die Grafik möglicherweise nicht an dem Zeitpunkt geladen, an dem die Textzeile die Spiegelbereiche erstellt werden.

Parameter
graphic:DisplayObject (default = null) — Das DisplayObject, mit dem das GraphicElement gefüllt wird. Der Standardwert ist null.
 
elementWidth:Number (default = 15.0) — Die Breite des Bereichs, der für das Element reserviert ist, in Pixel. Der Standardwert ist 15.
 
elementHeight:Number (default = 15.0) — Die Höhe des Bereichs, der für das Element reserviert ist, in Pixel. Der Standardwert ist 15.
 
elementFormat:ElementFormat (default = null) — Das Elementformat für das Element. Der Standardwert ist null.
 
eventMirror:EventDispatcher (default = null) — Das EventDispatcher-Objekt, das Kopien von jedem Ereignis erhält, das für Textzeilen ausgelöst wurde, die aufgrund dieses content-Elements erstellt wurden. Der Standardwert ist null.
 
textRotation:String (default = "rotate0") — Die Drehung, die auf das Element als Einheit angewendet werden soll. Verwenden Sie flash.text.engine.TextRotation-Konstanten für diese Eigenschaft. Der Standardwert ist flash.text.engine.TextRotation.ROTATE_0.

Verwandte API-Elemente

GraphicElementExample.as

Im folgenden Beispiel wird ein TextBlock mit einem GraphicElement (ein roter Rahmen) erstellt und angezeigt. Darunter wird ein zweiter TextBlock hinzugefügt, der eine Beschriftung enthält.
package {

    import flash.display.Sprite;
    import flash.display.MovieClip;
    import flash.text.engine.TextBlock;
    import flash.text.engine.TextElement;
    import flash.text.engine.GraphicElement;
    import flash.text.engine.TextLine;
    import flash.text.engine.ElementFormat;
    import flash.text.engine.FontDescription;
    
    public class GraphicElementExample extends Sprite {
        
        public function GraphicElementExample():void {
            
            var format:ElementFormat = new ElementFormat();
            format.fontSize = 14;
            var redBox:MovieClip = new MovieClip();
            redBox.graphics.beginFill(0xCC0000, 1.0);
            redBox.graphics.drawRect(0,0, 200, 200);
            redBox.graphics.endFill();   
            var graphicElement:GraphicElement = new GraphicElement(redBox,redBox.width,redBox.height, format);
            var textBlock:TextBlock = new TextBlock();
            textBlock.content = graphicElement;
            var textLine1:TextLine = textBlock.createTextLine(null,redBox.width);
            addChild(textLine1);
            textLine1.x = 15
            textLine1.y = 215
            var str:String = "Your picture here ...";
            var textElement:TextElement = new TextElement(str, format);
            textBlock = new TextBlock();
            textBlock.content = textElement;
            var textLine2 = textBlock.createTextLine(null, 300);
            addChild(textLine2);
            textLine2.x = textLine1.x;
            textLine2.y += textLine1.y + format.fontSize;        
        }
    }    
}




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