Aracılığıyla paylaş


PrintDialog Sınıf

Tanım

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

Ö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

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 ISiteComponent.

(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 ComponentContainersağ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

Ayrıca bkz.