Класс SynthGraphicsUtils

java.lang.Object

javax.swing.plaf.synth.SynthGraphicsUtils

public class SynthGraphicsUtils extends Object

Обёртка для примитивных графических вызовов.

Since:: 1.5

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

Конструктор	Описание
`SynthGraphicsUtils()`	Создаёт `SynthGraphicsUtils`.

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

Модификатор и тип	Метод	Описание
`int`	`computeStringWidth(SynthContext ss, Font font, FontMetrics metrics, String text)`	Возвращает размер переданной строки.
`void`	`drawLine(SynthContext context, Object paintKey, Graphics g, int x1, int y1, int x2, int y2)`	Рисует линию между двумя конечными точками.
`void`	`drawLine(SynthContext context, Object paintKey, Graphics g, int x1, int y1, int x2, int y2, Object styleKey)`	Рисует линию между двумя конечными точками.
`static int`	`getIconHeight(Icon icon, SynthContext context)`	Возвращает высоту иконки.
`static int`	`getIconWidth(Icon icon, SynthContext context)`	Возвращает ширину иконки.
`int`	`getMaximumCharHeight(SynthContext context)`	Возвращает максимальную высоту шрифта из переданного SynthContext.
`Dimension`	`getMaximumSize(SynthContext ss, Font font, String text, Icon icon, int hAlign, int vAlign, int hTextPosition, int vTextPosition, int iconTextGap, int mnemonicIndex)`	Возвращает максимальный размер, необходимый для правильного отображения иконки и текста.
`Dimension`	`getMinimumSize(SynthContext ss, Font font, String text, Icon icon, int hAlign, int vAlign, int hTextPosition, int vTextPosition, int iconTextGap, int mnemonicIndex)`	Возвращает минимальный размер, необходимый для правильного отображения иконки и текста.
`Dimension`	`getPreferredSize(SynthContext ss, Font font, String text, Icon icon, int hAlign, int vAlign, int hTextPosition, int vTextPosition, int iconTextGap, int mnemonicIndex)`	Возвращает рекомендуемый размер, необходимый для правильного отображения иконки и текста.
`String`	`layoutText(SynthContext ss, FontMetrics fm, String text, Icon icon, int hAlign, int vAlign, int hTextPosition, int vTextPosition, Rectangle viewR, Rectangle iconR, Rectangle textR, int iconTextGap)`	Размещает текст и иконку, возвращая по ссылке расположение для иконки и текста.
`static void`	`paintIcon(Icon icon, SynthContext context, Graphics g, int x, int y, int width, int height)`	Отрисовывает иконку.
`void`	`paintText(SynthContext ss, Graphics g, String text, int x, int y, int mnemonicIndex)`	Отрисовывает текст в указанном месте.
`void`	`paintText(SynthContext ss, Graphics g, String text, Rectangle bounds, int mnemonicIndex)`	Отрисовывает текст в указанном месте.
`void`	`paintText(SynthContext ss, Graphics g, String text, Icon icon, int hAlign, int vAlign, int hTextPosition, int vTextPosition, int iconTextGap, int mnemonicIndex, int textOffset)`	Отрисовывает иконку и текст.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

SynthGraphicsUtils

public SynthGraphicsUtils()

Создаёт SynthGraphicsUtils.

Подробное описание методов

drawLine

public void drawLine(SynthContext context, Object paintKey, Graphics g, int x1, int y1, int x2, int y2)

Рисует линию между двумя конечными точками.

Параметры:: context — Идентифицирует область размещения.; paintKey — Идентифицирует часть компонента, которую требуется отрисовать, может быть null.; g — Объект Graphics для рисования.; x1 — Координата x начала линии.; y1 — Координата y начала линии.; x2 — Координата x конца линии.; y2 — Координата y конца линии.

drawLine

public void drawLine(SynthContext context, Object paintKey, Graphics g, int x1, int y1, int x2, int y2, Object styleKey)

Рисует линию между двумя конечными точками.

Эта реализация поддерживает только один ключ стиля линии, "dashed". Стиль линии "dashed" применяется только к вертикальным и горизонтальным линиям.

Указание null или любого ключа, отличного от "dashed", нарисует сплошные линии.

Параметры:: context — идентифицирует область размещения; paintKey — идентифицирует часть компонента, которая запрашивает отрисовку, может быть null; g — Объект Graphics для рисования; x1 — Координата x начала линии.; y1 — Координата y начала линии.; x2 — Координата x конца линии.; y2 — Координата y конца линии.; styleKey — идентифицирует требуемый стиль линии (например, "штриховая")
С:: 1.6

layoutText

public String layoutText(SynthContext ss, FontMetrics fm, String text, Icon icon, int hAlign, int vAlign, int hTextPosition, int vTextPosition, Rectangle viewR, Rectangle iconR, Rectangle textR, int iconTextGap)

Выравнивает текст и значок, возвращая, по ссылке, местоположение для размещения значка и текста.

Параметры:: ss — SynthContext; fm — FontMetrics для используемого шрифта, этот параметр может быть проигнорирован; text — Текст для выравнивания; icon — Значок для выравнивания; hAlign — Горизонтальное выравнивание; vAlign — Вертикальное выравнивание; hTextPosition — Горизонтальное положение текста; vTextPosition — Вертикальное положение текста; viewR — Прямоугольник для выравнивания текста и значка.; iconR — Прямоугольник для границ значка; textR — Прямоугольник для текста; iconTextGap — Пробел между значком и текстом
Возвращает:: по ссылке, местоположение для размещения значка и текста.

computeStringWidth

public int computeStringWidth(SynthContext ss, Font font, FontMetrics metrics, String text)

Возвращает размер переданной строки.

Параметры:: ss — SynthContext; font — Используемый шрифт; metrics — FontMetrics, может быть проигнорирован; text — Текст, размер которого необходимо получить.
Возвращает:: размер переданной строки.

getMinimumSize

public Dimension getMinimumSize(SynthContext ss, Font font, String text, Icon icon, int hAlign, int vAlign, int hTextPosition, int vTextPosition, int iconTextGap, int mnemonicIndex)

Возвращает минимальный размер, необходимый для правильной отрисовки значка и текста.

Параметры:: ss — SynthContext; font — Используемый шрифт; text — Текст для выравнивания; icon — Значок для выравнивания; hAlign — Горизонтальное выравнивание; vAlign — Вертикальное выравнивание; hTextPosition — Горизонтальное положение текста; vTextPosition — Вертикальное положение текста; iconTextGap — Расстояние между значком и текстом; mnemonicIndex — Индекс в тексте для отрисовки мнемоники, -1 указывает, что мнемоники нет.
Возвращает:: минимальный размер, необходимый для правильной отрисовки значка и текста.

getMaximumSize

public Dimension getMaximumSize(SynthContext ss, Font font, String text, Icon icon, int hAlign, int vAlign, int hTextPosition, int vTextPosition, int iconTextGap, int mnemonicIndex)

Возвращает максимальный размер, необходимый для правильной отрисовки значка и текста.

Параметры:: ss — SynthContext; font — Используемый шрифт; text — Текст для выравнивания; icon — Значок для выравнивания; hAlign — Горизонтальное выравнивание; vAlign — Вертикальное выравнивание; hTextPosition — Горизонтальное положение текста; vTextPosition — Вертикальное положение текста; iconTextGap — Расстояние между значком и текстом; mnemonicIndex — Индекс в тексте для отрисовки мнемоники, -1 указывает, что мнемоники нет.
Возвращает:: максимальный размер, необходимый для правильной отрисовки значка и текста.

getMaximumCharHeight

public int getMaximumCharHeight(SynthContext context)

Возвращает максимальную высоту символа из переданного SynthContext.

Параметры:: context — SynthContext, используемый для определения шрифта.
Возвращает:: максимальную высоту символов для шрифта из переданного контекста.

getPreferredSize

public Dimension getPreferredSize(SynthContext ss, Font font, String text, Icon icon, int hAlign, int vAlign, int hTextPosition, int vTextPosition, int iconTextGap, int mnemonicIndex)

Возвращает предпочтительный размер, необходимый для правильной отрисовки значка и текста.

Параметры:: ss — SynthContext; font — Используемый шрифт; text — Текст для выравнивания; icon — Значок для выравнивания; hAlign — Горизонтальное выравнивание; vAlign — Вертикальное выравнивание; hTextPosition — Горизонтальное положение текста; vTextPosition — Вертикальное положение текста; iconTextGap — Расстояние между значком и текстом; mnemonicIndex — Индекс в тексте для отрисовки мнемоники, -1 указывает, что мнемоники нет.
Возвращает:: предпочтительный размер, необходимый для правильной отрисовки значка и текста.

paintText

public void paintText(SynthContext ss, Graphics g, String text, Rectangle bounds, int mnemonicIndex)

Отрисовывает текст в указанном месте. Это не будет пытаться отобразить текст как html, а также не будет смещаться на отступы компонента.

Параметры:: ss — SynthContext; g — Объект Graphics, используемый для отрисовки строки.; text — Текст для отрисовки; bounds — Границы текста, который необходимо нарисовать.; mnemonicIndex — Индекс для отрисовки строки.

paintText

public void paintText(SynthContext ss, Graphics g, String text, int x, int y, int mnemonicIndex)

Параметры:: ss — SynthContext; g — Объект Graphics, используемый для отрисовки строки.; text — Текст для отрисовки; x — Положение X для отрисовки текста.; y — Верхний левый угол для отрисовки текста.; mnemonicIndex — Индекс для отрисовки строки.

paintText

public void paintText(SynthContext ss, Graphics g, String text, Icon icon, int hAlign, int vAlign, int hTextPosition, int vTextPosition, int iconTextGap, int mnemonicIndex, int textOffset)

Отрисовывает значок и текст. Это будет отрисовывать текст как html, при необходимости, и смещать положение на отступы компонента.

Параметры:: ss — SynthContext; g — Объект Graphics для отрисовки строки и значка; text — Текст для выравнивания; icon — Значок для выравнивания; hAlign — Горизонтальное выравнивание; vAlign — Вертикальное выравнивание; hTextPosition — Горизонтальное положение текста; vTextPosition — Вертикальное положение текста; iconTextGap — Расстояние между значком и текстом; mnemonicIndex — Индекс в тексте для отрисовки мнемоники, -1 указывает, что мнемоники нет.; textOffset — Сдвиг текста при отрисовке

getIconWidth

public static int getIconWidth(Icon icon, SynthContext context)

Возвращает ширину значка. Метод getIconWidth(context) вызывается для SynthIcon.

Параметры:: icon — значок; context — запрос значка, может быть null.
Возвращает:: целое число, представляющее ширину значка.

getIconHeight

public static int getIconHeight(Icon icon, SynthContext context)

Возвращает высоту значка. Метод getIconHeight(context) вызывается для SynthIcon.

Parameters:: icon - значок; context - SynthContext, запрашивающий значок, может быть null.
Returns:: int, определяющий высоту значка.

paintIcon

public static void paintIcon(Icon icon, SynthContext context, Graphics g, int x, int y, int width, int height)

Рисует значок. Метод paintIcon(context, g, x, y, width, height) вызывается для SynthIcon.

Parameters:: icon - значок; context - идентифицирует область размещения, может быть null.; g - контекст графики; x - координата x для рисования; y - координата y для рисования; width - ширина области для рисования, может быть 0; height - высота области для рисования, может быть 0

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/plaf/synth/SynthGraphicsUtils.html