Platform SDK: DirectX |
DirectMusicComposer.ComposeSegmentFromTemplate メソッドは、スタイル、コード マップ、およびテンプレートからオリジナルのセクション セグメントを作成する。
object.ComposeSegmentFromTemplate( _ style As DirectMusicStyle, _ templateSeg As DirectMusicSegment, _ activity As Integer, _ chordmap As DirectMusicChordMap) As DirectMusicSegment
成功すれば DirectMusicSegment オブジェクトを返す。
失敗すればエラーが発生し、Err.Number に次の値が設定される。
DMUS_E_INVALIDARG |
style が NULL ではない場合、このスタイルはセグメントのアレンジに使用される。NULL の場合、templateSeg で指定されたテンプレートから取り出したスタイルをセグメントのアレンジに使用する。同様に、chordmap が NULL ではない場合、このコード マップはセグメントのアレンジに使用される。NULL の場合、テンプレートから取り出したコード マップをセグメントのアレンジに使用する。
style が NULL でテンプレート内にスタイル トラックが存在しない場合や、chordmap が NULL でコード マップ トラックが存在しない場合、このメソッドは DMUS_E_INVALIDARG を返す。
セクション セグメントの長さは、渡されたテンプレート セクションの長さと等しくなる。
DirectMusicComposer.ComposeSegmentFromShape、DirectMusicComposer.ComposeTemplateFromShape