Spec-Zone.ru › OpenJDK 21

Класс RectangularShape

java.lang.Object
java.awt.geom.RectangularShape
Все реализованные интерфейсы:
Shape, Cloneable
Прямые известные подклассы:
Arc2D, Ellipse2D, Rectangle2D, RoundRectangle2D
public abstract class RectangularShape extends Object implements Shape, Cloneable
RectangularShape — базовый класс для ряда объектов Shape, чья геометрия определяется прямоугольной рамкой. Сам по себе этот класс не определяет конкретной геометрии, а лишь предоставляет методы управления, унаследованные целым классом объектов Shape. Предоставленные этим классом методы могут использоваться для запроса и изменения прямоугольной рамки, которая служит ссылкой для подклассов, чтобы определить свою геометрию.
С тех пор:
1.2

Краткое описание конструкторов

RectangularShape()
Модификатор Конструктор Описание
protected
Этот абстрактный класс не может быть напрямую инстанцирован.

Краткое описание методов

Модификатор и тип Метод Описание
Object clone()
Создаёт новый объект того же класса с тем же содержимым, что и этот объект.
boolean contains(Point2D p)
Проверяет, находится ли указанная Point2D внутри границ Shape, как описано в определении попадания внутри.
boolean contains(Rectangle2D r)
Проверяет, полностью ли внутренняя часть Shape содержит указанный Rectangle2D.
Rectangle getBounds()
Возвращает целое число Rectangle, которое полностью охватывает Shape.
double getCenterX()
Возвращает координату X центра прямоугольной рамки Shape с точностью double.
double getCenterY()
Возвращает координату Y центра прямоугольной рамки Shape с точностью double.
Rectangle2D getFrame()
Возвращает прямоугольную Rectangle2D рамку, определяющую общую форму этого объекта.
abstract double getHeight()
Возвращает высоту прямоугольной рамки с точностью double.
double getMaxX()
Возвращает максимальную координату X прямоугольной рамки Shape с точностью double.
double getMaxY()
Возвращает максимальную координату Y прямоугольной рамки Shape с точностью double.
double getMinX()
Возвращает минимальную координату X прямоугольной рамки Shape с точностью double.
double getMinY()
Возвращает минимальную координату Y прямоугольной рамки Shape с точностью double.
PathIterator getPathIterator(AffineTransform at, double flatness)
Возвращает объект-итератор, который итерирует по границе объекта Shape и предоставляет доступ к уплощенному представлению контура геометрии объекта Shape.
abstract double getWidth()
Возвращает ширину прямоугольной рамки с точностью double.
abstract double getX()
Возвращает координату X верхнего левого угла прямоугольной рамки с точностью double.
abstract double getY()
Возвращает координату Y верхнего левого угла прямоугольной рамки с точностью double.
boolean intersects(Rectangle2D r)
Проверяет, пересекается ли внутренняя часть Shape с внутренней частью указанного Rectangle2D.
abstract boolean isEmpty()
Определяет, пуста ли RectangularShape.
abstract void setFrame(double x, double y, double w, double h)
Устанавливает положение и размер прямоугольной рамки этого Shape до указанных прямоугольных значений.
void setFrame(Point2D loc, Dimension2D size)
Устанавливает положение и размер прямоугольной рамки этого Shape до указанных Point2D и Dimension2D, соответственно.
void setFrame(Rectangle2D r)
Устанавливает прямоугольную рамку этого Shape на указанную Rectangle2D.
void setFrameFromCenter(double centerX, double centerY, double cornerX, double cornerY)
Устанавливает прямоугольную рамку этого Shape на основе указанных координат центра и углов.
void setFrameFromCenter(Point2D center, Point2D corner)
Устанавливает прямоугольную рамку этого Shape на основе заданного центра Point2D и координат углов Point2D.
void setFrameFromDiagonal(double x1, double y1, double x2, double y2)
Устанавливает диагональ прямоугольной рамки этого Shape на основе двух заданных координат.
void setFrameFromDiagonal(Point2D p1, Point2D p2)
Устанавливает диагональ прямоугольной рамки этого Shape на основе двух заданных объектов Point2D.

Методы, объявленные в классе java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, объявленные в интерфейсе java.awt.Shape

contains, contains, getBounds2D, getPathIterator, intersects

Подробное описание конструкторов

RectangularShape

protected RectangularShape()
Это абстрактный класс, который нельзя создать напрямую.
С момента:
1.2
См. также:
  • Arc2D
  • Ellipse2D
  • Rectangle2D
  • RoundRectangle2D

Подробное описание методов

getX

public abstract double getX()
Возвращает координату X левого верхнего угла рамки в double точности.
Возвращает:
координату X левого верхнего угла рамки.
С момента:
1.2

getY

public abstract double getY()
Возвращает координату Y левого верхнего угла рамки в double точности.
Возвращает:
координату Y левого верхнего угла рамки.
С момента:
1.2

getWidth

public abstract double getWidth()
Возвращает ширину рамки в double точности.
Возвращает:
ширину рамки.
С момента:
1.2

getHeight

public abstract double getHeight()
Возвращает высоту рамки в double точности.
Возвращает:
высоту рамки.
С момента:
1.2

getMinX

public double getMinX()
Возвращает наименьшую координату X рамки Shape в double точности.
Возвращает:
наименьшую координату X рамки Shape.
С момента:
1.2

getMinY

public double getMinY()
Возвращает наименьшую координату Y рамки Shape в double точности.
Возвращает:
наименьшую координату Y рамки Shape.
С момента:
1.2

getMaxX

public double getMaxX()
Возвращает наибольшую координату X рамки Shape в double точности.
Возвращает:
наибольшую координату X рамки Shape.
С момента:
1.2

getMaxY

public double getMaxY()
Возвращает наибольшую координату Y рамки Shape в double точности.
Возвращает:
наибольшую координату Y рамки Shape.
С момента:
1.2

getCenterX

public double getCenterX()
Возвращает координату X центра рамки Shape в double точности.
Возвращает:
координату X центра рамки Shape.
С момента:
1.2

getCenterY

public double getCenterY()
Возвращает координату Y центра рамки Shape в double точности.
Возвращает:
координату Y центра рамки Shape.
С момента:
1.2

getFrame

public Rectangle2D getFrame()
Возвращает рамку Rectangle2D, которая определяет общую форму этого объекта.
Возвращает:
объект Rectangle2D, заданный в double координатах.
С момента:
1.2
См. также:
  • setFrame(double, double, double, double)
  • setFrame(Point2D, Dimension2D)
  • setFrame(Rectangle2D)

isEmpty

public abstract boolean isEmpty()
Определяет, является ли RectangularShape пустым. Когда RectangularShape пустой, он не охватывает никакой области.
Возвращает:
true если RectangularShape пустой; false в противном случае.
С момента:
1.2

setFrame

public abstract void setFrame(double x, double y, double w, double h)
Устанавливает расположение и размер рамки этого Shape на заданные прямоугольные значения.
Параметры:
x - координата X левого верхнего угла заданной прямоугольной фигуры
y - координата Y левого верхнего угла заданной прямоугольной фигуры
w - ширина заданной прямоугольной фигуры
h - высота заданной прямоугольной фигуры
С момента:
1.2
См. также:
  • getFrame()

setFrame

public void setFrame(Point2D loc, Dimension2D size)
Устанавливает расположение и размер рамки этого Shape на заданные Point2D и Dimension2D соответственно. Рамка используется подклассами RectangularShape для определения своей геометрии.
Параметры:
loc - заданная Point2D
size - заданная Dimension2D
С момента:
1.2
См. также:
  • getFrame()

setFrame

public void setFrame(Rectangle2D r)
Устанавливает рамку этого Shape на заданную Rectangle2D. Рамка используется подклассами RectangularShape для определения своей геометрии.
Параметры:
r - заданная Rectangle2D
С момента:
1.2
См. также:
  • getFrame()

setFrameFromDiagonal

public void setFrameFromDiagonal(double x1, double y1, double x2, double y2)
Устанавливает диагональ рамки этого Shape на основе двух заданных координат. Рамка используется подклассами RectangularShape для определения своей геометрии.
Параметры:
x1 - координата X начальной точки заданной диагонали
y1 - координата Y начальной точки заданной диагонали
x2 - координата X конечной точки заданной диагонали
y2 - координата Y конечной точки заданной диагонали
С момента:
1.2

setFrameFromDiagonal

public void setFrameFromDiagonal(Point2D p1, Point2D p2)
Устанавливает диагональ рамки этого Shape на основе двух заданных объектов Point2D. Рамка используется подклассами RectangularShape для определения своей геометрии.
Параметры:
p1 - начальная Point2D заданной диагонали
p2 - конечная Point2D заданной диагонали
С момента:
1.2

setFrameFromCenter

public void setFrameFromCenter(double centerX, double centerY, double cornerX, double cornerY)
Устанавливает рамку этого Shape на основе заданной центральной точки и координаты угла. Рамка используется подклассами RectangularShape для определения своей геометрии.
Параметры:
centerX - координата X заданной центральной точки
centerY - координата Y заданной центральной точки
cornerX - координата X заданной угловой точки
cornerY - координата Y заданной угловой точки
С момента:
1.2

setFrameFromCenter

public void setFrameFromCenter(Point2D center, Point2D corner)
Устанавливает рамку этого Shape на основе заданной центральной Point2D и угловой Point2D. Рамка используется подклассами RectangularShape для определения своей геометрии.
Параметры:
center - заданная центральная Point2D
corner - заданная угловая Point2D
С момента:
1.2

contains

public boolean contains(Point2D p)
Проверяет, находится ли указанная Point2D внутри границ Shape, как описано в определении принадлежности.
Определено в:
contains в интерфейсе Shape
Параметры:
p - указанная Point2D для проверки
Возвращает:
true , если указанная Point2D находится внутри границ Shape; false в противном случае.
С:
1.2

intersects

public boolean intersects(Rectangle2D r)
Проверяет, пересекается ли внутренняя область Shape с внутренней областью указанного Rectangle2D. Метод Shape.intersects() позволяет реализации Shape консервативно возвращать true в следующих случаях:
  • существует высокая вероятность пересечения Rectangle2D и Shape, но
  • вычисления для точного определения этого пересечения слишком дорогостоящие.
Это означает, что для некоторых Shapes этот метод может возвращать true, даже если Rectangle2D не пересекается с Shape. Класс Area выполняет более точные вычисления геометрических пересечений, чем большинство объектов Shape и, следовательно, может быть использован, если требуется более точный ответ.
Определено в:
intersects в интерфейсе Shape
Параметры:
r - указанный Rectangle2D
Возвращает:
true , если внутренняя область Shape и внутренняя область указанного Rectangle2D пересекаются или с высокой вероятностью пересекаются, но вычисления пересечения слишком дорогостоящи; false в противном случае.
С:
1.2
См. также:
  • Shape.intersects(double, double, double, double)

contains

public boolean contains(Rectangle2D r)
Проверяет, полностью ли внутренняя область Shape содержит указанный Rectangle2D. Метод Shape.contains() позволяет реализации Shape консервативно возвращать false в следующих случаях:
  • метод intersect возвращает true и
  • вычисления для определения того, полностью ли Shape содержит Rectangle2D, слишком дорогостоящие.
Это означает, что для некоторых Shapes этот метод может возвращать false, даже если Shape содержит Rectangle2D. Класс Area выполняет более точные геометрические вычисления, чем большинство объектов Shape и, следовательно, может быть использован, если требуется более точный ответ.
Определено в:
contains в интерфейсе Shape
Параметры:
r - Указанный Rectangle2D
Возвращает:
true , если внутренняя область Shape полностью содержит Rectangle2D; false в противном случае, или если Shape содержит Rectangle2D и метод intersects возвращает true, а вычисления принадлежности слишком дорогостоящие.
С:
1.2
См. также:
  • Shape.contains(double, double, double, double)

getBounds

public Rectangle getBounds()
Возвращает целые координаты Rectangle, полностью охватывающие Shape. Обратите внимание, что нет гарантии, что возвращаемый Rectangle является наименьшей ограничивающей прямоугольником, охватывающей Shape, только что Shape полностью лежит внутри указанного Rectangle. Возвращаемый Rectangle также может не полностью охватить Shape, если Shape выходит за пределы ограниченного диапазона целочисленного типа данных. Метод getBounds2D обычно возвращает более узкий ограничивающий прямоугольник из-за большей гибкости в представлении.

Обратите внимание, что определение принадлежности может привести к ситуациям, когда точки на определяющей контуре shape могут не считаться содержащимися в возвращаемом bounds объекте, но только в тех случаях, когда эти точки также не считаются содержащимися в исходном shape.

Если point находится внутри shape согласно методу contains(point), то он должен находиться внутри границ возвращаемого Rectangle объекта согласно методу contains(point) bounds.

shape.contains(x,y) требует bounds.contains(x,y)

Если point не находится внутри shape, то он все еще может быть заключен в bounds объект:

bounds.contains(x,y) не подразумевает shape.contains(x,y)

Определено в:
getBounds в интерфейсе Shape
Возвращает:
целые координаты Rectangle , полностью охватывающие Shape.
С:
1.2
См. также:
  • Shape.getBounds2D()

getPathIterator

public PathIterator getPathIterator(AffineTransform at, double flatness)
Возвращает объект-итератор, который проходит по границе объекта Shape и обеспечивает доступ к сплющенному представлению контура геометрии объекта Shape.

Итератор будет возвращать только типы точек SEG_MOVETO, SEG_LINETO и SEG_CLOSE.

Степень разбиения криволинейных отрезков контролируется параметром flatness, который задает максимальное расстояние, на которое любая точка на несплющенной преобразованной кривой может отклоняться от возвращаемых сплющенных отрезков пути. Можно указать необязательное AffineTransform, чтобы координаты, возвращаемые при итерации, преобразовывались соответствующим образом.

Определено в:
getPathIterator в интерфейсе Shape
Параметры:
at - необязательное AffineTransform для применения к координатам по мере их возврата в процессе итерации, или null для получения не преобразованных координат.
flatness - максимальное расстояние, на которое отрезки прямых, используемые для аппроксимации криволинейных отрезков, могут отклоняться от любой точки исходной кривой
Возвращает:
объект PathIterator , который предоставляет доступ к сплющенной геометрии объекта Shape.
С:
1.2

clone

public Object clone()
Создаёт новый объект того же класса и с тем же содержимым, что и этот объект.
Переопределяет:
clone в классе Object
Возвращает:
клонированный экземпляр.
Исключения:
OutOfMemoryError - если памяти недостаточно.
С:
1.2
См. также:
  • Cloneable

© 1993, 2023, 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://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/java/awt/geom/RectangularShape.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API