System.Drawing.Printing Namnområde
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.