QPrintDialog

La classe QPrintDialog fournit une bo�te de dialogue de configuration de l'imprimante. Plus d'informations...

 #include <QPrintDialog>

H�ritage

H�rite de QAbstractPrintDialog.

Description d�taill�e

La classe QPrintDialog fournit une bo�te de dialogue configuration de l'imprimante.

La bo�te de dialogue permet aux utilisateurs de modifier les param�tres relatifs au document, comme le format de la feuille et l'orientation, le type d'impression (couleurs ou niveaux de gris), les pages et le nombre de copies � imprimer.

La bo�te de dialogue contient �galement des contr�les permettant aux utilisateurs de choisir parmi les imprimantes disponibles, incluant les imprimantes r�seau configur�es.

Typiquement, les objets QPrintDialog sont construits avec un objet QPrinter et ex�cut�s avec la fonction exec().

 QPrintDialog printDialog(printer, parent);
 if (printDialog.exec() == QDialog::Accepted) {
     // imprimer ...
 }

Si la bo�te de dialogue est accept�e par l'utilisateur, l'objet QPrinter est correctement configur� pour l'impression.

| | |

La bo�te de dialogue d'impression (affich�e ici dans le style Plastique) donne acc�s aux propri�t�s d'impression communes. Sur les plates-formes X11 utilisant le syst�me d'impression CUPS, les param�tres de toutes les imprimantes disponibles peuvent �tre modifi�s via le bouton Propri�t�s de la bo�te de dialogue.

Sur Windows et Mac OS X, la bo�te de dialogue native est utilis�e, ce qui signifie que certaines propri�t�s de QWidget et de QDialog d�finies pour la bo�te de dialogue ne seront pas respect�es. La bo�te de dialogue d'impression native de Mac OS X ne permet pas de fixer les options d'impression, c'est-�-dire que setOptions() et setOption() n'ont pas d'effet.

Dans Qt 4.4, il �tait possible d'utiliser les fonctions statiques pour afficher une fen�tre de type feuille sur Mac OS X. Ce n'est plus le cas dans Qt 4.5. Si vous voulez cr�er des fen�tres de type feuille, utilisez � la place QPageSetupDialog::open().

Voir aussi QPageSetupDialog, QPrinter, Pixelator Example, Order Form Example, Image Viewer Example et Scribble Example.

Propri�t�s

options : PrintDialogOptions

Cette propri�t� contient les diverses options affectant l'aspect de la bo�te de dialogue.

Par d�faut, toutes les options sont d�sactiv�es.

Les options doivent �tre activ�es avant l'affichage de la bo�te de dialogue. Les modifier alors que la bo�te de dialogue est visible ne produira pas toujours d'effet imm�diat (en fonction de l'option et de la plateforme).

Cette classe a �t� introduite dans Qt 4.5.

Fonction d'acc�s

PrintDialogOptions options () const

void setOptions ( PrintDialogOptions options )

Voir aussi setOption() et testOption().

Fonctions membres

QPrintDialog::QPrintDialog ( QPrinter * printer, QWidget * parent = 0 )

Construit une nouvelle bo�te de dialogue d'impression modale pour l'imprimante printer donn�e avec le parent donn�.

QPrintDialog::QPrintDialog ( QWidget * parent = 0 )

Construit une bo�te de dialogue d'impression avec le parent donn�.

QPrintDialog::~QPrintDialog ()

D�truit la bo�te de dialogue.

void QPrintDialog::accepted ( QPrinter * printer ) [signal]

Ce signal est �mis lorsque l'utilisateur accepte les valeurs d�finies dans la bo�te de dialogue d'impression. Le param�tre printer contient l'imprimante sur laquelle les param�tres ont �t� appliqu�s.

void QPrintDialog::done ( int result ) [virtual]

R�impl�mentation de QDialog::done().

Ferme la bo�te de dialogue et affecte result � son code de r�sultat. Si cette bo�te de dialogue est affich�e avec exec(), done() arr�te la boucle d'�v�nements locale et fait retourner result � exec().

Voir aussi QDialog::done().

int QPrintDialog::exec () [virtual]

R�impl�mentation de QAbstractPrintDialog::exec().

void QPrintDialog::open ( QObject * receiver, const char * member )

Il s'agit d'une fonction surcharg�e.

Ouvre la bo�te de dialogue et connecte son signal accepted() au slot sp�cifi� par receiver et member.

Le signal sera d�connect� du slot lorsque la bo�te de dialogue sera ferm�e.

Cette fonction a �t� introduite dans Qt 4.5.

QPrinter * QPrintDialog::printer ()

Renvoie l'imprimante sur laquelle la bo�te de dialogue op�re. Cela peut �tre utile si l'on utilise la m�thode QPrintDialog::open().

Voir aussi setPrinter().

void QPrintDialog::setOption ( PrintDialogOption option, bool on = true )

Active l'option donn�e option si on est vrai ; sinon, d�sactive l'option donn�e.

Voir aussi options et testOption().

void QPrintDialog::setVisible ( bool visible ) [virtual]

R�impl�mentation de QWidget::setVisible().

bool QPrintDialog::testOption ( PrintDialogOption option ) const

Renvoie true si l'option donn�e est active ; sinon, renvoie false.

Voir aussi options et setOption().

Remerciements

Merci � Ilya Diallo pour la traduction, ainsi qu'� Dimitry Ernot, Ali-K?mal Aydin et Claude Leloup pour leur relecture !