PrintDialog Klass
Definition
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.
Anropar en standarddialogruta Microsoft Windows utskrift som konfigurerar en PrintTicket och PrintQueue enligt användarens indata och sedan skriver ut ett dokument.
public ref class PrintDialog
public class PrintDialog
type PrintDialog = class
Public Class PrintDialog
- Arv
-
PrintDialog
Exempel
I följande exempel visas hur du skapar en instans av och visar en enkel PrintDialog med XAML-kod (Extensible Application Markup Language).
<Button Width="200" Click="InvokePrint">Invoke PrintDialog</Button>
...
private void InvokePrint(object sender, RoutedEventArgs e)
{
// Create the print dialog object and set options
PrintDialog pDialog = new PrintDialog();
pDialog.PageRangeSelection = PageRangeSelection.AllPages;
pDialog.UserPageRangeEnabled = true;
// Display the dialog. This returns true if the user presses the Print button.
Nullable<Boolean> print = pDialog.ShowDialog();
if (print.Value)
{
XpsDocument xpsDocument = new XpsDocument("C:\\FixedDocumentSequence.xps", FileAccess.ReadWrite);
FixedDocumentSequence fixedDocSeq = xpsDocument.GetFixedDocumentSequence();
pDialog.PrintDocument(fixedDocSeq.DocumentPaginator, "Test print job");
}
}
Private Sub InvokePrint(ByVal sender As Object, ByVal e As RoutedEventArgs)
' Create the print dialog object and set options
Dim pDialog As New PrintDialog()
pDialog.PageRangeSelection = PageRangeSelection.AllPages
pDialog.UserPageRangeEnabled = True
' Display the dialog. This returns true if the user presses the Print button.
Dim print? As Boolean = pDialog.ShowDialog()
If print = True Then
Dim xpsDocument As New XpsDocument("C:\FixedDocumentSequence.xps", FileAccess.ReadWrite)
Dim fixedDocSeq As FixedDocumentSequence = xpsDocument.GetFixedDocumentSequence()
pDialog.PrintDocument(fixedDocSeq.DocumentPaginator, "Test print job")
End If
End Sub
Kommentarer
En användare kan använda dialogrutan Skriv ut för att välja en skrivare, konfigurera den och utföra ett utskriftsjobb.
Strikt sett kan du använda PrintDocument metoden utan att öppna dialogrutan. I det avseendet kan kontrollen användas som en osedda utskriftskomponent. Men av prestandaskäl skulle det vara bättre att använda antingen AddJob metoden eller någon av de många Write metoderna och WriteAsync metoderna i XpsDocumentWriter. Mer information om detta finns i How to: Programmatically Print XPS Files (Gör så här: Skriv ut XPS-filer programmatiskt).
Blanda inte ihop den här klassen, System.Windows.Controls.PrintDialog, med System.Windows.Forms.PrintDialog. Det senare används med Windows Forms program. System.Windows.Controls.PrintDialog används med Windows Presentation Foundation program.
Konstruktorer
| Name | Description |
|---|---|
| PrintDialog() |
Initierar en ny instans av PrintDialog klassen. |
Egenskaper
| Name | Description |
|---|---|
| CurrentPageEnabled |
Hämtar eller anger ett värde som anger om alternativet för att skriva ut den aktuella sidan är aktiverat. |
| MaxPage |
Hämtar eller anger det högsta sidnumret som tillåts i sidintervall. |
| MinPage |
Hämtar eller anger det lägsta sidnumret som tillåts i sidintervall. |
| PageRange |
Hämtar eller anger det sidintervall som ska skrivas ut när PageRangeSelection är inställt på UserPages. |
| PageRangeSelection |
Hämtar eller anger för den PageRangeSelection här instansen av PrintDialog. |
| PrintableAreaHeight |
Hämtar höjden på sidans utskrivbara område. |
| PrintableAreaWidth |
Hämtar bredden på det utskrivbara området på sidan. |
| PrintQueue |
Hämtar eller anger en PrintQueue som representerar den skrivare som är markerad. |
| PrintTicket |
Hämtar eller anger PrintTicket det som används av PrintDialog när användaren klickar på Skriv ut för det aktuella utskriftsjobbet. |
| SelectedPagesEnabled |
Hämtar eller anger ett värde som anger om alternativet för att skriva ut de valda sidorna är aktiverat. |
| UserPageRangeEnabled |
Hämtar eller anger ett värde som anger om användare av dialogrutan Skriv ut har möjlighet att ange intervall med sidor som ska skrivas ut. |
Metoder
| Name | Description |
|---|---|
| Equals(Object) |
Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object) |
| GetHashCode() |
Fungerar som standard-hash-funktion. (Ärvd från Object) |
| GetType() |
Hämtar den aktuella instansen Type . (Ärvd från Object) |
| MemberwiseClone() |
Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object) |
| PrintDocument(DocumentPaginator, String) |
Skriver ut ett DocumentPaginator objekt till det PrintQueue som för närvarande är markerat. |
| PrintVisual(Visual, String) |
Skriver ut ett visuellt objekt (icke-text) som härleds från Visual klassen till PrintQueue det objekt som för närvarande är markerat. |
| ShowDialog() |
Anropar PrintDialog som en modal dialogruta. |
| ToString() |
Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object) |