PageSetupDialog 类

参考

定义

命名空间:: System.Windows.Forms

程序集:: System.Windows.Forms.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

允许用户更改与页面相关的打印设置，包括边距和纸张方向。此类不能被继承。

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

继承: Object

MarshalByRefObject

Component

CommonDialog
PageSetupDialog

示例

下面的代码示例演示如何 PageSetupDialog 使用 PageSettings、 PrinterSettings和 ShowNetwork 属性。若要运行此示例，请将其置于包含Button名为、ListBox名为 Button1和 PageSetupDialog 的ListBox1PageSetupDialog1窗体中。确保按钮的单击事件已连接到此示例中的事件处理方法。

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

注解

对话框PageSetupDialog修改PageSettings给定 Document的和 PrinterSettings 信息。用户可以启用对话框的各个部分来操作打印和边距;纸张方向、大小和源;和，以显示“帮助”和“网络”按钮。属性 MinMargins 定义用户可以选择的最小边距。

创建类的 PageSetupDialog 实例时，读/写属性设置为初始值。有关这些值的列表，请参阅 PageSetupDialog 构造函数。

PageSetupDialog由于需要页面设置才能显示，因此你需要在调用 ShowDialog之前设置 Document、 PrinterSettings或 PageSettings 属性;否则，将发生异常。

构造函数

PageSetupDialog()

初始化 PageSetupDialog 类的新实例。

属性

AllowMargins	获取或设置一个值，该值指示是否启用对话框的边距部分。
AllowOrientation	获取或设置一个值，该值指示是否启用对话框的方向部分（横向对纵向）。
AllowPaper	获取或设置一个值，该值指示是否启用对话框的纸张部分（纸张大小和纸张来源）。
AllowPrinter	获取或设置一个值，该值指示是否启用“打印机”按钮。
CanRaiseEvents	获取一个指示组件是否可以引发事件的值。 (继承自 Component)
Container	获取包含 IContainer 的 Component。 (继承自 Component)
DesignMode	获取一个值，用以指示 Component 当前是否处于设计模式。 (继承自 Component)
Document	获取或设置一个值，指示从中获取页面设置的 PrintDocument。
EnableMetric	获取或设置一个值，该值指示以毫米显示时，边距设置是否应在百分之一英寸与毫米之间自动转换。
Events	获取附加到此 Component 的事件处理程序的列表。 (继承自 Component)
MinMargins	获取或设置一个值，该值指示允许用户选择的最小边距（以百分之一英寸为单位）。
PageSettings	获取或设置一个值，该值指示要修改的页设置。
PrinterSettings	获取或设置用户单击对话框中“打印机”按钮时修改的打印机设置。
ShowHelp	获取或设置一个值，该值指示“帮助”按钮是否可见。
ShowNetwork	获取或设置一个值，该值指示“网络”按钮是否可见。
Site	获取或设置 Component 的 ISite。 (继承自 Component)
Tag	获取或设置一个对象，该对象包含控件的数据。 (继承自 CommonDialog)

方法

CreateObjRef(Type)	创建一个对象，该对象包含生成用于与远程对象进行通信的代理所需的全部相关信息。 (继承自 MarshalByRefObject)
Dispose()	释放由 Component 使用的所有资源。 (继承自 Component)
Dispose(Boolean)	释放由 Component 占用的非托管资源，还可以另外再释放托管资源。 (继承自 Component)
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetLifetimeService()	已过时. 检索控制此实例的生存期策略的当前生存期服务对象。 (继承自 MarshalByRefObject)
GetService(Type)	返回一个对象，该对象表示由 Component 或它的 Container 提供的服务。 (继承自 Component)
GetType()	获取当前实例的 Type。 (继承自 Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	定义要重写的通用对话框挂钩过程，以便向通用对话框添加特定功能。 (继承自 CommonDialog)
InitializeLifetimeService()	已过时. 获取生存期服务对象来控制此实例的生存期策略。 (继承自 MarshalByRefObject)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
MemberwiseClone(Boolean)	创建当前 MarshalByRefObject 对象的浅表副本。 (继承自 MarshalByRefObject)
OnHelpRequest(EventArgs)	引发 HelpRequest 事件。 (继承自 CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	定义要重写的所有者窗口过程，以便向通用对话框添加特定功能。 (继承自 CommonDialog)
Reset()	将所有选项重新设置为其默认值。
RunDialog(IntPtr)	在派生类中被重写时，指定通用对话框。 (继承自 CommonDialog)
ShowDialog()	用默认的所有者运行通用对话框。 (继承自 CommonDialog)
ShowDialog(IWin32Window)	运行具有指定所有者的通用对话框。 (继承自 CommonDialog)
ToString()	返回包含 Component 的名称的 String（如果有）。不应重写此方法。 (继承自 Component)

事件

Disposed	在通过调用 Dispose() 方法释放组件时发生。 (继承自 Component)
HelpRequest	当用户单击通用对话框中的“帮助”按钮时发生。 (继承自 CommonDialog)

适用于

通过

PageSetupDialog 类

定义

示例

注解

构造函数

属性

方法

事件

适用于

另请参阅

其他资源