CreateUndo(string)

grandMA3 ユーザマニュアル » プラグイン » Lua 関数 - Object-Free API » CreateUndo(string)

Version 2.0

説明

CreateUndo 関数は、同じ Oops アクションにグループ化されたコマンドや機能呼び出しのリストへのハンドルを返します。

アンドゥ・ハンドルへの参照を付けて機能を実行すると、それがアンドゥ・リストに追加されます。

作成したアンドゥ・リストは、CloseUndo 関数によって閉じる必要があります。

引数

string:
アンドゥ・リストを識別するためのテキスト文字列です。

戻り値

handle:
アンドゥ・リストへのハンドルを返します。

例

アンドゥ・リストを作成し、リストに追加される一連のコマンドを実行してからリストを閉じます。これによって、一連のコマンドを Oops コマンド1つで取り消せるようになります。

Copy Code

Lua

return function()
    -- Create the undo group.
    local MyNewUndo = CreateUndo("MySelection")
    -- Make some command line actions linked to the undo.
    Cmd("ClearAll", MyNewUndo)
    Cmd("Fixture 1", MyNewUndo)
    Cmd("Fixture 2", MyNewUndo)
    Cmd("Fixture 5", MyNewUndo)
    Cmd("Fixture 7", MyNewUndo)
    -- Closing the undo group and store it's return in a variable.
    local closeSuccess = CloseUndo(MyNewUndo)
    -- Print the feedback from the closing action - 1 = Success / 0 = Failure.
    if (closeSuccess == 1) then
        Printf("The undo was closed successfully")
    else
        Printf("The undo was not closed correctly")
    end
end