PageSetupDialog Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

PageSetupDialog.cs

Umožňuje uživatelům změnit nastavení tisku související se stránkou, včetně okrajů a orientace papíru. Tuto třídu nelze zdědit.

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

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

type PageSetupDialog = class
    inherit CommonDialog

Public NotInheritable Class PageSetupDialog
Inherits CommonDialog

Dědičnost

Object

MarshalByRefObject

Component

CommonDialog

PageSetupDialog

Příklady

Následující příklad kódu ukazuje PageSetupDialog použití PageSettings, PrinterSettingsa ShowNetwork vlastnosti. Pokud chcete tento příklad spustit, umístěte ho do formuláře obsahujícího pojmenovaný Button , pojmenovaný ListBox1Button1a pojmenovaný PageSetupDialogPageSetupDialog1.ListBox Ujistěte se, že je událost kliknutí na tlačítko připojená k metodě zpracování událostí v tomto příkladu.

//This method displays a PageSetupDialog object. If the
// user clicks OK in the dialog, selected results of
// the dialog are displayed in ListBox1.
void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   
   // Initialize the dialog's PrinterSettings property to hold user
   // defined printer settings.
   PageSetupDialog1->PageSettings = gcnew System::Drawing::Printing::PageSettings;
   
   // Initialize dialog's PrinterSettings property to hold user
   // set printer settings.
   PageSetupDialog1->PrinterSettings = gcnew System::Drawing::Printing::PrinterSettings;
   
   //Do not show the network in the printer dialog.
   PageSetupDialog1->ShowNetwork = false;
   
   //Show the dialog storing the result.
   System::Windows::Forms::DialogResult result = PageSetupDialog1->ShowDialog();
   
   // If the result is OK, display selected settings in
   // ListBox1. These values can be used when printing the
   // document.
   if ( result == ::DialogResult::OK )
   {
      array<Object^>^results = {PageSetupDialog1->PageSettings->Margins,PageSetupDialog1->PageSettings->PaperSize,PageSetupDialog1->PageSettings->Landscape,PageSetupDialog1->PrinterSettings->PrinterName,PageSetupDialog1->PrinterSettings->PrintRange};
      ListBox1->Items->AddRange( results );
   }
   
}

//This method displays a PageSetupDialog object. If the
// user clicks OK in the dialog, selected results of
// the dialog are displayed in ListBox1.
private void Button1_Click(System.Object sender, System.EventArgs e)
{

    // Initialize the dialog's PrinterSettings property to hold user
    // defined printer settings.
    PageSetupDialog1.PageSettings =
        new System.Drawing.Printing.PageSettings();

    // Initialize dialog's PrinterSettings property to hold user
    // set printer settings.
    PageSetupDialog1.PrinterSettings =
        new System.Drawing.Printing.PrinterSettings();

    //Do not show the network in the printer dialog.
    PageSetupDialog1.ShowNetwork = false;

    //Show the dialog storing the result.
    DialogResult result = PageSetupDialog1.ShowDialog();

    // If the result is OK, display selected settings in
    // ListBox1. These values can be used when printing the
    // document.
    if (result == DialogResult.OK)
    {
        object[] results = new object[]{ 
            PageSetupDialog1.PageSettings.Margins, 
            PageSetupDialog1.PageSettings.PaperSize, 
            PageSetupDialog1.PageSettings.Landscape, 
            PageSetupDialog1.PrinterSettings.PrinterName, 
            PageSetupDialog1.PrinterSettings.PrintRange};
        ListBox1.Items.AddRange(results);
    }
}

'This method displays a PageSetupDialog object. If the
' user clicks OK in the dialog, selected results of
' the dialog are displayed in ListBox1.
Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    ' Initialize the dialog's PrinterSettings property to hold user
    ' defined printer settings.
    PageSetupDialog1.PageSettings = _
        New System.Drawing.Printing.PageSettings

    ' Initialize dialog's PrinterSettings property to hold user
    ' set printer settings.
    PageSetupDialog1.PrinterSettings = _
        New System.Drawing.Printing.PrinterSettings

    'Do not show the network in the printer dialog.
    PageSetupDialog1.ShowNetwork = False

    'Show the dialog storing the result.
    Dim result As DialogResult = PageSetupDialog1.ShowDialog()

    ' If the result is OK, display selected settings in
    ' ListBox1. These values can be used when printing the
    ' document.
    If (result = DialogResult.OK) Then
        Dim results() As Object = New Object() _
            {PageSetupDialog1.PageSettings.Margins, _
             PageSetupDialog1.PageSettings.PaperSize, _
             PageSetupDialog1.PageSettings.Landscape, _
             PageSetupDialog1.PrinterSettings.PrinterName, _
             PageSetupDialog1.PrinterSettings.PrintRange}
        ListBox1.Items.AddRange(results)
    End If

End Sub

Poznámky

Dialogové PageSetupDialog okno upraví PageSettings informace PrinterSettings o daném Document. Uživatel může povolit části dialogového okna pro manipulaci s tiskem a okraji; orientace papíru, velikost a zdroj; a zobrazení tlačítek Nápovědy a sítě. Vlastnost MinMargins definuje minimální okraje, které může uživatel vybrat.

Při vytváření instance PageSetupDialog třídy jsou vlastnosti pro čtení a zápis nastaveny na počáteční hodnoty. Seznam těchto hodnot naleznete v konstruktoru PageSetupDialog .

Vzhledem k tomu, že je třeba před voláním PageSetupDialog nastavit nastavení stránky, musíte před voláním ShowDialognastavit Documentvlastnost , PrinterSettingsnebo PageSettings vlastnost , jinak dojde k výjimce.

Konstruktory

Name	Description
PageSetupDialog()	Inicializuje novou instanci PageSetupDialog třídy.

Vlastnosti

Name	Description
AllowMargins	Získá nebo nastaví hodnotu označující, zda je oddíl okrajů dialogového okna povolen.
AllowOrientation	Získá nebo nastaví hodnotu určující, zda je povolen oddíl orientace dialogového okna (na šířku a na výšku).
AllowPaper	Získá nebo nastaví hodnotu určující, zda je povolena část papíru dialogového okna (formát papíru a zdroj papíru).
AllowPrinter	Získá nebo nastaví hodnotu určující, zda je tlačítko Tiskárna povoleno.
Document	Získá nebo nastaví hodnotu označující PrintDocument , ze které se má získat nastavení stránky.
EnableMetric	Získá nebo nastaví hodnotu určující, zda nastavení okrajů, při zobrazení v milimetrech, by se mělo automaticky převést na a z setiny palce.
MinMargins	Získá nebo nastaví hodnotu označující minimální okraje, v stovkách palce, uživatel může vybrat.
PageSettings	Získá nebo nastaví hodnotu označující nastavení stránky pro úpravy.
PrinterSettings	Získá nebo nastaví nastavení tiskárny, které jsou změněny, když uživatel klikne na tlačítko Tiskárna v dialogovém okně.
ShowHelp	Získá nebo nastaví hodnotu označující, zda je tlačítko Nápověda viditelné.
ShowNetwork	Získá nebo nastaví hodnotu určující, zda je tlačítko Síť viditelné.
Tag	Získá nebo nastaví objekt, který obsahuje data o ovládacím prvku. (Zděděno od CommonDialog)

Metody

Name	Description
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definuje běžnou proceduru háku dialogového okna, která se přepíše a přidá do společného dialogového okna konkrétní funkce. (Zděděno od CommonDialog)
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í funkce do společného dialogového okna. (Zděděno od CommonDialog)
Reset()	Obnoví všechny možnosti na výchozí hodnoty.
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)

Událost

Name	Description
HelpRequest	Nastane, když uživatel klikne na tlačítko Nápověda v běžném dialogovém okně. (Zděděno od CommonDialog)

Viz také

• CommonDialog
• Margins
• PageSettings
• PrintDocument
• PrinterSettings