System.Drawing.Printing Przestrzeń nazw

Udostępnia usługi związane z drukowaniem dla aplikacji Windows Forms.

Klasy

InvalidPrinterException

Reprezentuje wyjątek zgłaszany podczas próby uzyskania dostępu do drukarki przy użyciu nieprawidłowych ustawień drukarki.

Margins

Określa wymiary marginesów drukowanej strony.

MarginsConverter

Udostępnia element MarginsConverter dla .Margins

PageSettings

Określa ustawienia, które mają zastosowanie do jednej wydrukowanej strony.

PaperSize

Określa rozmiar kawałka papieru.

PaperSource

Określa tacę papieru, z której drukarka pobiera papier.

PreviewPageInfo

Określa informacje podglądu wydruku dla jednej strony. Klasa ta nie może być dziedziczona.

PreviewPrintController

Określa kontroler wydruku, który wyświetla dokument na ekranie jako serię obrazów.

PrintController

Określa sposób drukowania dokumentu podczas drukowania z aplikacji Windows Forms.

PrintDocument

Definiuje obiekt wielokrotnego użytku, który wysyła dane wyjściowe do drukarki podczas drukowania z aplikacji Windows Forms.

PrinterResolution

Reprezentuje rozdzielczość obsługiwaną przez drukarkę.

PrinterSettings

Określa informacje o sposobie drukowania dokumentu, w tym drukarki, która go drukuje, podczas drukowania z aplikacji Windows Forms.

PrinterSettings.PaperSizeCollection

Zawiera kolekcję PaperSize obiektów.

PrinterSettings.PaperSourceCollection

Zawiera kolekcję PaperSource obiektów.

PrinterSettings.PrinterResolutionCollection

Zawiera kolekcję PrinterResolution obiektów.

PrinterSettings.StringCollection

Zawiera kolekcję String obiektów.

PrinterUnitConvert

Określa serię metod konwersji, które są przydatne podczas współdziałania z interfejsem API drukowania Win32. Klasa ta nie może być dziedziczona.

PrintEventArgs

Dostarcza dane dla zdarzeń BeginPrint i EndPrint .

PrintingPermission

Kontroluje dostęp do drukarek. Klasa ta nie może być dziedziczona.

PrintingPermissionAttribute

Umożliwia sprawdzanie uprawnień do drukowania deklaratywnego.

PrintPageEventArgs

Udostępnia dane dla zdarzenia PrintPage.

QueryPageSettingsEventArgs

Udostępnia dane dla zdarzenia QueryPageSettings.

StandardPrintController

Określa kontroler wydruku, który wysyła informacje do drukarki.

Wyliczenia

Duplex

Określa ustawienie dupleksu drukarki.

PaperKind

Określa standardowe rozmiary papieru.

PaperSourceKind

Standardowe źródła papieru.

PrintAction

Określa typ wykonywanej operacji drukowania.

PrinterResolutionKind

Określa rozdzielczość drukarki.

PrinterUnit

Określa kilka jednostek miary używanych do drukowania.

PrintingPermissionLevel

Określa typ drukowania, który kod może wykonać.

PrintRange

Określa część dokumentu do wydrukowania.

Delegaci

PrintEventHandler

Reprezentuje metodę, która będzie obsługiwać BeginPrint zdarzenie lub EndPrint obiektu PrintDocument.

PrintPageEventHandler

Reprezentuje metodę, która będzie obsługiwać PrintPage zdarzenie klasy PrintDocument.

QueryPageSettingsEventHandler

Reprezentuje metodę, która obsługuje QueryPageSettings zdarzenie obiektu PrintDocument.

Uwagi

Zazwyczaj podczas drukowania z aplikacji Windows Forms tworzy się nowe wystąpienie PrintDocument klasy, ustawia właściwości, takie jak DefaultPageSettings i PrinterSettings, opisujące sposób drukowania i wywoływanie Print metody w celu faktycznego wydrukowania dokumentu. PrintDocument.Print Wywołanie metody wywołuje PrintDocument.PrintPage zdarzenie, które powinno być obsługiwane w celu wykonania układu dokumentu na potrzeby drukowania.

Graphics Użyj właściwości obiektu uzyskanego PrintPageEventArgsPrintDocument.PrintPage ze zdarzenia, aby określić dane wyjściowe do wydrukowania. Jeśli drukujesz plik tekstowy, użyj polecenia StreamReader , aby odczytać jeden wiersz naraz ze strumienia i wywołać DrawString metodę , aby narysować linię w obiekcie graficznym. Aby uzyskać więcej informacji na temat tego procesu, zobacz Graphics klasy i StreamReader . Przykład drukowania dokumentu tekstowego można wyświetlić w PrintDocument temacie przeglądu klasy.

Uwaga

Metody DrawTextTextRenderer klasy nie są obsługiwane do drukowania. Zamiast tego należy użyć DrawString metod Graphics klasy .

Po zaimplementowaniu w klasie pochodnej kontrolki PrintControllerPrintDocument sposób drukowania. Metoda PrintDocument.Print wywołuje metody , OnEndPrint, OnStartPagei OnEndPage kontrolera OnStartPrintwydruku, które z kolei informują drukarkę, jak wydrukować dokument. Aby uzyskać więcej informacji na temat drukowania okien dialogowych, zobacz PrintDialog i PageSetupDialog.

Proces drukowania w wersji zapoznawczej używa wyspecjalizowanego kontrolera wydruku, okna dialogowego i kontrolki. Aby zapoznać się z przykładem takiego kontrolera wydruku i okna dialogowego, zobacz PreviewPrintController, PrintPreviewDialogi PrintPreviewControl.

Przestroga

Klasy w przestrzeni System.Drawing.Printing nazw nie są obsługiwane w ramach usługi systemu Windows lub ASP.NET aplikacji lub usługi. Próba użycia tych klas z poziomu jednego z tych typów aplikacji może powodować nieoczekiwane problemy, takie jak zmniejszona wydajność usługi i wyjątki czasu wykonywania.

Jeśli chcesz drukować z aplikacji Windows Presentation Foundation (WPF), zobacz System.Printing przestrzeń nazw.

Zobacz też