Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, March 14, 2019
 
 

raise (1t)

Name

raise - Change a window's position in the stacking order

Synopsis

raise window ?aboveThis?

Description

raise(1t)                    Tk Built-In Commands                    raise(1t)



______________________________________________________________________________

NAME
       raise - Change a window's position in the stacking order

SYNOPSIS
       raise window ?aboveThis?
______________________________________________________________________________

DESCRIPTION
       If  the aboveThis argument is omitted then the command raises window so
       that it is above all of its siblings in the stacking order (it will not
       be  obscured by any siblings and will obscure any siblings that overlap
       it).  If aboveThis is specified then it must be the path name of a win-
       dow  that  is either a sibling of window or the descendant of a sibling
       of window.  In this case the raise command will insert window into  the
       stacking  order just above aboveThis (or the ancestor of aboveThis that
       is a sibling of window); this could end up either raising  or  lowering
       window.

       All toplevel windows may be restacked with respect to each other, what-
       ever their relative path names, but the window manager is not obligated
       to strictly honor requests to restack.

EXAMPLE
       Make  a  button  appear to be in a sibling frame that was created after
       it. This is is often necessary when building GUIs in  the  style  where
       you  create  your  activity widgets first before laying them out on the
       display:
              button .b -text "Hi there!"
              pack [frame .f -background blue]
              pack [label .f.l1 -text "This is above"]
              pack .b -in .f
              pack [label .f.l2 -text "This is below"]
              raise .b


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


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | runtime/tk-8     |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
SEE ALSO
       lower(n)

KEYWORDS
       obscure, raise, stacking order



NOTES
       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source        was        downloaded        from         https://source-
       forge.net/projects/tcl/files/Tcl/8.6.7/tk8.6.7-src.tar.gz/download

       Further information about this software can be found on the open source
       community website at https://www.tcl.tk/.



Tk                                    3.3                            raise(1t)