Область (Платформа Java SE 7)

java.lang. Объект
- java.awt.geom. Область

Все Реализованные Интерфейсы:

Форма, Cloneable
```
public class Area
extends Object
implements Shape, Cloneable
```
Area объектно-ориентированные памяти и управляют независимым от разрешения описанием включенной области 2-мерного пространства. Area объекты могут быть преобразованы и могут выполнить различную Конструктивную Геометрию области (CAG) операции когда объединено с другим Area объекты. Операции CAG включают область addition, subtraction, intersection, и exclusive or. См. соединенную документацию метода для примеров различных операций.
Area класс реализует Shape взаимодействуйте через интерфейс и обеспечивает полную поддержку всего ее тестирования хита и итеративных средств пути, но Area является более определенным чем обобщенный путь многими способами:
- Только замкнутые пути и подпути сохранены. Area объекты, созданные из открытых путей, неявно закрываются во время конструкции, как будто те пути были заполнены Graphics2D.fill метод.
- Внутренние части человека сохраненные подпути являются все непустыми и неперекрывающимися. Пути анализируются во время конструкции в отдельный компонент неперекрывающиеся части, пустые части пути отбрасываются, и затем эти непустые и неперекрывающиеся свойства сохраняются через все последующие операции CAG. Схемы различных компонентных подпутей могут коснуться друг друга, пока они не пересекаются так, чтобы их включенные области наложились.
- Геометрия пути, описывающего схему Area напоминает путь, из которого это было создано только, в котором это описывает ту же самую включенную 2-мерную область, но может использовать полностью различные типы и упорядочивание сегментов пути, чтобы сделать так.
Интересные проблемы, которые не всегда очевидны при использовании Area включайте:
- Создание Area от (открытого) открытого Shape результаты в окруженной схеме Area объект.
- Создание Area от a Shape то, который не включает области (даже когда "закрыто") производит пустое Area. Типичный пример этой проблемы является тем созданием Area от строки будет пусто, так как строка не включает области. Пустое Area не выполнит итерации никакой геометрии в PathIterator объекты.
- Самопересечение Shape может быть разделен на два (или больше) подсоединяет каналом каждого включающего одну из непересекающихся частей исходного пути.
- Area может взять больше сегментов пути, чтобы описать ту же самую геометрию, даже когда исходная схема проста и очевидна. Анализ, что Area класс должен выполнить на пути, возможно, не отражает то же самое понятие "простого и очевидного", как человек чувствует.
С тех пор:

1.2

Сводка конструктора

Конструкторы
Конструктор и Описание
`Area()` Конструктор по умолчанию, который создает пустую область.
`Area(Shape s)` `Area` класс создает геометрию области из указанного `Shape` объект.

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

Методы
Модификатор и Тип	Метод и Описание
`void`	`add(Area rhs)` Добавляет форма указанного `Area` к форме этого `Area`.
`Объект`	`clone()` Возвращает точную копию этого `Area` объект.
`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`.
`Область`	`createTransformedArea(AffineTransform t)` Создает новое `Area` объект, который содержит ту же самую геометрию как это `Area` преобразованный указанным `AffineTransform`.
`boolean`	`equals(Area other)` Тесты, ли конфигурации двух `Area` объекты равны.
`void`	`exclusiveOr(Area rhs)` Устанавливает форму этого `Area` быть объединенной областью его текущей формы и формы указанного `Area`, минус их пересечение.
`Прямоугольник`	`getBounds()` Возвращает ограничение `Rectangle` это полностью включает это `Area`.
`Rectangle2D`	`getBounds2D()` Возвращает высокое ограничение точности `Rectangle2D` это полностью включает это `Area`.
`PathIterator`	`getPathIterator(AffineTransform at)` Создает a `PathIterator` для схемы этого `Area` объект.
`PathIterator`	`getPathIterator(AffineTransform at, double flatness)` Создает a `PathIterator` для сглаженной схемы этого `Area` объект.
`void`	`intersect(Area rhs)` Устанавливает форму этого `Area` к пересечению его текущей формы и формы указанного `Area`.
`boolean`	`intersects(double x, double y, double w, double h)` Тесты, если внутренняя часть `Shape` пересекает внутреннюю часть указанной прямоугольной области.
`boolean`	`intersects(Rectangle2D r)` Тесты, если внутренняя часть `Shape` пересекает внутреннюю часть указанного `Rectangle2D`.
`boolean`	`isEmpty()` Тесты, ли это `Area` объект включает любую область.
`boolean`	`isPolygonal()` Тесты, ли это `Area` состоит полностью из прямой ограниченной многоугольной геометрии.
`boolean`	`isRectangular()` Тесты, ли это `Area` является прямоугольным в форме.
`boolean`	`isSingular()` Тесты, ли это `Area` состоит из единственного закрытого подпути.
`void`	`reset()` Удаляет всю геометрию от этого `Area` и восстановления это к пустой области.
`void`	`subtract(Area rhs)` Вычитает форму указанного `Area` от формы этого `Area`.
`void`	`transform(AffineTransform t)` Преобразовывает геометрию этого `Area` использование указанного `AffineTransform`.

Методы java.lang унаследованный от класса. Объект
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - Область
```
public Area()
```
    Конструктор по умолчанию, который создает пустую область.
    
    С тех пор:
    
    1.2
  - Область
```
public Area(Shape s)
```
    Area класс создает геометрию области из указанного Shape объект. Геометрия явно закрывается, если Shape уже не закрывается. Правило заливки (даже нечетный или вьющийся) определенный геометрией Shape используется, чтобы определить получающуюся включенную область.
    
    Параметры:
    s - Shape из которого создается область
    
    Броски:
    
    NullPointerException - если s нуль
    С тех пор:
    
    1.2
- Деталь метода
  - добавить
```
public void add(Area rhs)
```
    Добавляет форма указанного Area к форме этого Area. Получающаяся форма этого Area будет включать объединение обеих форм, или все области, которые содержались или в этом или в указанном Area.
```
     // Example:
     Area a1 = new Area([triangle 0,0 => 8,0 => 0,8]);
     Area a2 = new Area([triangle 0,0 => 8,0 => 8,8]);
     a1.add(a2);

        a1(before)     +         a2         =     a1(after)

     ################     ################     ################
     ##############         ##############     ################
     ############             ############     ################
     ##########                 ##########     ################
     ########                     ########     ################
     ######                         ######     ######    ######
     ####                             ####     ####        ####
     ##                                 ##     ##            ##
 
```
    Параметры:
    rhs - Area быть добавленным к текущей форме
    
    Броски:
    
    NullPointerException - если rhs нуль
    С тех пор:
    
    1.2
  - вычесть
```
public void subtract(Area rhs)
```
    Вычитает форму указанного Area от формы этого Area. Получающаяся форма этого Area будет включать области, которые содержались только в этом Area а не в указанном Area.
```
     // Example:
     Area a1 = new Area([triangle 0,0 => 8,0 => 0,8]);
     Area a2 = new Area([triangle 0,0 => 8,0 => 8,8]);
     a1.subtract(a2);

        a1(before)     -         a2         =     a1(after)

     ################     ################
     ##############         ##############     ##
     ############             ############     ####
     ##########                 ##########     ######
     ########                     ########     ########
     ######                         ######     ######
     ####                             ####     ####
     ##                                 ##     ##
 
```
    Параметры:
    rhs - Area быть вычтенным из текущей формы
    
    Броски:
    
    NullPointerException - если rhs нуль
    С тех пор:
    
    1.2
  - пересечься
```
public void intersect(Area rhs)
```
    Устанавливает форму этого Area к пересечению его текущей формы и формы указанного Area. Получающаяся форма этого Area будет включать только области, которые содержались в обоих это Area и также в указанном Area.
```
     // Example:
     Area a1 = new Area([triangle 0,0 => 8,0 => 0,8]);
     Area a2 = new Area([triangle 0,0 => 8,0 => 8,8]);
     a1.intersect(a2);

      a1(before)   intersect     a2         =     a1(after)

     ################     ################     ################
     ##############         ##############       ############
     ############             ############         ########
     ##########                 ##########           ####
     ########                     ########
     ######                         ######
     ####                             ####
     ##                                 ##
 
```
    Параметры:
    rhs - Area быть пересеченным с этим Area
    
    Броски:
    
    NullPointerException - если rhs нуль
    С тех пор:
    
    1.2
  - exclusiveOr
```
public void exclusiveOr(Area rhs)
```
    Устанавливает форму этого Area быть объединенной областью его текущей формы и формы указанного Area, минус их пересечение. Получающаяся форма этого Area будет включать только области, которые содержались в любом это Area или в указанном Area, но не в обоих.
```
     // Example:
     Area a1 = new Area([triangle 0,0 => 8,0 => 0,8]);
     Area a2 = new Area([triangle 0,0 => 8,0 => 8,8]);
     a1.exclusiveOr(a2);

        a1(before)    xor        a2         =     a1(after)

     ################     ################
     ##############         ##############     ##            ##
     ############             ############     ####        ####
     ##########                 ##########     ######    ######
     ########                     ########     ################
     ######                         ######     ######    ######
     ####                             ####     ####        ####
     ##                                 ##     ##            ##
 
```
    Параметры:
    rhs - Area быть монопольным ORed с этим Area.
    
    Броски:
    
    NullPointerException - если rhs нуль
    С тех пор:
    
    1.2
  - сброс
```
public void reset()
```
    Удаляет всю геометрию от этого Area и восстановления это к пустой области.
    
    С тех пор:
    
    1.2
  - isEmpty
```
public boolean isEmpty()
```
    Тесты, ли это Area объект включает любую область.
    
    Возвраты:
    true если это Area объект представляет пустую область; false иначе.
    С тех пор:
    
    1.2
  - isPolygonal
```
public boolean isPolygonal()
```
    Тесты, ли это Area состоит полностью из прямой ограниченной многоугольной геометрии.
    
    Возвраты:
    true если геометрия этого Area состоит полностью из линейных сегментов; false иначе.
    С тех пор:
    
    1.2
  - isRectangular
```
public boolean isRectangular()
```
    Тесты, ли это Area является прямоугольным в форме.
    
    Возвраты:
    true если геометрия этого Area является прямоугольным в форме; false иначе.
    С тех пор:
    
    1.2
  - isSingular
```
public boolean isSingular()
```
    Тесты, ли это Area состоит из единственного закрытого подпути. Этот метод возвраты true если путь содержит 0 или 1 подпуть, или false если путь содержит больше чем 1 подпуть. Подпути считаются числом SEG_MOVETO сегменты, которые появляются в пути.
    
    Возвраты:
    true если Area состоит из единственной основной геометрии; false иначе.
    С тех пор:
    
    1.2
  - getBounds2D
```
public Rectangle2D getBounds2D()
```
    Возвращает высокое ограничение точности Rectangle2D это полностью включает это Area.
    Класс области попытается возвратить самый трудный ограничивающий прямоугольник, возможный для Формы. Ограничивающий прямоугольник не будет дополнен, чтобы включать контрольные точки кривых в схеме Формы, но если плотно прилегающим образом фактическая геометрия схемы непосредственно.
    
    Определенный:
    
    getBounds2D в интерфейсе Shape
    
    Возвраты:
    ограничение Rectangle2D для Area.
    С тех пор:
    
    1.2
    
    См. Также:
    Shape.getBounds()
  - getBounds
```
public Rectangle getBounds()
```
    Возвращает ограничение Rectangle это полностью включает это Area.
    Класс области попытается возвратить самый трудный ограничивающий прямоугольник, возможный для Формы. Ограничивающий прямоугольник не будет дополнен, чтобы включать контрольные точки кривых в схеме Формы, но если плотно прилегающим образом фактическая геометрия схемы непосредственно. Так как возвращенный объект представляет ограничивающий прямоугольник с целыми числами, ограничивающий прямоугольник может только быть столь же трудным как самые близкие целочисленные координаты, которые охватывают геометрию Формы.
    
    Определенный:
    
    getBounds в интерфейсе Shape
    
    Возвраты:
    ограничение Rectangle для Area.
    С тех пор:
    
    1.2
    
    См. Также:
    Shape.getBounds2D()
  - клон
```
public Object clone()
```
    Возвращает точную копию этого Area объект.
    
    Переопределения:
    
    clone в классе Object
    
    Возвраты:
    Создаваемый объект клона
    С тех пор:
    
    1.2
    
    См. Также:
    Cloneable
  - равняется
```
public boolean equals(Area other)
```
    Тесты, ли конфигурации двух Area объекты равны. Этот метод возвратит false, если параметром будет нуль.
    
    Параметры:
    other - Area быть по сравнению с этим Area
    
    Возвраты:
    true если эти два конфигураций равны; false иначе.
    С тех пор:
    
    1.2
  - преобразовать
```
public void transform(AffineTransform t)
```
    Преобразовывает геометрию этого Area использование указанного AffineTransform. Геометрия преобразовывается на месте, который постоянно изменяет включенную область, определенную этим объектом.
    
    Параметры:
    t - преобразование, используемое, чтобы преобразовать область
    
    Броски:
    
    NullPointerException - если t нуль
    С тех пор:
    
    1.2
  - createTransformedArea
```
public Area createTransformedArea(AffineTransform t)
```
    Создает новое Area объект, который содержит ту же самую геометрию как это Area преобразованный указанным AffineTransform. Это Area объект неизменен.
    
    Параметры:
    t - указанное AffineTransform используемый, чтобы преобразовать новое Area
    
    Возвраты:
    новое Area объект, представляющий преобразованную геометрию.
    
    Броски:
    
    NullPointerException - если t нуль
    С тех пор:
    
    1.2
  - содержит
```
public boolean contains(double x,
               double y)
```
    Тесты, если указанные координаты в границе Shape, как описано определением внутренних.
    
    Определенный:
    
    contains в интерфейсе Shape
    
    Параметры:
    x - указанное X координат, которые будут протестированы
    y - указанные Y координируют, чтобы быть протестированными
    
    Возвраты:
    true если указанные координаты в Shape граница; false иначе.
    С тех пор:
    
    1.2
  - содержит
```
public boolean contains(Point2D p)
```
    Тесты, если указанное Point2D в границе Shape, как описано определением внутренних.
    
    Определенный:
    
    contains в интерфейсе Shape
    
    Параметры:
    p - указанное Point2D быть протестированным
    
    Возвраты:
    true если указанное Point2D в границе Shape; false иначе.
    С тех пор:
    
    1.2
  - содержит
```
public 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 объекты и поэтому могут использоваться, если более точный ответ требуется.
    Определенный:
    
    contains в интерфейсе Shape
    
    Параметры:
    x - X координат верхнего левого угла указанной прямоугольной области
    y - координата Y верхнего левого угла указанной прямоугольной области
    w - ширина указанной прямоугольной области
    h - высота указанной прямоугольной области
    
    Возвраты:
    true если внутренняя часть Shape полностью содержит указанную прямоугольную область; false иначе или, если Shape содержит прямоугольную область и intersects возвраты метода true и вычисления включения были бы слишком дороги, чтобы выполнить.
    С тех пор:
    
    1.2
    
    См. Также:
    Area, Shape.intersects(double, double, double, double)
  - содержит
```
public boolean contains(Rectangle2D r)
```
    Тесты, если внутренняя часть Shape полностью содержит указанное Rectangle2D. Shape.contains() метод позволяет a 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)
  - пересекается
```
public boolean intersects(double x,
                 double y,
                 double w,
                 double h)
```
    Тесты, если внутренняя часть Shape пересекает внутреннюю часть указанной прямоугольной области. Прямоугольная область, как полагают, пересекается Shape если какая-либо точка содержится в обоих внутренняя часть Shape и указанная прямоугольная область.
    Shape.intersects() метод позволяет a Shape реализация, чтобы консервативно возвратиться true когда:
    - есть высокая вероятность что прямоугольная область и Shape пересекитесь, но
    - вычисления, чтобы точно определить это пересечение предельно дороги.
    Это означает это для некоторых Shapes этот метод мог бы возвратиться true даже при том, что прямоугольная область не пересекается Shape. Area класс выполняет более точные вычисления геометрического пересечения чем больше всего Shape объекты и поэтому могут использоваться, если более точный ответ требуется.
    Определенный:
    
    intersects в интерфейсе Shape
    
    Параметры:
    x - X координат верхнего левого угла указанной прямоугольной области
    y - координата Y верхнего левого угла указанной прямоугольной области
    w - ширина указанной прямоугольной области
    h - высота указанной прямоугольной области
    
    Возвраты:
    true если внутренняя часть Shape и внутренняя часть прямоугольной области пересекается, или, и, очень вероятно, пересечется и перекрестные вычисления, было бы слишком дорого, чтобы выполнить; false иначе.
    С тех пор:
    
    1.2
    
    См. Также:
    Area
  - пересекается
```
public boolean intersects(Rectangle2D r)
```
    Тесты, если внутренняя часть Shape пересекает внутреннюю часть указанного Rectangle2D. Shape.intersects() метод позволяет a 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)
  - getPathIterator
```
public PathIterator getPathIterator(AffineTransform at)
```
    Создает a PathIterator для схемы этого Area объект. Это Area объект неизменен.
    
    Определенный:
    
    getPathIterator в интерфейсе Shape
    
    Параметры:
    at - дополнительное AffineTransform быть примененным к координатам, поскольку они возвращаются в итерации, или null если непреобразованные координаты требуются
    
    Возвраты:
    PathIterator возразите, что возвращает геометрию схемы этого Area, один сегмент за один раз.
    С тех пор:
    
    1.2
  - getPathIterator
```
public PathIterator getPathIterator(AffineTransform at,
                           double flatness)
```
    Создает a PathIterator для сглаженной схемы этого Area объект. Только некривые сегменты пути, представленные SEG_MOVETO, SEG_LINETO, и типами точки SEG_CLOSE, возвращаются iterator. Это Area объект неизменен.
    
    Определенный:
    
    getPathIterator в интерфейсе Shape
    
    Параметры:
    at - дополнительное AffineTransform быть примененным к координатам, поскольку они возвращаются в итерации, или null если непреобразованные координаты требуются
    flatness - максимальное количество, которое контрольные точки для данной кривой могут изменить от colinear перед подразделенной кривой, заменяется прямой линией, соединяющей конечные точки
    
    Возвраты:
    PathIterator возразите, что возвращает геометрию схемы этого Area, один сегмент за один раз.
    С тех пор:
    
    1.2

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Область класса

Сводка конструктора

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

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

Область

Область

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

добавить

вычесть

пересечься

exclusiveOr

сброс

isEmpty

isPolygonal

isRectangular

isSingular

getBounds2D

getBounds

клон

равняется

преобразовать

createTransformedArea

содержит

содержит

содержит

содержит

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

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

getPathIterator

getPathIterator