Shape (Java Platform SE 8 )

所有已知实现类：

Arc2D， Arc2D.Double， Arc2D.Float， Area， BasicTextUI.BasicCaret， CubicCurve2D， CubicCurve2D.Double， CubicCurve2D.Float， DefaultCaret， Ellipse2D， Ellipse2D.Double， Ellipse2D.Float， GeneralPath， Line2D， Line2D.Double， Line2D.Float， Path2D， Path2D.Double， Path2D.Float， Polygon，z- bbbbbbbb -9f0a-4e2e-91c0-aa1d154f1e04， QuadCurve2D.Double， QuadCurve2D.Float， Rectangle， Rectangle2D， Rectangle2D.Double， Rectangle2D.Float， RectangularShape， RoundRectangle2D， RoundRectangle2D.Double， RoundRectangle2D.Float
```
public interface Shape
```
的 Shape接口提供对象代表了某种形式的几何定义。的 Shape由 PathIterator对象描述，可以表达的 Shape概要以及规则确定如何将二维平面轮廓分为内部和外部的点。每个 Shape对象提供回调得到几何边界框，确定点或矩形部分或完全在撒谎的 Shape内部，和检索 PathIterator对象描述的 Shape轮廓的运动轨迹。
Definition of insideness:一点是躺在一个Shape当且仅当：
- 它是完全在theShape边空或
- 它就在Shape边空和空间紧邻在增加X方向的点是完全或边界内的空
- 它就在一个水平段边界和空间紧邻在增加Y方向的点是在边界。
的contains和intersects方法考虑一个Shape内部是区域包围仿佛充满了。这意味着，这些方法考虑未闭合的形状是隐式关闭决定的目的，如果一个形状包含或相交的矩形或者形状包含一点。
从以下版本开始：

一点二

另请参见：

PathIterator， AffineTransform， FlatteningPathIterator， GeneralPath

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`boolean`	`contains(double x, double y)` 如果指定的坐标的 `Shape`边界内，由 definition of insideness描述。
`boolean`	`contains(double x, double y, double w, double h)` 如果 `Shape`测试的内部完全包含指定的矩形区域。
`boolean`	`contains(Point2D p)` 如果指定的 `Point2D`的 `Shape`边界内，由 definition of insideness描述。
`boolean`	`contains(Rectangle2D r)` 如果 `Shape`测试的内部完全包含指定的 `Rectangle2D`。
`Rectangle`	`getBounds()` 返回一个整数 `Rectangle`完全封闭 `Shape`。
`Rectangle2D`	`getBounds2D()` 返回一个高的精度和更精确的包围盒的 `Shape`比 `getBounds`方法。
`PathIterator`	`getPathIterator(AffineTransform at)` 返回一个迭代器对象沿 `Shape`迭代边界提供了访问的 `Shape`轮廓的几何。
`PathIterator`	`getPathIterator(AffineTransform at, double flatness)` 返回一个迭代器对象沿 `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方法一般返回一个紧密的包围盒由于在表示其更大的灵活性。
    请注意， definition of insideness可导致的情况下，点上的shape定义轮廓可能不被视为包含在返回的bounds对象，但只有在这些点的情况下，也不被认为是包含在原始的shape。
    
    如果一个point在shape根据contains(point)方法，那么它必须在返回的Rectangle界根据的bounds的contains(point)方法对象。明确地:
    
    shape.contains(x,y)需要bounds.contains(x,y)
    
    如果一个point是不是在shape，那么它可能仍然包含在bounds对象：
    
    bounds.contains(x,y)并不意味着shape.contains(x,y)
    
    结果
    
    一个整数 Rectangle完全封闭 Shape。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    getBounds2D()
  - getBounds2D
```
Rectangle2D getBounds2D()
```
    返回一个高的精度和更精确的包围盒的 Shape比 getBounds方法。需要注意的是不能保证返回的 Rectangle2D是最小包围盒包围 Shape，只有 Shape完全在于在显示 Rectangle2D。包围盒返回此方法通常是更严格的比 getBounds返回的方法，永远不会失败由于溢出的问题由于返回值可以是使用双精度值存储维度的 Rectangle2D实例。
    请注意， definition of insideness可导致的情况下，点上的shape定义轮廓可能不被视为包含在返回的bounds对象，但只有在这些点的情况下，也不被认为是包含在原始的shape。
    
    如果一个point在shape根据contains(point)方法，那么它必须在返回的Rectangle2D界根据的bounds的contains(point)方法对象。明确地:
    
    shape.contains(p)需要bounds.contains(p)
    
    如果一个point是不是在shape，那么它可能仍然包含在bounds对象：
    
    bounds.contains(p)并不意味着shape.contains(p)
    
    结果
    
    这是一个高精度的 Rectangle2D包围盒的 Shape实例。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    getBounds()
  - contains
```
boolean contains(double x,
                 double y)
```
    如果指定的坐标的 Shape边界内，由 definition of insideness描述。
    
    参数
    
    x -指定的x坐标进行测试
    
    y -指定的y坐标进行测试
    
    结果
    
    true如果指定坐标的 Shape边界内； false否则。
    
    从以下版本开始：
    
    一点二
  - contains
```
boolean contains(Point2D p)
```
    如果指定的 Point2D的 Shape边界内，由 definition of insideness描述。
    
    参数
    
    p -指定 Point2D进行测试
    
    结果
    
    true如果指定 Point2D的 Shape边界内； false否则。
    
    从以下版本开始：
    
    一点二
  - intersects
```
boolean intersects(double x,
                   double y,
                   double w,
                   double h)
```
    如果 Shape测试的内部与一个指定的矩形区域内。矩形区域是相交的 Shape如果任何点是否包含在内部的 Shape和指定的矩形区域。
    的Shape.intersects()方法允许Shape实施保守的回报true时：
    - 有一个高概率的矩形面积和Shape相交，但
    - 准确地确定这个路口计算是昂贵的。
    这意味着对一些 Shapes这个方法可能返回 true即使矩形区域不相交的 Shape。的 Area类执行更精确的计算几何相交比大多数 Shape对象，因此可以更准确的答案是需要用。
    参数
    
    x -指定的矩形区域左上角的x坐标
    
    y -指定的矩形区域的左上角的Y坐标
    
    w -指定的矩形区域的宽度
    
    h -指定矩形区域的高度
    
    结果
    
    true如果的 Shape内部与矩形区域内相交，或是相交，相交计算高度可能会执行 false否则太贵。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    Area
  - intersects
```
boolean intersects(Rectangle2D r)
```
    如果 Shape测试的内部与指定的 Rectangle2D内部。的 Shape.intersects()方法允许 Shape实施保守的回报 true时：
    - 有一个高概率的Rectangle2D和Shape相交，但
    - 准确地确定这个路口计算是昂贵的。
    这意味着对一些 Shapes这个方法可能返回 true即使 Rectangle2D不相交的 Shape。的 Area类执行更精确的计算几何相交比大多数 Shape对象，因此可以更准确的答案是需要用。
    参数
    
    r -指定 Rectangle2D
    
    结果
    
    true如果的 Shape内部和指定的 Rectangle2D内部相交，或是相交，相交计算高度可能会执行 false否则太贵。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    intersects(double, double, double, double)
  - contains
```
boolean contains(double x,
                 double y,
                 double w,
                 double h)
```
    如果 Shape测试的内部完全包含指定的矩形区域。所有的坐标，在矩形区域必须位于 Shape整个矩形区域被认为是包含在 Shape。
    的Shape.contains()方法允许Shape实施保守的回报false时：
    - 该方法返回true和intersect
    - 要确定是否Shape完全包含矩形区域是昂贵的计算。
    这意味着对一些 Shapes这个方法可能返回 false即使 Shape包含矩形区域。的 Area类执行更精确的几何计算比大多数 Shape对象，因此可以更准确的答案是需要用。
    参数
    
    x -指定的矩形区域左上角的x坐标
    
    y -指定的矩形区域的左上角的Y坐标
    
    w -指定的矩形区域的宽度
    
    h -指定矩形区域的高度
    
    结果
    
    true如果的 Shape内部完全包含指定矩形区域； false否则，如果 Shape包含矩形面积和 intersects方法返回 true和遏制的计算是执行太贵。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    Area， intersects(double, double, double, double)
  - contains
```
boolean contains(Rectangle2D r)
```
    如果 Shape测试的内部完全包含指定的 Rectangle2D。的 Shape.contains()方法允许 Shape实施保守的回报 false时：
    - 该方法返回true和intersect
    - 要确定是否Shape完全包含Rectangle2D是昂贵的计算。
    这意味着对一些 Shapes这个方法可能返回 false即使 Shape包含 Rectangle2D。的 Area类执行更精确的几何计算比大多数 Shape对象，因此可以更准确的答案是需要用。
    参数
    
    r -指定 Rectangle2D
    
    结果
    
    true如果的 Shape内部完全包含 false Rectangle2D；否则，如果 Shape包含 Rectangle2D和 intersects方法返回 true和遏制的计算是执行太贵。
    
    从以下版本开始：
    
    一点二
    
    另请参见：
    
    contains(double, double, double, double)
  - getPathIterator
```
PathIterator getPathIterator(AffineTransform at)
```
    返回一个迭代器对象沿 Shape迭代边界提供了访问的 Shape轮廓的几何。如果一个可选的 AffineTransform指定返回的坐标在迭代进行相应的转换。
    每次调用此方法返回一个新的PathIterator对象遍历的Shape几何对象独立于使用任何其他PathIterator对象同时。
    
    这是建议，但不保证，对象实施Shape界面分离迭代过程中任何发生在原物体的几何形状的变化可能在这样的迭代。
    
    参数
    
    at可选 AffineTransform被应用到坐标作为他们在迭代返回，或 null如果需要转化的坐标
    
    结果
    
    一个新的 PathIterator对象，独立的 Shape几何遍历。
    
    从以下版本开始：
    
    一点二
  - getPathIterator
```
PathIterator getPathIterator(AffineTransform at,
                             double flatness)
```
    返回一个迭代器对象沿 Shape迭代边界提供了一个扁平的 Shape外形几何。
    只有seg_moveto，seg_lineto，和seg_close点类型通过返回的迭代器。
    
    如果一个可选的AffineTransform指定返回的坐标在迭代进行相应的转换。
    
    对弯曲段细分总量由flatness参数控制，它指定在不平的转化曲线任意点偏离回到平坦的路径段的最大距离。请注意，平坦的路径的精度上的限制可能会被悄悄地施加，导致非常小的平坦化参数被视为更大的值。这个限制，如果有一个，是由所使用的特定的实现定义的。
    
    每次调用此方法返回一个新的PathIterator对象遍历Shape对象几何独立使用任何其他PathIterator对象同时。
    
    这是建议，但不保证，对象实施Shape界面分离迭代过程中任何发生在原物体的几何形状的变化可能在这样的迭代。
    
    参数
    
    at可选 AffineTransform被应用到坐标作为他们在迭代返回，或 null如果需要转化的坐标
    
    flatness，用近似曲线线段的线段偏离原始曲线上的任何点的最大距离
    
    结果
    
    一个新的 PathIterator独立穿越平坦的 Shape几何角度。
    
    从以下版本开始：
    
    一点二

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface Shape

方法摘要

方法详细信息

getBounds

getBounds2D

contains

contains

intersects

intersects

contains

contains

getPathIterator

getPathIterator