Read Property of UI object From Point

Retrieves the UI object that contains the specified point, and reads the specified property of the UI object .


  • Position is relative to Specifies how to calculate the value of the location coordinates, it can be one of the following:

    • Relative to the screen coordinates Absolute coordinates, start from the top-left of the screen.
    • Relative to the foreground window Relative coordinates, start from the top-left of the foreground window.
    • Relative to the current position Relative coordinates, start from the position of the current mouse pointer.
  • Position X Specifies the value of X coordinate.

  • Position Y Specifies the value of Y coordinate.

  • Read what Specifies what property to be read. If the "Auto detect" is selected, Macro Player will compare the content in the name property of the UI object and the content in the value property, and then return the longer one.

  • Populate variable with result Specifies a variable to hold the result. If the option "Read what" is set to "Retrieve object's current location", the variable will be converted to a one-dimensional array with five elements for holding the coordinate value of left, top, width and right. The fifth element of the array is the window handle value.


  • Some applications use picture or other self-draw controls that may act like standard windows controls but do not support the interfaces required to communicate with them. This action will not work with these controls (UI object s).
  • For more information about locating a UI object , please refer to "Find a UI object".
  • For more information about the tab "Which Window", please refer to "Locate a window".