Sophie

Sophie

distrib > Mandriva > 2010.0 > i586 > media > contrib-release > by-pkgid > a6711891ce757817bba854bf3f25205a > files > 2164

qtjambi-doc-4.3.3-3mdv2008.1.i586.rpm

<class name="QPrintDialog" doc="/**
&lt;p&gt;The &lt;a href=&quot;QPrintDialog.html#QPrintDialog(com.trolltech.qt.gui.QPrinter, com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QPrintDialog&lt;/tt&gt;&lt;/a&gt; class provides a dialog for specifying the printer's configuration.&lt;/p&gt;
&lt;p&gt;The dialog allows users to change document-related settings, such as the paper size and orientation, type of print (color or grayscale), range of pages, and number of copies to print.&lt;/p&gt;
&lt;p&gt;Controls are also provided to enable users to choose from the printers available, including any configured network printers.&lt;/p&gt;
&lt;p&gt;Typically, &lt;a href=&quot;QPrintDialog.html#QPrintDialog(com.trolltech.qt.gui.QPrinter, com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QPrintDialog&lt;/tt&gt;&lt;/a&gt; objects are constructed with a &lt;a href=&quot;QPrinter.html&quot;&gt;&lt;tt&gt;QPrinter&lt;/tt&gt;&lt;/a&gt; object, and executed using the &lt;a href=&quot;QPrintDialog.html#exec()&quot;&gt;&lt;tt&gt;exec&lt;/tt&gt;&lt;/a&gt; function.&lt;/p&gt;
&lt;pre&gt;    QPrintDialog printDialog(printer, parent);
    if (printDialog.exec() == QDialog::Accepted) {
        &lt;span class=&quot;comment&quot;&gt;// print ...&lt;/span&gt;
    }&lt;/pre&gt;
&lt;p&gt;If the dialog is accepted by the user, the &lt;a href=&quot;QPrinter.html&quot;&gt;&lt;tt&gt;QPrinter&lt;/tt&gt;&lt;/a&gt; object is correctly configured for printing.&lt;/p&gt;
    &lt;table align=&quot;center&quot;&gt;
    &lt;tr&gt;&lt;td&gt;
    &lt;p&gt;&lt;img src=&quot;%2E%2E/images/plastique-printdialog.png&quot; /&gt;&lt;/p&gt;
    &lt;/td&gt;&lt;td&gt;
    &lt;p&gt;&lt;img src=&quot;%2E%2E/images/plastique-printdialog-properties.png&quot; /&gt;&lt;/p&gt;
    &lt;/td&gt;&lt;/tr&gt;
    &lt;/table&gt;
    &lt;p&gt;The printer dialog (shown above in Plastique style) enables access to common printing properties. On X11 platforms that use the CUPS printing system, the settings for each available printer can be modified via the dialog's &lt;b&gt;Properties&lt;/b&gt; push button.&lt;/p&gt;
&lt;p&gt;On Windows and Mac OS X, the native print dialog is used, which means that some &lt;a href=&quot;QWidget.html#QWidget(com.trolltech.qt.gui.QWidget, com.trolltech.qt.core.Qt.WindowFlags)&quot;&gt;&lt;tt&gt;QWidget&lt;/tt&gt;&lt;/a&gt; and &lt;a href=&quot;QDialog.html#QDialog(com.trolltech.qt.gui.QWidget, com.trolltech.qt.core.Qt.WindowFlags)&quot;&gt;&lt;tt&gt;QDialog&lt;/tt&gt;&lt;/a&gt; properties set on the dialog won't be respected. In addition, the native print dialog on Mac OS X does not support setting printer options, i.e&amp;#x2e; QAbstractPrintDialog::setEnabledOptions() and QAbstractPrintDialog::addEnabledOption() have no effect.&lt;/p&gt;

@see &lt;a href=&quot;QPageSetupDialog.html&quot;&gt;&lt;tt&gt;QPageSetupDialog&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QPrinter.html&quot;&gt;&lt;tt&gt;QPrinter&lt;/tt&gt;&lt;/a&gt;
@see Pixelator Example&lt;/tt&gt;
@see Order Form Example&lt;/tt&gt;
@see Image Viewer Example&lt;/tt&gt;
@see Scribble Example&lt;/tt&gt; */">
    <signal name="protected final void accepted()" doc="/**
&lt;p&gt;This signal is emitted when the dialog has been accepted either by the user or by calling &lt;a href=&quot;QDialog.html#accept()&quot;&gt;&lt;tt&gt;accept&lt;/tt&gt;&lt;/a&gt; or &lt;a href=&quot;QDialog.html#done(int)&quot;&gt;&lt;tt&gt;done&lt;/tt&gt;&lt;/a&gt; with the QDialog::Accepted argument.&lt;/p&gt;
&lt;p&gt;Note that this signal is &lt;i&gt;not&lt;/i&gt; emitted when hiding the dialog with &lt;a href=&quot;QWidget.html#hide()&quot;&gt;&lt;tt&gt;hide&lt;/tt&gt;&lt;/a&gt; or &lt;a href=&quot;QDialog.html#setVisible(boolean)&quot;&gt;&lt;tt&gt;setVisible&lt;/tt&gt;&lt;/a&gt;(false). This includes deleting the dialog while it is visible.&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signature:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;See Also:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;a href=&quot;QPrintDialog.html#finished(int)&quot;&gt;&lt;tt&gt;finished&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QPrintDialog.html#rejected()&quot;&gt;&lt;tt&gt;rejected&lt;/tt&gt;&lt;/a&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <signal name="protected final void customContextMenuRequested(com.trolltech.qt.core.QPoint pos)" doc="/**
&lt;p&gt;This signal is emitted when the widget's &lt;a href=&quot;QWidget.html#contextMenuPolicy()&quot;&gt;&lt;tt&gt;contextMenuPolicy&lt;/tt&gt;&lt;/a&gt; is Qt::CustomContextMenu, and the user has requested a context menu on the widget. The position &lt;tt&gt;pos&lt;/tt&gt; is the position of the context menu event that the widget receives. Normally this is in widget coordinates. The exception to this rule is &lt;a href=&quot;QAbstractScrollArea.html&quot;&gt;&lt;tt&gt;QAbstractScrollArea&lt;/tt&gt;&lt;/a&gt; and its subclasses that map the context menu event to coordinates of the viewport()&lt;/tt&gt; .&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signatures:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot(com.trolltech.qt.core.QPoint pos)&lt;/tt&gt;&lt;/dd&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;See Also:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;a href=&quot;QWidget.html#mapToGlobal(com.trolltech.qt.core.QPoint)&quot;&gt;&lt;tt&gt;mapToGlobal&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QMenu.html&quot;&gt;&lt;tt&gt;QMenu&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QWidget.html#contextMenuPolicy()&quot;&gt;&lt;tt&gt;contextMenuPolicy&lt;/tt&gt;&lt;/a&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <signal name="protected final void finished(int result)" doc="/**
&lt;p&gt;This signal is emitted when the dialog's &lt;tt&gt;result&lt;/tt&gt; code has been set, either by the user or by calling &lt;a href=&quot;QDialog.html#done(int)&quot;&gt;&lt;tt&gt;done&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QDialog.html#accept()&quot;&gt;&lt;tt&gt;accept&lt;/tt&gt;&lt;/a&gt;, or &lt;a href=&quot;QDialog.html#reject()&quot;&gt;&lt;tt&gt;reject&lt;/tt&gt;&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;Note that this signal is &lt;i&gt;not&lt;/i&gt; emitted when hiding the dialog with &lt;a href=&quot;QWidget.html#hide()&quot;&gt;&lt;tt&gt;hide&lt;/tt&gt;&lt;/a&gt; or &lt;a href=&quot;QDialog.html#setVisible(boolean)&quot;&gt;&lt;tt&gt;setVisible&lt;/tt&gt;&lt;/a&gt;(false). This includes deleting the dialog while it is visible.&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signatures:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot(int result)&lt;/tt&gt;&lt;/dd&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;See Also:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;a href=&quot;QPrintDialog.html#accepted()&quot;&gt;&lt;tt&gt;accepted&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QPrintDialog.html#rejected()&quot;&gt;&lt;tt&gt;rejected&lt;/tt&gt;&lt;/a&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <signal name="protected final void rejected()" doc="/**
&lt;p&gt;This signal is emitted when the dialog has been rejected either by the user or by calling &lt;a href=&quot;QDialog.html#reject()&quot;&gt;&lt;tt&gt;reject&lt;/tt&gt;&lt;/a&gt; or &lt;a href=&quot;QDialog.html#done(int)&quot;&gt;&lt;tt&gt;done&lt;/tt&gt;&lt;/a&gt; with the QDialog::Rejected argument.&lt;/p&gt;
&lt;p&gt;Note that this signal is &lt;i&gt;not&lt;/i&gt; emitted when hiding the dialog with &lt;a href=&quot;QWidget.html#hide()&quot;&gt;&lt;tt&gt;hide&lt;/tt&gt;&lt;/a&gt; or &lt;a href=&quot;QDialog.html#setVisible(boolean)&quot;&gt;&lt;tt&gt;setVisible&lt;/tt&gt;&lt;/a&gt;(false). This includes deleting the dialog while it is visible.&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signature:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;See Also:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;a href=&quot;QPrintDialog.html#finished(int)&quot;&gt;&lt;tt&gt;finished&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QPrintDialog.html#accepted()&quot;&gt;&lt;tt&gt;accepted&lt;/tt&gt;&lt;/a&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <method name="public QPrintDialog(com.trolltech.qt.gui.QPrinter printer, com.trolltech.qt.gui.QWidget parent)" doc="/**
&lt;p&gt;Constructs a new modal printer dialog for the given &lt;tt&gt;printer&lt;/tt&gt; with the given &lt;tt&gt;parent&lt;/tt&gt;.&lt;/p&gt;
 */"/>
    <method name="public QPrintDialog(com.trolltech.qt.gui.QPrinter printer)" doc="/**
&lt;p&gt;Equivalent to &lt;a href=&quot;QPrintDialog.html#QPrintDialog(com.trolltech.qt.gui.QPrinter, com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;QPrintDialog&lt;/tt&gt;&lt;/a&gt;(&lt;tt&gt;printer&lt;/tt&gt;, 0). */"/>
    <method name="public int exec()" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
</class>