~ubuntu-branches/ubuntu/quantal/gtkmm3.0/quantal

 <tbody>

 <tr style="height: 56px;">

  <td style="padding-left: 0.5em;">

  </td>

 </tr>

 </tbody>

<div class="textblock"><p>A <a class="el" href="classGtk_1_1PrintSettings.html" title="A PrintSettings object represents the settings of a print dialog in a system-independent way...">PrintSettings</a> object represents the settings of a print dialog in a system-independent way. </p>

<p>The main use for this object is that once you've printed you can get a settings object that represents the settings the user chose, and the next time you print you can pass that object in so that the user doesn't have to re-set all his settings.</p>

<p>It's also possible to enumerate the settings so that you can easily save the settings for the next time your app runs, or even store them in a document. The predefined keys try to use shared values as much as possible so that moving such a document between systems still works.</p>

</div><hr/><h2>Member Typedef Documentation</h2>

<a class="anchor" id="ac85f89b5d8929a58d9cb8c671b46f504"></a><!-- doxytag: member="Gtk::PrintSettings::SlotForeach" ref="ac85f89b5d8929a58d9cb8c671b46f504" args="" -->

<div class="memitem">

<div class="memdoc">

 

<p>Copies a <a class="el" href="classGtk_1_1PrintSettings.html" title="A PrintSettings object represents the settings of a print dialog in a system-independent way...">Gtk::PrintSettings</a> object. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>A newly allocated copy of <em>other</em>. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Looks up the string value associated with <em>key</em>. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">key</td><td>A key. </td></tr>

 

<p>Returns the boolean represented by the value that is associated with <em>key</em>. </p>

<p>The string "true" represents <code>true</code>, any other string <code>false</code>.</p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">key</td><td>A key. </td></tr>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_COLLATE. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>Whether to collate the printed pages. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_DEFAULT_SOURCE. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The default source. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_DITHER. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The dithering that is used. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Returns the double value associated with <em>key</em>, or 0. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">key</td><td>A key. </td></tr>

 

<p>Returns the floating point number represented by the value that is associated with <em>key</em>, or <em>default_val</em> if the value does not represent a floating point number. </p>

<p>Floating point numbers are parsed with Glib::ascii_strtod().</p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">key</td><td>A key. </td></tr>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_DUPLEX. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>Whether to print the output in duplex. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_FINISHINGS. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The finishings. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Returns the integer value of <em>key</em>, or 0. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">key</td><td>A key. </td></tr>

<div class="memdoc">

 

<p>Returns the value of <em>key</em>, interpreted as an integer, or the default value. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">key</td><td>A key. </td></tr>

 

<p>Returns the value associated with <em>key</em>, interpreted as a length. </p>

<p>The returned value is converted to <em>units</em>.</p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">key</td><td>A key. </td></tr>

 

<p>Gets the value of Gtk::PRINT_SETTINGS_MEDIA_TYPE. </p>

<p>The set of media types is defined in PWG 5101.1-2002 PWG.</p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The media type. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_N_COPIES. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The number of copies to print. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_NUMBER_UP. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The number of pages per sheet. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Get the value of Gtk::PRINT_SETTINGS_ORIENTATION, converted to a <a class="el" href="group__gtkmmEnums.html#ga466045b8876a149482ab0034c53302bf">Gtk::PageOrientation</a>. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The orientation. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_OUTPUT_BIN. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The output bin. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_PAGE_SET. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The set of pages to print. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_PAPER_HEIGHT, converted to <em>unit</em>. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">unit</td><td>The unit for the return value. </td></tr>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_PAPER_FORMAT, converted to a <a class="el" href="classGtk_1_1PaperSize.html" title="PaperSize handles paper sizes.">Gtk::PaperSize</a>. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The paper size. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_PAPER_FORMAT, converted to a <a class="el" href="classGtk_1_1PaperSize.html" title="PaperSize handles paper sizes.">Gtk::PaperSize</a>. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The paper size. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_PAPER_WIDTH, converted to <em>unit</em>. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">unit</td><td>The unit for the return value. </td></tr>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_PRINT_PAGES. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>Which pages to print. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Convenience function to obtain the value of Gtk::PRINT_SETTINGS_PRINTER. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The printer name. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_PRINTER_LPI. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The resolution in lpi (lines per inch). </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_QUALITY. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The print quality. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_RESOLUTION. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The resolution in dpi. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_RESOLUTION_X. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The horizontal resolution in dpi. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_RESOLUTION_Y. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The vertical resolution in dpi. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_REVERSE. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>Whether to reverse the order of the printed pages. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_SCALE. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>The scale in percent. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Gets the value of Gtk::PRINT_SETTINGS_USE_COLOR. </p>

<dl class="return"><dt><b>Returns:</b></dt><dd>Whether to use color. </dd></dl>

 

</div>

<div class="memdoc">

 

<p>Returns <code>true</code>, if a value is associated with <em>key</em>. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">key</td><td>A key. </td></tr>

  </dd>

</dl>

<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> on success</dd></dl>

 

</div>

</div>

<div class="memdoc">

 

<p>This function adds the print settings from <em>settings</em> to <em>key_file</em>. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">key_file</td><td>The <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1KeyFile.html">Glib::KeyFile</a> to save the print settings to. </td></tr>

<div class="memdoc">

 

<p>This function adds the print settings from <em>settings</em> to <em>key_file</em>, in the "Print Settings" group. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">key_file</td><td>The <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1KeyFile.html">Glib::KeyFile</a> to save the print settings to. </td></tr>

<div class="memdoc">

 

<p>Associates <em>value</em> with <em>key</em>. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">key</td><td>A key. </td></tr>

<div class="memdoc">

 

<p>Sets <em>key</em> to a boolean value. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">key</td><td>A key. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_COLLATE. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">collate</td><td>Whether to collate the output. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_DEFAULT_SOURCE. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">default_source</td><td>The default source. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_DITHER. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">dither</td><td>The dithering that is used. </td></tr>

<div class="memdoc">

 

<p>Sets <em>key</em> to a double value. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">key</td><td>A key. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_DUPLEX. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">duplex</td><td>A <a class="el" href="group__gtkmmEnums.html#ga50af48ce5ffc122b50924230939b78e3">Gtk::PrintDuplex</a> value. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_FINISHINGS. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">finishings</td><td>The finishings. </td></tr>

<div class="memdoc">

 

<p>Sets <em>key</em> to an integer value. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">key</td><td>A key. </td></tr>

<div class="memdoc">

 

<p>Associates a length in units of <em>unit</em> with <em>key</em>. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">key</td><td>A key. </td></tr>

 

<p>Sets the value of Gtk::PRINT_SETTINGS_MEDIA_TYPE. </p>

<p>The set of media types is defined in PWG 5101.1-2002 PWG.</p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">media_type</td><td>The media type. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_N_COPIES. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">num_copies</td><td>The number of copies. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_NUMBER_UP. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">number_up</td><td>The number of pages per sheet. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_ORIENTATION. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">orientation</td><td>A page orientation. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_OUTPUT_BIN. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">output_bin</td><td>The output bin. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_PAGE_SET. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">page_set</td><td>A <a class="el" href="group__gtkmmEnums.html#ga26726525983cb55ec0633b7485143cf3">Gtk::PageSet</a> value. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_PAPER_HEIGHT. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">height</td><td>The paper height. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_PAPER_FORMAT, Gtk::PRINT_SETTINGS_PAPER_WIDTH and Gtk::PRINT_SETTINGS_PAPER_HEIGHT. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">paper_size</td><td>A paper size. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_PAPER_WIDTH. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">width</td><td>The paper width. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_PRINT_PAGES. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">pages</td><td>A <a class="el" href="group__gtkmmEnums.html#ga003abcb0f8711428f85e3c54c68ee25e">Gtk::PrintPages</a> value. </td></tr>

<div class="memdoc">

 

<p>Convenience function to set Gtk::PRINT_SETTINGS_PRINTER to <em>printer</em>. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">printer</td><td>The printer name. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_PRINTER_LPI. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">lpi</td><td>The resolution in lpi (lines per inch). </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_QUALITY. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">quality</td><td>A <a class="el" href="group__gtkmmEnums.html#gab282abd83fff59a70ddba9e26cd30e04">Gtk::PrintQuality</a> value. </td></tr>

<div class="memdoc">

 

<p>Sets the values of Gtk::PRINT_SETTINGS_RESOLUTION, Gtk::PRINT_SETTINGS_RESOLUTION_X and Gtk::PRINT_SETTINGS_RESOLUTION_Y. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">resolution</td><td>The resolution in dpi. </td></tr>

<div class="memdoc">

 

<p>Sets the values of Gtk::PRINT_SETTINGS_RESOLUTION, Gtk::PRINT_SETTINGS_RESOLUTION_X and Gtk::PRINT_SETTINGS_RESOLUTION_Y. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">resolution_x</td><td>The horizontal resolution in dpi. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_REVERSE. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">reverse</td><td>Whether to reverse the output. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_SCALE. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">scale</td><td>The scale in percent. </td></tr>

<div class="memdoc">

 

<p>Sets the value of Gtk::PRINT_SETTINGS_USE_COLOR. </p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">use_color</td><td>Whether to use color. </td></tr>

 

<p>Removes any value associated with <em>key</em>. </p>

<p>This has the same effect as setting the value to <code>0</code>.</p>

<dl><dt><b>Parameters:</b></dt><dd>

  <table class="params">

    <tr><td class="paramname">key</td><td>A key. </td></tr>

<li>gtkmm/printsettings.h</li>

</ul>

</div>

<a href="http://www.doxygen.org/index.html">

<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.4 </small></address>

</body>