PageSetupDialog Класс

Определение

Позволяет пользователям изменять параметры печати для страницы, включая поля и ориентацию бумаги.Enables users to change page-related print settings, including margins and paper orientation. Этот класс не наследуется.This class cannot be inherited.

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
Наследование

Примеры

В следующем примере кода демонстрируется PageSetupDialog использование PageSettings свойств, PrinterSettings и ShowNetwork .The following code example demonstrates the PageSetupDialog using the PageSettings, PrinterSettings, and ShowNetwork properties. Чтобы выполнить этот пример, поместите его в форму, содержащую Button именованный объект Button1 , ListBox именованный объект ListBox1 и PageSetupDialog именованный объект PageSetupDialog1 .To run this example, place it in a form containing a Button named Button1, a ListBox named ListBox1, and a PageSetupDialog named PageSetupDialog1. Убедитесь, что событие нажатия кнопки подключено к методу обработки событий в этом примере.Ensure the button's click event is connected to the event-handling method in this example.

//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 PrinterSettings сведения о и для заданного Document .The PageSetupDialog dialog box modifies the PageSettings and PrinterSettings information for a given Document. Пользователь может включить разделы диалогового окна для управления печатью и полями. ориентация, размер и источник бумаги; и для отображения кнопок Справка и сеть.The user can enable sections of the dialog box to manipulate printing and margins; paper orientation, size, and source; and to show Help and network buttons. MinMarginsСвойство определяет минимальные поля, которые пользователь может выбрать.The MinMargins property defines the minimum margins a user can select.

При создании экземпляра PageSetupDialog класса свойства чтения и записи устанавливаются в начальные значения.When you create an instance of the PageSetupDialog class, the read/write properties are set to initial values. Список этих значений см. в конструкторе PageSetupDialog.For a list of these values, see the PageSetupDialog constructor.

Так как PageSetupDialog для вывода требуются параметры страницы, необходимо задать Document PrinterSettings свойство, или PageSettings перед вызовом ShowDialog ; в противном случае возникнет исключение.Because a PageSetupDialog needs page settings to display, you need to set the Document, PrinterSettings, or PageSettings property before calling ShowDialog; otherwise, an exception will occur.

Конструкторы

PageSetupDialog()

Инициализирует новый экземпляр класса PageSetupDialog.Initializes a new instance of the PageSetupDialog class.

Свойства

AllowMargins

Получает или задает значение, показывающее, включен ли раздел полей в диалоговом окне.Gets or sets a value indicating whether the margins section of the dialog box is enabled.

AllowOrientation

Получает или задает значение, показывающее, включен ли раздел ориентации (книжная или альбомная) в диалоговом окне.Gets or sets a value indicating whether the orientation section of the dialog box (landscape versus portrait) is enabled.

AllowPaper

Получает или задает значение, показывающее, включен ли раздел параметров бумаги (размер и источник) в диалоговом окне.Gets or sets a value indicating whether the paper section of the dialog box (paper size and paper source) is enabled.

AllowPrinter

Получает или задает значение, показывающее, включена ли кнопка Принтер.Gets or sets a value indicating whether the Printer button is enabled.

CanRaiseEvents

Возвращает значение, показывающее, может ли компонент вызывать событие.Gets a value indicating whether the component can raise an event.

(Унаследовано от Component)
Container

Возвращает объект IContainer, который содержит коллекцию Component.Gets the IContainer that contains the Component.

(Унаследовано от Component)
DesignMode

Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время.Gets a value that indicates whether the Component is currently in design mode.

(Унаследовано от Component)
Document

Получает или задает значение, указывающее объект PrintDocument, из которого получаются параметры страницы.Gets or sets a value indicating the PrintDocument to get page settings from.

EnableMetric

Считывает или задает значение, указывающее, должны ли параметры полей, указанные в миллиметрах, автоматически преобразовываться в сотые доли дюйма и обратно.Gets or sets a value indicating whether the margin settings, when displayed in millimeters, should be automatically converted to and from hundredths of an inch.

Events

Возвращает список обработчиков событий, которые прикреплены к этому объекту Component.Gets the list of event handlers that are attached to this Component.

(Унаследовано от Component)
MinMargins

Получает или задает значение, определяющее минимальный размер полей в сотых долях дюйма, который может выбрать пользователь.Gets or sets a value indicating the minimum margins, in hundredths of an inch, the user is allowed to select.

PageSettings

Получает или задает значение, указывающее параметры страницы для изменения.Gets or sets a value indicating the page settings to modify.

PrinterSettings

Получает или задает параметры принтера, которые пользователь может изменить, нажав кнопку "Принтер" в диалоговом окне.Gets or sets the printer settings that are modified when the user clicks the Printer button in the dialog.

ShowHelp

Получает или задает значение, определяющее, видима ли кнопка Справка.Gets or sets a value indicating whether the Help button is visible.

ShowNetwork

Получает или задает значение, определяющее, видима ли кнопка Сеть.Gets or sets a value indicating whether the Network button is visible.

Site

Получает или задает ISite объекта Component.Gets or sets the ISite of the Component.

(Унаследовано от Component)
Tag

Получает или задает объект, содержащий данные элемента управления.Gets or sets an object that contains data about the control.

(Унаследовано от CommonDialog)

Методы

CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Унаследовано от MarshalByRefObject)
Dispose()

Освобождает все ресурсы, занятые модулем Component.Releases all resources used by the Component.

(Унаследовано от Component)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Унаследовано от Component)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetLifetimeService()
Является устаревшей.

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
GetService(Type)

Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container.Returns an object that represents a service provided by the Component or by its Container.

(Унаследовано от Component)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)

Определяет процедуру обработки общего диалогового окна, переопределенную, чтобы добавить специальные функции для общего диалогового окна.Defines the common dialog box hook procedure that is overridden to add specific functionality to a common dialog box.

(Унаследовано от CommonDialog)
InitializeLifetimeService()
Является устаревшей.

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Унаследовано от MarshalByRefObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Унаследовано от MarshalByRefObject)
OnHelpRequest(EventArgs)

Вызывает событие HelpRequest.Raises the HelpRequest event.

(Унаследовано от CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)

Определяет процедуру окна-владельца, которая переопределяется, чтобы добавить специальные функции для общего диалогового окна.Defines the owner window procedure that is overridden to add specific functionality to a common dialog box.

(Унаследовано от CommonDialog)
Reset()

Восстанавливает для всех параметров значения по умолчанию.Resets all options to their default values.

RunDialog(IntPtr)

В случае переопределения в производном классе указывает общее диалоговое окно.When overridden in a derived class, specifies a common dialog box.

(Унаследовано от CommonDialog)
ShowDialog()

Запускает общее диалоговое окно с заданным по умолчанию владельцем.Runs a common dialog box with a default owner.

(Унаследовано от CommonDialog)
ShowDialog(IWin32Window)

Запускает общее диалоговое окно с указанным владельцем.Runs a common dialog box with the specified owner.

(Унаследовано от CommonDialog)
ToString()

Возвращает объект String, содержащий имя Component, если оно есть.Returns a String containing the name of the Component, if any. Этот метод не следует переопределять.This method should not be overridden.

(Унаследовано от Component)

События

Disposed

Возникает при удалении компонента путем вызова метода Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Унаследовано от Component)
HelpRequest

Происходит при нажатии пользователем кнопки справки в общем диалоговом окне.Occurs when the user clicks the Help button on a common dialog box.

(Унаследовано от CommonDialog)

Применяется к

См. также раздел