Bagikan melalui


PageSetupDialog Kelas

Definisi

Memungkinkan pengguna mengubah setelan cetak terkait halaman, termasuk margin dan orientasi kertas. Kelas ini tidak dapat diwariskan.

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
Warisan

Contoh

Contoh kode berikut menunjukkan PageSetupDialog penggunaan properti , PrinterSettings, dan ShowNetworkPageSettings. Untuk menjalankan contoh ini, letakkan dalam formulir yang berisi Button bernama , bernama ListBox1ListBox , dan bernama PageSetupDialogPageSetupDialog1.Button1 Pastikan peristiwa klik tombol tersambung ke metode penanganan peristiwa dalam contoh ini.

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

Keterangan

Kotak PageSetupDialog dialog memodifikasi PageSettings informasi dan PrinterSettings untuk .Document Pengguna dapat mengaktifkan bagian kotak dialog untuk memanipulasi pencetakan dan margin; orientasi, ukuran, dan sumber kertas; dan untuk menampilkan tombol Bantuan dan jaringan. Properti MinMargins menentukan margin minimum yang dapat dipilih pengguna.

Saat Anda membuat instans PageSetupDialog kelas , properti baca/tulis diatur ke nilai awal. Untuk daftar nilai-nilai ini, lihat PageSetupDialog konstruktor.

PageSetupDialog Karena perlu pengaturan halaman untuk ditampilkan, Anda perlu mengatur Documentproperti , , PrinterSettingsatau PageSettings sebelum memanggil ShowDialog; jika tidak, pengecualian akan terjadi.

Konstruktor

PageSetupDialog()

Menginisialisasi instans baru kelas PageSetupDialog.

Properti

AllowMargins

Mendapatkan atau mengatur nilai yang menunjukkan apakah bagian margin dari kotak dialog diaktifkan.

AllowOrientation

Mendapatkan atau menetapkan nilai yang menunjukkan apakah bagian orientasi kotak dialog (lanskap versus potret) diaktifkan.

AllowPaper

Mendapatkan atau menetapkan nilai yang menunjukkan apakah bagian kertas kotak dialog (ukuran kertas dan sumber kertas) diaktifkan.

AllowPrinter

Mendapatkan atau mengatur nilai yang menunjukkan apakah tombol Printer diaktifkan.

CanRaiseEvents

Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa.

(Diperoleh dari Component)
Container

IContainer Mendapatkan yang berisi Component.

(Diperoleh dari Component)
DesignMode

Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain.

(Diperoleh dari Component)
Document

Mendapatkan atau menetapkan nilai yang menunjukkan PrintDocument untuk mendapatkan pengaturan halaman.

EnableMetric

Mendapatkan atau menetapkan nilai yang menunjukkan apakah pengaturan margin, ketika ditampilkan dalam milimeter, harus secara otomatis dikonversi ke dan dari seratus inci.

Events

Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component.

(Diperoleh dari Component)
MinMargins

Mendapatkan atau menetapkan nilai yang menunjukkan margin minimum, dalam sepersepuluh inci, pengguna diizinkan untuk memilih.

PageSettings

Mendapatkan atau menetapkan nilai yang menunjukkan pengaturan halaman untuk dimodifikasi.

PrinterSettings

Mendapatkan atau menyetel setelan pencetak yang dimodifikasi ketika pengguna mengklik tombol Printer dalam dialog.

ShowHelp

Mendapatkan atau mengatur nilai yang menunjukkan apakah tombol Bantuan terlihat.

ShowNetwork

Mendapatkan atau mengatur nilai yang menunjukkan apakah tombol Jaringan terlihat.

Site

Mendapatkan atau mengatur ISite dari Component.

(Diperoleh dari Component)
Tag

Mendapatkan atau mengatur objek yang berisi data tentang kontrol.

(Diperoleh dari CommonDialog)

Metode

CreateObjRef(Type)

Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh.

(Diperoleh dari MarshalByRefObject)
Dispose()

Merilis semua sumber daya yang Componentdigunakan oleh .

(Diperoleh dari Component)
Dispose(Boolean)

Merilis sumber daya tidak terkelola yang digunakan oleh Component dan secara opsional merilis sumber daya terkelola.

(Diperoleh dari Component)
Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetLifetimeService()
Kedaluwarsa.

Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini.

(Diperoleh dari MarshalByRefObject)
GetService(Type)

Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container.

(Diperoleh dari Component)
GetType()

Mendapatkan dari instans Type saat ini.

(Diperoleh dari Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)

Menentukan prosedur kait kotak dialog umum yang ditimpa untuk menambahkan fungsionalitas tertentu ke kotak dialog umum.

(Diperoleh dari CommonDialog)
InitializeLifetimeService()
Kedaluwarsa.

Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini.

(Diperoleh dari MarshalByRefObject)
MemberwiseClone()

Membuat salinan dangkal dari saat ini Object.

(Diperoleh dari Object)
MemberwiseClone(Boolean)

Membuat salinan dangkal objek saat ini MarshalByRefObject .

(Diperoleh dari MarshalByRefObject)
OnHelpRequest(EventArgs)

Memunculkan kejadian HelpRequest.

(Diperoleh dari CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)

Menentukan prosedur jendela pemilik yang ditimpa untuk menambahkan fungsionalitas tertentu ke kotak dialog umum.

(Diperoleh dari CommonDialog)
Reset()

Mengatur ulang semua opsi ke nilai defaultnya.

RunDialog(IntPtr)

Saat ditimpa dalam kelas turunan, menentukan kotak dialog umum.

(Diperoleh dari CommonDialog)
ShowDialog()

Menjalankan kotak dialog umum dengan pemilik default.

(Diperoleh dari CommonDialog)
ShowDialog(IWin32Window)

Menjalankan kotak dialog umum dengan pemilik yang ditentukan.

(Diperoleh dari CommonDialog)
ToString()

Mengembalikan yang String berisi nama Component, jika ada. Metode ini tidak boleh ditimpa.

(Diperoleh dari Component)

Acara

Disposed

Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode .

(Diperoleh dari Component)
HelpRequest

Terjadi ketika pengguna mengklik tombol Bantuan pada kotak dialog umum.

(Diperoleh dari CommonDialog)

Berlaku untuk

Lihat juga