PageSetupDialog Kelas

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

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: Object

MarshalByRefObject

Component

CommonDialog
PageSetupDialog

Contoh

Contoh kode berikut menunjukkan PageSetupDialog penggunaan properti , PrinterSettings, dan ShowNetwork PageSettings. 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

Share via