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 события и проверка аргумента PageSettingsPrintPageEventArgs. Чтобы использовать этот код, добавьте PrintDocument компонент с именем PrintDocument1 в Windows Form и свяжите его 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.QueryPageSettings измените PageSettingsPrintDocument.PrintPage аргумент, включенный в 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 |
Получает координату x(в сотках дюйма) жесткого поля слева от страницы. |
| HardMarginY |
Получает координату y в сотках дюйма жесткого поля в верхней части страницы. |
| 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 Преобразует строку формы. |