System.Drawing.Printing Namnområde

Tillhandahåller utskriftsrelaterade tjänster för Windows Forms program.

Klasser

Name Description
InvalidPrinterException

Representerar undantaget som utlöses när du försöker komma åt en skrivare med hjälp av skrivarinställningar som inte är giltiga.

Margins

Anger dimensionerna för marginalerna på en utskriven sida.

MarginsConverter

Tillhandahåller en MarginsConverter för Margins.

PageSettings

Anger inställningar som gäller för en enda, utskriven sida.

PaperSize

Anger storleken på ett papper.

PaperSource

Anger vilket pappersfack skrivaren ska hämta papper från.

PreviewPageInfo

Anger förhandsgranskningsinformation för en enskild sida. Det går inte att ärva den här klassen.

PreviewPrintController

Anger en utskriftskontrollant som visar ett dokument på en skärm som en serie bilder.

PrintController

Styr hur ett dokument skrivs ut när du skriver ut från ett Windows Forms program.

PrintDocument

Definierar ett återanvändbart objekt som skickar utdata till en skrivare när det skrivs ut från ett Windows Forms program.

PrinterResolution

Representerar den upplösning som stöds av en skrivare.

PrinterSettings

Anger information om hur ett dokument skrivs ut, inklusive den skrivare som skriver ut det, när det skrivs ut från ett Windows Forms program.

PrinterSettings.PaperSizeCollection

Innehåller en samling PaperSize objekt.

PrinterSettings.PaperSourceCollection

Innehåller en samling PaperSource objekt.

PrinterSettings.PrinterResolutionCollection

Innehåller en samling PrinterResolution objekt.

PrinterSettings.StringCollection

Innehåller en samling String objekt.

PrinterUnitConvert

Anger en serie konverteringsmetoder som är användbara när du samverkar med Win32-utskrifts-API:et. Det går inte att ärva den här klassen.

PrintEventArgs

Tillhandahåller data för BeginPrint och EndPrint händelserna.

PrintingPermission

Styr åtkomsten till skrivare. Det går inte att ärva den här klassen.

PrintingPermissionAttribute

Tillåter deklarativa utskriftsbehörighetskontroller.

PrintPageEventArgs

Innehåller data för PrintPage händelsen.

QueryPageSettingsEventArgs

Innehåller data för QueryPageSettings händelsen.

StandardPrintController

Anger en utskriftskontrollant som skickar information till en skrivare.

Uppräkningar

Name Description
Duplex

Anger skrivarens duplexinställning.

PaperKind

Anger standardpappersstorlekarna.

PaperSourceKind

Standardpapperskällor.

PrintAction

Anger vilken typ av utskriftsåtgärd som inträffar.

PrinterResolutionKind

Anger en skrivarupplösning.

PrinterUnit

Anger flera av måttenheterna som används för utskrift.

PrintingPermissionLevel

Anger vilken typ av utskrift som koden tillåts göra.

PrintRange

Anger den del av dokumentet som ska skrivas ut.

Delegeringar

Name Description
PrintEventHandler

Representerar den metod som ska hantera BeginPrint eller EndPrint händelsen för en PrintDocument.

PrintPageEventHandler

Representerar den metod som ska hantera PrintPage händelsen för en PrintDocument.

QueryPageSettingsEventHandler

Representerar den metod som hanterar QueryPageSettings händelsen för en PrintDocument.

Kommentarer

När du skriver ut från ett Windows Forms program skapar du vanligtvis en ny instans av klassen PrintDocument, anger egenskaper, till exempel DefaultPageSettings och PrinterSettings, som beskriver hur du skriver ut och anropar metoden Print för att faktiskt skriva ut dokumentet. PrintDocument.Print När metoden anropas genereras händelsenPrintDocument.PrintPage, som ska hanteras för att utföra dokumentlayouten för utskrift.

Graphics Använd egenskapen för objektet PrintPageEventArgs som hämtats från PrintDocument.PrintPage händelsen för att ange utdata som ska skrivas ut. Om du skriver ut en textfil kan du använda StreamReader för att läsa en rad i taget från strömmen och anropa DrawString metoden för att rita linjen i grafikobjektet. Mer information om den här processen finns i klasserna Graphics och StreamReader . Du kan visa ett exempel på hur du skriver ut ett textdokument i klassöversiktsavsnittet PrintDocument .

Note

Klassmetoderna DrawTextTextRenderer stöds inte för utskrift. Använd DrawString i stället klassens Graphics metoder.

När den implementeras i en härledd klass styrs PrintController hur en PrintDocument skrivs ut. Metoden PrintDocument.Print anropar utskriftskontrollantens OnStartPrintmetoder , OnEndPrint, OnStartPageoch OnEndPage som i sin tur talar om för skrivaren hur dokumentet ska skrivas ut. Mer information om hur du skriver ut dialogrutor finns i PrintDialog och PageSetupDialog.

Förhandsgranskningsprocessen använder en specialiserad utskriftskontrollant, dialogruta och kontroll. Ett exempel på en sådan utskriftskontrollant och dialogruta finns i PreviewPrintController, PrintPreviewDialogoch PrintPreviewControl.

Caution

Klasser inom namnområdet System.Drawing.Printing stöds inte för användning i en Windows-tjänst eller ASP.NET program eller tjänst. Om du försöker använda dessa klasser inifrån någon av dessa programtyper kan det uppstå oväntade problem, till exempel sämre tjänstprestanda och körningsfel.

Om du vill skriva ut från ett Windows Presentation Foundation-program (WPF) läser du namnområdet System.Printing.

Se även