Spec-Zone.ru › OpenJDK 17

Класс GraphicsEnvironment

java.lang.Object
java.awt.GraphicsEnvironment
public abstract class GraphicsEnvironment extends Object
Класс GraphicsEnvironment описывает набор объектов GraphicsDevice и объектов Font, доступных Java(tm) приложению на конкретной платформе. Ресурсы в этом GraphicsEnvironment могут быть локальными или на удалённой машине. Объекты GraphicsDevice могут быть экранами, принтерами или буферами изображений и являются местом назначения методов рисования Graphics2D. У каждого объекта GraphicsDevice есть ряд объектов GraphicsConfiguration, которые определяют различные конфигурации, в которых можно использовать объект GraphicsDevice.
См. также:
  • GraphicsDevice
  • GraphicsConfiguration

Краткое описание конструкторов

GraphicsEnvironment()
Модификатор Конструктор Описание
protected
Этот класс является абстрактным и не может быть напрямую создан.

Краткое описание методов

Модификатор и тип Метод Описание
abstract Graphics2D createGraphics(BufferedImage img)
Возвращает объект Graphics2D для отрисовки в указанный BufferedImage.
abstract Font[] getAllFonts()
Возвращает массив, содержащий экземпляр размера одного пункта всех шрифтов, доступных в этом 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()
Возвращает максимальные границы для центрированных окон.
abstract GraphicsDevice[] getScreenDevices()
Возвращает массив всех объектов экранного GraphicsDevice.
static boolean isHeadless()
Проверяет, поддерживаются ли в этой среде дисплей, клавиатура и мышь.
boolean isHeadlessInstance()
Возвращает, поддерживаются ли в этой графической среде дисплей, клавиатура и мышь.
void preferLocaleFonts()
Указывает предпочтение для шрифтов, специфичных для локали, в сопоставлении логических шрифтов с физическими шрифтами.
void preferProportionalFonts()
Указывает предпочтение пропорциональным шрифтам над непропорциональными (например,
boolean registerFont(Font font)
Регистрирует созданный Font в этом GraphicsEnvironment.

Методы, объявленные в классе 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, исключение HeadlessException выбрасывается из областей Toolkit и GraphicsEnvironment, которые зависят от отображения, клавиатуры или мыши.
Возвращает:
true если эта среда не может поддерживать отображение, клавиатуру и мышь; false в противном случае
С момента:
1.4
См. также:
  • HeadlessException

isHeadlessInstance

public boolean isHeadlessInstance()
Возвращает, поддерживается ли в этой графической среде отображение, клавиатура и мышь. Если это возвращает true, 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 равен null

getAllFonts

public abstract Font[] getAllFonts()
Возвращает массив, содержащий экземпляр всех шрифтов размером в один пункт, доступных в этой 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, локализованных для языка по умолчанию, как возвращается Locale.getDefault().

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

Возвращает:
массив String , содержащий имена семейств шрифтов, локализованные для языка по умолчанию, или подходящее альтернативное имя, если для этого языка нет имени.
С момента:
1.2
См. также:
  • getAllFonts()
  • Font
  • Font.getFamily()

getAvailableFontFamilyNames

public abstract String[] getAvailableFontFamilyNames(Locale l)
Возвращает массив, содержащий имена всех семейств шрифтов в этой GraphicsEnvironment , локализованных для указанного языка.

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

Параметры:
l - объект Locale , представляющий определенную географическую, политическую или культурную область. Указание null эквивалентно указанию Locale.getDefault().
Возвращает:
массив 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() в контексте выполнения этого приложения или апплета. Это означает, что апплеты не могут регистрировать шрифты таким образом, чтобы они были видны другим апплетам.

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

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

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

Параметры:
font - шрифт, который должен быть зарегистрирован
Возвращает:
true, если font успешно зарегистрирован в этой GraphicsEnvironment.
Исключения:
NullPointerException - если font равен null
С момента:
1.6

preferLocaleFonts

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

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

С момента:
1.5

preferProportionalFonts

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

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

Since:
1.5

getCenterPoint

public Point getCenterPoint() throws HeadlessException
Возвращает точку, по которой должны центрироваться окна. Рекомендуется проверять центрированные окна на соответствие доступной области отображения с помощью getMaximumWindowBounds().
Returns:
точка, по которой должны центрироваться окна
Throws:
HeadlessException - если isHeadless() возвращает true
Since:
1.4
See Also:
  • getMaximumWindowBounds()

getMaximumWindowBounds

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

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

Returns:
максимальные границы для центрированных окон
Throws:
HeadlessException - если isHeadless() возвращает true
Since:
1.4
See Also:
  • getCenterPoint()
  • GraphicsConfiguration.getBounds()
  • Toolkit.getScreenInsets(java.awt.GraphicsConfiguration)

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/java/awt/GraphicsEnvironment.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API