MMB常用脚本关键字文档格式.docx
《MMB常用脚本关键字文档格式.docx》由会员分享，可在线阅读，更多相关《MMB常用脚本关键字文档格式.docx（18页珍藏版）》请在冰点文库上搜索。
MILLISEC"
等待指定的时间后结束工程
MILLISEC
毫秒数
注：
PageTime（）命令将使该命令失效。
FileExist（"
PATHTOFILE"
检测外部文件是否存在
PATHTOFILE
指定路径和文件名；
VARIABLE
返回值，为"
1"
表示存在；
为"
0"
则不存在
检测当前目录是否包含Readme.txt，如果文件存在，变量test_a返回值为"
<
ScrDir>
\Readme.txt"
test_a"
FirstPage（）
跳转到工程第一页
FileString（"
substring"
variable"
从打开的文件中查找匹配的字符串
substring
查找字符串；
variable
返回值。
如果存在返回"
，不存在返回"
弹出打开文件对话框，如果选择的打开文件包含.wav字符则该文件
OpenFile（"
AllFiles|*.*||"
*.*"
.wav"
result"
if（result=1）then
WavePlay（"
File>
"
end
Hide（"
OBJECT"
隐藏对象或组中的对象
MMB4.4及以后版本可以在命令中指定对象的所在页（包括主层和主页），格式为Hide（"
Page:
:
Object"
）。
Page1:
Text01"
MasterPage:
Bitmap01"
MasterLayer:
Invere（"
翻转对象或组中对象的显示/隐藏状态
LastPage（）
跳转到工程最后一页
LoadText（"
从一个字符串变量或文本文件读取文本内容并赋值给段落文本、文本或文字按钮对象
TEXTOBJECT
文本对象
VARIABLE
变量
更多的LoadText命令格式
TextObject"
variable$"
path"
List>
Number"
LoadVariable（“KeyName”,”Valume"
从Windows注册表读取已经保存的变量值
KeyName
保存到注册表中的键名，可以与变量名不同；
Valume
已经保存的变量名
该命令将从注册表的以下位置读取变量：
Valume=KeyName
HKEY_CURRENT_USER\Software\MMBuilder\MultimediaBuilder\MyApp
Message（"
ANYSTRING"
弹出一个警告窗口
ANYSTRING
警告文本；
变量值
Minimize（）
最小化当前工程
NextPage（）
跳转到工程下一页
filter"
"
default"
调用Windows打开文件对话框
Filter
文件类型过滤器，格式如MPEGFiles（*.mpg）|*.mpg|AllFiles|*.*||，过滤器的最后要求使用“||”作为结束符；
Default
默认的打开文件类型
被选择的打开文件名保存在系统变量OpenFile$中，文件内容存放在系统变量File中
从打开文件对话框打开一个文本文件并赋值给Paragraph文本对象
TextFiles（*.txt）|*.txt|AllFiles|*.*||"
*.txt"
Thefileyouselectedis"
OpenFile$"
Paragraph"
Page（"
PAGELABEL"
跳转到工程指定页
PAGELABEL
页标签名
PageTimer（"
PAGE"
等待指定的时间后跳转到指定页
PageTime（"
MILLIEC"
THIS_PAGE"
）将在指定时间后重新执行当前页；
其它参见Page（）
在等待时间鼠标点击任何交互对象都将取消该命令；
也可以指定一个脚本名在指定的时间后运行
PrevPage（）
跳转到工程上一页
Return（）
从当前执行的脚本返回
RunMBD（"
PATHTOMBD"
运行一个外部MBD文件。
PATHTOMBD
MBD文件路径和文件名；
PAGELABEL
指定运行MBD文件的起始页
在指定MBD文件路径时不允许使用系统变量形式的路径<
RunScript（"
运行指定对象所包含的脚本
SaveVariable（“KeyName”,”Valume"
将变量值保存到Windows注册表
保存变量名
该命令将向注册表的以下位置写入：
KeyName=Valume
ScriptTimer（"
MILISEC"
在指定的时间后运行指定对象包含的脚本
MILISEC
SendComand（"
Binder"
m,n"
向捆绑应用程序对象（BindingObject）的菜单传递执行命令
Binder
捆绑对象；
m第几项菜单（左起第一项为“0”）；
n
菜单第几项命令（上起第一项为“0”，包括菜单分割线）
向捆绑了记事本的对象Bin_01传递"
文件"
>
"
打印"
命令
SendCommand（"
Bin_01"
0,6"
Show（"
显示对象或组中的对象
对于gif动画将从第一帧开始显示。
VideoPlay（"
VIDEOOBJECT"
VideoStop（"
播放或停止视频（AVI）对象
CDBW（）
CD快退
CDFW（）
CD快进
CDPause（）
暂停播放音乐CD
CDPlay（）
播放音乐CD
CDPlayPause（）
切换CD的播放／暂停状态
CDStop（）
停止播放音乐CD
CDTrack（"
NUMBEROFTRACK"
指定并播放音乐CD某一音轨
NUMBEROFTRACK
CD音轨
对于制作的混合模式CD，第一音轨的序号可能是"
2"
MidiPlay（"
PATHTOMIDI"
[LOOP]"
播放外部MIDI文件
MidiStop（）
停止播放MIDI文件
MODOpen（"
PATHTOMOD"
打开并播放Mod文件
MODPlay（）
播放打开的Mod文件
MODStop（）
停止播放Mod文件
MP3Open（"
PATHTOMP3"
打开并播放MP3声音文件。
PATHTOMP3
MP3声音文件的路径和文件名。
在MMB中只能播放外部MP3声音文件；
如果命令使用空字符串作为参数:
Mp3Open（"
），命令会自动弹出打开文件对话框。
Mp3Pause（）
暂停当前播放的MP3声音。
使用Mp3Play（）从当前暂停位置继续播放
Mp3Play（）
播放当前打开的MP3声音文件
Mp3Stop（）
停止当前播放的MP3声音
PlaySound（"
播放所有支持的声音文件格式。
可以使用PlaySound（"
）在打开文件对话框中选择播放的文件
VolumeDown（"
volume"
向下调整计算机主音量5%
volume
如果指定具体值，则调整到给定值（0100）
VolumeUp（"
向上调整计算机主音量5%
（同VolumeDown）
PATHTOWAVE"
command"
功能:
播放外部或置入的WAV声音文件。
PATHTOWAVE
外部WAV文件及其路径，对于置入的WAV文件不是用路径，但要直接使用WAV声音文件名（不是MCI对象名）并必须包括扩展名;
command
可以使用"
LOOP"
来强制声音的循环播放，直至使用WaveStop（）命令停止。
若不使用"
参数，必须用一空字符串代替，并必须包含在命令之中。
WaveStop（）
停止WAV声音的播放
MoveObject（"
x,y,w,h"
移动对象（或组）
Object
操作对象；
x,y
对象坐标；
w,h
对象宽高
MoveTo（"
x,y,steps,type"
移动对象（或组）从当前位置到目标点；
说明：
目标点；
steps
移动所需的步数（越多则运动越平滑）；
type
动作类型：
（无）表示线性移动类型；
EASYTO表示减速运行；
EASYFROM表示加速运行
Pause（"
ms"
暂停脚本执行
ms
暂停时间（秒）
Refresh（）
强制刷新屏幕（无参数）
媒体控制命令
通用格式：
MCICommand（"
MCISTRING"
在"
MICSTRING"
中允许使用<
SrcDir>
<
SrcDrive>
CD>
来指定相对路径
InitTTS（）
初始化系统TTS引擎
要求Windows系统必须已经安装TTS系统。
执行这个命令需要几秒钟的时间，并会在屏幕显示一个很小的检查信息框。
InstallTTS（"
PATH"
从指定的位置安装TTS系统
该命令会首先检测Windows系统是否已经安装TTS引擎，如果已经安装则会自动跳过。
MultimediaBuilder\TTS目录下的text2speech.txt文件中列举了许多可以免费下载TTS安装程序的网址（TTS引擎是微软的一个免费软件）
PitchTTS（"
Frequency"
改变TTS引擎朗读频率
范围在50
200之间，默认为100
PauseTTS（）
暂停当前的TTS朗读
ResumeTTS（）
继续暂停的TTS朗读
SpeakText（"
阅读文本对象的文本内容
朗读页面文本对象text02中的文字内容
text02"
SpeedTTS（"
Speed"
改变TTS引擎的朗读速度
范围在30
450，默认为150
StopTTS（）
停止当前的TTS朗读
CBK_CurItemList
显示当前播放的MP3在播放列表中的位置
CBK_Exit
被Exit（）命令激活并显示
Samples目录的close.mdb
CBK_MP3Bit
显示MP3文件的采样率
显示格式为XXKbips
CBK_MP3EOF
MP3特殊脚本对象
如果一个脚本在当前页、主页或主层切它的标签为CBK_MP3EOF，当一段MP3播放到末端时该脚本会被自动运行。
CBK_MP3Freq
显示当前MP3文件采样频率
显示格式为：
XXXXXHz
CBK_MP3Name
显示当前MP3音乐名
CBK_NumInList
显示当前播放列表中的项目总数
CBK_MP3Type
文本对象。
显示文件类型
对于MP3文件显示：
MPEG1AudioLayer3
CBK_Time
显示当前MP3文件播放经过的时间
CBK_Total
显示MP3文件的音乐总长度。
显示格式为XX:
XX
播放列表中的下一曲
MP3ListLoad（"
从外部文件装入一个MP3列表
MP3ListPlay（"
按内部列表顺序播放MP3文件
MP3ListPrev（）
播放列表中的上一曲
MP3ListReset（）
从内部MP3列表中删除所有项目
MP3ListRND（）
随机排列当前的内部列表
SearchForMP3（"
在指定的路径搜索MP3文件并全部添加到播放列表
MatrixSet（"
matrixobject[column,row]"
imageindex（0...3）"
定义矩阵图像某一行列坐标的图像索引值
matrixobject–矩阵图像标签名；
colume,row--行列坐标；
imageindex–图像索引值（0-3）
图像索引值为0表示不显示图像；
行或列坐标值为0表示操作整个行或列；
行列值均为0表示操作整个矩阵图像
MatrixGet（"
将一个变量放置到图像矩阵的某一行列坐标，变量值会对应该坐标的图像索引值变化而变化。
MP3播放器自己做
李军
看过前面介绍的MP3制作方法，有没有想过再自己动手制作一个MP3播放器呢？
别以为MP3播放器只有那些高手通过编程的手段才能实现，实际上，无需编程也能制作出相当专业的MP3播放器来。
秘密就在于——MultimediaBuilderV4.8。
它的下载地址是MultimediaBuilder.htm，下载文件大小为5722KB。
我们来看看如何用它制作一个漂亮的MP3播放器。
启动MultimediaBuilderV4.8，程序会自动建立一个新项目，执行“Project/GeneralSetting”命令，打开项目设置窗口（如图1），设置Window对话框的宽度为300、高度为100（单位为像素，即生成后的MP3播放器界面尺寸）。
在“Window”后面的文本框中输入文本，如“我的MP3播放器！
”作为播放器的页面名称，然后将“StandardWindow”前的复选框清除，再选择“Movable”选项，使界面窗口可以移动。
接下来在“Palette”选项中选择“GraphicMMB”，单击“OK”返回到主界面。
图1
执行“Page/Properties”命令，打开页面参数设置窗口（如图2），在Color后面的选项卡中设置页面背景颜色，完成后单击“OK”按钮返回主界面。
图2
在工具箱中选取“FillRetangle”工具，并在播放器中画出一个矩形区域，然后双击此区域，在打开的对话框中设置Fill（填充色），Border（边框色），同时在后面的列表框中选择线型为SunKen，然后按“OK”按钮返回，一个有立体感的显示窗口制作完成。
点击工具栏的插入工具按钮，在打开的下拉菜单中选择“InsertMP3Control”命令，这样就可以在页面中插入一组播放器控制按钮了，同时还会自动添加一个“总时间显示”和“播放时间显示”文本提示标签，用鼠标可将该标签移动到合适的位置。
现在为播放器添加MP3歌曲的提示信息，选取工具栏的文本工具（Text），然后在显示器上画出一个矩形区域，双击此文本区域打开“TextProperties”文本属性窗口（如图3），在文本区域输入“名称:
”，然后单击“Font”按钮，在打开的字体对话框中设定字体，如“宋体、9号字”。
图3
然后在刚才插入的文本后，新插入一个文本标签，在“TextProperties”文本属性窗口中，清除文本区文字，再点击“Label”右侧的箭头，在弹出的菜单中选择“CBK_MP3Name”，并按“OK”按钮返回。
同样道理，还可以添加更多的文本标签，并设置更多的提示显示信息。
“Label”选项中几个常用标签选项的含义为：
CBK_Totals：
歌曲的总时长
CBK_Time：
当前播放的时间
CBK_MP3Type：
歌曲的类型
CBK_MP3Bit：
位速率
CBK_MP3Freq：
采样率
CBK_Channels：
控制类型
完成提示信息设置后，开始制作音量控制按钮。
首先在工具栏选择“TextButton”工具，然后在界面上添加一个命令按钮，双击此按钮，在打开的对话框中设置显示文字为“增加音量”，然后单击“Action”栏中的“MoreActions”按钮，在打开的对话框中单击“StartClicking（MouseDown）”中的“Wizard”按钮，然后在弹出的“ScripWizard”窗口中设定“Action”值为“VolumeUP（）”。
按“OK”按钮返回后，用同样的方法制作一个“降低音量”的按钮，设定“Action”的值为“VolumeDown（）”。
我们现在为播放器加入支持MP3文件播放列表功能。
添加一个按钮，然后设定此按钮文字为“播放列表”，并在“MoreActions”的对话窗口中设定“TheClickisFinished”的“Actions”值为“MP3ListEdit（）”和“MP3ListPlay（"
）”。
完成按钮的设计后，下面来为播放器设计最大化和最小化按钮。
在工具箱中选择矩形工具，并在窗口右上方画出一个矩形区域，并双击此矩形区域，在打开的对话框中选择“EnableAction”选项，单击“ExternalCommandsandPageActions”按钮，在打开的对话框中（如图4），设置“OnMouse”事件为“Minimize”。
同样我们还可以添加一个关闭按钮，并设置其“OnMouse”事件为“Exit”。
图4
你也可以把自己的主页地址放在播放器的标题栏中，在标题栏添加一段文本，然后双击此文本，在打开的对话框的文本输入区域中输入文字主页的名称，然后选择“EnableAction”选项，单击“ExternalCommandsandPageActions”，设置“OnMouse”事件为“Browweb”，在“Path”中输入相对应的网址即可（如图5）。
图5
现在，我们完成了一个MP3播放器的制作，最后执行“File/Compile”命令，将我们的工作编译成为一个EXE文件，直接执行此可执行文件就可以使用我们亲手制作的MP3播放器了（如图6）。
图6
插件
插件是用MMB的SDK（软件开发工具包）开发的Windows的动态链接库。
插件扩展了MMB的功能。
插件和其它的对象能表现得一样。
这是针对开发者的部分。
插件是用VC++和MMBSDK编译的。
如果你是一些MMB插件的用户，请参阅插件的文档。
注意：
MMB插件是为MMB设计的动态链接库。
其它像Photoshop的插件无法应用！
载入插件：
菜单“对象”－插件－在工作区拖拽一个插件矩形框。
矩形框说明：
插件（空的），双击它，从属性窗口你可以载入DLL。
DLL可以是外部的或嵌入的。
如果插件的DLL保留在外部的与autorun.exe相同的目录里或插件的子目录里，你没有必要写。
载入DLL后，MMB会问你是否要使用嵌入的插件。
如果选择“是”，插件会变成嵌入式的。
插件有自己的属性。
如果是这种情况－插件的属性会被打开。
同样一些插件要求一
升级会员 