Partager via


CPrintDialog, classe

Encapsule les services fournis par la boîte de dialogue commune windows pour imprimer.

class CPrintDialog : public CCommonDialog

Membres

Constructeurs publics

Nom

Description

CPrintDialog::CPrintDialog

Construit un objet CPrintDialog.

Méthodes publiques

Nom

Description

CPrintDialog::CreatePrinterDC

Crée un contexte de périphérique d'imprimante sans afficher la boîte de dialogue d'impression.

CPrintDialog::DoModal

Affiche la boîte de dialogue et permet à l'utilisateur d'effectuer une sélection.

CPrintDialog::GetCopies

Récupère le nombre de copies demandé.

CPrintDialog::GetDefaults

Récupère les valeurs par défaut du périphérique sans afficher une boîte de dialogue.

CPrintDialog::GetDeviceName

Récupère le nom de périphérique d'impression actuellement sélectionné.

CPrintDialog::GetDevMode

Extrait la structure d' DEVMODE .

CPrintDialog::GetDriverName

Extrait le nom du pilote d'imprimante actuellement sélectionné.

CPrintDialog::GetFromPage

Extrait la page de début de la plage d'impression.

CPrintDialog::GetPortName

Extrait le nom du port imprimante actuellement sélectionné.

CPrintDialog::GetPrinterDC

Récupère un handle au contexte de périphérique d'impression.

CPrintDialog::GetToPage

Extrait la page final de l'intervalle d'impression.

CPrintDialog::PrintAll

Détermine si imprimer toutes les pages du document.

CPrintDialog::PrintCollate

Détermine si des copies assemblys sont demandées.

CPrintDialog::PrintRange

Détermine si l'impression qu'un intervalle spécifié des pages.

CPrintDialog::PrintSelection

Détermine si l'impression actuel uniquement les éléments sélectionnés.

Données membres publiques

Nom

Description

CPrintDialog::m_pd

Une structure utilisée pour personnaliser un objet d' CPrintDialog .

Notes

Les boîtes de dialogue courantes d'impression offrent un moyen simple d'implémenter des boîtes de dialogue d'impression et de configuration de l'impression d'une manière conformes aux normes windows.

Notes

La classe d' CPrintDialogEx encapsule les services fournis par la feuille de propriétés d'impression Windows 2000.Pour plus d'informations consultez la vue d'ensemble de CPrintDialogEx .

La fonctionnalité d'CPrintDialog est remplacée par celle de CPageSetupDialog, conçue pour vous donner une boîte de dialogue commune pour la configuration de l'impression et la disposition.

Vous pouvez compter sur l'infrastructure pour gérer de nombreux aspects du processus d'impression de votre application. Dans ce cas, l'infrastructure affiche automatiquement la boîte de dialogue commune windows pour imprimer. Vous pouvez également avoir l'impression de handle d'infrastructure pour votre application sans remplacer la boîte de dialogue courante d'impression avec votre propre boîte de dialogue d'impression. Pour plus d'informations sur l'utilisation de l'infrastructure pour gérer des travaux d'impression, consultez l'article imprimer.

Si votre application doit gérer l'impression sans participation de l'infrastructure, vous pouvez utiliser la classe d' CPrintDialog « comme est » avec le constructeur fourni, ou vous pouvez dériver votre propre classe de boîte de dialogue d' CPrintDialog et écrire un constructeur pour l'adapter à vos besoins. Dans les deux cas, ces boîtes de dialogue se comporteront comme les boîtes de dialogue MFC standard car elles sont dérivées de la classe CCommonDialog.

Pour utiliser un objet d' CPrintDialog , créez d'abord l'objet à l'aide de le constructeur d' CPrintDialog . Une fois la boîte de dialogue a été générée, vous pouvez définir ou modifier les valeurs dans la structure de m_pd pour initialiser les valeurs des contrôles de la boîte de dialogue. La structure d' m_pd est de type PRINTDLG. Pour plus d'informations sur cette structure, consultez Kit de développement logiciel Windows.

Si vous ne fournissez pas vos propres handles dans m_pd pour les membres de hDevMode et de hDevNames , veillez à appeler la fonction Windows GlobalFree pour les handles lorsque vous avez terminé avec la boîte de dialogue. Lorsque vous utilisez l'implémentation de configuration de l'impression de l'infrastructure fournie par CWinApp::OnFilePrintSetup, vous ne devez pas libérer les handles. Les handles sont mis à jour par CWinApp et est libéré dans le destructeur d'CWinApp. Il n'est nécessaire de libérer les handles lors de l'utilisation CPrintDialog autonome.

Après avoir initialisé les contrôles de boîte de dialogue, appelez la fonction membre d' DoModal pour afficher la boîte de dialogue et autoriser l'utilisateur à des options d'impression sélectionnées. DoModal retourne si l'utilisateur a sélectionné le bouton OK d'IDOK() ou d'annulation (IDCANCEL).

Si DoModal retourne IDOK, vous pouvez utiliser l'une des fonctions membres d'CPrintDialog pour récupérer l'entrée des informations par utilisateur.

La fonction membre d' CPrintDialog::GetDefaults est utile pour récupérer les valeurs par défaut actuelles d'imprimante sans afficher une boîte de dialogue. Cette fonction membre ne requiert aucune intervention de l'utilisateur.

Vous pouvez utiliser la fonction de CommDlgExtendedError windows pour déterminer si une erreur s'est produite pendant l'initialisation de la boîte de dialogue et pour en savoir plus sur l'erreur. Pour plus d'informations sur cette fonction, consultez Kit de développement logiciel Windows.

CPrintDialog repose sur le fichier de COMMDLG.DLL fourni avec les versions de Windows 3,1 et versions ultérieures.

Pour personnaliser la boîte de dialogue, dérivez une classe d' CPrintDialog, fournissez un modèle de boîte de dialogue personnalisé, puis ajoutez une table des messages pour traiter les messages de notification des contrôles étendus. Tous les messages non-traités doivent être passés en fonction de la classe de base. Personnaliser la fonction de raccordement n'est pas obligatoire.

Pour traiter le même selon que de message différemment la boîte de dialogue est copie ou configuration de l'impression, vous devez dériver une classe pour chaque boîte de dialogue. Vous devez substituer la fonction d' AttachOnSetup windows, qui gère la création d'une boîte de dialogue lorsque le bouton de configuration de l'impression est sélectionné dans une boîte de dialogue d'impression.

Pour plus d'informations sur l'utilisation CPrintDialog, consultez Classes de boîte de dialogue courantes.

Hiérarchie d'héritage

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

CPrintDialog

Configuration requise

Header: afxdlgs.h

Voir aussi

Référence

CCommonDialog, classe

Graphique de la hiérarchie

CPrintInfo, structure

Concepts

DIBLOOK exemple MFC