PrintDialog Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Roept een standaarddialoogvenster voor Microsoft Windows afdrukken aan waarmee een PrintTicket en PrintQueue worden geconfigureerd op basis van gebruikersinvoer en vervolgens een document wordt afgedrukt.
public ref class PrintDialog
public class PrintDialog
type PrintDialog = class
Public Class PrintDialog
- Overname
-
PrintDialog
Voorbeelden
In het volgende voorbeeld ziet u hoe u een exemplaar van een eenvoudig PrintDialog exemplaar maakt en weergeeft met behulp van XAML-markeringen (Extensible Application Markup Language) en code.
<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
Opmerkingen
Een gebruiker kan het dialoogvenster Afdrukken gebruiken om een printer te selecteren, deze te configureren en een afdruktaak uit te voeren.
Strikt genomen kunt u de PrintDocument methode gebruiken zonder het dialoogvenster te openen. In dat opzicht kan het besturingselement worden gebruikt als een ongelezen afdrukonderdeel. Maar om prestatieredenen is het beter om de AddJob methode of een van de vele Write methoden van WriteAsync de XpsDocumentWriter. Zie Procedure voor meer informatie: Programmatisch XPS-bestanden afdrukken.
Verwar deze klasse niet, System.Windows.Controls.PrintDialog, met System.Windows.Forms.PrintDialog. De laatste wordt gebruikt met Windows Forms toepassingen. System.Windows.Controls.PrintDialog wordt gebruikt met Windows Presentation Foundation toepassingen.
Constructors
| Name | Description |
|---|---|
| PrintDialog() |
Initialiseert een nieuw exemplaar van de PrintDialog klasse. |
Eigenschappen
| Name | Description |
|---|---|
| CurrentPageEnabled |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de optie voor het afdrukken van de huidige pagina is ingeschakeld. |
| MaxPage |
Hiermee haalt of stelt u het hoogste paginanummer in dat is toegestaan in paginabereiken. |
| MinPage |
Hiermee haalt u het laagste paginanummer op dat is toegestaan in paginabereiken of stelt u dit in. |
| PageRange |
Hiermee wordt het bereik van pagina's dat moet worden afgedrukt, opgevraagd of ingesteld PageRangeSelectionop UserPages . |
| PageRangeSelection |
Hiermee wordt het PageRangeSelection voor dit exemplaar van PrintDialog. |
| PrintableAreaHeight |
Hiermee haalt u de hoogte van het afdrukbare gebied van de pagina op. |
| PrintableAreaWidth |
Hiermee wordt de breedte van het afdrukbare gebied van de pagina weergegeven. |
| PrintQueue |
Hiermee haalt u een PrintQueue printer op of stelt u deze in die de printer vertegenwoordigt die is geselecteerd. |
| PrintTicket |
Hiermee haalt u de PrintTicket gegevens op die door de PrintDialog gebruiker worden gebruikt wanneer de gebruiker op Afdrukken klikt voor de huidige afdruktaak. |
| SelectedPagesEnabled |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de optie voor het afdrukken van de geselecteerde pagina's is ingeschakeld. |
| UserPageRangeEnabled |
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of gebruikers van het dialoogvenster Afdrukken de optie hebben om bereiken van pagina's op te geven die moeten worden afgedrukt. |
Methoden
| Name | Description |
|---|---|
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| PrintDocument(DocumentPaginator, String) |
Hiermee wordt een DocumentPaginator object afgedrukt op het PrintQueue object dat momenteel is geselecteerd. |
| PrintVisual(Visual, String) |
Hiermee wordt een visualobject (niet-tekst) afgedrukt dat is afgeleid van de Visual klasse, naar het PrintQueue object dat momenteel is geselecteerd. |
| ShowDialog() |
Hiermee wordt het PrintDialog dialoogvenster aangeroepen als een modaal dialoogvenster. |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |