GetTopOverlay()

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

Version 2.1

説明

The GetTopOverlay Lua function returns a handle for the overlay at the top of the display with the provided index number. Overlay is the internal name for what is called pop-ups or menus in the rest of this manual.

引数

この関数は、引数を受け取りません。

戻り値

handle | nil:
The function returns a handle to the top overlay UI object if there is one.

例

This example uses the Dump() function to show information about the MenuSelector pop-up - it is the one opening when pressing the Menu key.

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()
    -- Open the MenuSelector overlay.
    Cmd('Menu "MenuSelector')
    -- Add a small delay.
    coroutine.yield({activeShowstatus=0.2})
    -- Get the handle for the overlay on the display with index 1.
    local overlayHandle = GetTopOverlay(1)
    -- Add a small delay.
    coroutine.yield({activeShowstatus=0.2})
    -- Close the MenuSelector overlay.
    Cmd('Menu "MenuSelector')
    -- Check if there is a handle and print appropriate feedback.
    if overlayHandle ~= nil then
        Printf("=============== START OF DUMP ===============")
        overlayHandle:Dump()
        Printf("================ END OF DUMP ================")
    else
        ErrPrintf("The Overlay UI object could not be found.")
    end
end