SNDOPEN

7.8.5, PLBCMP GUI Only

The SNDOPEN instruction opens a sound file. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

sndfile

Required. A previously defined SNDFILE opened.

name

Required. A previously defined Character String Variable or string Literal specifying the name of the sound file to open.

MCI

Optional. A keyword that indicates that the Windows Media Control Interface functions are used when playing sound files.

Flags Affected: NONE

Note the following:

1. If {sndfile} is currently open, it is closed before the open operation takes place.

2. {name} contains the name of the file to open. If {name} is a Null String, the standard open file dialog is displayed to allow the user to select a file.

3. If a FILEPI is active and {name} is null causing the activation of the file dialog, the FILEPI is terminated.

4. The MCI option causes use of the Windows Media Control Interface functions when playing sound files.

5. If {name} begins with an at sign (@), the file name species a form resource name.

6. When running under the PL/B Application Server, the first character of the file name has special meaning:

 

First Character	The file ...
! (exclamation mark)	resides on the client rather than the server.
? (question mark)	should be obtained from the cache or from the server and placed in the cache.
* (asterisk)	should be obtained from the in-memory cache or from the server and placed only in the in-memory cache.

 

7. This instruction is not supported by the PLB Web Server.

See Also: Example Code, SNDCLOSE, Interactive I/O Instructions