Класс GraphicsEnvironment

protected GraphicsEnvironment()

Этот класс является абстрактным и не может быть создан напрямую. Экземпляры необходимо получать с помощью подходящей фабрики или метода запроса.

public static GraphicsEnvironment getLocalGraphicsEnvironment()

Возвращает локальный GraphicsEnvironment.

public static boolean isHeadless()

Проверяет, поддерживаются ли в этой среде дисплей, клавиатура и мышь. Если этот метод возвращает true, в тех областях Toolkit и GraphicsEnvironment, работа которых зависит от дисплея, клавиатуры или мыши, выбрасывается HeadlessException.

public boolean isHeadlessInstance()

Возвращает сведения о том, поддерживаются ли в этой графической среде дисплей, клавиатура и мышь. Если этот метод возвращает true, в тех областях графической среды, работа которых зависит от дисплея, клавиатуры или мыши, будет выброшено HeadlessException.

public abstract GraphicsDevice[] getScreenDevices() throws HeadlessException

Возвращает массив всех объектов экранных GraphicsDevice.

public abstract GraphicsDevice getDefaultScreenDevice() throws HeadlessException

Возвращает конфигурацию экрана по умолчанию GraphicsDevice.

public abstract Graphics2D createGraphics(BufferedImage img)

Возвращает объект Graphics2D для отрисовки в указанном BufferedImage.

public abstract Font[] getAllFonts()

Возвращает массив, содержащий экземпляр каждого доступного в этом GraphicsEnvironment шрифта размером в один пункт. Обычно этот метод используется для предоставления пользователю возможности выбрать определенный шрифт. Затем приложение может задать размер шрифта и установить различные атрибуты шрифта, вызвав метод deriveFont для выбранного экземпляра.

Этот метод предоставляет приложению наиболее точный контроль над тем, какой экземпляр Font используется для отображения текста. Если шрифт в этом GraphicsEnvironment имеет несколько программируемых вариантов, в массив возвращается только один экземпляр этого Font, а остальные варианты приложение должно получить самостоятельно.

Если шрифт в этой среде имеет несколько программируемых вариантов, например шрифты Multiple-Master, в массив Font возвращается только один экземпляр этого шрифта. Остальные варианты приложение должно получить самостоятельно.

public abstract String[] getAvailableFontFamilyNames()

Возвращает массив с именами всех семейств шрифтов в этом GraphicsEnvironment, локализованными для локали по умолчанию, как возвращает Locale.getDefault().

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

public abstract String[] getAvailableFontFamilyNames(Locale l)

Возвращает массив с именами всех семейств шрифтов в этом GraphicsEnvironment, локализованными для указанной локали.

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

public boolean registerFont(Font font)

Регистрирует созданный Font в этом GraphicsEnvironment. Созданный шрифт — это шрифт, возвращенный вызовом Font.createFont(int, InputStream) или полученный на основе созданного шрифта вызовом Font.deriveFont(int, float). После вызова этого метода такой шрифт становится доступен для создания новых Font по имени или имени семейства и перечисляется методами getAvailableFontFamilyNames() и getAllFonts() в контексте выполнения этого приложения.

Этот метод может не зарегистрировать шрифт и вернуть false по следующим причинам:

• Шрифт не является созданным Font.
• Шрифт конфликтует с уже имеющимся в этом GraphicsEnvironment шрифтом, который не был создан приложением Font. Например, если имя совпадает с именем системного шрифта или логического шрифта, описанного в документации класса Font. Зависит от реализации, будет ли также считаться конфликтом совпадение имени семейства шрифта с именем семейства системного шрифта.

  Обратите внимание: приложение может заменить регистрацию ранее созданного шрифта новым.

public void preferLocaleFonts()

Указывает предпочтение шрифтам, специфичным для локали, при сопоставлении логических шрифтов с физическими. Вызов этого метода указывает, что при отрисовке шрифтов следует в первую очередь использовать шрифты, соответствующие основной письменности (определяемой кодировкой по умолчанию и исходной локалью по умолчанию). Например, если основной письменностью является японская, символы следует отображать японским шрифтом, если это возможно; другие шрифты следует использовать только для символов, отсутствующих в японском шрифте.

Фактическое изменение поведения отрисовки шрифтов в результате вызова этого метода зависит от реализации: оно может отсутствовать, либо запрошенное поведение уже может соответствовать поведению по умолчанию. Поведение может различаться при отрисовке шрифтов в облегченных компонентах и компонентах с peer-объектами. Поскольку вызов этого метода запрашивает другой шрифт, следует учитывать возможность изменения метрик и необходимость пересчета размеров окон и компоновки. Поэтому этот метод следует вызывать до инициализации пользовательского интерфейса.

public void preferProportionalFonts()

Указывает предпочтение пропорциональным шрифтам перед непропорциональными (например, шрифтами CJK с двойным интервалом) при сопоставлении логических шрифтов с физическими. Если сопоставление по умолчанию содержит шрифты с пропорциональными и непропорциональными вариантами, вызов этого метода указывает, что следует использовать пропорциональный вариант.

Фактическое изменение поведения отрисовки шрифтов в результате вызова этого метода зависит от реализации; оно может отсутствовать. Поведение может различаться при отрисовке шрифтов в облегченных компонентах и компонентах с peer-объектами. Поскольку вызов этого метода запрашивает другой шрифт, следует учитывать возможность изменения метрик и необходимость пересчета размеров окон и компоновки. Поэтому этот метод следует вызывать до инициализации пользовательского интерфейса.

public Point getCenterPoint() throws HeadlessException

Возвращает точку, в которой следует центрировать окна. Рекомендуется проверять центрированные окна, чтобы убедиться, что они помещаются в доступной области экрана, используя getMaximumWindowBounds().

public Rectangle getMaximumWindowBounds() throws HeadlessException

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

Чтобы получить доступные границы одного дисплея, используйте GraphicsConfiguration.getBounds() и Toolkit.getScreenInsets().