GetDisplayByIndex(integer)

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

Version 2.2

説明

GetDisplayByIndex 関数は、指定されたインデックス番号に一致するディスプレイ・オブジェクトへのハンドルを返します。

引数

integer:
This function needs an index number for one of the displays.

戻り値

handle:
The returned handle to the display object.

例

This example prints the data connected to the handle. It uses the Dump() function:

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()
    -- Get the index number for "Display 1"
    local displayIndex = GetDisplayCollect()["Display 1"].INDEX
    -- return error text in case the index number is nil
    if displayIndex == nil then
        ErrPrintf('Something went wrong. It appears that there is no "display 1"')
        return
    end
    -- Dump all information about the display with the index number
    Printf("=============== START OF DUMP ===============")
    GetDisplayByIndex(displayIndex):Dump()
    Printf("================ END OF DUMP ================")
end

	ヒント
	The example uses the GetDisplayCollect() function to get the index number. The displays are children of the Display Collect, and this function can be used to access the same information using: GetDisplayCollect() The GetDisplayCollect Lua function returns a handle to the DisplayCollect object. Learn more in the GetDisplayCollect() topic. GetDisplayCollect()["Display 1"]