Skip to main content
Version: 7.9

system.gui.convertPointToScreen

This function is used in Python Scripting.

Description

Converts a pair of coordinates that are relative to the upper-left corner of some component to be relative to the upper-left corner of the entire screen.

Client Permission Restrictions

This scripting function has no Client Permission restrictions.

Syntax

system.gui.convertPointToScreen(x, y, event)

Parameters

TypeParameterDescription
intxThe X-coordinate, relative to the component that fired the event.
intyThe Y-coordinate, relative to the component that fired the event.
EventObjecteventAn event object for a component event.

Returns

PyTuple - A tuple of (x,y) in screen coordinates.

Scope

All

Code Examples

Example #1
# This example will get the coordinates where the mouse is (from the corner of the monitor) and display them in a label.
# Get the screen coordinates of the pointer and write them to a label.
coords = system.gui.convertPointToScreen(event.x, event.y, event)
event.source.getComponent('Label').text = "x: %s y: %s" %(coords[0], coords[1])