PrintDialog控件用於選擇打印機、選擇要打印的頁以及確定其他與打印相關的設置。通過PrintDialog控件可以選擇全部打印、打印選定的頁范圍或打印選定內容。PrintDialog控件的常見屬性及說明如表1所示。
表1 PrintDialog控件的常用屬性及說明
屬性 |
說明 |
Document |
獲取PrinterSettings類的PrintDocument對象 |
AllowCurrentPage |
是否顯示“當前頁”選項按鈕 |
AllowPrintToFile |
是否啟用“打印到文件”復選框 |
AllowSelection |
是否啟用“選擇”選項按鈕 |
AllowSomePages |
是否啟用“頁”選項按鈕 |
下面對這幾種常見的屬性進行詳細的介紹。
(1)Document屬性
用於獲取PrinterSettings的PrintDocument。
語法:
public PrintDocument Document { get; set; }
屬性值:PrinterSettings的PrintDocument。
(2)AllowCurrentPage屬性
用於設置是否顯示“當前頁”選項按鈕。
語法:
public bool AllowCurrentPage { get; set; }
屬性值:如果顯示“當前頁”選項按鈕,為true;否則為false。默認為false。
(3)AllowPrintToFile屬性
用於設置是否啟用“打印到文件”復選框。
語法:
public bool AllowPrintToFile { get; set; }
屬性值:如果啟用“打印到文件”復選框,為true;否則為false。默認為true。
(4)AllowSelection屬性
用於設置是否啟用“選擇”選項按鈕。
語法:
public bool AllowSelection { get; set; }
屬性值:如果啟用“選擇”選項按鈕,為true;否則為false。默認為false。
(5)AllowSomePages屬性
用於設置是否啟用“頁”選項按鈕。
語法:
public bool AllowSomePages { get; set; }
屬性值:如果啟用“頁”選項按鈕,為true;否則為false。默認為false。
例 創建一個Windows應用程序,向窗體中添加一個PrintDialog控件、一個PrintDocument控件和一個Button控件。在Button控件的Click事件中設置PrintDialog控件的相應屬性,最后打開“打印”設置窗體,代碼如下。
private void button1_Click(object sender, EventArgs e) { //設置printDialog控件的Document屬性,設置操作文檔 printDialog1.Document = printDocument1; //啟用"打印到文件"復選框 printDialog1.AllowPrintToFile = true; //顯示“當前項”按鈕 printDialog1.AllowCurrentPage = true; //啟用"選擇按鈕" printDialog1.AllowSelection = true; //啟用"頁"按鈕 printDialog1.AllowSomePages = true; printDialog1.ShowDialog(); }
運行程序,單擊“打印機設置”按鈕,如圖所示。