説明

The GetUIObjectAtPosition Lua function returns the handle of the UI Object at a specified position on a specified display.

引数

• integer:
  The integer should be the index number of the display with the UI object.
• table:
  The table must have two elements with the following keys:
  • x: This is the X position on the display. The value must be a number indicating the desired pixel position. It is counted from the left side of the display.
    
  • y: This is the Y position on the display. The value must be a number indicating the desired pixel position. It is counted from the top of the display.
    

戻り値

• handle | nil:
  If a UI object is at the provided position, then the handle to the object is returned. Otherwise, it returns nil.
  

例

This example prints the Dump of the UIObject at a specific position on display 1. It also uses the DrawPointer function to draw a red pointer at the position.

return function()
    -- Get the index number for "Display 1"
    local displayIndex = GetDisplayCollect()["Display 1"].INDEX
    -- Create a table with X and Y position
    local positionTable = {}
    positionTable.x = 1000
    positionTable.y = 500
    -- Get the UI object handle
    local uiObjectAtPositionHandle = GetUIObjectAtPosition(displayIndex,positionTable)
    -- Dump all information about the display with the index number if not nil
    if uiObjectAtPositionHandle == nil then
        Printf("The returned value was not a valid handle.")
        return
    end
    -- Draw a pointer at the posiiton for 5 seconds
    DrawPointer(displayIndex,positionTable,5000)
    --Dump of the UIObject
    Printf("=============== START OF DUMP ===============")
    uiObjectAtPositionHandle:Dump()
    Printf("================ END OF DUMP ================")
end