CPrintDialogEx Sınıfı

Windows Print özellik sayfası tarafından sağlanan hizmetleri kapsüller.

Sözdizimi

class CPrintDialogEx : public CCommonDialog

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CPrintDialogEx::CPrintDialogEx	Bir CPrintDialogEx nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CPrintDialogEx::CreatePrinterDC	Yazdır iletişim kutusunu görüntülemeden bir yazıcı cihazı bağlamı oluşturur.
CPrintDialogEx::D oModal	İletişim kutusunu görüntüler ve kullanıcının seçim yapmasına izin verir.
CPrintDialogEx::GetCopies	İstenen kopya sayısını alır.
CPrintDialogEx::GetDefaults	bir iletişim kutusu görüntülemeden cihaz varsayılanlarını alır.
CPrintDialogEx::GetDeviceName	Seçili durumdaki yazıcı cihazının adını alır.
CPrintDialogEx::GetDevMode	Yapıyı DEVMODE alır.
CPrintDialogEx::GetDriverName	Sistem tanımlı yazıcı aygıt sürücüsünün adını alır.
CPrintDialogEx::GetPortName	Seçili durumdaki yazıcı bağlantı noktasının adını alır.
CPrintDialogEx::GetPrinterDC	Yazıcı cihazı bağlamı için bir tanıtıcı alır.
CPrintDialogEx::P rintAll	Belgenin tüm sayfalarının yazdırılıp yazdırılmayacağını belirler.
CPrintDialogEx::P rintCollate	Harmanlanmış kopyaların istenip istenmediğini belirler.
CPrintDialogEx::P rintCurrentPage	Belgenin geçerli sayfasının yazdırılıp yazdırılmayacağını belirler.
CPrintDialogEx::P rintRange	Yalnızca belirtilen sayfa aralığının yazdırılıp yazdırılmayacağını belirler.
CPrintDialogEx::P rintSelection	Yalnızca seçili durumdaki öğelerin yazdırılıp yazdırılmayacağını belirler.

Ortak Veri Üyeleri

Veri Akışı Adı	Açıklama
CPrintDialogEx::m_pdex	Nesneyi özelleştirmek için kullanılan bir CPrintDialogEx yapı.

Açıklamalar

Uygulamanız için yazdırma işleminin birçok yönünü işlemek için çerçeveye güvenebilirsiniz. Yazdırma görevlerini işlemek için çerçeveyi kullanma hakkında daha fazla bilgi için Yazdırma makalesine bakın.

Uygulamanızın çerçevenin katılımı olmadan yazdırmayı işlemesini istiyorsanız, sağlanan oluşturucuyla "olduğu gibi" sınıfını kullanabilir CPrintDialogEx veya kendi iletişim sınıfınızı CPrintDialogEx türetebilir ve gereksinimlerinize uygun bir oluşturucu yazabilirsiniz. Her iki durumda da, bu iletişim kutuları sınıfından CCommonDialogtüretildiği için standart MFC iletişim kutuları gibi davranır.

Bir CPrintDialogEx nesneyi kullanmak için önce oluşturucuyu CPrintDialogEx kullanarak nesnesini oluşturun. İletişim kutusu oluşturulduktan sonra, iletişim kutusunun denetimlerinin değerlerini başlatmak için m_pdex yapısındaki herhangi bir değeri ayarlayabilir veya değiştirebilirsiniz. Yapı m_pdex PRINTDLGEX türündedir. Bu yapı hakkında daha fazla bilgi için bkz. Windows SDK'sı.

ve hDevNames üyeleri için hDevMode kendi tanıtıcılarınızı m_pdex sağlamazsanız, iletişim kutusuyla işiniz bittiğinde bu tanıtıcılar için Windows işlevini GlobalFree çağırdığınızdan emin olun.

İletişim kutusu denetimlerini başlatdıktan sonra, iletişim kutusunu görüntülemek için üye işlevini çağırın DoModal ve kullanıcının yazdırma seçeneklerini belirlemesine izin verin. Döndürdüğünde DoModal , kullanıcının Tamam, Uygula veya İptal düğmesini seçerek belirleyebilirsiniz.

Kullanıcı Tamam'a bastıysa, kullanıcı tarafından bilgi girişini almak için 'nin üye işlevlerini kullanabilirsiniz CPrintDialogEx.

CPrintDialogEx::GetDefaults Üye işlevi, bir iletişim kutusu görüntülemeden geçerli yazıcı varsayılanlarını almak için kullanışlıdır. Bu yöntem kullanıcı etkileşimi gerektirmez.

İletişim kutusunun başlatılması sırasında bir hata oluşup oluşmadığını belirlemek ve hata hakkında daha fazla bilgi edinmek için Windows CommDlgExtendedError işlevini kullanabilirsiniz. Bu işlev hakkında daha fazla bilgi için bkz. Windows SDK' sı.

kullanma CPrintDialogExhakkında daha fazla bilgi için bkz . Ortak İletişim Kutusu Sınıfları.

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CDialog

IObjectWithSite

IPrintDialogCallback

CCommonDialog

CPrintDialogEx

Gereksinimler

Üst bilgi: afxdlgs.h

CPrintDialogEx::CPrintDialogEx

Bir Windows Print özellik sayfası oluşturur.

CPrintDialogEx(
    DWORD dwFlags = PD_ALLPAGES | PD_USEDEVMODECOPIES | PD_NOPAGENUMS       | PD_HIDEPRINTTOFILE | PD_NOSELECTION | PD_NOCURRENTPAGE,
    CWnd* pParentWnd = NULL);

Parametreler

dwFlags
İletişim kutusunun ayarlarını özelleştirmek için kullanabileceğiniz bir veya daha fazla bayrak, bit düzeyinde OR işleci kullanılarak birleştirilir. Örneğin, PD_ALLPAGES bayrağı varsayılan yazdırma aralığını belgenin tüm sayfalarına ayarlar. Bu bayraklar hakkında daha fazla bilgi için Windows SDK'sında PRINTDLGEX yapısına bakın.

pParentWnd
İletişim kutusunun üst veya sahip penceresinin işaretçisi.

Açıklamalar

Bu üye işlevi yalnızca nesnesini oluşturur. DoModal İletişim kutusunu görüntülemek için üye işlevini kullanın.

CPrintDialogEx::CreatePrinterDC

DEVMODE ve DEVNAMES yapılarından bir yazıcı cihazı bağlamı (DC) oluşturur.

HDC CreatePrinterDC();

Dönüş Değeri

Yeni oluşturulan yazıcı cihazı bağlamı için tanıtıcı.

Açıklamalar

Döndürülen DC, m_pdex üyesinde hDC de depolanır.

Bu DC'nin geçerli yazıcı DC olduğu varsayılır ve daha önce edinilen diğer yazıcı DC'leri silinmelidir. Bu işlev, Yazdır iletişim kutusu görüntülenmeden çağrılabilir ve sonuçta elde edilen DC kullanılabilir.

CPrintDialogEx::D oModal

Windows Print özellik sayfasını görüntülemek ve kullanıcının kopya sayısı, sayfa aralığı ve kopyaların harmanlanıp harmanlanmaması gibi çeşitli yazdırma seçeneklerini belirlemesine izin vermek için bu işlevi çağırın.

virtual INT_PTR DoModal();

Dönüş Değeri

INT_PTR dönüş değeri aslında bir HRESULT değeridir. Windows SDK'sında PrintDlgEx'teki Dönüş Değerleri bölümüne bakın.

Açıklamalar

Yapının üyelerini m_pdex ayarlayarak çeşitli yazdırma iletişim kutusu seçeneklerini başlatmak istiyorsanız, çağrısından önce DoModalancak iletişim kutusu nesnesi oluşturulduğunda bunu yapmanız gerekir.

çağrısı DoModalyaptıktan sonra, kullanıcı tarafından iletişim kutusuna ayarları veya bilgi girişini almak için diğer üye işlevlerini çağırabilirsiniz.

çağrılırken DoModalPD_RETURNDC bayrağı kullanılırsa, m_pdex üyesinde hDC bir yazıcı DC'si döndürülür. Bu DC, çağıranın CPrintDialogExDeleteDC çağrısıyla serbest olmalıdır.

CPrintDialogEx::GetCopies

İstenen kopya sayısını almak için çağrısından DoModal sonra bu işlevi çağırın.

int GetCopies() const;

Dönüş Değeri

İstenen kopya sayısı.

CPrintDialogEx::GetDefaults

İletişim kutusu görüntülemeden varsayılan yazıcının cihaz varsayılanlarını almak için bu işlevi çağırın.

BOOL GetDefaults();

Dönüş Değeri

Başarılı olursa DOĞRU, aksi takdirde YANLIŞ.

Açıklamalar

DEVMODE ve DEVNAMES yapılarından bir yazıcı cihazı bağlamı (DC) oluşturur.

GetDefaults Print özellik sayfasını görüntülemez. Bunun yerine, sistem varsayılan yazıcısı için başlatılan DEVMODE ve DEVNAMES yapılarını işlemek üzere m_pdex ve hDevMode üyelerini ayarlarhDevNames. hDevMode Hem hem de hDevNames NULL olmalıdır veya GetDefaults başarısız olur.

PD_RETURNDC bayrağı ayarlanırsa, bu işlev çağırana yalnızca ve hDevMode (ve m_pdex.hDevModeiçindem_pdex.hDevNames) döndürmezhDevNames, aynı zamanda içinde bir yazıcı DC'sini m_pdex.hDCdöndürür. Çağıranın sorumluluğu, yazıcı DC'sini silmek ve nesneyle işiniz bittiğinde tanıtıcılarda Windows GlobalFree işlevini çağırmaktır CPrintDialogEx .

CPrintDialogEx::GetDeviceName

Seçili durumdaki yazıcının adını almak için DoModal'ı çağırdıktan sonra veya varsayılan yazıcının adını almak için GetDefaults'u çağırdıktan sonra bu işlevi çağırın.

CString GetDeviceName() const;

Dönüş Değeri

Seçili durumdaki yazıcının adı.

Açıklamalar

CDC::CreateDC çağrısında değeri lpszDeviceName olarak tarafından GetDeviceName döndürülen nesneye bir işaretçi CString kullanın.

CPrintDialogEx::GetDevMode

Yazdırma cihazı hakkındaki bilgileri almak için DoModal veya GetDefaults çağrısı yaptıktan sonra bu işlevi çağırın.

LPDEVMODE GetDevMode() const;

Dönüş Değeri

Cihaz başlatma ve yazdırma sürücüsünün ortamı hakkında bilgi içeren DEVMODE veri yapısı. Windows SDK'sında açıklanan Windows GlobalUnlock işleviyle bu yapı tarafından alınan belleğin kilidini açmanız gerekir.

CPrintDialogEx::GetDriverName

Sistem tanımlı yazıcı aygıt sürücüsünün adını almak için DoModal veya GetDefaults çağrısı yaptıktan sonra bu işlevi çağırın.

CString GetDriverName() const;

Dönüş Değeri

CString Sistem tanımlı sürücü adını belirten bir.

Açıklamalar

CDC::CreateDC çağrısında lpszDriverName değeri olarak tarafından GetDriverName döndürülen nesneye yönelik bir işaretçi CString kullanın.

CPrintDialogEx::GetPortName

Seçili durumdaki yazıcı bağlantı noktasının adını almak için DoModal veya GetDefaults çağrısı yaptıktan sonra bu işlevi çağırın.

CString GetPortName() const;

Dönüş Değeri

Seçili durumdaki yazıcı bağlantı noktasının adı.

CPrintDialogEx::GetPrinterDC

Yazıcı cihazı bağlamı için bir tanıtıcı döndürür.

HDC GetPrinterDC() const;

Dönüş Değeri

Yazıcı cihaz bağlamı için bir tanıtıcı.

Açıklamalar

Kullanmayı bitirdiğinizde cihaz bağlamını silmek için Windows DeleteDC işlevini çağırmanız gerekir.

CPrintDialogEx::m_pdex

Üyeleri iletişim kutusu nesnesinin özelliklerini depolayan PRINTDLGEX yapısı.

PRINTDLGEX m_pdex;

Açıklamalar

Nesneyi CPrintDialogEx oluşturdıktan sonra, DoModal üye işlevini çağırmadan önce iletişim kutusunun çeşitli yönlerini ayarlamak için kullanabilirsinizm_pdex. Yapı hakkında m_pdex daha fazla bilgi için bkz . Windows SDK'da PRINTDLGEX .

Veri üyesini m_pdex doğrudan değiştirirseniz, tüm varsayılan davranışları geçersiz kılarsınız.

CPrintDialogEx::P rintAll

Belgedeki tüm sayfaların yazdırılıp yazdırılmayacağını belirlemek için çağrısından DoModal sonra bu işlevi çağırın.

BOOL PrintAll() const;

Dönüş Değeri

Belgedeki tüm sayfalar yazdırılacaksa DOĞRU; aksi takdirde YANLIŞ.

CPrintDialogEx::P rintCollate

Yazıcının belgenin tüm yazdırılan kopyalarını harmanlayıp harmanlamayacağını belirlemek için çağırdıktan DoModal sonra bu işlevi çağırın.

BOOL PrintCollate() const;

Dönüş Değeri

Kullanıcı iletişim kutusunda harmanla onay kutusunu seçerse DOĞRU; aksi takdirde YANLIŞ.

CPrintDialogEx::P rintCurrentPage

Belgedeki geçerli sayfanın yazdırılıp yazdırılmayacağını belirlemek için çağrısından DoModal sonra bu işlevi çağırın.

BOOL PrintCurrentPage() const;

Dönüş Değeri

Yazdır iletişim kutusunda Geçerli Sayfayı Yazdır seçiliyse DOĞRU; aksi takdirde YANLIŞ.

CPrintDialogEx::P rintRange

Belgedeki yalnızca bir sayfa aralığının yazdırılıp yazdırılmayacağını belirlemek için çağrısından DoModal sonra bu işlevi çağırın.

BOOL PrintRange() const;

Dönüş Değeri

Yalnızca belgedeki bir sayfa aralığı yazdırılacaksa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

Belirtilen sayfa aralıkları m_pdex belirlenebilir (bkznMaxPageRangesnPageRanges. , ve lpPageRanges Windows SDK'sının PRINTDLGEX yapısında).

CPrintDialogEx::P rintSelection

Yalnızca seçili durumdaki öğelerin yazdırılıp yazdırılmayacağını belirlemek için çağrısından DoModal sonra bu işlevi çağırın.

BOOL PrintSelection() const;

Dönüş Değeri

Yalnızca seçili öğeler yazdırılacaksa DOĞRU; aksi takdirde YANLIŞ.

Ayrıca bkz.

CCommonDialog Sınıfı
Hiyerarşi Grafiği
CPrintInfo Yapısı