delphi-MediaPlayer组件常用属性方法

MediaPlayer组件常用属性

MediaPlayer组件位于组件板的System页中，其功能比Animate组件强大，不仅可以播放AVI文件，还可以通过MCI(Media Control Interface，媒体控制接口)播放多种多媒体文件，如各种AVI文件、WAV、MIDI、CD音乐文件和DAT文件等。

MediaPlayer组件具有一组执行MCI命令的下压式按钮。这些命令与通常的cD机、录像机上的按钮很相似。

从左到右，这些按钮的功能依次是Play(播放)、Pause(暂停)、Stop(停止)、Next(下一个)、Prev(上一个)、Step(向前步进)、Back(向后步进)、Record(开始录制)和Eject(退出)。

(1)AutoEnable属性

当属性值为True时，媒体播放器在运行过程中能够自动控制哪些按钮当前可用，哪些按钮当前不可用(以灰色显示)。判断的依据是Mode特性返回的设备状态以及I)eviceType特性设置的设备类型。如果没有打开文件，所有按钮都无效。

当属性值为False时，媒体播放器不能自动控制哪些按钮是当前可用的，哪些按钮是当前不能用的。每个按钮是否允许或禁止操作需要设置EnableButtons属性。

(2)AutoRewind属性

该属性用于设置是否具有自动返回功能。若属性值设为True，则当需要播放或录制时将自动返回到媒体文件头部；当多媒体文件播放完毕后，也会自动返回到媒体文件头部。

如果该属性设为False，只有当用户按下Prey或在程序中调用了Previous方法后才能返回到媒体文件头部。

(3)ColoredButton属性

该属性是TButtonSet集合类型，用于设置哪些按钮用彩色显示，哪些按钮用黑白显示，缺省时全部按钮均用彩色显示。

(4)DeviceType属性

该属性是TMPDeviceType类型，用于指定设备类型。该属性的缺省值是dtAutoSelect，此时根据FileName属性指定的媒体文件的扩展名来判断设备类型，每种扩展名对应着一种设备类型。设为其他值时，将指定某种特定的设备类型。

(5)display属性．

该属性是win(~ontrol类型，用于指定一个窗体作为媒体文件的输出界面。缺省值是Nil，表示媒体播放器开设一个窗体显示输出。

(6)EnabledButtons属性

该属性是TButtonSet集合类型，用于设置哪些按钮当前可用，哪些按钮当前不可用。不可用的按钮以灰色显示。如果AutoEnable特性设为True，则这个特性无效。

(7)FilleName属性

该属性是string类型，用于指定要播放的媒体文件名。

(8)Frames属性

该属性是Longini类型，用于设置快进或返回时的步进幅度，即每次移动占整个媒体文件长度的百分比。这个特性的缺省值10，表示每次移动整个媒体文件长度的10％。

(9)Mode属性

该属性是只读的TMPModes类型，返回媒体设备的当前状态。通常应该在MediaPlayer对象的OnNotify事件处理中检查该属性值。Mode可以是表中的常数值之一。

Value Mode

mpNotReady Not ready

mpStopped Stopped

mpPlaying Playing

mpRecording Recording

mpSeeking Seeking

mpPaused Paused

mpOpen Open

MediaPlayer组件的常用方法

(1)AutoButtonSet方法

该方法能够指定媒体播放器的按钮可用或不可用。当AutoEnable特性设置为’True时，该过程可根据媒体设备的状态自动体播放器的按钮处于可用或不可用状态。

(2)Play方法

该方法用于播放已打开的媒体文件。如果设置了StartPos属性，则该方法从Start．Pos指定的位置开始播放；否则从Position特性指定的当前位置开始播放。同样，如果设置了：EndPos特性，那么该过程播放到，EndPos指定的位置结束；否则一直播放到媒体结束。如果设置AutoRewind特性为True，那么调用该过程时，无论当前位置在何处，都将从头开始播放。

(3)Open方法

该方法用于打开多媒体设备。在调用该过程打开多媒体设备之前，须在DeviceType特性中指定设备类型。

(4)Save方法

该方法用于把当前已加载的媒体存储到FileName特性指定的文件中。

(5)Close方法

该方法用于关闭已打开的多媒体播放设备。应用程序中止时，自动调用该过程。

(6)Pause方法

该方法用于暂停多媒体设备的播放或录制。如果在设备暂停状态调用该过程，则设备将调用Resume方法恢复播放或录制。在程序运行中按下媒体播放器的：Pause按钮，将调用该过程，中国自学编程网整理发布，www.zxbc.cn。

(7)：Next方法

该方法用于将媒体播放器移动到下一个轨道的开始位置。如果调用该方法时，媒体的当前位置是最后一个轨道，那么媒体播放器将定位于当前位置。如果多媒体设备不使用轨道，该方法将定位于媒体的最后位置。在程序运行中按下媒体播放器的Next按钮，将调用该过程。

(8)Preyious方法

该方法使媒体播放器回退。如果当前位置是一个轨道的开始位置，那么调用该方法可使媒体回退到上一个轨道的开始位置；如果当前位置不是一个轨道的开始位置，那么回退到当前轨道的开始位置；如果媒体设备不使用轨道，那么回退到Start特性指定的开始位置。

(9)Step方法

该方法在媒体中向前(播放方向)移动数个。Frames。在程序运行中按下媒体播放器的Step按钮，将调用该过程。

(10)Back方法

该方法使媒体播放器回退数个Frames。在程序运行中按下媒体播放器的Back按钮，将调用该方法。

(11)StartRecording方法

该方法从当前位置或StartPos特性指定的位置开始录制。在程序运行中按下媒体播放器的Record按钮，将调用该方法。

(12)Eject方法

该方法用于打开多媒体设备仓门，删除已安装的媒体文件。在程序运行中按下媒体播放器的Eject按钮，将调用该方法。

(13)Resume方法

该方法使用目前处于暂停状态的媒体设备恢复播放或录制。在程序运行中，当媒体设备处于暂停状态时，按下媒体播放器的Resume按钮，将调用该过程。

(14)Rewind方法

该方法用于移动当前位置到Start特性指定的媒体开始位置。

(15)Stop方法

该方法中止媒体播放或录制。在程序运行中按下媒体播放器的Stop按钮，将调用该方法。

(1)OnNotify事件

如果Notify特性设置为True，当一个媒体控制方法(如Back、Close、Eject、Next、Open、Pause、PauseOnly、Play、Previous、Resume、StartRecording、Step或Stop等)执行结束时，触发该事件。一个OnNotify事件触发后，必须重新设置Notify特性为True，以便触发下一个OnNotify事件。

(2)0nPostClick事件

当OnClick事件处理程序被调用以后，触发该事件。如果wait属性设置为true当媒体播放器控制按钮被点击时，只有在0nclick事件处理程序执行结束后，才能调用该事件处理程序；如果wait设置为False，应用程序可以在()nClick事件处理程序执行结束前，取得控制权。

Postion属性