PrintDialog Sınıf

Tanım

Bir PrintTicket ve PrintQueue Kullanıcı girişine göre yapılandıran ve sonra bir belge yazdıran standart bir Microsoft Windows yazdırma iletişim kutusu çağırır.Invokes a standard Microsoft Windows print dialog box that configures a PrintTicket and PrintQueue according to user input and then prints a document.

public ref class PrintDialog
public class PrintDialog
type PrintDialog = class
Public Class PrintDialog
Devralma
PrintDialog

Örnekler

Aşağıdaki örnek, bir örneğinin nasıl oluşturulacağını ve PrintDialog biçimlendirme ve kod kullanarak basit bir şekilde nasıl görüntüleneceğini gösterir Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) .The following example shows how to create an instance of and display a simple PrintDialog by using Extensible Application Markup Language (XAML)Extensible Application Markup Language (XAML) markup and 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 == true)
        {
            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

Açıklamalar

Bir Kullanıcı bir yazıcı seçmek, yapılandırmak ve bir yazdırma işi gerçekleştirmek için Yazdır iletişim kutusunu kullanabilir.A user can use the Print dialog box to select a printer, configure it, and perform a print job.

Kesinlikle konuşurken, PrintDocument iletişim kutusunu açmak zorunda kalmadan yöntemini kullanabilirsiniz.Strictly speaking, you can use the PrintDocument method without ever opening the dialog. Bu anlamda denetim, görülmeyen bir yazdırma bileşeni olarak kullanılabilir.In that sense, the control can be used as an unseen printing component. Ancak performans nedenleriyle, AddJob yöntemi veya Write ' nin birçok ve yönteminden birini kullanmak daha iyi olacaktır WriteAsync XpsDocumentWriter .But for performance reasons, it would be better to use either the AddJob method or one of the many Write and WriteAsync methods of the XpsDocumentWriter. Bunun hakkında daha fazla bilgi için bkz. nasıl yapılır: program aracılığıyla XPS dosyalarını yazdırma.For more about this, see How to: Programmatically Print XPS Files.

Bu sınıfı, System.Windows.Controls.PrintDialog ile karıştırmayın System.Windows.Forms.PrintDialog .Do not confuse this class, System.Windows.Controls.PrintDialog, with System.Windows.Forms.PrintDialog. İkincisi Windows Forms uygulamalarla kullanılır.The latter is used with Windows Forms applications. System.Windows.Controls.PrintDialog Windows Presentation Foundation uygulamalarla kullanılır.System.Windows.Controls.PrintDialog is used with Windows Presentation Foundation applications.

Oluşturucular

PrintDialog()

PrintDialog sınıfının yeni bir örneğini başlatır.Initializes a new instance of the PrintDialog class.

Özellikler

CurrentPageEnabled

Geçerli sayfanın yazdırılması seçeneğinin etkin olup olmadığını gösteren bir değer alır veya ayarlar.Gets or sets a value that indicates whether the option to print the current page is enabled.

MaxPage

Sayfa aralıklarında izin verilen en yüksek sayfa numarasını alır veya ayarlar.Gets or sets the highest page number that is allowed in page ranges.

MinPage

Sayfa aralıklarında izin verilen en düşük sayfa numarasını alır veya ayarlar.Gets or sets the lowest page number that is allowed in page ranges.

PageRange

Olarak ayarlandığında yazdırılacak sayfaların aralığını alır veya ayarlar PageRangeSelection UserPages .Gets or sets the range of pages to print when PageRangeSelection is set to UserPages.

PageRangeSelection

Bu örneği için öğesini alır veya ayarlar PageRangeSelection PrintDialog .Gets or sets the PageRangeSelection for this instance of PrintDialog.

PrintableAreaHeight

Sayfanın yazdırılabilir alanının yüksekliğini alır.Gets the height of the printable area of the page.

PrintableAreaWidth

Sayfanın yazdırılabilir alanının genişliğini alır.Gets the width of the printable area of the page.

PrintQueue

PrintQueueSeçilen yazıcıyı temsil eden bir alır veya ayarlar.Gets or sets a PrintQueue that represents the printer that is selected.

PrintTicket

PrintTicket PrintDialog Geçerli yazdırma işi Için Kullanıcı Yazdır ' a tıkladığında tarafından kullanılan öğesini alır veya ayarlar.Gets or sets the PrintTicket that is used by the PrintDialog when the user clicks Print for the current print job.

SelectedPagesEnabled

Seçilen sayfaların yazdırılması seçeneğinin etkin olup olmadığını gösteren bir değer alır veya ayarlar.Gets or sets a value that indicates whether the option to print the selected pages is enabled.

UserPageRangeEnabled

Yazdır iletişim kutusunun kullanıcılarının yazdırılacak sayfa aralıklarını belirtme seçeneğine sahip olup olmadığını gösteren bir değer alır veya ayarlar.Gets or sets a value that indicates whether users of the Print dialog box have the option to specify ranges of pages to print.

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
PrintDocument(DocumentPaginator, String)

DocumentPaginator PrintQueue Şu anda seçili olan öğesine bir nesne yazdırır.Prints a DocumentPaginator object to the PrintQueue that is currently selected.

PrintVisual(Visual, String)

VisualŞu anda seçili olan sınıfından türetilmiş bir görsel (metin olmayan) nesneyi yazdırır PrintQueue .Prints a visual (non-text) object, which is derived from the Visual class, to the PrintQueue that is currently selected.

ShowDialog()

PrintDialogKalıcı iletişim kutusu olarak çağırır.Invokes the PrintDialog as a modal dialog box.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)

Şunlara uygulanır