Tk_SetWindowBorder man page on Solaris

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
Solaris 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

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

       ┌────────────────────┬─────────────────┐
       │  ATTRIBUTE TYPE    │ ATTRIBUTE VALUE │
       ├────────────────────┼─────────────────┤
       │Availability	    │ SUNWTk	      │
       ├────────────────────┼─────────────────┤
       │Interface Stability │ External	      │
       └────────────────────┴─────────────────┘
NOTES
       Source for Tk is available in the SUNWTkS package.

Tk				      4.0		 Tk_ConfigureWindow(3)
[top]

List of man pages available for Solaris

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