java.awt

Интерфейсная Форма

Все Известные Классы с реализацией:

Arc2D, Arc2D.Double, Arc2D.Float, область, BasicTextUI.BasicCaret, CubicCurve2D, CubicCurve2D.Double, CubicCurve2D.Float, DefaultCaret, Ellipse2D, Ellipse2D.Double, Ellipse2D.Float, GeneralPath, Line2D, Line2D.Double, Line2D.Float, Path2D, Path2D.Double, Path2D.Float, Многоугольник, QuadCurve2D, QuadCurve2D.Double, QuadCurve2D.Float, Прямоугольник, Rectangle2D, Rectangle2D.Double, Rectangle2D.Float, RectangularShape, RoundRectangle2D, RoundRectangle2D.Double, RoundRectangle2D.Float

public interface Shape

Shape интерфейс обеспечивает определения для объектов, которые представляют некоторую форму геометрической формы. Shape описывается a PathIterator объект, который может выразить схему Shape так же как правило для того, чтобы определить, как схема делит 2-D плоскость на внутренние и внешние точки. Каждый Shape объект обеспечивает обратные вызовы, чтобы получить ограничивающий прямоугольник геометрии, определить или точки, или прямоугольники лежат частично или полностью в пределах внутренней части Shape, и получите a PathIterator объект, который описывает путь траектории Shape схема.

Определение внутренних: вопрос рассматривается, чтобы лечь внутри a Shape если и только если:

• это находится полностью вShape граница или
• это находится точно на Shape граница и пространство, сразу смежное с точкой в увеличении X направление полностью в границе или
• это находится точно на горизонтальном граничном сегменте и пространстве, сразу смежном с точкой в увеличении Y направление в границе.

contains и intersects методы рассматривают внутреннюю часть a Shape чтобы быть областью, это включает, как будто это было заполнено. Это означает, что эти методы полагают, что открытые формы неявно закрываются с целью определения, если форма содержит или пересекает прямоугольник или если форма содержит точку.

С тех пор:

1.2

См. Также:

PathIterator, AffineTransform, FlatteningPathIterator, GeneralPath

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
boolean	contains(double x, double y) Тесты, если указанные координаты в границе Shape, как описано определением внутренних.
boolean	contains(double x, double y, double w, double h) Тесты, если внутренняя часть Shape полностью содержит указанную прямоугольную область.
boolean	contains(Point2D p) Тесты, если указанное Point2D в границе Shape, как описано определением внутренних.
boolean	contains(Rectangle2D r) Тесты, если внутренняя часть Shape полностью содержит указанное Rectangle2D.
Прямоугольник	getBounds() Возвращает целое число Rectangle это полностью включает Shape.
Rectangle2D	getBounds2D() Возвращает высокую точность и более точный ограничивающий прямоугольник Shape чем getBounds метод.
PathIterator	getPathIterator(AffineTransform at) Возвращает объект iterator, который выполняет итерации вперед Shape граница и обеспечивает доступ к геометрии Shape схема.
PathIterator	getPathIterator(AffineTransform at, double flatness) Возвращает объект iterator, который выполняет итерации вперед Shape граница и обеспечивает доступ к сглаженному представлению Shape геометрия схемы.
boolean	intersects(double x, double y, double w, double h) Тесты, если внутренняя часть Shape пересекает внутреннюю часть указанной прямоугольной области.
boolean	intersects(Rectangle2D r) Тесты, если внутренняя часть Shape пересекает внутреннюю часть указанного Rectangle2D.

Деталь метода

getBounds

Rectangle getBounds()

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

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

Если a point в shape согласно contains(point) метод, тогда это должно быть в возвращенном Rectangle границы возражают согласно contains(point) метод bounds. Определенно:

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

Если a point не в shape, тогда это могло бы все еще содержаться в bounds объект:

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

Возвраты:

целое число Rectangle это полностью включает Shape.

С тех пор:

1.2

См. Также:

getBounds2D()

getBounds2D

Rectangle2D getBounds2D()

Возвращает высокую точность и более точный ограничивающий прямоугольник Shape чем getBounds метод. Отметьте, что нет никакой гарантии что возвращенный Rectangle2D самый маленький ограничивающий прямоугольник, который включает Shape, только то, что Shape находится полностью в пределах обозначенного Rectangle2D. Ограничивающий прямоугольник, возвращенный этим методом, обычно более труден чем возвращенное getBounds метод и никогда не перестал работать должный переполнить проблем, так как возвращаемое значение может быть экземпляром Rectangle2D это использует значения двойной точности, чтобы сохранить размерности.

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

Если a point в shape согласно contains(point) метод, тогда это должно быть в возвращенном Rectangle2D границы возражают согласно contains(point) метод bounds. Определенно:

shape.contains(p) требует bounds.contains(p)

Если a point не в shape, тогда это могло бы все еще содержаться в bounds объект:

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

Возвраты:

экземпляр Rectangle2D это - ограничивающий прямоугольник высокой точности Shape.

С тех пор:

1.2

См. Также:

getBounds()

содержит

boolean contains(double x,
               double y)

Тесты, если указанные координаты в границе Shape, как описано определением внутренних.

Параметры:

x - указанное X координат, которые будут протестированы

y - указанные Y координируют, чтобы быть протестированными

Возвраты:

true если указанные координаты в Shape граница; false иначе.

С тех пор:

1.2

содержит

boolean contains(Point2D p)

Тесты, если указанное Point2D в границе Shape, как описано определением внутренних.

Параметры:

p - указанное Point2D быть протестированным

Возвраты:

true если указанное Point2D в границе Shape; false иначе.

С тех пор:

1.2

пересекается

boolean intersects(double x,
                 double y,
                 double w,
                 double h)

Тесты, если внутренняя часть Shape пересекает внутреннюю часть указанной прямоугольной области. Прямоугольная область, как полагают, пересекается Shape если какая-либо точка содержится в обоих внутренняя часть Shape и указанная прямоугольная область.

Shape.intersects() метод позволяет a Shape реализация, чтобы консервативно возвратиться true когда:

• есть высокая вероятность что прямоугольная область и Shape пересекитесь, но
• вычисления, чтобы точно определить это пересечение предельно дороги.

Это означает это для некоторых Shapes этот метод мог бы возвратиться true даже при том, что прямоугольная область не пересекается Shape. Area класс выполняет более точные вычисления геометрического пересечения чем больше всего Shape объекты и поэтому могут использоваться, если более точный ответ требуется.

Параметры:

x - X координат верхнего левого угла указанной прямоугольной области

y - координата Y верхнего левого угла указанной прямоугольной области

w - ширина указанной прямоугольной области

h - высота указанной прямоугольной области

Возвраты:

true если внутренняя часть Shape и внутренняя часть прямоугольной области пересекается, или, и, очень вероятно, пересечется и перекрестные вычисления, было бы слишком дорого, чтобы выполнить; false иначе.

С тех пор:

1.2

См. Также:

Area

пересекается

boolean intersects(Rectangle2D r)

Тесты, если внутренняя часть Shape пересекает внутреннюю часть указанного Rectangle2D. Shape.intersects() метод позволяет a Shape реализация, чтобы консервативно возвратиться true когда:

• есть высокая вероятность что Rectangle2D и Shape пересекитесь, но
• вычисления, чтобы точно определить это пересечение предельно дороги.

Это означает это для некоторых Shapes этот метод мог бы возвратиться true даже при том, что Rectangle2D не пересекается Shape. Area класс выполняет более точные вычисления геометрического пересечения чем больше всего Shape объекты и поэтому могут использоваться, если более точный ответ требуется.

Параметры:

r - указанное Rectangle2D

Возвраты:

true если внутренняя часть Shape и внутренняя часть указанного Rectangle2D пересекитесь, или, и, очень вероятно, пересекутся и перекрестные вычисления, было бы слишком дорого, чтобы выполнить; false иначе.

С тех пор:

1.2

См. Также:

intersects(double, double, double, double)

содержит

boolean contains(double x,
               double y,
               double w,
               double h)

Тесты, если внутренняя часть Shape полностью содержит указанную прямоугольную область. Все координаты, которые лежат в прямоугольной области, должны лечь в пределах Shape для всей rectanglar области, которую рассмотрят содержавший в пределах Shape.

Shape.contains() метод позволяет a Shape реализация, чтобы консервативно возвратиться false когда:

• intersect возвраты метода true и
• вычисления, чтобы определить, действительно ли Shape полностью содержит прямоугольную область, предельно дороги.

Это означает это для некоторых Shapes этот метод мог бы возвратиться false даже при том, что Shape содержит прямоугольную область. Area класс выполняет более точные геометрические вычисления чем больше всего Shape объекты и поэтому могут использоваться, если более точный ответ требуется.

Параметры:

x - X координат верхнего левого угла указанной прямоугольной области

y - координата Y верхнего левого угла указанной прямоугольной области

w - ширина указанной прямоугольной области

h - высота указанной прямоугольной области

Возвраты:

true если внутренняя часть Shape полностью содержит указанную прямоугольную область; false иначе или, если Shape содержит прямоугольную область и intersects возвраты метода true и вычисления включения были бы слишком дороги, чтобы выполнить.

С тех пор:

1.2

См. Также:

Area, intersects(double, double, double, double)

содержит

boolean contains(Rectangle2D r)

Тесты, если внутренняя часть Shape полностью содержит указанное Rectangle2D. Shape.contains() метод позволяет a Shape реализация, чтобы консервативно возвратиться false когда:

• intersect возвраты метода true и
• вычисления, чтобы определить, действительно ли Shape полностью содержит Rectangle2D предельно дороги.

Это означает это для некоторых Shapes этот метод мог бы возвратиться false даже при том, что Shape содержит Rectangle2D. Area класс выполняет более точные геометрические вычисления чем больше всего Shape объекты и поэтому могут использоваться, если более точный ответ требуется.

Параметры:

r - Указанное Rectangle2D

Возвраты:

true если внутренняя часть Shape полностью содержит Rectangle2D; false иначе или, если Shape содержит Rectangle2D и intersects возвраты метода true и вычисления включения были бы слишком дороги, чтобы выполнить.

С тех пор:

1.2

См. Также:

contains(double, double, double, double)

getPathIterator

PathIterator getPathIterator(AffineTransform at)

Возвращает объект iterator, который выполняет итерации вперед Shape граница и обеспечивает доступ к геометрии Shape схема. Если дополнительное AffineTransform определяется, координаты, возвращенные в итерации, преобразовываются соответственно.

Каждый звонок в этот метод возвращает новое PathIterator возразите, что пересекает геометрию Shape возразите независимо от любого другого PathIterator объекты в использовании одновременно.

Это рекомендуется, но не гарантируется, который возражает реализации Shape интерфейс изолирует итерации, которые в процессе от любых изменений, которые могли бы произойти с геометрией исходного объекта во время таких итераций.

Параметры:

at - дополнительное AffineTransform быть примененным к координатам, поскольку они возвращаются в итерации, или null если непреобразованные координаты требуются

Возвраты:

новое PathIterator объект, который независимо пересекает геометрию Shape.

С тех пор:

1.2

getPathIterator

PathIterator getPathIterator(AffineTransform at,
                           double flatness)

Возвращает объект iterator, который выполняет итерации вперед Shape граница и обеспечивает доступ к сглаженному представлению Shape геометрия схемы.

Только SEG_MOVETO, SEG_LINETO, и типы точки SEG_CLOSE возвращаются iterator.

Если дополнительное AffineTransform определяется, координаты, возвращенные в итерации, преобразовываются соответственно.

Количеством подразделения кривых сегментов управляют flatness параметр, который определяет максимальное расстояние, которое любая точка на несглаженной преобразованной кривой может отклонить от возвращенных сглаженных сегментов пути. Отметьте, что предел на точности сглаженного пути мог бы быть тихо наложен, заставляя очень маленькие параметры выравнивания быть обработанным как большие значения. Этот предел, если есть один, определяется определенной реализацией, которая используется.

Каждый звонок в этот метод возвращает новое PathIterator возразите что пересечения Shape объектная геометрия независимо от любого другого PathIterator объекты в использовании одновременно.

Это рекомендуется, но не гарантируется, который возражает реализации Shape интерфейс изолирует итерации, которые в процессе от любых изменений, которые могли бы произойти с геометрией исходного объекта во время таких итераций.

Параметры:

at - дополнительное AffineTransform быть примененным к координатам, поскольку они возвращаются в итерации, или null если непреобразованные координаты требуются

flatness - максимальное расстояние, которое линейным сегментам, используемым, чтобы приблизить кривые сегменты, позволяют отклонить от любой точки на исходной кривой

Возвраты:

новое PathIterator это независимо пересекает сглаженное представление геометрии Shape.

С тех пор:

1.2