CdReader.CreateSoundClips メソッド

引数で指定されたトラックを読み込みます。

書式
obj_var.CreateSoundClips ( [tno1 [,tno2 [, ...]]] )

引数
obj_var
CdReader オブジェクト。

tno1, tno2, ... (int)
読み込むトラックの番号。トラックの指定が一つもない場合は、全トラックを読み込みます。

戻り値
SAFEARRAY
SoundClip オブジェクトの配列。JScript では VBArray。

備考
トラックごとに一時ファイルを作成し、それぞれの一時ファイルについて SoundClip オブジェクトを作成します。戻り値は SoundClip オブジェクトの配列 (SAFEARRAY) になり、配列内での SoundClip オブジェクトの順番は、メソッドの引数 (トラック番号) と同順になります。

引数でトラックが一つも指定されない場合は、全てのトラックを読み込み、戻り値配列上での SoundClip オブジェクトの順番はトラック番号順 (1, 2, 3, ..., 99) になります。

引数でトラックが指定されている場合は、与えられた順番でトラックを読み込みますが、存在しないトラック番号にぶつかった場合は、そこで作業を終了し、既に読み込んだトラックのみを戻り値として返します (エラーになりません)。

例 (JScript)
var reader = Application.CreateCdReader();
// 全トラック読み込み
var clips = reader.CreateSoundClips();
clips = clips.toArray();
// 波形グラフを与える.
var i;
for (i in clips)
    Application.Documents.AddSoundClip(clips[i]);

例 (VBScript)
Dim reader, clips, c
Set reader = Application.CreateCdReader
' 全トラック読み込み
clips = reader.CreateSoundClips
' 波形グラフを与える.
For Each c In clips
    Application.Documents.AddSoundClip(c)
Next