CPrintInfo Yapısı

Yazdırma veya baskı önizleme işi hakkındaki bilgileri depolar.

Sözdizimi

struct CPrintInfo

Üyeler

Genel Yöntemler

Ortak Veri Üyeleri

Açıklamalar

CPrintInfo bir yapıdır ve temel sınıfı yoktur.

Çerçeve, Print veya Print Preview komutu her seçildiğinde nesnesini CPrintInfo oluşturur ve komut tamamlandığında yok eder.

CPrintInfo hem yazdırılacak sayfa aralığı hem de yazdırılmakta olan sayfa gibi yazdırma işinin geçerli durumu gibi bir bütün olarak yazdırma işi hakkında bilgi içerir. Bazı bilgiler ilişkili bir CPrintDialog nesnesinde depolanır; bu nesne, yazdır iletişim kutusuna kullanıcı tarafından girilen değerleri içerir.

CPrintInfo Yazdırma işlemi sırasında çerçeve ile görünüm sınıfınız arasında bir nesne geçirilir ve ikisi arasında bilgi alışverişi yapmak için kullanılır. Örneğin, çerçeve üyesine bir değer m_nCurPage CPrintInfoatayarak belgenin hangi sayfasının yazdırılacağını görünüm sınıfına bildirir; görünüm sınıfı değeri alır ve belirtilen sayfanın gerçek yazdırmasını gerçekleştirir.

Başka bir örnek, belgenin uzunluğunun yazdırılana kadar bilinmemesidir. Bu durumda, görünüm sınıfı her sayfa yazdırıldığında belgenin sonu için sınar. Sonuna ulaşıldığında, görünüm sınıfı öğesini CPrintInfo FALSE olarak ayarlarm_bContinuePrinting; bu, çerçeveyi yazdırma döngüsünü durdurması konusunda bilgilendirır.

CPrintInfo, "Ayrıca Bkz. " altında listelenen üye işlevleri CView tarafından kullanılır. Microsoft Foundation Sınıf Kitaplığı tarafından sağlanan yazdırma mimarisi hakkında daha fazla bilgi için bkz. Çerçeve Pencereleri ve Belge/Görünüm Mimarisi ve Yazdırma ve Yazdırma: Çok Sayfalı Belgeler.

Devralma Hiyerarşisi

CPrintInfo

Gereksinimler

Üst bilgi: afxext.h

CPrintInfo::GetFromPage

Yazdırılacak ilk sayfanın numarasını almak için bu işlevi çağırın.

UINT GetFromPage() const;

Dönüş Değeri

Yazdırılacak ilk sayfanın sayısı.

Açıklamalar

Bu, Yazdır iletişim kutusunda kullanıcı tarafından belirtilen değerdir ve üye tarafından m_pPD başvurulan nesnede CPrintDialog depolanır. Kullanıcı bir değer belirtmediyse, varsayılan değer belgenin ilk sayfasıdır.

CPrintInfo::GetMaxPage

Belgenin son sayfasının numarasını almak için bu işlevi çağırın.

UINT GetMaxPage() const;

Dönüş Değeri

Belgenin son sayfasının numarası.

Açıklamalar

Bu değer, üye tarafından başvurulan nesnede CPrintDialog m_pPD depolanır.

CPrintInfo::GetMinPage

Belgenin ilk sayfasının numarasını almak için bu işlevi çağırın.

UINT GetMinPage() const;

Dönüş Değeri

Belgenin ilk sayfasının numarası.

Açıklamalar

Bu değer, üye tarafından başvurulan nesnede CPrintDialog m_pPD depolanır.

CPrintInfo::GetOffsetPage

Bir DocObject istemcisinden birden çok DocObject öğesi yazdırırken uzaklığı almak için bu işlevi çağırın.

UINT GetOffsetPage() const;

Dönüş Değeri

Bir DocObject öğesinin birleşik docobject yazdırma işinde yazdırılan ilk sayfasından önce gelen sayfa sayısı.

Açıklamalar

Bu değere üye tarafından başvurulur m_nOffsetPage . Belgenizin ilk sayfası, diğer etkin belgelerle DocObject olarak yazdırıldığında + 1 değeri numaralandırılır m_nOffsetPage . Üye m_nOffsetPage yalnızca değer TRUE olduğunda m_bDocObject geçerlidir.

CPrintInfo::GetToPage

Yazdırılacak son sayfanın numarasını almak için bu işlevi çağırın.

UINT GetToPage() const;

Dönüş Değeri

Yazdırılacak son sayfanın sayısı.

Açıklamalar

Bu, Yazdır iletişim kutusunda kullanıcı tarafından belirtilen değerdir ve üye tarafından m_pPD başvurulan nesnede CPrintDialog depolanır. Kullanıcı bir değer belirtmediyse, varsayılan değer belgenin son sayfasıdır.

CPrintInfo::m_bContinuePrinting

Çerçevenin yazdırma döngüsüne devam edip etmeyeceğini belirten bir bayrak içerir.

Açıklamalar

Yazdırma zamanı sayfalandırması yapıyorsanız, belgenin sonuna ulaşıldığında geçersiz kılma CView::OnPrepareDC işleminizde bu üyeyi YANLIŞ olarak ayarlayabilirsiniz. Üye işlevini kullanarak SetMaxPage yazdırma işinin başında belgenin uzunluğunu belirttiyseniz bu değişkeni değiştirmeniz gerekmez. m_bContinuePrinting Üye, BOOL türünde bir ortak değişkendir.

CPrintInfo::m_bDirect

Doğrudan yazdırma için Yazdır iletişim kutusu atlanacaksa çerçeve bu üyeyi TRUE olarak ayarlar; FALSE aksi takdirde.

Açıklamalar

Normalde kabuktan yazdırdığınızda veya yazdırma işlemi komut kimliği ID_FILE_PRINT_DIRECT kullanılarak yapıldığında Yazdır iletişim kutusu atlanır.

Normalde bu üyeyi değiştirmezsiniz, ancak değiştirirseniz, CView::OnPreparePrinting geçersiz kılmanızda CView::D oPreparePrinting'i çağırmadan önce değiştirin.

CPrintInfo::m_bDocObject

Yazdırılmakta olan belgenin DocObject olup olmadığını gösteren bir bayrak içerir.

Açıklamalar

Bu bayrak TRUE olmadığı sürece veri üyeleri m_dwFlags ve m_nOffsetPage geçersizdir.

CPrintInfo::m_bPreview

Belgenin önizlemesinin yapılıp yapılmadığını gösteren bir bayrak içerir.

Açıklamalar

Bu, kullanıcının hangi komutu yürüttüğüne bağlı olarak çerçeve tarafından ayarlanır. Yazdırma önizleme işi için Yazdır iletişim kutusu görüntülenmez. m_bPreview Üye, BOOL türünde bir ortak değişkendir.

CPrintInfo::m_dwFlags

DocObject yazdırma işlemlerini belirten bayrakların bir bileşimini içerir.

Açıklamalar

Yalnızca veri üyesi m_bDocObject TRUE ise geçerlidir.

Bayraklar aşağıdaki değerlerden biri veya daha fazlası olabilir:

• PRINTFLAG_MAYBOTHERUSER

• PRINTFLAG_PROMPTUSER

• PRINTFLAG_USERMAYCHANGEPRINTER

• PRINTFLAG_RECOMPOSETODEVICE

• PRINTFLAG_DONTACTUALLYPRINT

• PRINTFLAG_FORCEPROPERTIES

• PRINTFLAG_PRINTTOFILE

CPrintInfo::m_lpUserData

Kullanıcı tarafından oluşturulan bir yapıya işaretçi içerir.

Açıklamalar

Görünüm sınıfınızda depolamak istemediğiniz yazdırmaya özgü verileri depolamak için bunu kullanabilirsiniz. Üye m_lpUserData , LPVOID türünde bir ortak değişkendir.

CPrintInfo::m_nCurPage

Geçerli sayfanın numarasını içerir.

Açıklamalar

Çerçeve CView::OnPrepareDC , belgenin her sayfası için ve CView::OnPrint çağrısı yaparak her seferinde bu üye için farklı bir değer belirtir; değerleri tarafından GetFromPage döndürülen değerden tarafından GetToPagedöndürülen değere kadar değişir. Belgenin belirtilen sayfasını yazdırmak için ve CView::OnPrint geçersiz kılmalarınızda CView::OnPrepareDC bu üyeyi kullanın.

Önizleme modu ilk kez çağrıldığında, çerçeve bu üyenin değerini okuyarak belgenin hangi sayfasının başlangıçta önizlenmesi gerektiğini belirler. Önizleme moduna girerken kullanıcının belgedeki geçerli konumunu korumak için geçersiz kılmanızda CView::OnPreparePrinting bu üyenin değerini ayarlayabilirsiniz. Üye m_nCurPage , UINT türünde bir ortak değişkendir.

CPrintInfo::m_nJobNumber

Geçerli yazdırma işi için işletim sistemi tarafından atanan iş numarasını gösterir.

Açıklamalar

İş henüz yazdırılmamışsa (nesne yeni oluşturulduysa CPrintInfo ve henüz yazdırmak için kullanılmadıysa) veya işi başlatırken bir hata oluştuysa bu değer SP_ERROR olabilir.

CPrintInfo::m_nNumPreviewPages

Önizleme modunda görüntülenen sayfa sayısını içerir; 1 veya 2 olabilir.

Açıklamalar

Üye m_nNumPreviewPages , UINT türünde bir ortak değişkendir.

CPrintInfo::m_nOffsetPage

Birleşik bir DocObject yazdırma işinde belirli bir DocObject'in ilk sayfasından önce gelen sayfa sayısını içerir.

CPrintInfo::m_pPD

Yazdırma işinin CPrintDialog Yazdır iletişim kutusunu görüntülemek için kullanılan nesneye yönelik bir işaretçi içerir.

Açıklamalar

m_pPD Üye, işaretçi CPrintDialogolarak bildirilen bir ortak değişkendir.

CPrintInfo::m_rectDraw

Sayfanın kullanılabilir çizim alanını mantıksal koordinatlarda belirtir.

Açıklamalar

Geçersiz kılmanızda CView::OnPrintbuna başvurmak isteyebilirsiniz. Üst bilgileri, alt bilgileri vb. yazdırdıktan sonra hangi alanın kullanılabilir durumda kaldığını izlemek için bu üyeyi kullanabilirsiniz. m_rectDraw Üye, türünde CRectbir ortak değişkendir.

CPrintInfo::m_strPageDesc

Baskı önizleme sırasında sayfa numaralarını görüntülemek için kullanılan bir biçim dizesi içerir; bu dize, biri tek sayfalı görüntü, diğeri de çift sayfalı görüntü için olmak üzere her biri '\n' karakteriyle sonlandırılan iki alt dizeden oluşur.

Açıklamalar

Çerçeve, varsayılan değer olarak "Sayfa %u\nSayfa %u-%u\n" kullanır. Sayfa numaraları için farklı bir biçim istiyorsanız, geçersiz kılmanızda CView::OnPreparePrintingbir biçim dizesi belirtin. m_strPageDesc Üye, türünde CStringbir ortak değişkendir.

CPrintInfo::SetMaxPage

Belgenin son sayfasının numarasını belirtmek için bu işlevi çağırın.

void SetMaxPage(UINT nMaxPage);

Parametreler

nMaxPage
Belgenin son sayfasının numarası.

Açıklamalar

Bu değer, üye tarafından başvurulan nesnede CPrintDialog m_pPD depolanır. Belgenin uzunluğu yazdırılmadan önce biliniyorsa, geçersiz kılmanızdan bu işlevi çağırın CView::OnPreparePrinting. Belgenin uzunluğu, Yazdır iletişim kutusunda kullanıcı tarafından belirtilen bir ayara bağlıysa, geçersiz kılmanızdan bu işlevi çağırın CView::OnBeginPrinting. Belge yazdırılana kadar belgenin uzunluğu bilinmiyorsa, yazdırma döngüsünü denetlemek için üyeyi kullanın m_bContinuePrinting .

Örnek

CView::OnPreparePrinting örneğine bakın.

CPrintInfo::SetMinPage

Belgenin ilk sayfasının numarasını belirtmek için bu işlevi çağırın.

void SetMinPage(UINT nMinPage);

Parametreler

nMinPage
Belgenin ilk sayfasının numarası.

Açıklamalar

Sayfa numaraları normalde 1'de başlar. Bu değer, üye tarafından başvurulan nesnede CPrintDialog m_pPD depolanır.

Ayrıca bkz.

MFC Örneği DIBLOOK
Hiyerarşi Grafiği
CView::OnBeginPrinting
CView::OnEndPrinting
CView::OnEndPrintPreview
CView::OnPrepareDC
CView::OnPreparePrinting
CView::OnPrint