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 !