PageSetupDialog Класс

Ссылка

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Позволяет пользователям изменять параметры печати для страницы, включая поля и ориентацию бумаги. Этот класс не наследуется.

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 с именем Button1, ListBox с именем ListBox1и PageSetupDialog с именем PageSetupDialog1. Убедитесь, что событие нажатия кнопки подключено к методу обработки событий в этом примере.

//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. Пользователь может включить разделы диалогового окна для управления печатью и полями; ориентация, размер и источник бумаги; и для отображения кнопок "Справка" и "Сеть". Свойство MinMargins определяет минимальные поля, которые может выбрать пользователь.

При создании экземпляра PageSetupDialog класса свойствам чтения и записи присваиваются начальные значения. Список этих значений см. в конструкторе PageSetupDialog.

PageSetupDialog Так как требуется отображение параметров страницы, необходимо задать Documentсвойство , PrinterSettingsили PageSettings перед вызовом ShowDialog; в противном случае возникнет исключение.

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

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	Получает или задает ISite объекта Component. (Унаследовано от 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()	Возвращает объект String, содержащий имя Component, если оно есть. Этот метод не следует переопределять. (Унаследовано от Component)

События

Disposed	Возникает при удалении компонента путем вызова метода Dispose(). (Унаследовано от Component)
HelpRequest	Происходит при нажатии пользователем кнопки справки в общем диалоговом окне. (Унаследовано от CommonDialog)

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

Поделиться через