Страницы справочника OS X

Эта страница руководства является частью версии 5.0 Инструментов XCode

Читать страницы руководства

Tk_WindowId(3)                              Tk Library Procedures                             Tk_WindowId(3)



____________________________________________________________________________________________________________

NAME
       Tk_WindowId, Tk_Parent, Tk_Display, Tk_DisplayName, Tk_ScreenNumber, Tk_Screen, Tk_X, Tk_Y, Tk_Width,
       Tk_Height, Tk_Changes,  Tk_Attributes,  Tk_IsContainer,  Tk_IsEmbedded,  Tk_IsMapped,  Tk_IsTopLevel,
       Tk_ReqWidth, Tk_ReqHeight, Tk_MinReqWidth, Tk_MinReqHeight, Tk_InternalBorderLeft, Tk_InternalBorder-Right, Tk_InternalBorderRight,
       Right, Tk_InternalBorderTop, Tk_InternalBorderBottom, Tk_Visual, Tk_Depth, Tk_Colormap, Tk_Interp   -retrieve Tk_Interpretrieve
       retrieve information from Tk's local data structure

SYNOPSIS
       #include <tk.h>

       Window
       Tk_WindowId(tkwin)

       Tk_Window
       Tk_Parent(tkwin)

       Display *
       Tk_Display(tkwin)

       const char *
       Tk_DisplayName(tkwin)

       int
       Tk_ScreenNumber(tkwin)

       Screen *
       Tk_Screen(tkwin)

       int
       Tk_X(tkwin)

       int
       Tk_Y(tkwin)

       int
       Tk_Width(tkwin)

       int
       Tk_Height(tkwin)

       XWindowChanges *
       Tk_Changes(tkwin)

       XSetWindowAttributes *
       Tk_Attributes(tkwin)

       int
       Tk_IsContainer(tkwin)

       int
       Tk_IsEmbedded(tkwin)

       int
       Tk_IsMapped(tkwin)

       int
       Tk_IsTopLevel(tkwin)

       int
       Tk_ReqWidth(tkwin)

       int
       Tk_ReqHeight(tkwin)

       int
       Tk_MinReqWidth(tkwin)

       int
       Tk_MinReqHeight(tkwin)

       int
       Tk_InternalBorderLeft(tkwin)

       int
       Tk_InternalBorderRight(tkwin)

       int
       Tk_InternalBorderTop(tkwin)

       int
       Tk_InternalBorderBottom(tkwin)

       Visual *
       Tk_Visual(tkwin)

       int
       Tk_Depth(tkwin)

       Colormap
       Tk_Colormap(tkwin)

       Tcl_Interp *
       Tk_Interp(tkwin)

ARGUMENTS
       Tk_Window tkwin (in)          Token for window.
____________________________________________________________________________________________________________


DESCRIPTION
       Tk_WindowId  and  the other names listed above are all macros that return fields from Tk's local data
       structure for tkwin.  None of these macros requires any interaction with the server;  it is  safe  to
       assume that all are fast.

       Tk_WindowId  returns  the  X  identifier for tkwin, or NULL if no X window has been created for tkwin
       yet.

       Tk_Parent returns Tk's token for the logical parent of tkwin.  The parent is the token that was spec-ified specified
       ified when tkwin was created, or NULL for main windows.

       Tk_Interp returns the Tcl interpreter associated with a tkwin or NULL if there is an error.

       Tk_Display  returns  a  pointer to the Xlib display structure corresponding to tkwin.  Tk_DisplayName
       returns an ASCII string identifying tkwin's display.  Tk_ScreenNumber returns the  index  of  tkwin's
       screen  among  all the screens of tkwin's display.  Tk_Screen returns a pointer to the Xlib structure
       corresponding to tkwin's screen.

       Tk_X, Tk_Y, Tk_Width, and Tk_Height return information about tkwin's location within its  parent  and
       its  size.   The  location information refers to the upper-left pixel in the window, or its border if
       there is one.  The width and height information refers to  the  interior  size  of  the  window,  not
       including any border.  Tk_Changes returns a pointer to a structure containing all of the above infor-mation information
       mation plus a few other fields.  Tk_Attributes returns a pointer to an XSetWindowAttributes structure
       describing all of the attributes of the tkwin's window, such as background pixmap, event mask, and so
       on (Tk keeps track of all this information as it is changed by the application).  Note: it is  essen-tial essential
       tial  that  applications  use  Tk  procedures  like Tk_ResizeWindow instead of X procedures like XRe-sizeWindow, XResizeWindow,
       sizeWindow, so that Tk can keep its data structures up-to-date.

       Tk_IsContainer returns a non-zero value if tkwin is a container, and that some other application  may
       be embedding itself inside tkwin.

       Tk_IsEmbedded returns a non-zero value if tkwin is not a free-standing window, but rather is embedded
       in some other application.

       Tk_IsMapped returns a non-zero value if tkwin is mapped and zero if tkwin is not mapped.

       Tk_IsTopLevel returns a non-zero value if tkwin is a top-level window (its X parent is the root  win-dow window
       dow of the screen) and zero if tkwin is not a top-level window.

       Tk_ReqWidth and Tk_ReqHeight return information about the window's requested size.  These values cor-respond correspond
       respond to the last call to Tk_GeometryRequest for tkwin.

       Tk_MinReqWidth and Tk_MinReqHeight return information about  the  window's  minimum  requested  size.
       These values correspond to the last call to Tk_SetMinimumRequestSize for tkwin.

       Tk_InternalBorderLeft,   Tk_InternalBorderRight,   Tk_InternalBorderTop  and  Tk_InternalBorderBottom
       return the width of one side of the internal border that has been requested for tkwin,  or  0  if  no
       internal  border  was requested.  The return value is simply the last value passed to Tk_SetInternal-Border Tk_SetInternalBorder
       Border or Tk_SetInternalBorderEx for tkwin.

       Tk_Visual, Tk_Depth, and Tk_Colormap return information about the visual characteristics of a window.
       Tk_Visual  returns the visual type for the window, Tk_Depth returns the number of bits per pixel, and
       Tk_Colormap returns the current colormap for the window.  The visual characteristics are normally set
       from  the defaults for the window's screen, but they may be overridden by calling Tk_SetWindowVisual.


KEYWORDS
       attributes, colormap, depth, display, height, geometry manager, identifier, mapped,  requested  size,
       screen, top-level, visual, width, window, x, y



Tk                                                   8.4                                      Tk_WindowId(3)