Класс 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 используется для рендеринга текста. Если шрифт в данной среде имеет несколько программируемых вариантов, например, шрифты Multiple-Master, в массиве возвращается только один экземпляр этого шрифта, а другие вариации должны быть получены приложением.

Если шрифт в данной среде имеет несколько программируемых вариаций, таких как шрифты 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, java.io.InputStream) или получен из созданного шрифта путём вызова Font.deriveFont(int, float). После вызова этого метода для такого шрифта он доступен для использования при создании новых Font по имени или имени семейства, и перечисляется методами getAvailableFontFamilyNames() и getAllFonts() в контексте выполнения этого приложения или апплета. Это означает, что апплеты не могут регистрировать шрифты таким образом, чтобы они были видны другим апплетам.

Причины, по которым этот метод может не зарегистрировать шрифт и, следовательно, вернуть false:

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

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

public void preferLocaleFonts()

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

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

public void preferProportionalFonts()

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

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

public Point getCenterPoint() throws HeadlessException

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

public Rectangle getMaximumWindowBounds() throws HeadlessException

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

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