Tk_ChangeWindowAttributes man page on BSDi

Man page or keyword search:  
man Server   6284 pages
apropos Keyword Search (all sections)
Output format
BSDi logo
[printable version]



Tk_ConfigureWindow(3) Tk Library Procedures Tk_ConfigureWindow(3)

_________________________________________________________________

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
						      or *attsPtr

Tk			       4.0				1

Tk_ConfigureWindow(3) Tk Library Procedures Tk_ConfigureWindow(3)

						      to use.

       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
						      for tkwin's

Tk			       4.0				2

Tk_ConfigureWindow(3) Tk Library Procedures Tk_ConfigureWindow(3)

						      border.

       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
						      own cursor;

Tk			       4.0				3

Tk_ConfigureWindow(3) Tk Library Procedures Tk_ConfigureWindow(3)

						      it will use
						      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			       4.0				4

Tk_ConfigureWindow(3) Tk Library Procedures Tk_ConfigureWindow(3)

BUGS
       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

Tk			       4.0				5

[top]

List of man pages available for BSDi

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net