Sdílet prostřednictvím


PrintDialog Třída

Definice

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

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

Viz také