util/src/TclTk/tk8.6.12/doc/ttk_sizegrip.n

   1 '\"
   2 '\" Copyright (c) 2006 Joe English
   3 '\"
   4 '\" See the file "license.terms" for information on usage and redistribution
   5 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
   6 '\"
   7 .TH ttk::sizegrip n 8.5 Tk "Tk Themed Widget"
   8 .so man.macros
   9 .BS
  10 .SH NAME
  11 ttk::sizegrip \- Bottom-right corner resize widget
  12 .SH SYNOPSIS
  13 \fBttk::sizegrip\fR \fIpathName \fR?\fIoptions\fR?
  14 .BE
  15 .SH DESCRIPTION
  16 .PP
  17 A \fBttk::sizegrip\fR widget (also known as a \fIgrow box\fR)
  18 allows the user to resize the containing toplevel window
  19 by pressing and dragging the grip.
  20 .SO ttk_widget
  21 \-class \-cursor
  22 \-style \-takefocus
  23 .SE
  24 .SH "WIDGET COMMAND"
  25 .PP
  26 Sizegrip widgets support the standard
  27 \fBcget\fR, \fBconfigure\fR, \fBidentify\fR, \fBinstate\fR, and \fBstate\fR
  28 methods.  No other widget methods are used.
  29 .SH "PLATFORM-SPECIFIC NOTES"
  30 .PP
  31 On Mac OSX, toplevel windows automatically include a built-in
  32 size grip by default.
  33 Adding a \fBttk::sizegrip\fR there is harmless, since
  34 the built-in grip will just mask the widget.
  35 .SH EXAMPLES
  36 .PP
  37 Using pack:
  38 .CS
  39 pack [ttk::frame $top.statusbar] \-side bottom \-fill x
  40 pack [\fBttk::sizegrip\fR $top.statusbar.grip] \-side right \-anchor se
  41 .CE
  42 .PP
  43 Using grid:
  44 .CS
  45 grid [\fBttk::sizegrip\fR $top.statusbar.grip] \e
  46     \-row $lastRow \-column $lastColumn \-sticky se
  47 # ... optional: add vertical scrollbar in $lastColumn,
  48 # ... optional: add horizontal scrollbar in $lastRow
  49 .CE
  50 .SH "BUGS"
  51 .PP
  52 If the containing toplevel's position was specified
  53 relative to the right or bottom of the screen
  54 (e.g.,
  55 .QW "\fBwm geometry ... \fIw\fBx\fIh\fB\-\fIx\fB\-\fIy\fR"
  56 instead of
  57 .QW "\fBwm geometry ... \fIw\fBx\fIh\fB+\fIx\fB+\fIy\fR" ),
  58 the sizegrip widget will not resize the window.
  59 .PP
  60 \fBttk::sizegrip\fR widgets only support
  61 .QW southeast
  62 resizing.
  63 .SH "STYLING OPTIONS"
  64 .PP
  65 The class name for a \fBttk::sizegrip\fP is \fBTSizegrip\fP.
  66 .PP
  67 \fBTSizegrip\fP styling options configurable with \fBttk::style\fP
  68 are:
  69 .PP
  70 \fB\-background\fP \fIcolor\fP
  71 .PP
  72 Some options are only available for specific themes.
  73 .PP
  74 See the \fBttk::style\fP manual page for information on how to configure
  75 ttk styles.
  76 .SH "SEE ALSO"
  77 ttk::widget(n)
  78 .SH "KEYWORDS"
  79 widget, sizegrip, grow box
  80 '\" Local Variables:
  81 '\" mode: nroff
  82 '\" End: