GetExecutor(integer)

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

説明

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

引数

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

戻り値

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

例

This example stores the handles for executor number 201. It then uses the Dump() function to show the data for the two handles.

Dump()

The Dump() function returns a string with information about the object, for instance, the name, class, path of the object, its properties, and children.

Learn more in the Dump() topic.

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