24.2 ActiveX
In den meisten Fällen wird die ActiveX-Steuerung für Flash-Filme analog zum Plug-in verwendet und z.B. mit JavaScript gesteuert. Flash-Filme lassen sich über ActiveX jedoch nicht nur in einem Webbrowser abspielen, sondern können auch in andere Programme integriert werden.
Außer dem Flash Player (Shockwave Flash Object) gibt es zahlreiche weitere ActiveX-Steuerungen (auch unter dem Namen OLE/OCX-Steuerungen bekannt) – z.B. für Shockwave Director oder Real Audio.
Da die ActiveX-Steuerung als Plug-in im Internet Explorer unter Windows verwendet wird, besitzt sie zum größten Teil dieselbe Funktionalität wie das Netscape-Plug-in. Beispiele sowohl für das Plug-in als auch die ActiveX-Steuerung finden Sie im vorherigen Kapitel. ActiveX-Steuerungen können auch die Funktionalität normaler Anwendungen erweitern. Über ActiveX lassen sich Flash Player-Filme z.B. innerhalb Visual C++ oder Visual Basic einsetzen. Die ActiveX-Steuerung bietet eine Schnittstelle, über die ein Flash-Film mehr als gestartet und gestoppt werden kann: Es gibt zahlreiche Eigenschaften, Methoden und Ereignisse.
ActiveX-Steuerung
Ein Großteil der Eigenschaften, Methoden und Ereignisse bezüglich der Flash Player ist nicht oder nur unzureichend dokumentiert. Eine gute Hilfe bietet hier Windows dank ActiveX. Denn viele Programmierumgebungen erlauben es, ActiveX-Steuerungen einzubetten und deren Funktionalität zu analysieren. Recht einfach geht das mit dem Visual Studio von Microsoft. Aber selbst der Macromedia Director enthält eine entsprechende Schnittstelle.
Falls Sie einen Flash Player-Film über ActiveX kontrollieren möchten, muss die ActiveX-Steuerung auf dem Zielrechner installiert sein. Falls Sie ein Programm vertreiben, das die ActiveX-Steuerung für Flash benötigt, reicht die Installation des Plug-ins für den Internet Explorer aus. Automatisch wird die ActiveX-Steuerung im System angemeldet und für andere Programme zur Verfügung gestellt. Die ActiveX-Steuerung ist kostenlos auf der Macromedia-Website unter http://www.macromedia.com erhältlich. Wenn Sie die ActiveX-Steuerung selber mitliefern möchten, müssen Sie sich direkt mit Macromedia in Verbindung setzen und eine Lizenzvereinbarung treffen.
24.2.1 Eigenschaften
Der Flash Player in der ActiveX-Variante besitzt zahlreiche Eigenschaften, die sich zum Teil auch mit dem Flash Player-Plug-in (Netscape) verwenden lassen. Manche der Eigenschaften, die nur für die ActiveX-Steuerung zur Verfügung stehen, können für das Plug-in im EMBED-Tag festgelegt werden.
24.2.2 AlignMode
Diese Eigenschaft legt die Platzierung des Flash-Films im durch Höhe und Breite festgelegten Bereich fest (siehe SAlign).
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 2 eingeführt. |
|
|
|
Wert |
|
Sinnvolle Kombinationen (z.B. 5 für links oben) der Bit-Flags 0 (Mitte), 1 (links), 2 (rechts), 4 (oben) und 8 (unten), Standard 0. |
|
|
|
BackgroundColor |
|
Diese Eigenschaft legt die Hintergrundfarbe des Flash-Films fest (siehe BGColor). |
|
|
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 2 eingeführt. Bei dem Wert -1 wird die Hintergrundfarbe aus den Filmeigenschaften verwendet. |
|
|
|
Wert |
|
Ganzzahl (Integer), Standard -1 |
|
|
24.2.3 Base
Diese Eigenschaft legt das Basisverzeichnis für relative URLs innerhalb des Flash-Films fest.
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 2 eingeführt. |
|
|
|
Wert |
|
URL als Zeichenfolge (String) |
|
|
24.2.4 BGColor
Diese Eigenschaft legt die Hintergrundfarbe des Flash-Films fest (siehe BackgroundColor).
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 2 eingeführt. Bei einer leeren Zeichenfolge wird die Hintergrundfarbe aus den Filmeigenschaften verwendet. |
|
|
|
Wert |
|
Hintergrundfarbe als Zeichenfolge (hexadezimale Angabe der Farbwerte im Format: #RRGGBB), Standard ist eine leere Zeichenfolge. |
|
|
24.2.5 DeviceFont
Diese Eigenschaft bestimmt, ob für Text innerhalb des Flash-Films Geräteschriftarten verwendet werden sollen.
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 2 eingeführt. |
|
|
|
Wert |
|
Boolean (TRUE und FALSE), Standard FALSE |
|
|
24.2.6 EmbedMovie
Diese Eigenschaft bestimmt, ob der Flash-Film eingebettet werden soll.
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 4 eingeführt. |
|
|
|
Wert |
24.2.7 FrameNum
Diese Eigenschaft bestimmt das angezeigte Bild des Flash-Films.
|
Bemerkung |
|
Diese Eigenschaft kann nur mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 2 eingeführt. Wenn diese Eigenschaft gesetzt wird, stoppt der Abspielvorgang. |
|
|
|
Wert |
24.2.8 Loop
Diese Eigenschaft bestimmt, ob der Flash-Film in einer Schleife wiederholt werden soll.
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 2 eingeführt. |
|
|
|
Wert |
24.2.9 Menü
Diese Eigenschaft bestimmt, ob das Kontextmenü des Flash Players komplett oder verkürzt angezeigt wird.
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 2 eingeführt. |
|
|
|
Wert |
24.2.10 Movie
Diese Eigenschaft bestimmt die URL für den Flash Player-Film (SWF).
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 2 eingeführt. |
|
|
|
Wert |
24.2.11 Playing
Diese Eigenschaft bestimmt, ob der Flash Player-Film abspielt.
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 2 eingeführt. |
|
|
|
Wert |
24.2.12 Quality
Diese Eigenschaft bestimmt die Darstellungsqualität (siehe Quality2).
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 2 eingeführt. |
|
|
|
Wert |
|
0 (niedrig), 1 (automatisch niedrig), 2 (automatisch hoch), 3 (hoch) |
|
|
24.2.13 Quality2
Diese Eigenschaft bestimmt die Darstellungsqualität (siehe Quality).
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 4 eingeführt. |
|
|
|
Wert |
|
Low (niedrig), AutoLow (automatisch niedrig), Medium (mittel), AutoHigh (automatisch hoch), High (hoch), Best (beste) |
|
|
24.2.14 ReadyState
Diese Eigenschaft bestimmt den Ladezustand des Flash-Films.
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung nur gelesen werden. Sie wurde mit Flash 2 eingeführt. |
|
|
|
Wert |
|
0 (während des Ladens), 1 (nicht initialisiert), 2 (geladen), 3 (interaktiv), 4 (das Laden des Darstellers ist abgeschlossen) |
|
|
24.2.15 SAlign
Diese Eigenschaft legt fest, wie der Flash-Film innerhalb des durch die Größe (height und width) festgelegten Bereiches platziert wird (siehe auch AlignMode).
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 2 eingeführt. |
|
|
|
SAlign legt im Zusammenspiel mit Scale fest, welche Bereiche beschnitten (NoBorder) oder welche Teile des Arbeitsbereiches angezeigt werden
(ShowAll). |
|
|
|
Wert |
|
Alle sinnvollen Kombinationen von B (untere Kante), T (obere Kante), L (linke Kante) und R (rechte Kante). Falls kein Wert angegeben wird, wird der Flash-Film horizontal und vertikal zentriert. |
|
|
24.2.16 Scale
Diese Eigenschaft bestimmt, wie die Skalierung des Flash-Films durchgeführt werden soll (siehe ScaleMode).
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 2 eingeführt. |
|
|
|
Wert |
ShowAll (alles anzeigen), NoBorder (kein Rand), ExactFit (genau passend), Standard ShowAll
24.2.17 ScaleMode
Diese Eigenschaft bestimmt, wie die Skalierung des Flash-Films durchgeführt werden soll (siehe Scale).
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 2 eingeführt. |
|
|
|
Wert |
|
0 (alles anzeigen), 1 (kein Rand), 2 (genau passend), Standard ist 0 |
|
|
24.2.18 SWRemote
Diese Eigenschaft wird im Zusammenhang mit Shockwave Remote und Shockmachine eingesetzt.
|
Bemerkung |
|
Diese Eigenschaft kann nur mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 4 eingeführt. Weitere Informationen erhalten Sie im Entwicklerzentrum unter http://www.shockwave.com. |
|
|
24.2.19 TotalFrames
Diese Eigenschaft ermittelt die Anzahl der Bilder eines Flash-Films.
|
Bemerkung |
|
Diese Eigenschaft kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in gelesen werden. Sie wurde mit Flash 2 eingeführt. |
|
|
|
Wert |
|
Beispiel |
// JavaScript-Beispiel
// Ermittle die Anzahl der Bilder
var InternetExplorer = navigator.appName.indexOf("Microsoft")
!= -1;
var meinFilmObj = InternetExplorer ? meinFilm :
document.meinFilm;
if (InternetExplorer) {
alert(meinFilmObj.TotalFrames);
} else {
alert(meinFilmObj.TotalFrames());
}
24.2.20 WMode
Diese Eigenschaft bestimmt den Fenstermodus des Flash-Films.
|
Bemerkung |
|
Diese Eigenschaft kann mit der ActiveX-Steuerung gelesen und gesetzt werden. Sie wurde mit Flash 3 eingeführt. Diese Eigenschaft hat nur eine Wirkung auf den Internet Explorer 4 oder höher. |
|
|
|
Wert |
|
Window (Fenster), Opaque (undurchsichtig), Transparent, Standard ist Window |
|
|
24.2.21 Methoden
Fast alle Methoden der ActiveX-Steuerung stehen auch für das Plug-in (Netscape) zur Verfügung.
24.2.22 Back
Diese Methode setzt den Flash-Film genau ein Bild zurück und stoppt ihn dann (siehe Forward).
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 2 zur Verfügung. |
|
|
|
Parameter |
|
Rückgabewert |
24.2.23 CurrentFrame
Diese Methode gibt die Bildnummer des im Flash-Film dargestellten Bildes an.
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. |
|
|
|
Parameter |
|
Rückgabewert |
24.2.24 FlashVersion
Diese Methode gibt die Version des Flash Players an.
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 3 zur Verfügung. |
|
|
|
Parameter |
|
Rückgabewert |
Ganzzahl
24.2.25 Forward
Diese Methode setzt den Flash-Film genau ein Bild vor und stoppt ihn dann (siehe auch Back).
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 2 zur Verfügung. |
|
|
|
Parameter |
|
Rückgabewert |
24.2.26 FrameLoaded
Diese Methode ermittelt für ein Bild im Flash-Film, ob es bereits geladen ist.
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. |
|
|
|
Parameter |
|
Rückgabewert |
24.2.27 GetVariable
Diese Methode ermittelt den Wert einer Variablen im Flash-Film.
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 4 zur Verfügung. Die Variable geben Sie wie in Flash als Zeichenfolge an. Sie können auch eine Variable in einer Filmsequenz ermitteln, indem Sie den kompletten Pfad verwenden. |
|
|
|
Parameter |
|
Variable als Zeichenfolge |
|
|
|
Rückgabewert |
24.2.28 GotoFrame
Diese Methode setzt den aktuellen Bildzeiger auf das angegebene Bild im Flash-Film und stoppt ihn dann (siehe TGotoFrame).
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 2 zur Verfügung. |
|
|
|
Parameter |
|
Rückgabewert |
24.2.29 IsPlaying
Diese Methode ermittelt, ob der Flash-Film gerade abspielt.
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 2 zur Verfügung. |
|
|
|
Parameter |
|
Rückgabewert |
24.2.30 LoadMovie
Diese Methode lädt einen Flash Player-Film (SWF) in die angegebene Ebene (engl. Level).
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 3 zur Verfügung. |
|
|
|
Parameter |
|
Ebene als Ganzzahl, URL als Zeichenfolge |
|
|
|
Rückgabewert |
24.2.31 Pan
Diese Methode verschiebt den Flash-Film.
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 2 zur Verfügung. Das Verschieben funktioniert nur bei einem vergrößerten Flash-Film (siehe Zoom). |
|
|
|
Parameter |
|
x als Ganzzahl, y als Ganzzahl, Modus als Ganzzahl (0 für Pixel, 1 für Prozent) |
|
|
|
Rückgabewert |
24.2.32 PercentLoaded
Diese Methode gibt an, wie viel des Flash-Films bereits in den Speicher geladen ist.
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 2 zur Verfügung. |
|
|
|
Parameter |
|
Rückgabewert |
|
Prozent als Ganzzahl (0-100) |
|
|
24.2.33 Play
Diese Methode startet den Flash-Film (siehe Stop).
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 2 zur Verfügung. |
|
|
|
Parameter |
|
Rückgabewert |
24.2.34 Rewind
Diese Methode setzt den Flash-Film zurück auf das erste Bild (siehe Forward).
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 2 zur Verfügung. |
|
|
|
Parameter |
|
Rückgabewert |
24.2.35 SetVariable
Diese Methode setzt den Wert einer Variablen im Flash-Film.
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 4 zur Verfügung. |
|
|
|
Die Variable geben Sie als Zeichenfolge wie in Flash an. Sie können auch eine Variable in einer Filmsequenz setzen, indem Sie den kompletten Pfad verwenden. |
|
|
|
Parameter |
|
Variable als Zeichenfolge, Wert als Zeichenfolge |
|
|
|
Rückgabewert |
24.2.36 SetZoomRect
Diese Methode vergrößert einen rechteckigen Ausschnitt des Flash-Films. Die Einheiten für die Koordinaten z.B. bei SetZoomRect werden in 1440 Einheiten pro Zoll angegeben (TWIPS). Um ein Rechteck in Flash zu ermitteln, setzen Sie die Anzeige der Lineale auf die Einheit Punkt und multiplizieren die Koordinaten mit 20.
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 2 zur Verfügung. |
|
|
|
Parameter |
|
Links als Ganzzahl, oben als Ganzzahl, rechts als Ganzzahl, unten als Ganzzahl |
|
|
|
Rückgabewert |
24.2.37 Stop
Diese Methode stoppt den Flash-Film (siehe StopPlay).
|
Bemerkung |
|
Diese Methode kann nur mit der ActiveX-Steuerung verwendet werden. Sie steht seit Flash 3 zur Verfügung. |
|
|
|
Parameter |
|
Rückgabewert |
Keiner
24.2.38 StopPlay
|
Diese Methode stoppt den Flash-Film (siehe Stop). |
|
|
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 2 zur Verfügung. |
|
|
|
Parameter |
|
Rückgabewert |
24.2.39 TCallFrame
Diese Methode ruft ein ActionScript in einem Flash-Film auf (siehe
TCallLabel).
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 4 zur Verfügung. Die Bildnummern beginnen für diese Methode nicht bei eins, sondern bei null. |
|
|
|
Parameter |
|
Ziel als Zeichenfolge, Bildnummer als Ganzzahl |
|
|
|
Rückgabewert |
|
Beispiel |
meinFilmObj.TCallLabel("filmsequenz",1);
24.2.40 TCallLabel
Diese Methode ruft ein ActionScript in einem Flash-Film auf (siehe TCall
Frame).
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 4 zur Verfügung. |
|
|
|
Parameter |
|
Ziel als Zeichenfolge, Bildbezeichnung als Zeichenfolge |
|
|
|
Rückgabewert |
|
Beispiel |
meinFilmObj.TCallFrame("filmsequenz", "bildbezeichnung");
24.2.41 TCurrentFrame
Diese Methode ermittelt die Bildnummer des Bildes, das gerade in der angegebenen Filmsequenz dargestellt wird.
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 3 zur Verfügung. Die Bildnummern beginnen für diese Methode nicht bei eins, sondern bei null. |
|
|
|
Parameter |
|
Rückgabewert |
24.2.42 TCurrentLabel
Diese Methode gibt die Bezeichnung des in einer Filmsequenz dargestellten Bildes an.
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 3 zur Verfügung. |
|
|
|
Parameter |
|
Rückgabewert |
|
Bildbezeichnung als Zeichenfolge |
|
|
24.2.43 TGetProperty
Diese Methode ermittelt eine Eigenschaft der angegebenen Filmsequenz (siehe TGetPropertyNum, TSetProperty, TSetPropertyNum).
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 4 zur Verfügung. |
|
|
|
Um einzelne Eigenschaften auslesen oder setzen zu können, benötigen Sie die Kennung der Eigenschaft als Ganzzahl wie in der Tabelle aufgeführt. |
|
|
|
Parameter |
|
Ziel als Zeichenfolge, Eigenschaft als Ganzzahl |
|
|
Tabelle 24.4
Eigenschaften und ihre Kennung
Eigenschaft
|
Ganzzahl
|
Lesen/Schreiben
|
_x
|
0
|
ja
|
_y
|
1
|
ja
|
_xscale
|
2
|
ja
|
_yscale
|
3
|
ja
|
_currentframe
|
4
|
nur lesen
|
_totalframes
|
5
|
nur lesen
|
_alpha
|
6
|
ja
|
_visible
|
7
|
ja
|
_width
|
8
|
nur lesen
|
_height
|
9
|
nur lesen
|
_rotation
|
10
|
ja
|
_target
|
11
|
nur lesen
|
_framesloaded
|
12
|
nur lesen
|
_name
|
13
|
ja
|
_droptarget
|
14
|
nur lesen
|
_url
|
15
|
nur lesen
|
Tabelle 24.5
Globale Eigenschaften und ihre Kennung
GlobaleEigenschaft
|
Ganzzahl
|
Lesen/Schreiben
|
_highquality
|
16
|
ja
|
_focusrect
|
17
|
ja
|
_soundbuftime
|
18
|
ja
|
|
Rückgabewert |
24.2.44 TGetPropertyNum
Diese Methode ermittelt eine Eigenschaft der angegebenen Filmsequenz (siehe TGetProperty, TSetProperty, TSetPropertyNum).
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 4 zur Verfügung. |
|
|
|
Die Kennung der einzelnen Eigenschaften finden Sie in diesem Kapitel unter der Methode TGetProperty. |
|
|
|
Parameter |
|
Ziel als Zeichenfolge, Eigenschaft als Ganzzahl |
|
|
|
Rückgabewert |
24.2.45 TGotoFrame
Diese Methode setzt den aktuellen Bildzeiger auf das angegebene Bild in der angegebenen Filmsequenz (siehe GotoFrame).
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 3 zur Verfügung. Die Bildnummern beginnen für diese Methode nicht bei eins, sondern bei null. |
|
|
|
Parameter |
|
Ziel als Zeichenfolge, Bildnummer als Ganzzahl |
|
|
|
Rückgabewert |
24.2.46 TGotoLabel
Diese Methode setzt den aktuellen Bildzeiger auf das angegebene Bild in der angegebenen Filmsequenz.
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 3 zur Verfügung. |
|
|
|
Parameter |
|
Ziel als Zeichenfolge, Bildbezeichnung als Zeichenfolge |
|
|
|
Rückgabewert |
24.2.47 TPlay
Diese Methode startet eine Filmsequenz.
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 3 zur Verfügung. |
|
|
|
Parameter |
|
Rückgabewert |
24.2.48 TSetProperty
Diese Methode bestimmt eine Eigenschaft der angegebenen Filmsequenz (siehe TGetProperty, TGetPropertyNum, TSetPropertyNum).
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 4 zur Verfügung. |
|
|
|
Die Kennung der einzelnen Eigenschaften finden Sie in diesem Kapitel bei der Methode TGetProperty. |
|
|
|
Parameter |
|
Ziel als Zeichenfolge, Eigenschaft als Ganzzahl, Wert als Zeichenfolge |
|
|
|
Rückgabewert |
24.2.49 TSetPropertyNum
Diese Methode bestimmt eine Eigenschaft der angegebenen Filmsequenz (siehe TGetProperty, TGetPropertyNum, TSetProperty).
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 4 zur Verfügung. |
|
|
|
Die Kennung der einzelnen Eigenschaften finden Sie in diesem Kapitel bei der Methode TGetProperty. |
|
|
|
Parameter |
|
Ziel als Zeichenfolge, Eigenschaft als Ganzzahl, Wert als Ganzzahl |
|
|
|
Rückgabewert |
Keiner
24.2.50 TStopPlay
Diese Methode stoppt eine Filmsequenz.
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 3 zur Verfügung. |
|
|
|
Parameter |
|
Rückgabewert |
24.2.51 Zoom
Diese Methode vergrößert die Darstellung des Flash-Films.
|
Bemerkung |
|
Diese Methode kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Sie steht seit Flash 2 zur Verfügung. Durch den Wert 50 wird die Darstellungsgröße verdoppelt, durch 200 wird die Größe halbiert. Der Wert 0 setzt die Darstellung zurück auf 100 Prozent. |
|
|
|
Parameter |
|
Rückgabewert |
24.2.52 Ereignisse
Ereignisse
siehe Seite 282
Die ActiveX-Steuerung kann drei verschiedene Ereignisse auslösen. So ist eine Kommunikation in beide Richtungen möglich. Sie können aus einem Flash-Film z.B. VBScripts oder C-Routinen aufrufen.
Wenn Sie eines der Ereignisse in einem Webbrowser verwenden möchten, müssen Sie dem Ereignis den Namen (Netscape) bzw. das ID-Tag (ActiveX) des Flash-Objektes voranstellen: Sub meinFilm_FSCommand(ByVal befehl, ByVal argumente).
24.2.53 FSCommand
Dieses Ereignis wird immer dann ausgelöst, wenn im Flash-Film die Aktion FSCommand ausgelöst wird.
|
Bemerkung |
|
Dieses Ereignis kann sowohl mit der ActiveX-Steuerung als auch mit dem Plug-in verwendet werden. Es steht seit Flash 2 zur Verfügung. Anstelle der Aktion fscommand kann auch getURL verwendet werden, wobei die URL mit FSCommand: beginnen muss. |
|
|
|
Parameter |
|
Befehl als Zeichenfolge, Argumente als Zeichenfolge |
|
|
|
Beispiel |
<SCRIPT LANGUAGE=JavaScript>
// JavaScript (Plug-in) Beispiel
// Gib "Heppa!" aus, sobald ein FSCommand-Ereignis eintritt
function meinFilm_DoFSCommand(befehl, argumente) {
alert("Heppa!");
}
</SCRIPT>
<SCRIPT LANGUAGE=VBScript>
// VBScript (ActiveX) Beispiel
// Gib "Heppa!" aus, sobald ein FSCommand-Ereignis eintritt
Sub meinFilm_FSCommand(ByVal befehl, ByVal argumente)
alert("Heppa!")
end sub
</SCRIPT>
24.2.54 OnProgress
Dieses Ereignis wird beim Laden des Flash Player-Films ausgelöst. Siehe PercentLoaded.
|
Bemerkung |
|
Dieses Ereignis kann nur mit der ActiveX-Steuerung verwendet werden. Es steht seit Flash 2 zur Verfügung. |
|
|
|
Parameter |
24.2.55 OnReadyStateChange
Dieses Ereignis wird ausgelöst, wenn sich der Zustand des Flash Player-Films ändert.
|
Bemerkung |
|
Dieses Ereignis kann nur mit der ActiveX-Steuerung verwendet werden. Es steht seit Flash 2 zur Verfügung. |
|
|
|
Parameter |
|
Zustand als Ganzzahl (0: ladend, 1: nicht initialisiert, 2: geladen, 3: interaktiv, 4: das Laden des Darstellers ist abgeschlossen) |
|
|
|