GetExecutor(integer)

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

説明

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 | 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