PrintDialog Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

PrintDialog.cs

Kullanıcıların bir yazıcı seçmesine ve belgenin hangi bölümlerinin Bir Windows Forms uygulamasından yazdırılacağını seçmesine olanak tanır.

public ref class PrintDialog sealed : System::Windows::Forms::CommonDialog

public sealed class PrintDialog : System.Windows.Forms.CommonDialog

type PrintDialog = class
    inherit CommonDialog

Public NotInheritable Class PrintDialog
Inherits CommonDialog

Devralma

Object

MarshalByRefObject

Component

CommonDialog

PrintDialog

Örnekler

Aşağıdaki kod örneği, , ShowHelpve Document özelliklerini ayarlamak için denetimin AllowSomePagesnasıl kullanılacağını PrintDialog gösterir. Bu örneği çalıştırmak için, aşağıdaki kodu adlı bir denetimi ve adlı PrintDialog1Button1bir PrintDialog düğmeyi içeren bir forma yapıştırın. Bu örnek, düğmenin Click olayının ve PrintPage olayının docToPrint bu örnekte tanımlanan olay işleme yöntemlerine bağlı olmasını gerektirir.

// Declare the PrintDocument object.
System::Drawing::Printing::PrintDocument^ docToPrint;

// This method will set properties on the PrintDialog object and
// then display the dialog.
void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   // Allow the user to choose the page range he or she would
   // like to print.
   PrintDialog1->AllowSomePages = true;
   
   // Show the help button.
   PrintDialog1->ShowHelp = true;
   
   // Set the Document property to the PrintDocument for 
   // which the PrintPage Event has been handled. To display the
   // dialog, either this property or the PrinterSettings property 
   // must be set 
   PrintDialog1->Document = docToPrint;
   if ( docToPrint == nullptr )
         System::Windows::Forms::MessageBox::Show(  "null" );

   ;
   ;
   if ( PrintDialog1 == nullptr )
         System::Windows::Forms::MessageBox::Show(  "pnull" );

   ;
   ;
   System::Windows::Forms::DialogResult result = PrintDialog1->ShowDialog();
   System::Windows::Forms::MessageBox::Show( result.ToString() );
   ;
   ;
   
   // If the result is OK then print the document.
   if ( result == ::DialogResult::OK )
   {
      docToPrint->Print();
   }

}

// The PrintDialog will print the document
// by handling the document's PrintPage event.
void document_PrintPage( Object^ /*sender*/, System::Drawing::Printing::PrintPageEventArgs^ e )
{
   // Insert code to render the page here.
   // This code will be called when the control is drawn.
   // The following code will render a simple
   // message on the printed document.
   String^ text = "In document_PrintPage method.";
   System::Drawing::Font^ printFont = gcnew System::Drawing::Font( "Arial",35,System::Drawing::FontStyle::Regular );
   
   // Draw the content.
   e->Graphics->DrawString( text, printFont, System::Drawing::Brushes::Black, 10, 10 );
}

// Declare the PrintDocument object.
private System.Drawing.Printing.PrintDocument docToPrint = 
    new System.Drawing.Printing.PrintDocument();

// This method will set properties on the PrintDialog object and
// then display the dialog.
private void Button1_Click(System.Object sender, 
    System.EventArgs e)
{

    // Allow the user to choose the page range he or she would
    // like to print.
    PrintDialog1.AllowSomePages = true;

    // Show the help button.
    PrintDialog1.ShowHelp = true;

    // Set the Document property to the PrintDocument for 
    // which the PrintPage Event has been handled. To display the
    // dialog, either this property or the PrinterSettings property 
    // must be set 
    PrintDialog1.Document = docToPrint;

    DialogResult result = PrintDialog1.ShowDialog();

    // If the result is OK then print the document.
    if (result==DialogResult.OK)
    {
        docToPrint.Print();
    }
}

// The PrintDialog will print the document
// by handling the document's PrintPage event.
private void document_PrintPage(object sender, 
    System.Drawing.Printing.PrintPageEventArgs e)
{

    // Insert code to render the page here.
    // This code will be called when the control is drawn.

    // The following code will render a simple
    // message on the printed document.
    string text = "In document_PrintPage method.";
    System.Drawing.Font printFont = new System.Drawing.Font
        ("Arial", 35, System.Drawing.FontStyle.Regular);

    // Draw the content.
    e.Graphics.DrawString(text, printFont, 
        System.Drawing.Brushes.Black, 10, 10);
}

' Declare the PrintDocument object.
Private WithEvents docToPrint As New Printing.PrintDocument

' This method will set properties on the PrintDialog object and
' then display the dialog.
Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    ' Allow the user to choose the page range he or she would
    ' like to print.
    PrintDialog1.AllowSomePages = True

    ' Show the help button.
    PrintDialog1.ShowHelp = True

    ' Set the Document property to the PrintDocument for 
    ' which the PrintPage Event has been handled. To display the
    ' dialog, either this property or the PrinterSettings property 
    ' must be set 
    PrintDialog1.Document = docToPrint

    Dim result As DialogResult = PrintDialog1.ShowDialog()

    ' If the result is OK then print the document.
    If (result = DialogResult.OK) Then
        docToPrint.Print()
    End If

End Sub

' The PrintDialog will print the document
' by handling the document's PrintPage event.
Private Sub document_PrintPage(ByVal sender As Object, _
   ByVal e As System.Drawing.Printing.PrintPageEventArgs) _
       Handles docToPrint.PrintPage

    ' Insert code to render the page here.
    ' This code will be called when the control is drawn.

    ' The following code will render a simple
    ' message on the printed document.
    Dim text As String = "In document_PrintPage method."
    Dim printFont As New System.Drawing.Font _
        ("Arial", 35, System.Drawing.FontStyle.Regular)

    ' Draw the content.
    e.Graphics.DrawString(text, printFont, _
        System.Drawing.Brushes.Black, 10, 10)
End Sub

Açıklamalar

örneğini PrintDialogoluşturduğunuzda, okuma/yazma özellikleri ilk değerlere ayarlanır. Bu değerlerin listesi için oluşturucuya PrintDialog bakın. ile PrintDialogkullanıcı tarafından değiştirilen yazıcı ayarlarını almak için özelliğini kullanın PrinterSettings .

Windows Forms ile yazdırma hakkında daha fazla bilgi için ad alanına genel bakış bölümüne System.Drawing.Printing bakın. Bir Windows Presentation Foundation uygulamasından yazdırmak istiyorsanız ad alanına System.Printing bakın.

Oluşturucular

Name	Description
PrintDialog()	PrintDialog sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
AllowCurrentPage	Geçerli Sayfa seçeneği düğmesinin görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar.
AllowPrintToFile	Dosyaya yazdır onay kutusunun etkin olup olmadığını belirten bir değer alır veya ayarlar.
AllowSelection	Seçim seçeneği düğmesinin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.
AllowSomePages	Sayfalar seçenek düğmesinin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.
Document	elde PrinterSettingsetmek için kullanılan değerini alır PrintDocument veya ayarlar.
PrinterSettings	İletişim kutusunun değiştirildiği yazıcı ayarlarını alır veya ayarlar.
PrintToFile	Dosyaya yazdır onay kutusunun seçili olup olmadığını belirten bir değer alır veya ayarlar.
ShowHelp	Yardım düğmesinin görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar.
ShowNetwork	Ağ düğmesinin görüntülenip görüntülenmeyeceğini belirten bir değer alır veya ayarlar.
Tag	Denetim hakkındaki verileri içeren bir nesneyi alır veya ayarlar. (Devralındığı yer: CommonDialog)
UseEXDialog	Windows XP Home Edition, Windows XP Professional, Windows Server 2003 veya sonraki sürümleri çalıştıran sistemler için iletişim kutusunun Windows XP stilinde gösterilip gösterilmeymeyeceğini belirten bir değer alır veya ayarlar.

Yöntemler

Name	Description
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Ortak bir iletişim kutusuna belirli işlevler eklemek için geçersiz kılınan ortak iletişim kutusu kanca yordamını tanımlar. (Devralındığı yer: CommonDialog)
OnHelpRequest(EventArgs)	Olayı tetikler HelpRequest . (Devralındığı yer: CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Ortak bir iletişim kutusuna belirli işlevler eklemek için geçersiz kılınan sahip penceresi yordamını tanımlar. (Devralındığı yer: CommonDialog)
Reset()	Tüm seçenekleri, son seçilen yazıcıyı ve sayfa ayarlarını varsayılan değerlerine sıfırlar.
RunDialog(IntPtr)	Türetilmiş bir sınıfta geçersiz kılındığında, ortak bir iletişim kutusu belirtir. (Devralındığı yer: CommonDialog)
ShowDialog()	Varsayılan sahibi olan ortak bir iletişim kutusu çalıştırır. (Devralındığı yer: CommonDialog)
ShowDialog(IWin32Window)	Belirtilen sahiple ortak bir iletişim kutusu çalıştırır. (Devralındığı yer: CommonDialog)

Ekinlikler

Name	Description
HelpRequest	Kullanıcı ortak bir iletişim kutusunda Yardım düğmesine tıkladığında gerçekleşir. (Devralındığı yer: CommonDialog)

Ayrıca bkz.

• PageSetupDialog
• PrintPreviewDialog
• PrintDialog Bileşeni (Windows Forms)