GraphicsEnvironment (Java Platform SE 8 )

java.lang.Object
- java.awt.GraphicsEnvironment

```
public abstract class GraphicsEnvironment
extends Object
```
GraphicsEnvironment类描述了可用于特定平台上的Java（tm）应用程序的GraphicsDevice对象和Font对象的集合。此GraphicsEnvironment中的GraphicsEnvironment可能是本地的或远程机器上的。 GraphicsDevice对象可以是屏幕，打印机或图像缓冲区，并且是Graphics2D绘图方法的目的地。每个GraphicsDevice都有一些与之相关的GraphicsConfiguration对象。这些对象指定可以使用GraphicsDevice不同配置。

另请参见：

GraphicsDevice ， GraphicsConfiguration

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`GraphicsEnvironment()` 这是一个抽象类，不能直接实例化。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`abstract Graphics2D`	`createGraphics(BufferedImage img)` 返回一个`Graphics2D`对象，用于渲染到指定的`BufferedImage`中。
`abstract Font[]`	`getAllFonts()` 返回一个包含此 `GraphicsEnvironment`的所有字体的一点大小实例的 `GraphicsEnvironment` 。
`abstract String[]`	`getAvailableFontFamilyNames()` 返回包含在此所有字体系列名称的数组， `GraphicsEnvironment`本地化为默认的语言环境，如返回 `Locale.getDefault()` 。
`abstract String[]`	`getAvailableFontFamilyNames(Locale l)` 返回包含在此所有字体系列名称的数组， `GraphicsEnvironment`本地化为指定的语言环境。
`Point`	`getCenterPoint()` 返回Windows应该居中的点。
`abstract GraphicsDevice`	`getDefaultScreenDevice()` 返回默认屏幕 `GraphicsDevice` 。
`static GraphicsEnvironment`	`getLocalGraphicsEnvironment()` 返回本地 `GraphicsEnvironment` 。
`Rectangle`	`getMaximumWindowBounds()` 返回居中Windows的最大边界。
`abstract GraphicsDevice[]`	`getScreenDevices()` 返回所有屏幕 `GraphicsDevice`对象的数组。
`static boolean`	`isHeadless()` 测试此环境中是否可以支持显示器，键盘和鼠标。
`boolean`	`isHeadlessInstance()` 返回在此图形环境中是否可以支持显示，键盘和鼠标。
`void`	`preferLocaleFonts()` 表示对逻辑字体映射到物理字体的区域设置特定字体的偏好。
`void`	`preferProportionalFonts()` 表示比例超过非比例的偏好（例如
`boolean`	`registerFont(Font font)` 注册一个创建 `Font`这个 `GraphicsEnvironment` 。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造方法详细信息
  - GraphicsEnvironment
```
protected GraphicsEnvironment()
```
    这是一个抽象类，不能直接实例化。必须从合适的工厂或查询方法获取实例。
- 方法详细信息
  - getLocalGraphicsEnvironment
```
public static GraphicsEnvironment getLocalGraphicsEnvironment()
```
    返回本地 GraphicsEnvironment 。
    
    结果
    
    当地 GraphicsEnvironment
  - isHeadless
```
public static boolean isHeadless()
```
    测试此环境中是否可以支持显示器，键盘和鼠标。如果此方法返回true，则会从依赖于显示器，键盘或鼠标的Toolkit和GraphicsEnvironment的区域抛出HeadlessException。
    
    结果
    
    true如果这个环境不能支持显示器，键盘和鼠标; false否则
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    HeadlessException
  - isHeadlessInstance
```
public boolean isHeadlessInstance()
```
    返回在此图形环境中是否可以支持显示，键盘和鼠标。如果这返回true， HeadlessException从依赖于显示器，键盘或鼠标的图形环境的区域抛出HeadlessException。
    
    结果
    
    true如果在这种环境中可以支持显示器，键盘和鼠标; false否则
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    HeadlessException ， isHeadless()
  - getScreenDevices
```
public abstract GraphicsDevice[] getScreenDevices()
                                           throws HeadlessException
```
    返回所有屏幕 GraphicsDevice对象的数组。
    
    结果
    
    一个包含代表屏幕设备的所有 GraphicsDevice对象的数组
    
    异常
    
    HeadlessException - 如果isHeadless（）返回true
    
    另请参见：
    
    isHeadless()
  - getDefaultScreenDevice
```
public abstract GraphicsDevice getDefaultScreenDevice()
                                               throws HeadlessException
```
    返回默认屏幕 GraphicsDevice 。
    
    结果
    
    所述 GraphicsDevice表示默认屏幕设备
    
    异常
    
    HeadlessException - 如果isHeadless（）返回true
    
    另请参见：
    
    isHeadless()
  - createGraphics
```
public abstract Graphics2D createGraphics(BufferedImage img)
```
    返回一个Graphics2D对象，用于渲染到指定的BufferedImage中。
    
    参数
    
    img - 指定的 BufferedImage
    
    结果
    
    一个 Graphics2D用于渲染到指定的 BufferedImage
    
    异常
    
    NullPointerException - 如果 img为空
  - getAllFonts
```
public abstract Font[] getAllFonts()
```
    返回一个包含此GraphicsEnvironment的所有字体的一点大小实例的GraphicsEnvironment 。典型的用法是允许用户选择特定的字体。然后，应用程序可以调整字体的大小并通过在所选实例上调用deriveFont方法来设置各种字体属性。
    该方法为应用程序提供了最精确的控制，使用哪种Font实例来呈现文本。如果此GraphicsEnvironment中的字体具有多个可编程变量，那么该数组中只返回一个该Font一个实例，并且应用程序必须导出其他变体。
    
    如果此环境中的字体具有多个可编程变体，例如Multiple-Master字体，那么在Font数组中只返回该字体的一个实例。其他变体必须由应用程序导出。
    
    结果
    
    一组 Font对象
    
    从以下版本开始：
    
    1.2
    
    另请参见：
    
    getAvailableFontFamilyNames() ， Font ， Font.deriveFont(int, float) ， Font.getFontName()
  - getAvailableFontFamilyNames
```
public abstract String[] getAvailableFontFamilyNames()
```
    返回一个数组，该GraphicsEnvironment包含本地化为默认语言环境的GraphicsEnvironment中所有字体族的名称，由Locale.getDefault()返回。
    典型的用法是呈现给用户以选择特定的姓氏。然后，应用程序可以在创建字体时指定此名称，并结合使用粗体或斜体的样式，使字体系统灵活地选择自己在同一字体系列中的多种字体之间的最佳匹配。
    
    结果
    
    的阵列 String本地化默认语言环境，或者如果没有名称此语言环境中存在的合适的替代名称包含字体系列名称。
    
    从以下版本开始：
    
    1.2
    
    另请参见：
    
    getAllFonts() ， Font ， Font.getFamily()
  - getAvailableFontFamilyNames
```
public abstract String[] getAvailableFontFamilyNames(Locale l)
```
    返回一个数组，其中包含本指定区域设置的本GraphicsEnvironment中所有字体族的名称。
    典型的用法是呈现给用户以选择特定的姓氏。然后，应用程序可以在创建字体时指定此名称，并结合使用粗体或斜体的样式，使字体系统灵活地选择自己在同一字体系列中的多种字体之间的最佳匹配。
    
    参数
    
    l - 代表特定地理，政治或文化区域的Locale对象。指定null等效于指定Locale.getDefault() 。
    
    结果
    
    包含 String本地化的字体族名称的String Locale ，或者如果指定的区域设置中没有名称，则为合适的替代名称。
    
    从以下版本开始：
    
    1.2
    
    另请参见：
    
    getAllFonts() ， Font ， Font.getFamily()
  - registerFont
```
public boolean registerFont(Font font)
```
    注册一个创建 Font这个GraphicsEnvironment 。创建的字体是从调用Font.createFont(int, java.io.InputStream)返回的字体，或通过调用Font.deriveFont(int, float)从创建的字体派生的。在调用此类字体的方法之后，可以在名称或姓氏中构建新的Font ，并在此应用程序或小应用程序的执行上下文中列举getAvailableFontFamilyNames()和getAllFonts() 。这意味着小程序无法以其他applet可见的方式注册字体。
    这种方法可能不会注册字体，因此返回false是：
    - 该字体不是创建的 Font 。
    - 字体与未创建的Font已经在此GraphicsEnvironment 。例如，如果名称是系统字体的名称，或者如Font类的文档中所述的逻辑字体。如果字体与系统字体具有相同的系列名称，字体是否也可能会发生冲突。
      请注意，应用程序可以使用新的字体替换先前创建的字体的注册。
    结果
    
    真要是 font成功注册在这个 GraphicsEnvironment 。
    
    异常
    
    NullPointerException - 如果 font为空
    
    从以下版本开始：
    
    1.6
  - preferLocaleFonts
```
public void preferLocaleFonts()
```
    表示对逻辑字体映射到物理字体的区域设置特定字体的偏好。调用此方法表示字体渲染应主要使用主要写入系统特定的字体（由默认编码和初始默认语言环境指定的字体）。例如，如果主要的书写系统是日语，那么如果可能，应该使用日语字体来渲染字符，而其他字体只能用于日文字体没有字形的字符。
    由调用此方法导致的字体渲染行为的实际变化取决于实现; 它可能根本没有影响，或者所请求的行为可能已经与默认行为相匹配。轻量级和对等组件中的字体渲染行为可能会有所不同。由于调用此方法请求不同的字体，客户端应该期望不同的度量，并且可能需要重新计算窗口大小和布局。因此，在用户界面初始化之前应该调用此方法。
    
    从以下版本开始：
    
    1.5
  - preferProportionalFonts
```
public void preferProportionalFonts()
```
    表示在逻辑字体映射到物理字体时比例超过非比例（例如双间隔CJK字体）字体的偏好。如果默认映射包含存在比例和非比例变量的字体，则调用此方法表示映射应使用比例变量。
    由调用此方法导致的字体渲染行为的实际变化取决于实现; 它可能没有任何效果。轻量级和对等组件中的字体渲染行为可能会有所不同。由于调用此方法请求不同的字体，客户端应该期望不同的度量，并且可能需要重新计算窗口大小和布局。因此，在用户界面初始化之前应该调用此方法。
    
    从以下版本开始：
    
    1.5
  - getCenterPoint
```
public Point getCenterPoint()
                     throws HeadlessException
```
    返回Windows应该居中的点。建议使用getMaximumWindowBounds（）检查居中的Windows，以确保它们适合可用的显示区域。
    
    结果
    
    Windows应该居中的地步
    
    异常
    
    HeadlessException - 如果isHeadless（）返回true
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    getMaximumWindowBounds()
  - getMaximumWindowBounds
```
public Rectangle getMaximumWindowBounds()
                                 throws HeadlessException
```
    返回居中Windows的最大边界。这些边界是本地窗口系统中的对象，如任务栏和菜单栏。返回的界限将驻留在单个显示屏上，但有一个例外：在多屏幕系统中，Windows应以所有显示为中心，此方法返回整个显示区域的界限。
    要获得单个显示的可用边界，请使用GraphicsConfiguration.getBounds()和Toolkit.getScreenInsets() 。
    
    结果
    
    居中Windows的最大边界
    
    异常
    
    HeadlessException - 如果isHeadless（）返回true
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    getCenterPoint() ， GraphicsConfiguration.getBounds() ， Toolkit.getScreenInsets(java.awt.GraphicsConfiguration)

Class GraphicsEnvironment

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

GraphicsEnvironment

方法详细信息

getLocalGraphicsEnvironment

isHeadless

isHeadlessInstance

getScreenDevices

getDefaultScreenDevice

createGraphics

getAllFonts

getAvailableFontFamilyNames

getAvailableFontFamilyNames

registerFont

preferLocaleFonts

preferProportionalFonts

getCenterPoint

getMaximumWindowBounds