Import(handle, file_path, file_name)

説明

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

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

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

引数

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

戻り値

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

例

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

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

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

return main

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

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

return main