#22003/6/12 16:58:37
[转载]Flash的控制函数
◆ 属性：#actionsEnabled
函数：SetIconProperty(@"IconTitle", #actionsEnabled, boolean)
SetSpriteProperty(@"IconTitle", #actionsEnabled, boolean)
说明：设置Flash动画中按钮的动作是否有效，参数boolean取值为TRUE时，Flash动画中按钮的动作有效，取值FALSE时无效。例如：
If Checked@"MyButton" then
SetSpriteProperty(@"Flash Icon", #actionsEnabled, True)
else
SetSpriteProperty(@"Flash Icon", #actionsEnabled, False)
end if
◆ 属性：#broadcastProps
函数：SetIconProperty(@"IconTitle", #broadcastProps, boolean)
说明：控制当对Sprite图标的属性有改动时，是否立即对Sprite图标的显示产生影响。当参数boolean取值为TRUE时，所有对Sprite图标属性的改动将立即体现在Sprite图标的显示上；当参数boolean取值为FALSE时，对Sprite图标属性的改动将不会立即体现在Sprite图标的显示上，而将体现在下一次执行此Sprite图标时。例如：
SetIconProperty(@"Flash Icon", #viewScale, 200)
SetIconProperty(@"Flash Icon", #broadcastProps, False)
◆ 属性：#bufferSize
函数：SetIconProperty(@"IconTitle", #bufferSize, integer)
说明：对于属性设置为链接的Flash动画，设置一次载入内存的数据流的字节数，参数integer只能取整数，默认值为32768。此函数只在Flash动画的预载入属性（# preload）为假时有效。例如：
SetIconProperty(@"Flash Icon", #preload, False)
SetIconProperty(@"Flash Icon", #bufferSize, 65536)
◆ 属性：#buttonsEnabled
函数：SetIconProperty(@"IconTitle", #buttonsEnabled, boolean)
SetSpriteProperty(@"IconTitle", #buttonsEnabled, boolean)
说明：控制Flash动画中的按钮是否有效，参数boolean的取值可以是TRUE或FALSE。例如：
If ButtonsOn then
SetSpriteProperty(@"Flash Icon", #actionsEnabled, True)
SetSpriteProperty(@"Flash Icon", #buttonsEnabled, True)
end if
注：If ButtonsOn then表示如果变量ButtonsOn为真。
◆ 属性：#bytesStreamed
函数：number:=GetIconProperty(@"IconTitle", #bytesStreamed)
说明：返回指定图标中Flash动画载入到内存的数据的字节数，返回值为整数。例如：
repeat while GetIconProperty(@"Flash Icon", #percentStreamed) < 100
CallIcon(@"Flash Icon", #stream)
Message:="Bytes streamed:"^GetIconProperty(@"Flash Icon",
#bytesStreamed)
end repeat
◆ 属性：#centerRegPoint
函数：SetIconProperty(@"IconTitle", #centerRegPoint, boolean)
说明：控制是否将Flash动画的定位点设置到Flash动画的中心位置，参数boolean的取值为TRUE时，即将Flash动画的定位点始终定在Flash动画的中心位置；参数boolean的取值为FALSE时，即使调整了Flash动画的画面大小，或是更改了Flash动画的#defaultRect属性，定位点都将保持在原位置不变。我们可以通过设置Flash动画的#RegPoint属性来更改定位点的位置，如果用户更改了#RegPoint属性，则#centerRegPoint属性将自动变为FALSE，#centerRegPoint属性的默认值为TRUE。例如：
If GetIconProperty(@"Flash Icon", #centerRegPoint) then
SetIconProperty(@"Flash Icon", #regPoint, Point(0,0))
end if
◆ 方法：#clearError
函数：CallIcon(@"IconTitle", #clearError)
说明：将错误状态重置为0。如果Flash动画在载入内存时发生了错误，则Authorware将Flash动画的#state属性设置为-1，调用该方法可以将#state属性重置为0。例如：
If GetIconProperty(@"Flash Icon", #state)=-1 then
Error:=CallIcon(@"Flash Icon", #getError)
CallIcon(@"Flash Icon", #clearError)
end if
◆ 属性：#defaultRect
函数：SetIconProperty(@"IconTitle", #defaultRect, rect)
说明：设置指定的Flash Xtra图标中显示Flash动画的默认大小，参数rect 为一个矩形范围，比如：Rect(0,0,50,50)。当更改Flash动画的#defaultRect属性后，#defaultRectMode属性的值将自动变为#fixed。例如：
SetIconProperty(@"Flash Icon", #defaultRect, Rect(0, 0, WindowWidth, WindowHeight))
◆ 属性：#defaultRectMode
函数：SetIconProperty(@"IconTitle", #defaultRectMode, rect)
说明：设置Flash动画默认大小的模式，当参数rect取值为#Flash时，即将Flash动画的默认大小设置为Flash动画的原始大小；当参数rect取值#fixed时，即将Flash动画的默认大小设置为属性#defaultRect指定的大小，rect的默认取值为#Flash。例如：
SetIconProperty(@"Flash Icon", #defaultRectMode, #fixed)
◆ 属性：#directToStage
函数：SetIconProperty(@"IconTitle", #directToStage, boolean)
SetSpriteProperty(@"IconTitle", #directToStage, boolean)
说明：设置Flash动画是否以最优显示方式播放，参数boolean的取值为TRUE或FALSE。
◆ 属性：#eventPassMode
函数：SetIconProperty(@"IconTitle", #eventPassMode, value)
SetSpriteProperty(@"IconTitle", #eventPassMode, value)
说明：设置鼠标事件的发送模式，当参数value取值为#passAlways时，则总是向Authorware发送鼠标事件；取值为# passButton时，则只有当Flash动画中的按钮被点击时才发送鼠标事件；取值为#passNotButton时，则只有当按钮以外的对象被点击时才发送鼠标事件；取值为#passNever时，则不发送鼠标事件，value的默认值为#passAlways。
◆ 属性：#fixedRate
函数：SetIconProperty(@"IconTitle", #fixedRate, integer)
SetSpriteProperty(@"IconTitle", #fixedRate, integer)
说明：设置Flash动画的播放速率，默认取值为15，单位为帧／秒，该属性只在#playbackMode属性取值为#fixed时才有效。例如：
SetSpriteProperty(@"Flash Icon", #playbackMode, #fixed)
SetSpriteProperty(@"Flash Icon", #fixedRate, PathPositon@"Slider"
◆ 属性：#FlashRect
函数：result:=GetIconProperty(@"IconTitle", #FlashRect)
说明：获得Flash动画的原始大小，返回值为一矩形范围，比如：Rect(0,0,50,50)。
◆ 属性：#frame
函数：SetSpriteProperty(@"IconTitle", #frame, integer)
说明：设置Flash动画当前显示的帧数，帧数由参数integer确定，只能取整数。例如：
SetSpriteProperty(@"FlashIcon", #frame, GetSpriteProperty(@"FlashIcon", #frameCount)
◆ 属性：#frameCount
函数：integer:=GetIconProperty(@"IconTitle", #frameCount)
说明：返回指定图标中Flash动画的总帧数。
◆ 属性：#frameRate
函数：integer:=GetIconProperty(@"IconTitle", #frameRate)
说明：返回指定图标中Flash动画的原始速率，即在Flash中设定的速率，单位为帧／秒。例如：
If GetIconProperty(@"Flash Icon", #frameRate) < 15 then
SetSpriteProperty(@"Flash Icon", #playbackMode, #fixed)
SetSpriteProperty(@"Flash Icon", #fixedRate, 15)
end if
◆ 方法：#frameReady
函数：boolean:=CallSprite(@"IconTitle", #frameReady, framenumber)
说明：检测变量framenumber指定的某一帧的数据是否已经载入到内存中，即检测该帧是否可以播放，是则返回值为TRUE，否则为FALSE。例如：
If CallSprite(@"Flash Icon", #frameReady, 25) then
FrameReady:=True
else
FrameReady:=False
end if
◆ 方法：#getError
函数：result:=CallIcon(@"IconTitle", #getError)
说明：返回将Flash动画载入内存时发生错误的种类。如果返回值为FALSE，则表示没有错误发生；如果返回值为#memory，则表示载入Flash动画时内存不足；如果返回值为#fileNotFound，则表示未找到需要载入内存的Flash动画文件；如果返回值为#network，则表示网络错误阻止Flash动画的载入；如果返回值为#fileFormat，则表示文件格式错误或读取文件时发生错误；如果返回值为#other，则表示发生了其他错误。例如：
If GetIconProperty(@"Flash Icon", #state)=-1 then
Error:=CallIcon(@"Flash Icon", #getError)
CallIcon(@"Flash Icon", #clearError)
end if
◆ 方法：#getVariable
函数：CallSprite(@"Flash Icon ", #getVariable, variableName)
说明：返回Flash动画中参数variableName指定的变量的值，变量仅限于非空的字符串变量。例如：
result:=CallSprite(@"Flash Icon", #getVariable, "currentURL"
◆ 方法：#goToFrame
函数：CallSprite(@"IconTitle", #goToFrame, framenumber)
说明：跳转到Flash动画的参数framenumber指定的某一帧，与设置#frame属性的效果是一样的。例如：
CallSprite(@"Flash Icon", #goToFrame, ChoiceNumber@"My Interaction"
◆ 方法：#hitTest
函数：result:=CallSprite(@"IconTitle", #hitTest, point)
说明：检测参数point所指定的位置（相对于演示窗口）处在Flash动画的何种区域。如果返回值为#background，则表示point指定的位置处于Flash动画的背景区；如果返回值为#normal，则表示point指定的位置处于Flash动画的某个填充对象之上；如果返回值为#button，则表示point指定的位置处于Flash动画的某个按钮区域之内。例如：
result:=CallSprite(@"Flash Icon", #hitTest, Point(CursorX, CursorY))
◆ 方法：#hold
函数：CallSprite(@"IconTitle", #hold)
说明：暂停播放Flash动画，但是如果Flash动画包含音频的话，声音将会继续播放，图像暂停在当前帧。
◆ 属性：#imageEnabled
函数：SetIconProperty(@"IconTitle", #imageEnabled, boolean)
SetSpriteProperty(@"IconTitle", #imageEnabled, boolean)
说明：设置播放Flash动画时是否显示图像，参数boolean的取值可以是TRUE或FALSE，默认取值为TRUE。例如：
SetSpriteProperty(@"Flash Icon", #imageEnabled, False)
repeat while GetIconProperty(@"Flash Icon", #state) <>4 |<>-1
end repeat
SetSpriteProperty(@"Flash Icon", #imageEnabled, True)
◆ 属性：#linked
函数：SetIconProperty(@"IconTitle", #linked, boolean)
说明：设置Flash动画是否作为链接方式播放，如果参数boolean的值为TRUE，则Flash动画作为外部文件链接到Authorware文件；如果参数boolean的值为FALSE，则Flash动画将存储到Authorware文件内部。
◆ 属性：#loop
函数：SetIconProperty(@"IconTitle", #loop, boolean)
SetSpriteProperty(@"IconTitle", #loop, boolean)
说明：设置Flash动画是否循环播放，参数boolean的取值可以是TRUE或FALSE。例如：
If Checked@"Continuous Play" then
SetSpriteProperty(@"Flash Icon", #loop, True)
else
SetSpriteProperty(@"Flash Icon", #loop, False)
end if
◆ 属性：#mouseOverButton
函数：boolean:=GetSpriteProperty(@"IconTitle", #mouseOverButton)
说明：检测当前鼠标位置是否正处于Flash动画的按钮之上，返回值为TRUE或FALSE。例如：
If GetSpriteProperty(@"Flash Icon", #mouseOverButton) then
Message:= "请点击此处继续！"
else
Message:= ""
end if
◆ 属性：#originH
函数：SetIconProperty(@"IconTitle", #originH, number)
SetSpriteProperty(@"IconTitle", #originH, number)
说明：设置Flash动画缩放或旋转时中心点的水平坐标，该属性只在#originMode属性的值为#point时有效。例如：
SetSpriteProperty(@"Flash Icon", #originMode, #point)
SetSpriteProperty(@"Flash Icon", #originH, ClickX)
SetSpriteProperty(@"Flash Icon", #originV, ClickY)
◆ 属性：#originMode
函数：SetIconProperty(@"IconTitle", #originMode, value)
SetSpriteProperty(@"IconTitle", #originMode, value)
说明：设置Flash动画中心点的模式，参数value取值为#center时，则将中心点设置在Flash动画的中央；参数value取值为#topleft时，则将中心点设置在Flash动画的左上角位置；参数value取值为#point时，则中心点的位置可以由#originPoint，#originH和#originV等属性确定，参数value的默认取值为#center。例如：
SetSpriteProperty(@"Flash Icon", #originMode, #point)
SetSpriteProperty(@"Flash Icon", #originH, 12)
◆ 属性：#originPoint
函数：SetIconProperty(@"IconTitle", #originPoint, point)
SetSpriteProperty(@"IconTitle", #originPoint, point)
说明：设置Flash动画中心点的位置，参数point的取值为一个点，比如：Point(100,200)。当使用该属性设置Flash动画中心点位置时，#originMode属性的值将自动更改为#point。例如：
SetSpriteProperty(@"Flash Icon", #originPoint, Point(ClickX, ClickY))
◆ 属性：#originV
函数：SetIconProperty(@"IconTitle", #originV, number)
SetSpriteProperty(@"IconTitle", #originV, number)
说明：设置Flash动画缩放或旋转时中心点的垂直坐标，该属性只在#originMode属性的值为#point时有效，与#originH属性类似。
◆ 属性：#pathName
函数：SetIconProperty(@"IconTitle", #pathName, filepath)
说明：设置以链接方式播放的Flash动画的路径，路径可以是本地驱动器、网络驱动器或是URL地址，该属性只在#linked属性的值为TRUE时才有效。例如：
SetIconProperty(@"Flash Icon", #pathName, FileLocation^"ya.swf"
◆ 属性：#pausedAtStart
函数：SetIconProperty(@"IconTitle", #pausedAtStart, boolean)
说明：设置Flash动画是否在开始播放时暂停，参数boolean的取值可以是TRUE或FALSE，默认值是FALSE。如果#pausedAtStart属性的值为TRUE，可以调用#play方法开始播放Flash动画。例如：
SetIconProperty(@"Flash Icon", #pausedAtStart, True)
if getscore>=100 then
CallSprite(@"Flash Icon", #play)
end if
◆ 属性：#percentStreamed
函数：integer:=GetIconProperty(@"IconTitle", #percentStreamed)
说明：返回指定标中Flash动画载入到内存时完成的百分比，返回值为0到100之间的整数。
◆ 方法：#play
函数：CallSprite(@"IconTitle", #play)
说明：开始播放指定图标中的Flash动画。如果指定的Flash动画已经停止播放，则从当前帧开始播放；如果Flash动画已经播放到最后一帧，则从第一帧开始播放。例如：
If GetSpriteProperty(@"Flash Icon", #playing) = False then
CallSprite(@"Flash Icon", #play)
end if
◆ 属性：#playBackMode
函数：SetIconProperty(@"IconTitle", #playBackMode, mode)
SetSpriteProperty(@"IconTitle", #playBackMode, mode)
说明：控制Flash动画播放速率的模式。参数mode取值为#normal时，Flash动画将以其原始速率播放，即在Flash里设定的播放速率；参数mode取值为#lockStep，Flash动画将以Flash Xtra属性对话框中设定的速率播放；参数mode取值为#fixed时，Flash动画将以#fixedRate属性指定的速率播放。例如：
SetIconProperty(@"Flash Icon", #playBackMode, #fixed)
SetIconProperty(@"Flash Icon", #fixedRate, 15)
◆ 属性：#playing
函数：boolean:=GetSpriteProperty(@"Flash Icon", #playing)
说明：检测指定图标中的Flash动画是否正在播放，如果正在播放，则返回值为TRUE，否则返回值为FALSE。
◆ 属性：#posterFrame
函数：SetIconProperty(@"IconTitle", #posterFrame, framenumber)
说明：设置将Flash动画第几帧的图像作为Flash Xtra属性对话框中预览区域的图像，参数framenumber取整数值，默认值为1。例如：
SetIconProperty(@"Flash Icon", #posterFrame, GetSpriteProperty(@
"Flash Icon", #frameCount))
◆ 属性：#preload
函数：SetIconProperty(@"IconTitle", #preload, boolean)
说明：设置Flash动画在播放前是否预先全部载入内存，参数boolean的取值可以是TRUE或FALSE，该属性只对最为外部链接方式的Flash动画有效。例如：
SetIconProperty(@"Flash Icon", #preload, False)
SetIconProperty(@"Flash Icon", #bufferSize, 65536)
◆ 属性：#quality
函数：SetIconProperty(@"IconTitle", #quality, value)
SetSpriteProperty(@"IconTitle", #quality, value)
说明：控制Flash动画的播放质量，即控制播放Flash动画时是否启用反图形失真（Anti-aliasing）。参数value取值为#autoHigh时，播放Flash动画时启用 Anti-aliasing，以高质量播放Flash动画，如果Flash动画的实际播放速率低于指定的播放速率，则Authorware将自动关闭Anti-aliasing，以低质量播放Flash动画；参数value取值为#autoLow时，播放Flash动画时将关闭 Anti-aliasing，以低质量播放Flash动画，如果Flash播放器判断当前系统可以使用高质量播放Flash动画，则自动启用Anti-aliasing；参数value取值为#high时，则播放Flash动画时总是启用Anti-aliasing，以高质量播放Flash动画；参数value取值为#low时，则播放Flash动画时总是关闭Anti-aliasing，以低质量播放Flash动画。例如：
If ScreenDepth <= 8 then
SetSpriteProperty(@"Flash Icon", #quality, #low)
end if
◆ 属性：#regPoint
函数：SetIconProperty(@"IconTitle", #regPoint, point)
说明：设置Flash动画定位点的坐标。例如：
SetIconProperty(@"Flash Icon", #regPoint, Point(0,0))
◆ 方法：#rewind
函数：CallSprite(@"IconTitle", #rewind)
说明：将Flash动画倒回到第一帧，不管Flash动画已经停止播放或是正在播放均适用。
◆ 属性：#rotation
函数：SetIconProperty(@"IconTitle", #rotation, degree)
SetSpriteProperty(@"IconTitle", #rotation, degree)
说明：设置Flash动画播放时旋转的角度。例如：
SetIconProperty(@"Flash Icon", #obeyScoreRotation, FALSE)
repeat with i := 1 to 36
SetSpriteProperty(@"Flash Icon", #rotation, i * 10)
end repeat
◆ 属性：#scale
函数：SetIconProperty(@"IconTitle", #scale, percent)
SetSpriteProperty(@"IconTitle", #scale, percent)
说明：设置Flash动画播放时的缩放比率，参数percent的默认值为100。例如：
SetSpriteProperty(@"Flash Icon", #scale, 0)
repeat with i := 1 to 20
SetSpriteProperty(@"Flash Icon", #scale, i * 5)
end repeat
◆ 方法：#setVariable
函数：CallSprite(@"Flash Icon", #setVariable, variableName, value)
说明：设置Flash动画中某个变量的值，该值必须是字符串值。例如：
CallSprite(@"Flash Icon", #setVariable, "currentURL",
"http://www.macromedia.com"
◆ 属性：#sound
函数：SetIconProperty(@"IconTitle", #sound, boolean)
SetSpriteProperty(@"IconTitle", #sound, boolean)
说明：设置播放Flash动画时是否播放动画中的音频部分，参数boolean的取值可以是TRUE或FALSE。例如：
If GetSpriteProperty(@"Flash Icon", #sound) then
SetSpriteProperty(@"Flash Icon", #sound, False)
else
SetSpriteProperty(@"Flash Icon", #sound, True)
end if
◆ 属性：#state
函数：result:=GetIconProperty(@"IconTitle", #state)
说明：返回Flash动画载入内存时的状态，属性#state的返回值与其含义的对应关系如下：
0：图标数据未载入内存
1：标题正在载入内存
2：标题载入完毕
3：图标媒体数据正在载入内存
4：图标媒体数据载入完毕
-1：有错误发生
◆ 方法：#stop
函数：CallSprite(@"IconTitle", #stop)
说明：停止播放Flash动画。例如：
If GetSpriteProperty(@"Flash Icon", #playing) then
CallSprite(@"Flash Icon", #stop)
end if
◆ 属性：#stream
函数：bytesStreamed:=CallIcon(@"IconTitle", #stream, numberOfBytes)
说明：手工确定Flash动画一次载入内存的字节数，由于各方面的影响，实际载入内存的数据量有可能小于参数numberOfBytes设定的数量。例如：
CallIcon(@"Flash Icon", #stream, 32000)
◆ 属性：#streamSize
函数：bytesInStream:=GetIconProperty(@"IconTitle", #streamSize)
说明：返回指定图标中Flash动画载入内存的字节数，返回值为整数。
◆ 属性：#URL
函数：SetIconProperty(@"IconTitle", #URL, filePath)
说明：#URL属性与#pathname属性的作用是一样的，请读者参见#pathname属性的用法。
真正的光明绝不是永没有黑暗的时间，只是永不被黑暗所湮没罢了；真正的英雄绝不是永没有卑下的情操，只是永不被卑下的情操所屈服罢了。
