PrintDialog Sınıf

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Kullanıcıların bir yazıcı seçmesine ve belgenin hangi bölümlerinin 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 olayının PrintPagedocToPrint 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 başlangıç değerlerine 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

PrintDialog()

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

Özellikler

AllowCurrentPage	Geçerli Sayfa seçenek 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 etkinleştirilip etkinleştirilmediğini 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.
CanRaiseEvents	Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component)
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
DesignMode	öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component)
Document	elde PrinterSettingsetmek için kullanılan değerini belirtir PrintDocument veya alır.
Events	Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
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.
Site	öğesini alır veya ayarlar ISite Component. (Devralındığı yer: Component)
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

CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	Component tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	Component tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır. (Devralındığı yer: Component)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Geçersiz. Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetService(Type)	veya tarafından Component Containersağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
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)
InitializeLifetimeService()	Geçersiz. Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
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)
ToString()	Varsa, adını Componentiçeren bir String döndürür. Bu yöntem geçersiz kılınmamalıdır. (Devralındığı yer: Component)

Ekinlikler

Disposed	Bileşen yöntemine Dispose() yapılan bir çağrı tarafından atıldığında gerçekleşir. (Devralındığı yer: Component)
HelpRequest	Kullanıcı ortak bir iletişim kutusundaki Yardım düğmesine tıkladığında gerçekleşir. (Devralındığı yer: CommonDialog)

Şunlara uygulanır