Import(handle, file_path, file_name)

grandMA3 ユーザマニュアル » プラグイン » Lua 関数 - Object API » Import(handle, file_path, file_name)

Version 2.0

説明

XML形式で記述されたオブジェクトをインポートするには、オブジェクト関数の Import を使用します。

	制限
	インポートするには、そのファイルがすでに存在している必要があります。

	重要
	Import は、確認ポップアップなしで、XMLファイルの内容をオブジェクトにマージします。

引数

handle:
light_userdata 型のハンドルです。オブジェクトでコロン記法を用いる場合は省略できます(後述の例を参照)。
file_path:
ファイルの保存場所を表すパス文字列です。
file_name:
目的のファイル名を表す文字列です。

戻り値

この関数は何も返しません。オブジェクトをインポートします。

例

以下の2つの例は、どちらもXMLファイルの内容を選択されているシーケンスにインポートします。ファイル名は "MySelectedSequence" で、"../gma3_library/datapools/sequences" にあります。

コロン記法による例です。

Copy Code

Lua

return function()
    --SelectedSequence() creates a handle to the selected sequence.
    local selectedSequence = SelectedSequence()
    --The path is stored in a variable.
    local path = GetPath(Enums.PathType.UserSequences)
    --The actual import function.
    selectedSequence:Import(path, "mySelectedSequence.xml")
    --Print some feedback.
    Printf("The sequence is imported from: " .. path)
end

引数にハンドルを指定しても同じ結果になります。

Copy Code

Lua

return function()
    --SelectedSequence() creates a handle to the selected sequence.
    local selectedSequence = SelectedSequence()
    --The path is stored in a variable.
    local path = GetPath(Enums.PathType.UserSequences)
    --The actual import function.
    selectedSequence.Import(selectedSequence, path, "mySelectedSequence.xml")
    --Print some feedback.
    Printf("The sequence is imported from: " .. path)
end