Класс 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.
• Шрифт конфликтует с уже существующим не созданным Font в этой GraphicsEnvironment. Например, если его имя совпадает с именем системного шрифта или логического шрифта, описанного в документации класса Font. Зависит от реализации, может ли возникнуть конфликт также в том случае, если у шрифта такое же название семейства, как у системного шрифта.

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

public void preferLocaleFonts()

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

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

public void preferProportionalFonts()

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

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

public Point getCenterPoint() throws HeadlessException

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

public Rectangle getMaximumWindowBounds() throws HeadlessException

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

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