Go to main content

man pages section 3: Extended Library Functions, Volume 1

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

Tk_GetRootCoords (3tk)

Name

Tk_GetRootCoords - window coordinates of window

Synopsis

#include <tk.h>

Tk_GetRootCoords(tkwin, xPtr, yPtr)

Description

Tk_GetRootCoords(3tk)        Tk Library Procedures       Tk_GetRootCoords(3tk)



______________________________________________________________________________

NAME
       Tk_GetRootCoords - Compute root-window coordinates of window

SYNOPSIS
       #include <tk.h>

       Tk_GetRootCoords(tkwin, xPtr, yPtr)

ARGUMENTS
       Tk_Window tkwin (in)          Token for window.

       int *xPtr (out)               Pointer  to  location  in  which to store
                                     root-window x-coordinate corresponding to
                                     left edge of tkwin's border.

       int *yPtr (out)               Pointer  to  location  in  which to store
                                     root-window y-coordinate corresponding to
                                     top edge of tkwin's border.
______________________________________________________________________________

DESCRIPTION
       This  procedure  scans through the structural information maintained by
       Tk to compute the root-window coordinates corresponding to  the  upper-
       left  corner  of  tkwin's border.  If tkwin has no border, then Tk_Get-
       RootCoords returns the root-window coordinates corresponding  to  loca-
       tion  (0,0)  in tkwin.  Tk_GetRootCoords is relatively efficient, since
       it does not have to communicate with the X server.

KEYWORDS
       coordinates, root window



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | runtime/tk-8     |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source        was        downloaded        from         https://source-
       forge.net/projects/tcl/files/Tcl/8.6.7/tk8.6.7-src.tar.gz/download.

       Further information about this software can be found on the open source
       community website at https://www.tcl.tk/.



Tk                                                       Tk_GetRootCoords(3tk)