summaryrefslogtreecommitdiffstats
path: root/doc/ttk_sizegrip.n
blob: 6da57f4bd1a4be3dc6f8eeed5c7945f7e64c225f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
'\"
'\" Copyright (c) 2006 Joe English
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
'\" RCS: @(#) $Id: ttk_sizegrip.n,v 1.8 2007/10/24 14:32:59 dkf Exp $
'\"
.so man.macros
.TH ttk_sizegrip n 8.5 Tk "Tk Themed Widget"
.BS
.\" Use _ instead of :: as the name becomes a filename on install
.SH NAME
ttk_sizegrip \- Bottom-right corner resize widget
.SH SYNOPSIS
\fBttk::sizegrip\fR \fIpathName \fR?\fIoptions\fR?
.BE

.SH DESCRIPTION
A \fBttk::sizegrip\fR widget (also known as a \fIgrow box\fR) allows the user
to resize the containing toplevel window by pressing and dragging the grip.
.SO
\-class	\-cursor	\-state
\-style	\-takefocus
.SE
.SH "WIDGET COMMAND"
Sizegrip widgets support the standard \fBcget\fR, \fBconfigure\fR,
\fBinstate\fR, and \fBstate\fR methods. No other widget methods are used.
.SH "PLATFORM-SPECIFIC NOTES"
On Mac OSX, toplevel windows automatically include a built-in size grip by
default. Adding an \fBttk::sizegrip\fR there is harmless, since the built-in
grip will just mask the widget.
.SH EXAMPLES
.PP
Using \fBpack\fR:
.CS
pack [ttk::frame $top.statusbar] -side bottom -fill x
pack [\fBttk::sizegrip\fR $top.statusbar.grip] -side right -anchor se
.CE
.PP
Using \fBgrid\fR:
.CS
grid [\Bttk::sizegrip\fR $top.statusbar.grip] \e
        -row $lastRow -column $lastColumn -sticky se
# ... optional: add vertical scrollbar in $lastColumn,
# ... optional: add horizontal scrollbar in $lastRow
.CE
.SH "BUGS"
If the containing toplevel's position was specified relative to the right or
bottom of the screen (e.g., \fB[wm geometry ...
\fIw\fBx\fIh\fB\-\fIx\fB\-\fIy\fB]\fR instead of \fB[wm geometry ...
\fIw\fBx\fIh\fB+\fIx\fB+\fIy\fB]\fR), the sizegrip widget will not resize the
window.
.PP
ttk::sizegrip widgets only support "southeast" resizing.
.SH "SEE ALSO"
ttk_widget(n)
.SH "KEYWORDS"
widget, sizegrip, grow box