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...
flashx.textLayout.edit 

ISelectionManager  - AS3

Paketflashx.textLayout.edit
Schnittstellepublic interface ISelectionManager extends IInteractionEventHandler
Umsetzer SelectionManager

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

Die ISelectionManager-Schnittstelle definiert die Schnittstelle zur Verarbeitung der Textauswahl.

Ein SelectionManager überwacht den ausgewählten Textbereich und verarbeitet Ereignisse für einen TextFlow.

Bei einer Auswahl kann es sich um eine Punktauswahl oder eine Bereichsauswahl handeln. Bei einer Punktauswahl handelt es sich um den Einfügepunkt, visuell durch Zeichnen eines Cursors angezeigt. Eine Bereichsauswahl enthält den Text zwischen einem Ankerpunkt und einem aktiven Punkt.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  absoluteEnd : int
[schreibgeschützt] Die Textposition am Ende der Auswahl als Offset ab Beginn des Textflusses.
ISelectionManager
  absoluteStart : int
[schreibgeschützt] Die Textposition am Anfang der Auswahl als Offset ab Beginn des Textflusses.
ISelectionManager
  activePosition : int
[schreibgeschützt] Der aktive Punkt der Auswahl.
ISelectionManager
  anchorPosition : int
[schreibgeschützt] Der Ankerpunkt der Auswahl.
ISelectionManager
  currentSelectionFormat : SelectionFormat
[schreibgeschützt] Das aktuelle SelectionFormat-Objekt.
ISelectionManager
  editingMode : String
[schreibgeschützt] Der Bearbeitungsmodus.
ISelectionManager
  focused : Boolean
[schreibgeschützt] Gibt an, ob ein Container im Textfluss den Fokus hat.
ISelectionManager
  focusedSelectionFormat : SelectionFormat
Das SelectionFormat-Objekt, das zum Ziehen der Auswahl in einen fokussierten Container verwendet wird.
ISelectionManager
  inactiveSelectionFormat : SelectionFormat
Das SelectionFormat-Objekt, das zum Ziehen der Auswahl verwendet wird, wenn sie sich nicht im aktiven Fenster befindet.
ISelectionManager
  textFlow : flashx.textLayout.elements:TextFlow
Das von diesem Auswahlmanager verwaltete TextFlow-Objekt.
ISelectionManager
  unfocusedSelectionFormat : SelectionFormat
Das SelectionFormat-Objekt, das zum Ziehen der Auswahl verwendet wird, wenn sie sich nicht im fokussierten Container, sondern im aktiven Fenster befindet.
ISelectionManager
  windowActive : Boolean
[schreibgeschützt] Gibt an, ob das mit dem Textfluss verknüpfte Fenster aktiv ist.
ISelectionManager
Öffentliche Methoden
 MethodeDefiniert von
 Inherited
Verarbeitet ein Aktivierungsereignis.
IInteractionEventHandler
 Inherited
Verarbeitet ein Deaktivierungsereignis.
IInteractionEventHandler
 Inherited
Verarbeitet ein Bearbeitungsereignis.
IInteractionEventHandler
  
Führt ausstehende FlowOperations aus.
ISelectionManager
 Inherited
Verarbeitet ein focusChange-Ereignis.
IInteractionEventHandler
 Inherited
Verarbeitet ein focusIn-Ereignis.
IInteractionEventHandler
 Inherited
Verarbeitet ein focusOut-Ereignis.
IInteractionEventHandler
  
Ruft die Zeichenformatattribute ab, die für alle Zeichen im angegebenen Textbereich oder in der aktuellen Auswahl verwendet werden.
ISelectionManager
  
Ruft die Containerformatattribute ab, die für alle Container im angegebenen Textbereich oder in der aktuellen Auswahl verwendet werden.
ISelectionManager
  
Ruft die Absatzformatattribute ab, die für alle Absätze im angegebenen Textbereich oder in der aktuellen Auswahl verwendet werden.
ISelectionManager
  
Ruft das SelectionState-Objekt der aktuellen Auswahl ab.
ISelectionManager
  
Zeigt an, ob es eine Auswahl gibt.
ISelectionManager
 Inherited
Verarbeitet ein imeStartComposition-Ereignis.
IInteractionEventHandler
  
Gibt an, ob die Auswahl einen Textbereich abdeckt.
ISelectionManager
 Inherited
Verarbeitet ein keyDown-Ereignis.
IInteractionEventHandler
 Inherited
Verarbeitet ein keyFocusChange-Ereignis.
IInteractionEventHandler
 Inherited
Verarbeitet ein keyUp-Ereignis.
IInteractionEventHandler
 Inherited
Verarbeitet ein menuSelect-Ereignis.
IInteractionEventHandler
 Inherited
Verarbeitet ein mouseDoubleClick-Ereignis.
IInteractionEventHandler
 Inherited
Verarbeitet ein mouseDown-Ereignis.
IInteractionEventHandler
 Inherited
Verarbeitet ein mouseMove-Ereignis.
IInteractionEventHandler
 Inherited
Verarbeitet ein mouseOut-Ereignis.
IInteractionEventHandler
 Inherited
Verarbeitet ein mouseOver-Ereignis.
IInteractionEventHandler
 Inherited
Verarbeitet ein mouseUp-Ereignis.
IInteractionEventHandler
 Inherited
Verarbeitet ein mouseWheel-Ereignis.
IInteractionEventHandler
  
notifyInsertOrDelete(absolutePosition:int, length:int):void
Aktualisiert den Auswahlmanager, wenn Text eingefügt oder gelöscht wird.
ISelectionManager
  
Zeigt die Auswahlformen erneut an.
ISelectionManager
  
Wählt den gesamten Fluss aus..
ISelectionManager
  
selectRange(anchorPosition:int, activePosition:int):void
Wählt einen Textbereich aus.
ISelectionManager
  
Legt den Fokus auf den ersten Container in der Auswahl.
ISelectionManager
  
Legt das SelectionState-Objekt der aktuellen Auswahl fest.
ISelectionManager
 Inherited
Verarbeitet ein softKeyboardActivating-Ereignis.
IInteractionEventHandler
 Inherited
Verarbeitet ein TextEvent.
IInteractionEventHandler
Eigenschaftendetails

absoluteEnd

Eigenschaft
absoluteEnd:int  [schreibgeschützt]

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

Die Textposition am Ende der Auswahl als Offset ab Beginn des Textflusses.

Das absolute Ende ist entweder mit dem aktiven oder dem Ankerpunkt der Auswahl identisch, je nachdem, welcher im Textfluss an letzter Stelle steht.



Implementierung
    public function get absoluteEnd():int

absoluteStart

Eigenschaft 
absoluteStart:int  [schreibgeschützt]

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

Die Textposition am Anfang der Auswahl als Offset ab Beginn des Textflusses.

Der absolute Anfang ist entweder mit dem aktiven oder dem Ankerpunkt der Auswahl identisch, je nachdem, welcher im Textfluss an letzter Stelle steht.



Implementierung
    public function get absoluteStart():int

activePosition

Eigenschaft 
activePosition:int  [schreibgeschützt]

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

Der aktive Punkt der Auswahl.

Der aktive Punkt ist das flüchtige Ende der Auswahl. Der aktive Punkt wird geändert, wenn die Auswahl modifiziert wird. Der aktive Punkt kann sich entweder am Anfang oder am Ende der Auswahl befinden.



Implementierung
    public function get activePosition():int

anchorPosition

Eigenschaft 
anchorPosition:int  [schreibgeschützt]

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

Der Ankerpunkt der Auswahl.

Ein Ankerpunkt ist das stabile Ende der Auswahl. Wenn die Auswahl erweitert wird, ändert sich der Ankerpunkt nicht. Der Ankerpunkt kann sich entweder am Anfang oder am Ende der Auswahl befinden.



Implementierung
    public function get anchorPosition():int

currentSelectionFormat

Eigenschaft 
currentSelectionFormat:SelectionFormat  [schreibgeschützt]

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

Das aktuelle SelectionFormat-Objekt.

Das aktuelle SelectionFormat-Objekt wird aus den SelectionFormat-Objekten gewählt, die den unfocusedSelectionFormat-, inactiveSelectionFormat- und focusedSelectionFormat-Eigenschaften basierend auf dem aktuellen Status der windowActive- und focused-Eigenschaften zugeordnet sind.



Implementierung
    public function get currentSelectionFormat():SelectionFormat

editingMode

Eigenschaft 
editingMode:String  [schreibgeschützt]

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

Der Bearbeitungsmodus.

Der Bearbeitungsmodus gibt an, ob der Textfluss Auswahl, Bearbeitung oder nur Lesen unterstützt. Ein Textfluss wird durch Zuweisen eines Auswahlmanagers auswählbar und durch Zuweisen eines Bearbeitungsmanagers bearbeitbar gemacht. Konstanten, die die Bearbeitungsmodi darstellen, werden in der EditingMode-Klasse definiert.



Implementierung
    public function get editingMode():String

Verwandte API-Elemente

flashx.textLayout.EditingMode

focused

Eigenschaft 
focused:Boolean  [schreibgeschützt]

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

Gibt an, ob ein Container im Textfluss den Fokus hat.

Die focused-Eigenschaft ist true, wenn einer der Container im Textfluss den Hauptfokus hat.



Implementierung
    public function get focused():Boolean

focusedSelectionFormat

Eigenschaft 
focusedSelectionFormat:SelectionFormat

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

Das SelectionFormat-Objekt, das zum Ziehen der Auswahl in einen fokussierten Container verwendet wird.



Implementierung
    public function get focusedSelectionFormat():SelectionFormat
    public function set focusedSelectionFormat(value:SelectionFormat):void

inactiveSelectionFormat

Eigenschaft 
inactiveSelectionFormat:SelectionFormat

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

Das SelectionFormat-Objekt, das zum Ziehen der Auswahl verwendet wird, wenn sie sich nicht im aktiven Fenster befindet.



Implementierung
    public function get inactiveSelectionFormat():SelectionFormat
    public function set inactiveSelectionFormat(value:SelectionFormat):void

textFlow

Eigenschaft 
textFlow:flashx.textLayout.elements:TextFlow

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

Das von diesem Auswahlmanager verwaltete TextFlow-Objekt.

Ein Auswahlmanager verwaltet einen einzelnen Textfluss. Ein Auswahlmanager kann auch einem Textfluss zugewiesen werden, indem die interactionManager-Eigenschaft des TextFlow-Objekts festgelegt wird.



Implementierung
    public function get textFlow():flashx.textLayout.elements:TextFlow
    public function set textFlow(value:flashx.textLayout.elements:TextFlow):void

Verwandte API-Elemente

unfocusedSelectionFormat

Eigenschaft 
unfocusedSelectionFormat:SelectionFormat

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

Das SelectionFormat-Objekt, das zum Ziehen der Auswahl verwendet wird, wenn sie sich nicht im fokussierten Container, sondern im aktiven Fenster befindet.



Implementierung
    public function get unfocusedSelectionFormat():SelectionFormat
    public function set unfocusedSelectionFormat(value:SelectionFormat):void

windowActive

Eigenschaft 
windowActive:Boolean  [schreibgeschützt]

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

Gibt an, ob das mit dem Textfluss verknüpfte Fenster aktiv ist.

Die windowActive-Eigenschaft ist true, wenn das mit dem Textfluss angezeigte Fenster das aktive Fenster ist.



Implementierung
    public function get windowActive():Boolean
Methodendetails

flushPendingOperations

()Methode
public function flushPendingOperations():void

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

Führt ausstehende FlowOperations aus.

Die Ausführung einiger Bearbeitungsvorgänge wie beispielsweise das Einfügen von Text wird bis zum nächsten enterFrame-Ereignis aufgeschoben. Das Aufrufen von flushPendingOperations() hat zur Folge, dass verzögerte Vorgänge sofort ausgeführt werden.

getCommonCharacterFormat

()Methode 
public function getCommonCharacterFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat

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

Ruft die Zeichenformatattribute ab, die für alle Zeichen im angegebenen Textbereich oder in der aktuellen Auswahl verwendet werden.

Für Formatattribute, die nicht denselben Wert für alle Zeichen im angegebenen Elementbereich oder in der Auswahl haben, wird in der zurückgegebenen TextLayoutFormat-Instanz null festgelegt.

Parameter

range:flashx.textLayout.elements:TextRange (default = null) — Der optionale Textbereich, für den allgemeine Attribute angefordert werden. Bei dem Wert null wird die aktuelle Auswahl verwendet.

Rückgabewerte
flashx.textLayout.formats:TextLayoutFormat — Die häufig verwendeten Zeicheneinstellungen

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird erläutert, wie ein ITextLayoutFormat-Objekt, das die für alle Elemente in der Auswahl üblichen Zeichenformateinstellungen enthält, abgerufen werden kann. (Die textFlow-Variable im Beispiel ist ein TextFlow-Objekt.)
 var common:ITextLayoutFormat = textFlow.interactionManager.getCommonCharacterFormat();

getCommonContainerFormat

()Methode 
public function getCommonContainerFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat

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

Ruft die Containerformatattribute ab, die für alle Container im angegebenen Textbereich oder in der aktuellen Auswahl verwendet werden.

Für Formatattribute, die nicht denselben Wert für alle Container im angegebenen Elementbereich oder in der Auswahl haben, wird in der zurückgegebenen TextLayoutFormat-Instanz null festgelegt.

Parameter

range:flashx.textLayout.elements:TextRange (default = null) — Der optionale Textbereich, für den allgemeine Attribute angefordert werden. Bei dem Wert null wird die aktuelle Auswahl verwendet.

Rückgabewerte
flashx.textLayout.formats:TextLayoutFormat — Die häufig verwendeten Containereinstellungen

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird erläutert, wie ein ITextLayoutFormat-Objekt, das die für alle Elemente in der Auswahl üblichen Containereinstellungen aufweist, abgerufen werden kann. (Die textFlow-Variable im Beispiel ist ein TextFlow-Objekt.)
 var common:ITextLayoutFormat = textFlow.interactionManager.getCommonContainerFormat();

getCommonParagraphFormat

()Methode 
public function getCommonParagraphFormat(range:flashx.textLayout.elements:TextRange = null):flashx.textLayout.formats:TextLayoutFormat

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

Ruft die Absatzformatattribute ab, die für alle Absätze im angegebenen Textbereich oder in der aktuellen Auswahl verwendet werden.

Für Formatattribute, die nicht denselben Wert für alle Absätze im angegebenen Elementbereich oder in der Auswahl haben, wird in der zurückgegebenen TextLayoutFormat-Instanz null festgelegt.

Parameter

range:flashx.textLayout.elements:TextRange (default = null) — Der optionale Textbereich, für den allgemeine Attribute angefordert werden. Bei dem Wert null wird die aktuelle Auswahl verwendet.

Rückgabewerte
flashx.textLayout.formats:TextLayoutFormat — Die häufig verwendeten Absatzeinstellungen

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird erläutert, wie ein ITextLayoutFormat-Objekt, das die für alle Elemente in der Auswahl üblichen Absatzeinstellungen aufweist, abgerufen werden kann. (Die textFlow-Variable im Beispiel ist ein TextFlow-Objekt.)
 var common:ITextLayoutFormat = textFlow.interactionManager.getCommonParagraphFormat();

getSelectionState

()Methode 
public function getSelectionState():SelectionState

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

Ruft das SelectionState-Objekt der aktuellen Auswahl ab.

Rückgabewerte
SelectionState

Verwandte API-Elemente


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird ein SelectionState-Objekt für die aktuelle Auswahl in einem Textfluss abgerufen. (Die textFlow-Variable im Beispiel ist ein TextFlow-Objekt.)
 var selection:SelectionState = textFlow.interactionManager.getSelectionState();

hasSelection

()Methode 
public function hasSelection():Boolean

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

Zeigt an, ob es eine Auswahl gibt.

Gibt true zurück, wenn entweder eine Bereichsauswahl oder eine Punktauswahl vorhanden ist. Wenn standardmäßig zuerst ein Auswahlmanager eingerichtet wird, gibt es keine Auswahl (Anfang und Ende sind -1).

Rückgabewerte
Boolean

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird erläutert, wie bestimmt werden kann, ob ein Textfluss über eine Auswahl verfügt. (Die textFlow-Variable im Beispiel ist ein TextFlow-Objekt.)
 var selection:SelectionState = textFlow.interactionManager.hasSelection();

isRangeSelection

()Methode 
public function isRangeSelection():Boolean

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

Gibt an, ob die Auswahl einen Textbereich abdeckt.

Gibt true zurück, wenn eine Auswahl vorliegt, die nach einer einzelnen Position erweitert wird.

Rückgabewerte
Boolean

Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird erläutert, wie bestimmt werden kann, ob die aktuelle Auswahl in einem Textfluss sich über einen Textbereich erstreckt. (Die textFlow-Variable im Beispiel ist ein TextFlow-Objekt.)
 var selection:SelectionState = textFlow.interactionManager.isRangeSelection();

notifyInsertOrDelete

()Methode 
public function notifyInsertOrDelete(absolutePosition:int, length:int):void

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

Aktualisiert den Auswahlmanager, wenn Text eingefügt oder gelöscht wird.

Vorgänge müssen notifyInsertOrDelete aufrufen, wenn der Text im Textfluss geändert wird. Der Auswahlmanager passt indexbasierte Positionsindikatoren dementsprechend an. Wenn Sie eine neue Operation-Klasse erstellen, die Text in einem Textfluss direkt ändert (ohne Verwendung eines anderen Vorgangs), muss Ihr Vorgang diese Funktion aufrufen, um die Auswahl auf dem aktuellen Stand zu halten.

Parameter

absolutePosition:int — Der Punkt im Text, an dem die Änderung vorgenommen wurde.
 
length:int — Eine positive oder negative Zahl, die angibt, wie viele Zeichen eingefügt oder gelöscht wurden.


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird erläutert, wie eine Funktion in einer benutzerdefinierten Operation-Klasse die notifyInsertOrDelete()-Methode aufruft.

Diese Funktion ersetzt einen Textbereich in einem SpanElement als Teil eines hypothetischen Vorgangs.

 import flashx.textLayout.elements.SpanElement;
 

function doReplace( span:SpanElement, newText:String, relativeStart:int, relativeEnd:int ):void
{
    span.replaceText(  relativeStart, relativeEnd, newText );
    var parentFlow:TextFlow = span.getTextFlow();
    var lengthDifference:int = newText.length - (relativeEnd - relativeStart);

    parentFlow.interactionManager.notifyInsertOrDelete(    span.getAbsoluteStart() + relativeStart, lengthDifference );
}

refreshSelection

()Methode 
public function refreshSelection():void

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

Zeigt die Auswahlformen erneut an.

Hinweis: Sie müssen diese Methode nicht direkt aufrufen. Sie wird automatisch aufgerufen.

selectAll

()Methode 
public function selectAll():void

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

Wählt den gesamten Textfluss aus.

selectRange

()Methode 
public function selectRange(anchorPosition:int, activePosition:int):void

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

Wählt einen Textbereich aus.

Wenn eine negative Zahl als einer der Parameter übergeben wird, wird jede vorhandene Auswahl entfernt.

Parameter

anchorPosition:int — Der Ankerpunkt für die neue Auswahl als absolute Position im TextFlow
 
activePosition:int — Das aktive Ende der neuen Auswahl als absolute Position im TextFlow


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird ein Textfluss erstellt und eine Auswahl vorgenommen:
 var textFlow:TextFlow = TextConverter.importToFlow( "Let me not to the marriage of true minds", TextConverter.PLAIN_TEXT_FORMAT );
 textFlow.interactionManager = new SelectionManager();
 
 textFlow.interactionManager.selectRange( 18, 26 ); // Selects the word 'marriage'

setFocus

()Methode 
public function setFocus():void

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

Legt den Fokus auf den ersten Container in der Auswahl.


Beispiel  ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird der Fokus auf den ersten Container in der aktuellen Auswahl eines Textflusses gelegt. (Die textFlow-Variable im Beispiel ist ein TextFlow-Objekt.)
 textFlow.interactionManager.setFocus();

setSelectionState

()Methode 
public function setSelectionState(state:SelectionState):void

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

Legt das SelectionState-Objekt der aktuellen Auswahl fest.

Parameter

state:SelectionState

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.