NAME

       Tk_ConfigureWindow,     Tk_MoveWindow,    Tk_ResizeWindow,
       Tk_MoveResizeWindow,              Tk_SetWindowBorderWidth,
       Tk_ChangeWindowAttributes,         Tk_SetWindowBackground,
       Tk_SetWindowBackgroundPixmap,          Tk_SetWindowBorder,
       Tk_SetWindowBorderPixmap,            Tk_SetWindowColormap,
       Tk_DefineCursor, Tk_UndefineCursor - change window config­
       uration or attributes


SYNOPSIS

       #include <tk.h>

       Tk_ConfigureWindow(tkwin, valueMask, valuePtr)

       Tk_MoveWindow(tkwin, x, y)

       Tk_ResizeWindow(tkwin, width, height)

       Tk_MoveResizeWindow(tkwin, x,  y, width, height)

       Tk_SetWindowBorderWidth(tkwin, borderWidth)

       Tk_ChangeWindowAttributes(tkwin, valueMask, attsPtr)

       Tk_SetWindowBackground(tkwin, pixel)

       Tk_SetWindowBackgroundPixmap(tkwin, pixmap)

       Tk_SetWindowBorder(tkwin, pixel)

       Tk_SetWindowBorderPixmap(tkwin, pixmap)

       Tk_SetWindowColormap(tkwin, colormap)

       Tk_DefineCursor(tkwin, cursor)

       Tk_UndefineCursor(tkwin)


ARGUMENTS

       Tk_Window              tkwin         (in)      Token   for
                                                      window.

       unsigned int           valueMask     (in)      OR-ed  mask
                                                      of   values
                                                      like CWX or
                                                      CWBorder­
                                                      Pixel,
                                                      indicating
                                                      which
                                                      fields   of
                                                      *valuePtr

       XWindowChanges         *valuePtr     (in)      Points to a
                                                      structure
                                                      containing
                                                      new  values
                                                      for     the
                                                      configura­
                                                      tion param­
                                                      eters
                                                      selected by
                                                      valueMask.
                                                      Fields  not
                                                      selected by
                                                      valueMask
                                                      are
                                                      ignored.

       int                    x             (in)      New x-coor­
                                                      dinate  for
                                                      tkwin's top
                                                      left  pixel
                                                      (including
                                                      border,  if
                                                      any) within
                                                      tkwin's
                                                      parent.

       int                    y             (in)      New y-coor­
                                                      dinate  for
                                                      tkwin's top
                                                      left  pixel
                                                      (including
                                                      border,  if
                                                      any) within
                                                      tkwin's
                                                      parent.

       int                    width         (in)      New   width
                                                      for   tkwin
                                                      (interior,
                                                      not includ­
                                                      ing    bor­
                                                      der).

       int                    height        (in)      New  height
                                                      for   tkwin
                                                      (interior,
                                                      not includ­
                                                      ing    bor­
                                                      der).

       int                    borderWidth   (in)      New   width

       XSetWindowAttributes   *attsPtr      (in)      Points to a
                                                      structure
                                                      containing
                                                      new  values
                                                      for     the
                                                      attributes
                                                      given    by
                                                      the  value­
                                                      Mask  argu­
                                                      ment.
                                                      Attributes
                                                      not
                                                      selected by
                                                      valueMask
                                                      are
                                                      ignored.

       unsigned long          pixel         (in)      New   back­
                                                      ground   or
                                                      border
                                                      color   for
                                                      window.

       Pixmap                 pixmap        (in)      New  pixmap
                                                      to use  for
                                                      background
                                                      or   border
                                                      of   tkwin.
                                                      WARNING:
                                                      cannot nec­
                                                      essarily be
                                                      deleted
                                                      immedi­
                                                      ately,   as
                                                      for    Xlib
                                                      calls.  See
                                                      note below.

       Colormap               colormap      (in)      New    col­
                                                      ormap    to
                                                      use     for
                                                      tkwin.

       Tk_Cursor              cursor        (in)      New  cursor
                                                      to  use for
                                                      tkwin.   If
                                                      None     is
                                                      specified,
                                                      then  tkwin
                                                      will    not
                                                      have    its
                                                      the  cursor
                                                      of its par­
                                                      ent.
_________________________________________________________________



DESCRIPTION

       These procedures are analogous to the X library procedures
       with similar names, such as XConfigureWindow.  Each one of
       the above procedures calls the corresponding  X  procedure
       and also saves the configuration information in Tk's local
       structure for the window.  This allows the information  to
       be retrieved quickly by the application (using macros such
       as Tk_X and Tk_Height) without having  to  contact  the  X
       server.   In  addition,  if  no X window has actually been
       created for tkwin yet, these procedures  do  not  issue  X
       operations  or  cause  event handlers to be invoked;  they
       save the information in Tk's local structure for the  win­
       dow;  when the window is created later, the saved informa­
       tion will be used to configure the window.

       See the X library documentation for details on what  these
       procedures do and how they use their arguments.

       In   the   procedures  Tk_ConfigureWindow,  Tk_MoveWindow,
       Tk_ResizeWindow, Tk_MoveResizeWindow, and Tk_SetWindowBor­
       derWidth,  if  tkwin is an internal window then event han­
       dlers interested in configure events are  invoked  immedi­
       ately,  before  the procedure returns.  If tkwin is a top-
       level window then  the  event  handlers  will  be  invoked
       later,  after X has seen the request and returned an event
       for it.

       Applications using Tk should never  call  procedures  like
       XConfigureWindow  directly;   they  should  always use the
       corresponding Tk procedures.

       The size and location of a window should only be  modified
       by  the  appropriate  geometry manager for that window and
       never by a window itself  (but  see  Tk_MoveToplevelWindow
       for moving a top-level window).

       You  may not use Tk_ConfigureWindow to change the stacking
       order of a window (valueMask may not contain the CWSibling
       or  CWStackMode  bits).  To change the stacking order, use
       the procedure Tk_RestackWindow.

       The procedure Tk_SetWindowColormap will automatically  add
       tkwin  to  the TK_COLORMAP_WINDOWS property of its nearest
       top-level ancestor if the new colormap is  different  from
       that  of  tkwin's  parent  and  tkwin isn't already in the
       TK_COLORMAP_WINDOWS property.
       Tk_SetWindowBackgroundPixmap and  Tk_SetWindowBorderPixmap
       differ  slightly  from their Xlib counterparts in that the
       pixmap argument may not necessarily be deleted immediately
       after  calling  one  of these procedures.  This is because
       tkwin's window may not exist yet at the time of the  call,
       in  which  case pixmap is merely saved and used later when
       tkwin's window is actually created.  If you wish to delete
       pixmap, then call Tk_MakeWindowExist first to be sure that
       tkwin's window exists and pixmap has been passed to the  X
       server.

       A similar problem occurs for the cursor argument passed to
       Tk_DefineCursor.  The solution is the same as for  pixmaps
       above:  call Tk_MakeWindowExist before freeing the cursor.



SEE ALSO

       Tk_MoveToplevelWindow, Tk_RestackWindow



KEYWORDS

       attributes,  border,  color,  configure,  height,   pixel,
       pixmap, width, window, x, y