Arbeiten mit der UIScrollBar-Komponente

Die Mithilfe der UIScrollBar-Komponente können Sie einem Textfeld eine Bildlaufleiste hinzufügen. Dies ist beim Authoring oder mithilfe von ActionScript zur Laufzeit möglich. Um die UIScrollBar-Komponente zu verwenden, erstellen Sie auf der Bühne ein Textfeld und ziehen die UIScrollBar-Komponente aus dem Bedienfeld „Komponenten“ in einen beliebigen Quadranten des Textfeld-Begrenzungsrahmens.

Wenn die gesamte Bildlaufleiste kleiner ist als die beiden Bildlaufpfeile zusammen, wird sie nicht korrekt angezeigt. Einer der Pfeile wird dann von dem anderen verdeckt. Flash bietet dafür keine Fehlerprüfung an. In diesem Fall empfiehlt es sich, die Bildlaufleiste mithilfe von ActionScript auszublenden. Wenn die Bildlaufleiste so klein ist, dass das Bildlauffeld keinen Platz hat, blendet Flash das Bildlauffeld aus.

Die UIScrollBar-Komponente funktioniert wie eine übliche Bildlaufleiste. Sie enthält Bildlaufpfeile an den beiden Enden und dazwischen die Spur der Bildlaufleiste sowie das Bildlauffeld. Sie kann an einem beliebigen Rand eines Textfelds angefügt und vertikal oder horizontal verwendet werden.

Informationen zum TextField finden Sie im Abschnitt zur TextField-Klasse im ActionScript 3.0 Referenzhandbuch für Flash Professional .

Benutzerinteraktion mit der UIScrollBar-Komponente

Im Gegensatz zu vielen anderen Komponenten kann die UIScrollBar-Komponente auf fortgesetzte Mauseingaben reagieren. Der Benutzer kann also die Maustaste gedrückt halten anstatt wiederholt zu klicken.

Für die UIScrollBar-Komponente gibt es keine Interaktion über die Tastatur.

Parameter der UIScrollBar-Komponente

Die folgenden Authoring-Parameter können für jede Instanz einer UIScrollBar-Komponente im Eigenschaften- oder Komponenteninspektor festgelegt werden: direction und scrollTargetName . Jeder dieser Parameter besitzt eine entsprechende ActionScript-Eigenschaft desselben Namens.

Sie können zusätzliche Optionen für UIScrollBar-Instanzen mit den Klassenmethoden, Eigenschaften und Ereignissen von ActionScript festlegen. Weitere Informationen finden Sie im Abschnitt zur UIScrollBar-Klasse im ActionScript 3.0 Referenzhandbuch für Flash Professional .

Erstellen einer Anwendung mit der UIScrollBar-Komponente

Im Folgenden wird beschrieben, wie Sie beim Authoring eine UIScrollBar-Komponente in eine Anwendung einfügen.

  1. Erstellen Sie ein neues Flash-Dokument (ActionScript 3.0).

  2. Erstellen Sie ein dynamisches Textfeld, das groß genug für ein oder zwei Textzeilen ist, und geben Sie der Instanz im Eigenschafteninspektor den Namen myText .

  3. Wählen Sie im Eigenschafteninspektor als Zeilentyp für das Texteingabefeld „Mehrzeilig“ oder „Mehrzeilig, kein Umbruch“, wenn Sie eine horizontale Bildlaufleiste verwenden möchten.

  4. Öffnen Sie das Bedienfeld „Aktionen“, wählen Sie Bild 1 in der Zeitleiste aus und geben Sie den folgenden ActionScript-Code ein, um die Eigenschaft text so zu füllen, dass ein Benutzer einen Bildlauf ausführen muss, um den gesamten Text zu sehen: 

    myText.text="When the moon is in the seventh house and Jupiter aligns with Mars, then peace will guide the planet and love will rule the stars."
    Hinweis: Achten Sie darauf, dass das Textfeld auf der Bühne klein genug ist, damit der Text nicht vollständig sichtbar ist. Andernfalls wird die Bildlaufleiste nicht angezeigt oder erscheint lediglich als zwei Zeilen ohne Grip (welchen Sie ziehen, um einen Bildlauf für den Inhalt auszuführen).

  5. Vergewissern Sie sich, dass die Ausrichtung an Objekten aktiviert ist („Ansicht“ > „Ausrichten“ > „An Objekten ausrichten“).

  6. Ziehen Sie eine UIScrollBar-Instanz aus dem Bedienfeld „Komponenten“ auf das Texteingabefeld, nahe der Seite, an der die Bildlaufleiste eingefügt werden soll. Die Komponente muss das Textfeld beim Loslassen der Maustaste überlappen, damit sie korrekt an das Feld gebunden wird. Geben Sie den Instanznamen mySb ein.

    Die Eigenschaft scrollTargetName der Komponente wird im Eigenschaften- und Komponenten-Inspektor automatisch mit dem Instanznamen des Textfelds versehen. Falls dies auf der Registerkarte „Parameter“ nicht zu sehen ist, haben Sie die UIScrollBar-Instanz evtl. nicht genug überlappt.

  7. Wählen Sie „Steuerung“ > „Film testen“.

Erstellen einer UIScrollBar-Komponenteninstanz mithilfe von ActionScript-Code

Sie können eine UIScrollBar-Instanz mithilfe von ActionScript erstellen und zur Laufzeit mit einem Textfeld verknüpfen. Im folgenden Beispiel wird eine horizontal ausgerichtete UIScrollBar-Instanz erstellt und unten an ein Textfeld mit dem Instanznamen myTxt angehängt. Das Textfeld wird mit Text aus einer URL-Adresse gefüllt. Im Beispiel wird zudem die Größe der Bildlaufleiste so eingestellt, dass sie der Größe des Textfelds entspricht.

  1. Erstellen Sie ein neues Flash-Dokument (ActionScript 3.0).

  2. Ziehen Sie die ScrollBar-Komponente in das Bedienfeld „Bibliothek“.

  3. Öffnen Sie das Bedienfeld „Aktionen“, wählen Sie in der Hauptzeitleiste Bild 1 aus und geben Sie den folgenden ActionScript-Code ein: 

    import flash.net.URLLoader; 
import fl.controls.UIScrollBar; 
import flash.events.Event; 
 
var myTxt:TextField = new TextField(); 
myTxt.border = true; 
myTxt.width = 200; 
myTxt.height = 16; 
myTxt.x = 200; 
myTxt.y = 150; 
 
var mySb:UIScrollBar = new UIScrollBar(); 
mySb.direction = "horizontal"; 
// Size it to match the text field. 
mySb.setSize(myTxt.width, myTxt.height);  
 
// Move it immediately below the text field. 
mySb.move(myTxt.x, myTxt.height + myTxt.y); 
 
// put them on the Stage 
addChild(myTxt); 
addChild(mySb); 
// load text 
var loader:URLLoader = new URLLoader(); 
var request:URLRequest = new URLRequest("http://www.helpexamples.com/flash/lorem.txt"); 
loader.load(request); 
loader.addEventListener(Event.COMPLETE, loadcomplete); 
 
function loadcomplete(event:Event) { 
    // move loaded text to text field 
    myTxt.text = loader.data; 
    // Set myTxt as target for scroll bar. 
    mySb.scrollTarget = myTxt; 
}

  4. Wählen Sie „Steuerung“ > „Film testen“.

Rechtliche Hinweise | Online-Datenschutzrichtlinie