PageSettings Класс

Определение

Пространство имен:

System.Drawing.Printing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

Исходный код:

PageSettings.cs

Задает параметры одной страницы, выводимой на печать.

public ref class PageSettings : ICloneable

public class PageSettings : ICloneable

type PageSettings = class
    interface ICloneable

Public Class PageSettings
Implements ICloneable

Наследование

Object

PageSettings

Реализации

ICloneable

Примеры

В следующем примере показана PrintPage обработка события и проверка PageSettings аргумента PrintPageEventArgs. Чтобы использовать этот код, добавьте компонент с PrintDocument именем PrintDocument1 в Форму Windows Forms и свяжите его PrintPage событие с методом printDocument1_PrintPage в примере.

private void printDocument1_PrintPage(object sender, System.Drawing.Printing.PrintPageEventArgs e)
{
    if (e.PageSettings.Color && !printDocument1.PrinterSettings.SupportsColor)
        MessageBox.Show("Color printing not supported on selected printer.", "Printer Warning", MessageBoxButtons.OKCancel);
}

Private Sub printDocument1_PrintPage(ByVal sender As Object, ByVal e As System.Drawing.Printing.PrintPageEventArgs)  Handles printDocument1.PrintPage
    If e.PageSettings.Color AndAlso Not printDocument1.PrinterSettings.SupportsColor Then
        MessageBox.Show("Color printing not supported on selected printer.", "Printer Warning", MessageBoxButtons.OKCancel)
    End If

End Sub

Комментарии

Класс PageSettings используется для указания параметров, которые изменяют способ печати страницы. Как правило, вы устанавливаете параметры по умолчанию для всех страниц, которые будут напечатаны с помощью PrintDocument.DefaultPageSettings свойства . Чтобы указать параметры на разных страницах, обработайте PrintDocument.PrintPage событие или PrintDocument.QueryPageSettings и измените PageSettings аргумент, включенный PrintPageEventArgs в или QueryPageSettingsEventArgsсоответственно.

Дополнительные сведения об обработке PrintDocument событий см. в обзоре PrintDocument класса. Дополнительные сведения о печати см. в обзоре System.Drawing.Printing пространства имен.

Примечание

В .NET 6 и более поздних версиях пакет System.Drawing.Common, включающий этот тип, поддерживается только в операционных системах Windows. Использование этого типа в кроссплатформенных приложениях вызывает предупреждения во время компиляции и исключения во время выполнения. Дополнительные сведения см . в статье System.Drawing.Common, поддерживаемая только в Windows.

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

PageSettings()	Инициализирует новый экземпляр класса PageSettings с помощью принтера, используемого по умолчанию.
PageSettings(PrinterSettings)	Инициализирует новый экземпляр класса PageSettings с помощью указанного принтера.

Свойства

Bounds	Получает размер страницы, принимая во внимание ориентацию страницы, заданную свойством Landscape.
Color	Получает или задает значение, определяющее необходимость цветной печати страницы.
HardMarginX	Получает координату на оси х в сотых долях дюйма фиксированного поля с левой стороны страницы.
HardMarginY	Получает координату на оси у в сотых долях дюйма фиксированного поля в верхней части страницы.
Landscape	Получает или задает значение, показывающее, выполняется печать страницы с альбомной или с книжной ориентацией.
Margins	Получает или задает поля страницы.
PaperSize	Получает или задает размер бумаги для страницы.
PaperSource	Получает или задает источник бумаги для страницы, например верхний лоток принтера.
PrintableArea	Получает границы области печати страницы для принтера.
PrinterResolution	Получает или задает разрешающую способность принтера для страницы.
PrinterSettings	Получает или задает параметры принтера для страницы.

Методы

Clone()	Создает копию данного объекта PageSettings.
CopyToHdevmode(IntPtr)	Копирует релевантную информацию из PageSettings в указанную структуру DEVMODE.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
SetHdevmode(IntPtr)	Копирует релевантную информацию в форму PageSettings из указанной структуры DEVMODE.
ToString()	Преобразует объект PageSettings в форму строки.

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

• PrintDocument
• PrinterSettings