Microsoft DirectX 8.0 (Visual Basic)

DirectMusicComposer8.ComposeSegmentFromTemplate

スタイル、コード マップ、およびテンプレートからオリジナルのセクション セグメントを作成する。

object.ComposeSegmentFromTemplate( _ 
    style As DirectMusicStyle8, _
    templateSeg As DirectMusicSegment8, _
    activity As Integer, _
    chordmap As DirectMusicChordMap8 _
) As DirectMusicSegment8

指定項目

object
DirectMusicComposer8 オブジェクトを指定する。
style
セクション セグメントの作成に使用する DirectMusicStyle8 オブジェクト。
templateSeg
セクション セグメントの作成に使用するテンプレートを表す DirectMusicSegment8 オブジェクト。
activity
和音進行のレート。有効な値は 0 〜 3。値が低いと、コード チェンジが増える。
chordmap
セクション セグメントの作成に使用するコード マップを表す DirectMusicChordMap8 オブジェクト。

戻り値

DirectMusicSegment8 オブジェクトを返す。

エラー コード

失敗した場合はエラーが発生し、Err.Number に次のいずれかの値が設定される。

DMUS_E_INVALIDARG

注意

style が NULL ではない場合、このスタイルはセグメントのアレンジに使用される。NULL の場合、templateSeg で指定されたテンプレートから取得したスタイルをセグメントのアレンジに使用する。同様に、chordmap が NULL ではない場合、このコード マップはセグメントのアレンジに使用される。NULL の場合、テンプレートから取得したコード マップをセグメントのアレンジに使用する。

style が NULL でテンプレート内にスタイル トラックが存在しない場合や、chordmap が NULL でコード マップ トラックが存在しない場合、このメソッドは DMUS_E_INVALIDARG を返す。

セクション セグメントの長さは、渡されたテンプレート セクションの長さと等しくなる。

参照

DirectMusicComposer8.ComposeSegmentFromShapeDirectMusicComposer8.ComposeTemplateFromShape