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


PageSetupDialog Класс

Определение

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

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 . Чтобы выполнить этот пример, поместите его в форму, содержащую 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)

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

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