iwidgets2.2.0 User Commands - canvasprintdialog






NAME

     canvasprintdialog - Create and  manipulate  a  canvas  print
     dialog widget


SYNOPSIS

     canvasprintdialog pathName ?options?


INHERITANCE

     itk::Toplevel <- Dialogshell <- Dialog <- Canvasprintdialog


STANDARD OPTIONS

     activeBackground               background      borderWidthcursor
     foreground      highlightBackground            highlightColorhighlightThickness
     insertBackground               insertBorderWidthinsertOffTimeinsertOnTime
     insertWidth     relief         repeatDelay     repeatInterval
     selectBackground               selectBorderWidthselectForeground

     See the "options" manual entry for details on  the  standard
     options.


ASSOCIATED OPTIONS

     filename        hpagecnt       orient          output
     pagesize        posterize      printcmd        printregion
     vpagecnt

     See the "canvasprintbox" widget manual entry for details  on
     the above associated options.



INHERITED OPTIONS

     buttonBoxPadX   buttonBoxPadY  buttonBoxPos    padX
     padY            separator      thickness

     See the "dialogshell" widget manual entry for details on the
     above inherited options.

     master          modality       title

     See the "shell" widget manual entry for details on the above
     inherited options.


WIDGET-SPECIFIC OPTIONS






DESCRIPTION

     The canvasprintdialog command creates  a  print  dialog  for
     printing  the  contents of a canvas widget to a printer or a
     file. It is possible to specify page orientation, the number
     of  pages  to print the image on and if the output should be
     stretched to fit the page.



METHODS

     The canvasprintdialog command  creates  a  new  Tcl  command
     whose  name is pathName.  This command may be used to invoke
     various operations on the widget.  It has the following gen-
     eral form:

          pathName option ?arg arg ...?

     Option and the args determine the exact behavior of the com-
     mand.    The   following  commands  are  possible  for  can-
     vasprintdialog widgets:


ASSOCIATED METHODS

     getoutput       setcanvas      refresh         print

     See the "canvasprintbox" class manual entry for  details  on
     the associated methods.


INHERITED METHODS

     add             buttonconfigure                defaulthide
     insert          invoke         show

     See the "buttonbox" widget manual entry for details  on  the
     above inherited methods.

     activate        deactivate

     See the "dialogshell" widget manual entry for details on the
     above inherited methods.



WIDGET-SPECIFIC METHODS

     pathName cget option
          Returns the current value of the  configuration  option
          given  by  option.   Option  may have any of the values
          accepted by the canvasprintdialog command.

     pathName configure ?option? ?value option value ...?
          Query  or  modify  the  configuration  options  of  the
          widget.   If  no  option  is  specified, returns a list
          describing all of the available  options  for  pathName
          (see  Tk_ConfigureInfo for information on the format of
          this list).  If option is specified with no value, then
          the  command  returns  a  list describing the one named
          option (this list will be identical to the  correspond-
          ing  sublist  of  the  value  returned  if no option is
          specified).  If one or more  option - value  pairs  are
          specified,  then  the command modifies the given widget
          option(s) to have the given value(s);  in this case the
          command  returns  an empty string.  Option may have any
          of the values accepted by  the  canvasprintdialog  com-
          mand.



COMPONENTS

     Name:           cpb
     Class:          Canvasprintbox

          The cpb component is the canvas print box for the  can-
          vas  print  dialog.   See  the  "canvasprintbox" widget
          manual entry for details on the cpb component item.



EXAMPLE

           option add *textBackground white

           canvasprintdialog .cpb
           .cpb activate



AUTHOR

     Tako Schotanus

     Tako.Schotanus@bouw.tno.nl


KEYWORDS

     canvasprintdialog, canvasprintbox, dialog, widget