CPrintDialogEx, classe

Article
06/10/2015

Encapsule les services fournis par la feuille de propriétés d'impression Windows 2000.

class CPrintDialogEx : public CCommonDialog

Membres

Constructeurs publics

Nom	Description
CPrintDialogEx::CPrintDialogEx	Construit un objet CPrintDialogEx.

Méthodes publiques

Nom	Description
CPrintDialogEx::CreatePrinterDC	Crée un contexte de périphérique d'imprimante sans afficher la boîte de dialogue d'impression.
CPrintDialogEx::DoModal	Affiche la boîte de dialogue et permet à l'utilisateur d'effectuer des sélections.
CPrintDialogEx::GetCopies	Récupère le nombre de copies demandé.
CPrintDialogEx::GetDefaults	Récupère les valeurs par défaut du périphérique sans afficher une boîte de dialogue.
CPrintDialogEx::GetDeviceName	Récupère le nom de périphérique d'impression actuellement sélectionné.
CPrintDialogEx::GetDevMode	Extrait la structure d' DEVMODE .
CPrintDialogEx::GetDriverName	Extrait le nom du pilote de périphérique défini par le système d'impression.
CPrintDialogEx::GetPortName	Extrait le nom du port imprimante actuellement sélectionné.
CPrintDialogEx::GetPrinterDC	Récupère un handle au contexte de périphérique d'impression.
CPrintDialogEx::PrintAll	Détermine si imprimer toutes les pages du document.
CPrintDialogEx::PrintCollate	Détermine si des copies assemblys sont demandées.
CPrintDialogEx::PrintCurrentPage	Détermine si imprimer la page active du document.
CPrintDialogEx::PrintRange	Détermine si l'impression qu'un intervalle spécifié des pages.
CPrintDialogEx::PrintSelection	Détermine si l'impression actuel uniquement les éléments sélectionnés.

Données membres publiques

Nom	Description
CPrintDialogEx::m_pdex	Une structure utilisée pour personnaliser un objet d' CPrintDialogEx .

Notes

Vous pouvez compter sur l'infrastructure pour gérer de nombreux aspects du processus d'impression de votre application. 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' CPrintDialogEx « comme est » avec le constructeur fourni, ou vous pouvez dériver votre propre classe de boîte de dialogue d' CPrintDialogEx 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' CPrintDialogEx , créez d'abord l'objet à l'aide de le constructeur d' CPrintDialogEx . 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_pdex pour initialiser les valeurs des contrôles de la boîte de dialogue. La structure d' m_pdex est de type PRINTDLGEX. Pour plus d'informations sur cette structure, consultez Kit de développement logiciel Windows.

Si vous ne fournissez pas vos propres handles dans m_pdex 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.

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. Lorsque DoModal retourne, vous pouvez déterminer si l'utilisateur a sélectionné OK, vous appliquez, ou bouton Annuler.

Si l'utilisateur appuyait OK, vous pouvez utiliser les fonctions membres d'CPrintDialogEx pour récupérer l'entrée des informations par utilisateur.

La fonction membre d' CPrintDialogEx::GetDefaults est utile pour récupérer les valeurs par défaut actuelles d'imprimante sans afficher une boîte de dialogue. Cette méthode 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.

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