PageSetupDialog 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 změnit nastavení tisku souvisejícího se stránkou, včetně okrajů a orientace papíru. Tato třída se nemůže dě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í PageSettingsvlastností , PrinterSettingsa ShowNetwork . Pokud chcete tento příklad spustit, umístěte ho do formuláře obsahujícího pojmenované Button1, pojmenované ListBoxListBox1a pojmenované PageSetupDialogPageSetupDialog1.Button Ujistěte se, že je událost kliknutí tlačítka 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 a PrinterSettings pro daný Document. Uživatel může povolit části dialogového okna pro manipulaci s tiskem a okraje; orientace, velikosti a zdroje papíru; a zobrazte tlačítka Nápověda a síť. 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 .

PageSetupDialog Vzhledem k tomu, že zobrazení vyžaduje nastavení stránky, musíte před voláním ShowDialognastavit Documentvlastnost , PrinterSettingsnebo PageSettings . Jinak dojde k výjimce.

Konstruktory

PageSetupDialog()

Inicializuje novou instanci PageSetupDialog třídy .

Vlastnosti

AllowMargins	Získá nebo nastaví hodnotu označující, zda je povolena část okrajů dialogového okna.
AllowOrientation	Získá nebo nastaví hodnotu označující, zda orientace oddíl dialogového okna (na šířku versus na výšku) je povolena.
AllowPaper	Získá nebo nastaví hodnotu označ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 označující, zda je tlačítko Tiskárny povoleno.
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í, ze PrintDocument které chcete získat nastavení stránky.
EnableMetric	Získá nebo nastaví hodnotu označující, zda nastavení okrajů, pokud jsou zobrazeny v milimetrech, by měly být automaticky převedeny na setiny palce a z .
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
MinMargins	Získá nebo nastaví hodnotu označující minimální okraje v setinách palce, uživatel může vybrat.
PageSettings	Získá nebo nastaví hodnotu označující nastavení stránky k úpravě.
PrinterSettings	Získá nebo nastaví nastavení tiskárny, které jsou změněny, když uživatel klepne 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 označující, zda je tlačítko Síť viditelné.
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)

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