PageSettings Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Задает параметры одной страницы, выводимой на печать.
public ref class PageSettings : ICloneable
public class PageSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
public class PageSettings : ICloneable
[System.Serializable]
public class PageSettings : ICloneable
type PageSettings = class
interface ICloneable
[<System.Runtime.InteropServices.ComVisible(false)>]
type PageSettings = class
interface ICloneable
[<System.Serializable>]
type PageSettings = class
interface ICloneable
Public Class PageSettings
Implements ICloneable
- Наследование
-
PageSettings
- Атрибуты
- Реализации
Примеры
В следующем примере показана 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 в указанную структуру |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
SetHdevmode(IntPtr) |
Копирует релевантную информацию в форму PageSettings из указанной структуры |
ToString() |
Преобразует объект PageSettings в форму строки. |