File: progressbar.html

package info (click to toggle)
tile 0.8.2-2.1
  • links: PTS
  • area: main
  • in suites: lenny, squeeze
  • size: 3,152 kB
  • ctags: 3,093
  • sloc: ansic: 18,144; tcl: 4,607; makefile: 398; sh: 71
file content (138 lines) | stat: -rw-r--r-- 6,889 bytes parent folder | download
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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
<html>
<head>
<link rel="stylesheet" href="manpage.css"><title>Tile package reference: progressbar</title><meta name="xsl-processor" content="Jochen Loewer (loewerj@hotmail.com), Rolf Ade (rolf@pointsman.de) et. al."><meta name="generator" content="$RCSfile: tmml-html.xsl,v $ $Revision: 1.12 $">
</head><body>
<div class="header">
<div class="navbar" align="center">
<a href="#SECTid8206658">NAME</a>  <a href="#SECTid82066d0">SYNOPSIS</a>  <a href="#SECTid8206798">STANDARD OPTIONS</a>  <a href="#SECTid82068b0">OPTIONS</a>  <a href="#SECTid82070f8">DESCRIPTION</a>  <a href="#SECTid82071c0">WIDGET COMMAND</a>  <a href="#SECTid8207af8">SEE ALSO</a>
</div><hr class="navsep">
</div><div class="body">



<h2><a name="SECTid8206658">NAME</a></h2><p class="namesection">
<b class="names">ttk::progressbar - </b><br>Provide progress feedback</p>
<h2><a name="SECTid82066d0">SYNOPSIS</a></h2><pre class="syntax">
<b>ttk::progressbar</b> <i class="m">pathName</i> ?<i class="m">options</i>?
</pre>
<h2><a name="SECTid8206798">STANDARD OPTIONS</a></h2><div class="menu"><table class="menu" width="100%"><tr>
<td width="25%"><a href="widget.html#stdopt_-class">-class</a></td><td width="25%"><a href="widget.html#stdopt_-cursor">-cursor</a></td><td width="25%"><a href="widget.html#stdopt_-style">-style</a></td><td width="25%"><a href="widget.html#stdopt_-takefocus">-takefocus</a></td>
</tr></table></div>
<h2><a name="SECTid82068b0">OPTIONS</a></h2><div class="table"><table width="100%" rules="none" cellpadding="5%">
<thead><tr class="heading">
<th width="20%">Name</th><th width="40%">Database name</th><th width="40%">Database class</th>
</tr></thead><tr class="syntax">
<td width="20%" align="left"><a name="option_-orient">-orient</a></td><td width="40%" align="left">orient</td><td width="40%" align="left">Orient</td>
</tr><tr class="desc">
<td class="padding" width="20%"></td><td class="argdesc" width="80%" align="left" colspan="2">One of <b>horizontal</b> or <b>vertical</b>.
Specifies the orientation of the progress bar.
</td>
</tr><tr class="syntax">
<td width="20%" align="left"><a name="option_-length">-length</a></td><td width="40%" align="left">length</td><td width="40%" align="left">Length</td>
</tr><tr class="desc">
<td class="padding" width="20%"></td><td class="argdesc" width="80%" align="left" colspan="2">Specifies the length of the long axis of the progress bar
(width if horizontal, height if vertical).
</td>
</tr><tr class="syntax">
<td width="20%" align="left"><a name="option_-mode">-mode</a></td><td width="40%" align="left">mode</td><td width="40%" align="left">Mode</td>
</tr><tr class="desc">
<td class="padding" width="20%"></td><td class="argdesc" width="80%" align="left" colspan="2">One of <b>determinate</b> or <b>indeterminate</b>.
</td>
</tr><tr class="syntax">
<td width="20%" align="left"><a name="option_-maximum">-maximum</a></td><td width="40%" align="left">maximum</td><td width="40%" align="left">Maximum</td>
</tr><tr class="desc">
<td class="padding" width="20%"></td><td class="argdesc" width="80%" align="left" colspan="2">A floating point number specifying the maximum <b>-value</b>.
Defaults to 100.
</td>
</tr><tr class="syntax">
<td width="20%" align="left"><a name="option_-value">-value</a></td><td width="40%" align="left">value</td><td width="40%" align="left">Value</td>
</tr><tr class="desc">
<td class="padding" width="20%"></td><td class="argdesc" width="80%" align="left" colspan="2">The current value of the progress bar.
In <i>determinate</i> mode, this represents the amount of work completed.
In <i>indeterminate</i> mode, it is interpreted modulo <b>-maximum</b>;
that is, the progress bar completes one "cycle" when
the <b>-value</b> increases by <b>-maximum</b>.
</td>
</tr><tr class="syntax">
<td width="20%" align="left"><a name="option_-variable">-variable</a></td><td width="40%" align="left">variable</td><td width="40%" align="left">Variable</td>
</tr><tr class="desc">
<td class="padding" width="20%"></td><td class="argdesc" width="80%" align="left" colspan="2">The name of a Tcl variable which is linked to the <b>-value</b>.
If specified, the <b>-value</b> of the progress bar is 
automatically set to the value of the variable whenever 
the latter is modified.
</td>
</tr><tr class="syntax">
<td width="20%" align="left"><a name="option_-phase">-phase</a></td><td width="40%" align="left">phase</td><td width="40%" align="left">Phase</td>
</tr><tr class="desc">
<td class="padding" width="20%"></td><td class="argdesc" width="80%" align="left" colspan="2">Read-only option.
The widget periodically increments the value of this option 
whenever the <b>-value</b> is greater than 0 and,
in <i>determinate</i> mode, less than <b>-maximum</b>.
This option may be used by the current theme 
to provide additional animation effects.
</td>
</tr>
</table></div>
<h2><a name="SECTid82070f8">DESCRIPTION</a></h2><p>A progress bar widget shows the status of a long-running operation.
They can operate in two modes: <i>determinate</i> mode shows the
amount completed relative to the total amount of work to be done,
and <i>indeterminate</i> mode provides an animated display to
let the user know that something is happening.
</p>
<h2><a name="SECTid82071c0">WIDGET COMMAND</a></h2><dl>

<dt>
<i class="m">pathName</i> <b>cget</b> <i class="m">option</i>
</dt>
<dd>Returns the current value of the specified <i>option</i>; see <i>widget(n)</i>.
</dd>


<dt>
<i class="m">pathName</i> <b>configure</b> ?<i class="m">option</i>? ?<i class="m">value option value ...</i>?</dt>
<dd>Modify or query widget options; see <i>widget(n)</i>.
</dd>


<dt>
<i class="m">pathName</i> <b>instate</b> <i class="m">statespec</i> ?<i class="m">script</i>?</dt>
<dd>Test the widget state; see <i>widget(n)</i>.
</dd>


<dt>
<i class="m">pathName</i> <b>start</b> ?<i class="m">interval</i>?</dt>
<dd>Begin autoincrement mode:
schedules a recurring timer event that calls <b>step</b> 
every <i>interval</i> milliseconds.
If omitted, <i>interval</i> defaults to 50 milliseconds (20 steps/second).
</dd>


<dt>
<i class="m">pathName</i> <b>state</b> ?<i class="m">stateSpec</i>?</dt>
<dd>Modify or query the widget state; see <i>widget(n)</i>.
</dd>


<dt>
<i class="m">pathName</i> <b>step</b> ?<i class="m">amount</i>?</dt>
<dd>Increments the <b>-value</b> by <i>amount</i>.  
<i>amount</i> defaults to 1.0 if omitted.
</dd>


<dt>
<i class="m">pathName</i> <b>stop</b>
</dt>
<dd>Stop autoincrement mode:
cancels any recurring timer event initiated by <i>pathName</i> <b>start</b>.
</dd>

</dl>
<h2><a name="SECTid8207af8">SEE ALSO</a></h2><p class="seealso">widget(n)</p>
</div><hr class="navsep"><div class="navbar" align="center">
<a class="navaid" href="index.html">Contents</a>  <a class="navaid" href="category-index.html">Index</a>  <a class="navaid" href="keyword-index.html">Keywords</a>
</div>
</body>
</html>