GetExecutor(integer)

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

Version 2.2

説明

GetExecutor 関数は、エクゼキュータ番号に基づいて、エクゼキュータとページのハンドルを返します。

引数

integer:
エクゼキュータ番号です。

戻り値

handle - Executor:
エクゼキュータへのハンドルです。
handle - Page:
ページへのハンドルです。

例

エクゼキュータ201に関する2つのハンドルを保存してから、それらを Dump() 関数で出力します。

Copy Code

Lua

return function ()
    -- This saves the handles for executor 201 on the selected page.
    local executorHandle, pageHandle = GetExecutor(201)
    -- exit the function and print an error message if any of the handles are nil.
    if executorHandle == nil or pageHandle == nil then
        ErrPrintf("There is not a valid object on executor 201, please assign something and try again.")
        return
    end
    -- The following prints the dumps of the two handles.
    Printf("============ START OF EXEC DUMP =============")
    executorHandle:Dump()
    Printf("================ END OF DUMP ================")
    Printf("============ START OF PAGE DUMP =============")
    pageHandle:Dump()
    Printf("================ END OF DUMP ================")
end