CPrintDialogEx 類別

發行項
08/04/2024

封裝 Windows Print 屬性表所提供的服務。

語法

class CPrintDialogEx : public CCommonDialog

成員

公用建構函式

名稱	描述
CPrintDialogEx：：CPrintDialogEx	建構 `CPrintDialogEx` 物件。

公用方法

名稱	描述
CPrintDialogEx：：CreatePrinterDC	建立印表機裝置內容，而不顯示 [列印] 對話框。
CPrintDialogEx：:D oModal	顯示對話框，並允許用戶進行選取。
CPrintDialogEx：：GetCopies	擷取所要求的複本數目。
CPrintDialogEx：：GetDefaults	擷取裝置預設值而不顯示對話框。
CPrintDialogEx：：GetDeviceName	擷取目前選取的印表機裝置名稱。
CPrintDialogEx：：GetDevMode	擷取 `DEVMODE` 結構。
CPrintDialogEx：：GetDriverName	擷取系統定義印表機設備驅動器的名稱。
CPrintDialogEx：：GetPortName	擷取目前選取之印表機埠的名稱。
CPrintDialogEx：：GetPrinterDC	擷取印表機裝置內容的句柄。
CPrintDialogEx：:P rintAll	判斷是否列印檔的所有頁面。
CPrintDialogEx：:P rintCollate	判斷是否要求定序複本。
CPrintDialogEx：:P rintCurrentPage	決定是否要列印檔的目前頁面。
CPrintDialogEx：:P rintRange	判斷是否只列印指定的頁面範圍。
CPrintDialogEx：:P rintSelection	判斷是否只列印目前選取的專案。

公用資料成員

名稱	描述
CPrintDialogEx：：m_pdex	用來自定義 `CPrintDialogEx` 對象的結構。

備註

您可以依賴架構來處理應用程式的列印程式的許多層面。如需使用架構來處理列印工作的詳細資訊，請參閱列印一文。

如果您想要讓應用程式在不涉及架構的情況下處理列印，您可以使用 CPrintDialogEx 類別「如同目前」搭配提供的建構函式，或者您可以從衍生自己的對話類別 CPrintDialogEx ，並撰寫建構函式以符合您的需求。不論是哪一種情況，這些對話框的行為都會像標準 MFC 對話框一樣，因為它們衍生自類別 CCommonDialog。

若要使用 CPrintDialogEx 物件，請先使用建 CPrintDialogEx 構函式建立物件。建構對話框之後，您可以設定或修改m_pdex結構中的任何值，以初始化對話框控件的值。結構 m_pdex 的類型為 PRINTDLGEX。如需此結構的詳細資訊，請參閱 Windows SDK。

如果您未為 hDevMode 和 hDevNames 成員提供自己的句柄m_pdex，請務必在完成對話框時，針對這些句柄呼叫 Windows 函GlobalFree式。

初始化對話框控件之後，請呼叫 DoModal 成員函式以顯示對話框，並允許用戶選取列印選項。當傳回時 DoModal ，您可以判斷使用者是否已選取 [確定]、[套用] 或 [取消] 按鈕。

如果使用者按下 [確定]，您可以使用 CPrintDialogEx的成員函式來擷取使用者輸入的資訊。

成員 CPrintDialogEx::GetDefaults 函式適用於擷取目前的印表機預設值，而不顯示對話方塊。此方法不需要用戶互動。

您可以使用 Windows CommDlgExtendedError 函式來判斷對話方塊初始化期間是否發生錯誤，以及深入瞭解錯誤。如需此函式的詳細資訊，請參閱 Windows SDK。

如需使用 CPrintDialogEx的詳細資訊，請參閱通用對話框類別。

繼承階層架構

IObjectWithSite

IPrintDialogCallback

CCommonDialog

CPrintDialogEx

需求

標頭： afxdlgs.h

CPrintDialogEx：：CPrintDialogEx

建構 Windows Print 屬性表。

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

參數

dwFlags
您可以使用一或多個旗標來自定義對話框的設定，並結合位 OR 運算元。例如，PD_ALLPAGES旗標會將預設列印範圍設定為檔的所有頁面。如需這些旗標的詳細資訊，請參閱 Windows SDK 中的 PRINTDLGEX 結構。

pParentWnd
對話框父視窗或擁有者視窗的指標。

備註

這個成員函式只會建構物件。 DoModal使用成員函式來顯示對話框。

CPrintDialogEx：：CreatePrinterDC

從 DEVMODE 和 DEVNAMES 結構建立印表機裝置內容（DC）。

HDC CreatePrinterDC();

傳回值

處理新建立的印表機裝置內容。

備註

傳回的 DC 也會儲存在 hDC m_pdex 的成員中。

此 DC 假設為目前的印表機 DC，而且必須刪除任何其他先前取得的印表機 DC。您可以呼叫此函式，並使用產生的 DC，而不會顯示 [列印] 對話方塊。

CPrintDialogEx：:D oModal

呼叫此函式以顯示 Windows Print 屬性表，並允許使用者選取各種列印選項，例如複本數目、頁面範圍，以及是否應該定序複本。

virtual INT_PTR DoModal();

傳回值

INT_PTR傳回值實際上是 HRESULT。請參閱 Windows SDK 中 PrintDlgEx 中的傳回值一節。

備註

如果您要藉由設定結構的成員 m_pdex 來初始化各種列印對話框選項，您應該先執行此動作，再呼叫 DoModal，但在建構對話對象之後。

呼叫 DoModal之後，您可以呼叫其他成員函式，將用戶的設定或資訊輸入擷取到對話框中。

如果在呼叫 DoModal時使用PD_RETURNDC旗標，則會在 m_pdex 的成員中hDC傳回印表機 DC。此 DC 必須透過的呼叫者CPrintDialogEx呼叫 DeleteDC 來釋放。

CPrintDialogEx：：GetCopies

呼叫之後呼叫 DoModal 此函式，以擷取所要求的複本數目。

int GetCopies() const;

傳回值

要求的複本數目。

CPrintDialogEx：：GetDefaults

呼叫此函式以擷取預設印表機的裝置預設值，而不顯示對話框。

BOOL GetDefaults();

傳回值

如果成功，則為TRUE，否則為 FALSE。

備註

從 DEVMODE 和 DEVNAMES 結構建立印表機裝置內容（DC）。

GetDefaults 不會顯示 Print 屬性表。相反地，它會設定 m_pdex 的和成員，以處理為系統預設印表機初始化的 DEVMODE 和 DEVNAMES 結構。hDevMode hDevNames hDevNames和 hDevMode 都必須是 NULL，或GetDefaults失敗。

如果已設定PD_RETURNDC旗標，此函式不僅會將和 hDevMode （位於 m_pdex.hDevNames 和m_pdex.hDevMode）傳回hDevNames給呼叫者，也會在中m_pdex.hDC傳回印表機 DC。呼叫端負責刪除印表機 DC，並在完成CPrintDialogEx物件時呼叫句柄上的 Windows GlobalFree 函式。

CPrintDialogEx：：GetDeviceName

呼叫 DoModal 以擷取目前選取的印表機名稱，或在呼叫 GetDefaults 以擷取預設印表機的名稱之後呼叫此函式。

CString GetDeviceName() const;

傳回值

目前選取之印表機的名稱。

備註

使用所傳回之物件的指標CString做為 CDC：：CreateDC 呼叫中的值lpszDeviceName。GetDeviceName

CPrintDialogEx：：GetDevMode

呼叫 DoModal 或 GetDefaults 之後呼叫此函式，以擷取列印裝置的相關信息。

LPDEVMODE GetDevMode() const;

傳回值

DEVMODE 數據結構，其中包含列印驅動程式之裝置初始化和環境的相關信息。您必須使用 Windows SDK 中所述的 Windows GlobalUnlock 函式來解除鎖定這個結構所取得的記憶體。

CPrintDialogEx：：GetDriverName

呼叫 DoModal 或 GetDefaults 之後呼叫此函式，以擷取系統定義的印表機設備驅動器名稱。

CString GetDriverName() const;

傳回值

CString，指定系統定義的驅動程式名稱。

備註

在呼叫 CDC：：CreateDC 時，使用所GetDriverName傳回之物件的指標CString做為 lpszDriverName 的值。

CPrintDialogEx：：GetPortName

呼叫 DoModal 或 GetDefaults 之後呼叫此函式，以擷取目前選取的印表機埠名稱。

CString GetPortName() const;

傳回值

目前選取之印表機埠的名稱。

CPrintDialogEx：：GetPrinterDC

傳回印表機裝置內容的句柄。

HDC GetPrinterDC() const;

傳回值

印表機裝置內容的句柄。

備註

當您完成使用 Windows DeleteDC 函式時，您必須呼叫 Windows DeleteDC 函式來刪除裝置內容。

CPrintDialogEx：：m_pdex

PRINTDLGEX 結構，其成員會儲存對話物件的特性。

PRINTDLGEX m_pdex;

備註

建 CPrintDialogEx 構物件之後，您可以使用 m_pdex 來設定對話框的各個層面，再呼叫 DoModal 成員函式。如需結構的詳細資訊 m_pdex ，請參閱 Windows SDK 中的 PRINTDLGEX 。

如果您直接修改 m_pdex 數據成員，則會覆寫任何默認行為。

CPrintDialogEx：:P rintAll

呼叫之後呼叫 DoModal 此函式，以判斷是否要列印檔中的所有頁面。

BOOL PrintAll() const;

傳回值

如果要列印檔中的所有頁面，則為TRUE;否則為 FALSE。

CPrintDialogEx：:P rintCollate

呼叫之後呼叫 DoModal 此函式，以判斷印表機是否應該整理檔的所有列印複本。

BOOL PrintCollate() const;

傳回值

如果使用者在對話框中選取定序複選框，則為TRUE;否則為 FALSE。

CPrintDialogEx：:P rintCurrentPage

呼叫之後呼叫 DoModal 此函式，以判斷是否要列印檔中的目前頁面。

BOOL PrintCurrentPage() const;

傳回值

如果在 列印對話框中選取 [列印目前頁面 ]，則為 TRUE;否則為 FALSE。

CPrintDialogEx：:P rintRange

呼叫之後呼叫 DoModal 此函式，以判斷是否只列印檔中的一系列頁面。

BOOL PrintRange() const;

傳回值

如果檔中只有一系列頁面要列印，則為TRUE;否則為 FALSE。

備註

您可以從m_pdex來判斷指定的頁面範圍（請參閱 nPageRangesWindows SDK 中的 PRINTDLGEX 結構中的、 nMaxPageRanges和 lpPageRanges 。

CPrintDialogEx：:P rintSelection

呼叫之後呼叫 DoModal 此函式，以判斷是否只列印目前選取的專案。

BOOL PrintSelection() const;

傳回值

如果只列印選取的專案，則為TRUE;否則為 FALSE。

另請參閱

CCommonDialog 類別
 階層架構圖表
 CPrintInfo 結構

共用方式為