Класс PageFormat
java.lang.Object
java.awt.print.PageFormat
- Все реализуемые интерфейсы:
Cloneable
public class PageFormat extends Object implements Cloneable
Класс
PageFormat описывает размер и ориентацию страницы для печати.Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final int |
LANDSCAPE |
Начало отсчёта в нижнем левом углу листа, где x направлен снизу вверх, а y — слева направо. |
static final int |
PORTRAIT |
Начало отсчёта в верхнем левом углу листа, где x направлен справа налево, а y — сверху вниз. |
static final int |
REVERSE_LANDSCAPE |
Начало отсчёта в верхнем правом углу листа, где x направлен сверху вниз, а y — справа налево. |
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
PageFormat() |
Создаёт стандартный, портретный PageFormat. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Object |
clone() |
Создаёт копию этого PageFormat с тем же содержимым, что и у этого PageFormat. |
double |
getHeight() |
Возвращает высоту страницы в 1/72-х дюйма. |
double |
getImageableHeight() |
Возвращает высоту области изображения страницы в 1/72-х дюйма. |
double |
getImageableWidth() |
Возвращает ширину области изображения страницы в 1/72-х дюйма. |
double |
getImageableX() |
Возвращает координату x левого верхнего угла области изображения объекта Paper, связанного с этим PageFormat. |
double |
getImageableY() |
Возвращает координату y левого верхнего угла области изображения объекта Paper, связанного с этим PageFormat. |
double[] |
getMatrix() |
Возвращает матрицу преобразования, которая преобразует рендеринг пространства пользователя в запрошенную ориентацию страницы. |
int |
getOrientation() |
Возвращает ориентацию этого PageFormat. |
Paper |
getPaper() |
Возвращает копию объекта Paper, связанного с этим PageFormat. |
double |
getWidth() |
Возвращает ширину страницы в 1/72-х дюйма. |
void |
setOrientation |
Устанавливает ориентацию страницы. |
void |
setPaper |
Устанавливает объект Paper для этого PageFormat. |
Подробное описание полей
LANDSCAPE
@Native public static final int LANDSCAPE
Начальная точка находится в левом нижнем углу страницы, ось x направлена снизу вверх, а ось y — слева направо. Обратите внимание, что это не макинтошевский режим «альбомная ориентация», а режим «альбомная ориентация» Windows и PostScript.
- См. также:
PORTRAIT
@Native public static final int PORTRAIT
Начальная точка находится в левом верхнем углу страницы, ось x направлена справа налево, а ось y — сверху вниз.
- См. также:
REVERSE_LANDSCAPE
@Native public static final int REVERSE_LANDSCAPE
Начальная точка находится в правом верхнем углу страницы, ось x направлена сверху вниз, а ось y — справа налево. Обратите внимание, что это макинтошевская «альбомная ориентация».
- См. также:
Подробное описание конструкторов
PageFormat
public PageFormat()
Создаёт
PageFormat по умолчанию с ориентацией по умолчанию — портрет.Подробное описание методов
clone
getWidth
public double getWidth()
Возвращает ширину страницы в 1/72-х дюйма. Этот метод учитывает ориентацию страницы при определении ширины.
- Возвращает:
- ширину страницы.
getHeight
public double getHeight()
Возвращает высоту страницы в 1/72-х дюйма. Этот метод учитывает ориентацию страницы при определении высоты.
- Возвращает:
- высоту страницы.
getImageableX
public double getImageableX()
Возвращает координату x левого верхнего угла области изображения объекта
Paper, связанного с этим PageFormat. Этот метод учитывает ориентацию страницы.- Возвращает:
- координату x левого верхнего угла области изображения объекта
Paper, связанного с этимPageFormat.
getImageableY
public double getImageableY()
Возвращает координату y левого верхнего угла области изображения объекта
Paper, связанного с этим PageFormat. Этот метод учитывает ориентацию страницы.- Возвращает:
- координату y левого верхнего угла области изображения объекта
Paper, связанного с этимPageFormat.
getImageableWidth
public double getImageableWidth()
Возвращает ширину области изображения страницы в 1/72-х дюйма. Этот метод учитывает ориентацию страницы.
- Возвращает:
- ширину страницы.
getImageableHeight
public double getImageableHeight()
Возвращает высоту области изображения страницы в 1/72-х дюйма. Этот метод учитывает ориентацию страницы.
- Возвращает:
- высоту страницы.
getPaper
public Paper getPaper()
Возвращает копию объекта
Paper, связанного с этим PageFormat. Изменения, внесённые в объект Paper, возвращённый этим методом, не влияют на объект Paper этого PageFormat. Для обновления объекта Paper этого PageFormat, создайте новый объект Paper и задайте его в этом PageFormat, используя метод setPaper(Paper).- Возвращает:
- копию объекта
Paper, связанного с этимPageFormat. - См. также:
setPaper
public void setPaper(Paper paper)
Устанавливает объект
Paper для этого PageFormat.- Параметры:
-
paper— объектPaper, которому необходимо задать объектPaperдля этогоPageFormat. - Исключения:
-
NullPointerException— передан экземпляр нулевого paper. - См. также:
setOrientation
public void setOrientation(int orientation) throws IllegalArgumentException
Устанавливает ориентацию страницы.
orientation должно быть одной из констант: PORTRAIT, LANDSCAPE или REVERSE_LANDSCAPE.- Параметры:
-
orientation— новая ориентация страницы - Исключения:
-
IllegalArgumentException— если была запрошена неизвестная ориентация - См. также:
getOrientation
public int getOrientation()
Возвращает ориентацию этого
PageFormat.- Возвращает:
- ориентация объекта
PageFormat. - См. также:
getMatrix
public double[] getMatrix()
Возвращает матрицу преобразования, которая переводит рендеринг пространства пользователя в запрошенную ориентацию страницы. Значения помещаются в массив как { m00, m10, m01, m11, m02, m12} в формате, требуемом конструктором
AffineTransform.- Возвращает:
- матрица, используемая для перевода рендеринга пространства пользователя в ориентацию страницы.
- См. также:
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/print/PageFormat.html