Unix/Linux Go Back    


CentOS 7.0 - man page for tk_setwindowbackgroundpixmap (centos section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


Tk_ConfigureWindow(3)		      Tk Library Procedures		    Tk_ConfigureWindow(3)

_________________________________________________________________________________________________

NAME
       Tk_ConfigureWindow,  Tk_MoveWindow, Tk_ResizeWindow, Tk_MoveResizeWindow, Tk_SetWindowBor-
       derWidth, Tk_ChangeWindowAttributes, Tk_SetWindowBackground, 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  val-
						      ueMask are ignored.

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

       int y (in)				      New y-coordinate 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 border).

       int height (in)				      New height for tkwin (interior, not includ-
						      ing 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
						      argument.   Attributes not selected by val-
						      ueMask 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
						      specified, then tkwin will not have its own
						      cursor;  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  window;  when the window is created later, the saved information will be used to con-
       figure 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 internal 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 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 man-
       ager  for that window and never by a window itself (but see Tk_MoveToplevelWindow for mov-
       ing 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 is not 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 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			    Tk_ConfigureWindow(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 08:45 AM.