1<TITLE>canvasprintdialog - Create and manipulate a canvas print dialog widget</TITLE>
2<H1>canvasprintdialog - Create and manipulate a canvas print dialog widget</H1>
3
4</pre><H2>SYNOPSIS</H2>
5<B>canvasprintdialog<I> <I>pathName </I>?<I>options</I>?
6</pre><H2>INHERITANCE</H2>
7itk::Toplevel &lt;- Dialogshell &lt;- Dialog &lt;- Canvasprintdialog
8</pre><H2>STANDARD OPTIONS</H2>
9<P>
10<table cellpadding=5>
11<td valign=top>
12<B>activeBackground</B><br>
13<B>foreground</B><br>
14<B>insertBackground</B><br>
15<B>insertWidth</B><br>
16<B>selectBackground</B><br>
17</td>
18<td valign=top>
19<B>background</B><br>
20<B>highlightBackground</B><br>
21<B>insertBorderWidth</B><br>
22<B>relief</B><br>
23<B>selectBorderWidth</B><br>
24</td>
25<td valign=top>
26<B>borderWidth</B><br>
27<B>highlightColor</B><br>
28<B>insertOffTime</B><br>
29<B>repeatDelay</B><br>
30<B>selectForeground</B><br>
31</td>
32<td valign=top>
33<B>cursor</B><br>
34<B>highlightThickness</B><br>
35<B>insertOnTime</B><br>
36<B>repeatInterval</B><br>
37</td>
38</table>
39<P>
40See the <A HREF="http://www.sco.com/Technology/tcl/man/tk_man/options.n.html"> "options" </A> manual entry for details on the standard options.
41</pre><H2>ASSOCIATED OPTIONS</H2>
42<P>
43<table cellpadding=5>
44<td valign=top>
45<B>filename</B><br>
46<B>pagesize</B><br>
47<B>vpagecnt</B><br>
48</td>
49<td valign=top>
50<B>hpagecnt</B><br>
51<B>posterize</B><br>
52</td>
53<td valign=top>
54<B>orient</B><br>
55<B>printcmd</B><br>
56</td>
57<td valign=top>
58<B>output</B><br>
59<B>printregion</B><br>
60</td>
61</table>
62<P>
63See the "canvasprintbox" widget manual entry for details on the above
64associated options.
65
66</pre><H2>INHERITED OPTIONS</H2>
67<P>
68<table cellpadding=5>
69<td valign=top>
70<B>buttonBoxPadX</B><br>
71<B>padY</B><br>
72</td>
73<td valign=top>
74<B>buttonBoxPadY</B><br>
75<B>separator</B><br>
76</td>
77<td valign=top>
78<B>buttonBoxPos</B><br>
79<B>thickness</B><br>
80</td>
81<td valign=top>
82<B>padX</B><br>
83</td>
84</table>
85<P>
86See the <A HREF="dialogshell.n.html"> "dialogshell" </A> widget manual entry for details on the above
87inherited options.
88<P>
89<table cellpadding=5>
90<td valign=top>
91<B>master</B><br>
92</td>
93<td valign=top>
94<B>modality</B><br>
95</td>
96<td valign=top>
97</td>
98<td valign=top>
99</td>
100</table>
101<P>
102See the "shell" widget manual entry for details on the above
103inherited options.
104<P>
105<P>
106<table cellpadding=5>
107<td valign=top>
108<B>title</B><br>
109</td>
110<td valign=top>
111</td>
112<td valign=top>
113</td>
114<td valign=top>
115</td>
116</table>
117<P>
118See the "Toplevel" widget manual entry for details on the above
119inherited options.
120<P>
121</pre><H2>WIDGET-SPECIFIC OPTIONS</H2>
122<P>
123</pre><HR>
124
125</pre><H2>DESCRIPTION</H2>
126<P>
127The <B>canvasprintdialog</B> command creates a print dialog for printing
128the contents of a canvas widget to a printer or a file. It is possible
129to specify page orientation, the number of pages to print the image on
130and if the output should be stretched to fit the page.
131
132</pre><H2>METHODS</H2>
133<P>
134The <B>canvasprintdialog</B> command creates a new Tcl command whose
135name is <I>pathName</I>.  This
136command may be used to invoke various
137operations on the widget.  It has the following general form:
138<pre>
139<I>pathName option </I>?<I>arg arg ...</I>?
140</pre>
141<I>Option</I> and the <I>arg</I>s
142determine the exact behavior of the command.  The following
143commands are possible for canvasprintdialog widgets:
144</pre><H2>ASSOCIATED METHODS</H2>
145<P>
146<table cellpadding=5>
147<td valign=top>
148<B>getoutput</B><br>
149</td>
150<td valign=top>
151<B>setcanvas</B><br>
152</td>
153<td valign=top>
154<B>refresh</B><br>
155</td>
156<td valign=top>
157<B>print</B><br>
158</td>
159</table>
160<P>
161See the "canvasprintbox" class manual entry for details on the 
162associated methods.
163</pre><H2>INHERITED METHODS</H2>
164<P>
165<table cellpadding=5>
166<td valign=top>
167<B>add</B><br>
168<B>insert</B><br>
169</td>
170<td valign=top>
171<B>buttonconfigure</B><br>
172<B>invoke</B><br>
173</td>
174<td valign=top>
175<B>default</B><br>
176<B>show</B><br>
177</td>
178<td valign=top>
179<B>hide</B><br>
180</td>
181</table>
182<P>
183See the <A HREF="buttonbox.n.html"> "buttonbox" </A> widget manual entry for details on the above
184inherited methods.
185<P>
186<table cellpadding=5>
187<td valign=top>
188<B>activate</B><br>
189</td>
190<td valign=top>
191<B>deactivate</B><br>
192</td>
193<td valign=top>
194</td>
195<td valign=top>
196</td>
197</table>
198<P>
199See the <A HREF="dialogshell.n.html"> "dialogshell" </A> widget manual entry for details on the above
200inherited methods.
201
202</pre><H2>WIDGET-SPECIFIC METHODS</H2>
203<DL>
204<DT> <I>pathName <B>cget</B> <I>option</I>
205</I></B>
206<DD> Returns the current value of the configuration option given
207by <I>option</I>.
208<I>Option</I> may have any of the values accepted by 
209the <B>canvasprintdialog</B> command.
210</DL>
211<DL>
212<DT> <I>pathName</I> <B>configure</B> ?<I>option</I>? ?<I>value option value ...</I>?
213</I></B>
214<DD> Query or modify the configuration options of the widget.
215If no <I>option</I> is specified, returns a list describing all of
216the available options for <I>pathName</I> (see <B>Tk_ConfigureInfo</B> for
217information on the format of this list).  If <I>option</I> is specified
218with no <I>value</I>, then the command returns a list describing the
219one named option (this list will be identical to the corresponding
220sublist of the value returned if no <I>option</I> is specified).  If
221one or more <I>option-value</I> pairs are specified, then the command
222modifies the given widget option(s) to have the given value(s);  in
223this case the command returns an empty string.
224<I>Option</I> may have any of the values accepted by 
225the <B>canvasprintdialog</B>
226command.
227
228</DL>
229</pre><H2>COMPONENTS</H2>
230<P>
231<pre>
232Name:                   <B>cpb</B>
233Class:                  <B>Canvasprintbox</B>
234</pre>
235<UL>
236The cpb component is the canvas print box for the canvas print dialog.
237See the "canvasprintbox" widget manual entry for details on the cpb
238component item.
239</UL>
240</table>
241
242</pre><H2>EXAMPLE</H2>
243<pre>
244 canvasprintdialog .cpb 
245 .cpb activate
246</pre>
247</pre><H2>AUTHOR</H2>
248Tako Schotanus
249</pre><H2>KEYWORDS</H2>
250canvasprintdialog, canvasprintbox, dialog, widget
251