Tk_MoveResizeWindow man page on OpenServer

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

Tk_ConfigureWindow(3)	     Tk Library Procedures	 Tk_ConfigureWindow(3)

______________________________________________________________________________

NAME
       Tk_ConfigureWindow,  Tk_MoveWindow,  Tk_ResizeWindow, Tk_MoveResizeWin-
       dow, Tk_SetWindowBorderWidth, Tk_ChangeWindowAttributes,	 Tk_SetWindow-
       Background,	Tk_SetWindowBackgroundPixmap,	   Tk_SetWindowBorder,
       Tk_SetWindowBorderPixmap,    Tk_SetWindowColormap,     Tk_DefineCursor,
       Tk_UndefineCursor - change window configuration 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 to use.

       XWindowChanges	      *valuePtr	    (in)      Points  to  a  structure
						      containing  new	values
						      for   the	 configuration
						      parameters  selected  by
						      valueMask.   Fields  not
						      selected	by   valueMask
						      are ignored.

       int		      x		    (in)      New   x-coordinate   for
						      tkwin's top  left	 pixel
						      (including   border,  if
						      any) within tkwin's par-
						      ent.

       int		      y		    (in)      New   y-coordinate   for
						      tkwin's top  left	 pixel
						      (including   border,  if
						      any) within tkwin's par-
						      ent.

       int		      width	    (in)      New   width   for	 tkwin
						      (interior, not including
						      border).

       int		      height	    (in)      New   height  for	 tkwin
						      (interior, not including
						      border).

       int		      borderWidth   (in)      New  width  for  tkwin's
						      border.

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

       unsigned long	      pixel	    (in)      New background or border
						      color for window.

       Pixmap		      pixmap	    (in)      New  pixmap  to  use for
						      background or border  of
						      tkwin.   WARNING: cannot
						      necessarily  be  deleted
						      immediately, as for Xlib
						      calls.  See note	below.

       Colormap		      colormap	    (in)      New  colormap to use for
						      tkwin.

       Tk_Cursor	      cursor	    (in)      New cursor  to  use  for
						      tkwin.  If None is spec-
						      ified, then  tkwin  will
						      not have its own cursor;
						      it will use  the	cursor
						      of its parent.
_________________________________________________________________

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
       window;	when the window is created later, the saved  information  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_SetWindowBorderWidth, if tkwin is an inter-
       nal window then event  handlers	interested  in	configure  events  are
       invoked	immediately, 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 XConfigureWin-
       dow directly;  they should always use the corresponding Tk  procedures.

       The size and location of a window should only be modified by the appro-
       priate 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.

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  pro-
       cedures.	  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		 Tk_ConfigureWindow(3)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server OpenServer

List of man pages available for OpenServer

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