PrintDialog Třída

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Umožňuje uživatelům vybrat tiskárnu a zvolit, které části dokumentu se mají vytisknout z model Windows Forms aplikace.

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

Dědičnost: Object

MarshalByRefObject

Component

CommonDialog
PrintDialog

Příklady

Následující příklad kódu ukazuje použití PrintDialog ovládacího prvku k nastavení AllowSomePages, ShowHelpa Document vlastnosti. Chcete-li spustit tento příklad, vložte následující kód do formuláře, který obsahuje PrintDialog ovládací prvek s názvem PrintDialog1 a tlačítko s názvem Button1. Tento příklad vyžaduje, aby se událost tlačítka Click a PrintPage událost docToPrint připojily k metodám zpracování událostí definovaným v tomto příkladu.

// 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

Poznámky

Když vytvoříte instanci PrintDialog, vlastnosti pro čtení a zápis se nastaví na počáteční hodnoty. Seznam těchto hodnot naleznete v konstruktoru PrintDialog . Pokud chcete získat nastavení tiskárny, která uživatel změnil pomocí PrintDialog, použijte PrinterSettings vlastnost .

Další informace o tisku s model Windows Forms najdete v přehledu System.Drawing.Printing oboru názvů. Pokud chcete tisknout z aplikace Windows Presentation Foundation, podívejte se na System.Printing obor názvů.

Konstruktory

PrintDialog()

Inicializuje novou instanci PrintDialog třídy .

Vlastnosti

AllowCurrentPage	Získá nebo nastaví hodnotu označující, zda aktuální stránka přepínač je zobrazena.
AllowPrintToFile	Získá nebo nastaví hodnotu označující, zda tisk do souboru zaškrtávací políčko je povoleno.
AllowSelection	Získá nebo nastaví hodnotu označující, zda je povoleno tlačítko výběru .
AllowSomePages	Získá nebo nastaví hodnotu označující, zda pages přepínač je povolen.
CanRaiseEvents	Získá hodnotu označující, zda komponenta může vyvolat událost. (Zděděno od Component)
Container	Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
DesignMode	Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
Document	Získá nebo nastaví hodnotu označující hodnotu použitou PrintDocument k získání PrinterSettings.
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
PrinterSettings	Získá nebo nastaví nastavení tiskárny modifikuje dialogové okno.
PrintToFile	Získá nebo nastaví hodnotu označující, zda je políčko Tisk do souboru zaškrtnuté.
ShowHelp	Získá nebo nastaví hodnotu označující, zda je zobrazen tlačítko Nápověda .
ShowNetwork	Získá nebo nastaví hodnotu označující, zda je zobrazena tlačítko Síť .
Site	Získá nebo nastaví ISite z Component. (Zděděno od Component)
Tag	Získá nebo nastaví objekt, který obsahuje data o ovládacím prvku. (Zděděno od CommonDialog)
UseEXDialog	Získá nebo nastaví hodnotu označující, zda má být dialogové okno zobrazeno ve stylu systému Windows XP pro systémy se systémem Windows XP Home Edition, Windows XP Professional, Windows Server 2003 nebo novější.

Metody

CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní nespravované prostředky používané nástrojem Component a volitelně uvolní spravované prostředky. (Zděděno od Component)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo .Container (Zděděno od Component)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definuje společnou proceduru hooku dialogového okna, která je přepsána pro přidání konkrétních funkcí do běžného dialogového okna. (Zděděno od CommonDialog)
InitializeLifetimeService()	Zastaralé. Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
OnHelpRequest(EventArgs)	HelpRequest Vyvolá událost. (Zděděno od CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definuje proceduru okna vlastníka, která je přepsána pro přidání konkrétních funkcí do společného dialogového okna. (Zděděno od CommonDialog)
Reset()	Obnoví výchozí hodnoty všech možností, naposledy vybrané tiskárny a nastavení stránky.
RunDialog(IntPtr)	Při přepsání v odvozené třídě určuje společné dialogové okno. (Zděděno od CommonDialog)
ShowDialog()	Spustí společné dialogové okno s výchozím vlastníkem. (Zděděno od CommonDialog)
ShowDialog(IWin32Window)	Spustí společné dialogové okno se zadaným vlastníkem. (Zděděno od CommonDialog)
ToString()	String Vrátí hodnotu obsahující název , Componentpokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)

Událost

Disposed	Vyvolá se, když je komponenta uvolněna voláním Dispose() metody . (Zděděno od Component)
HelpRequest	Vyvolá se, když uživatel klikne na tlačítko Nápověda ve společném dialogovém okně. (Zděděno od CommonDialog)

Platí pro