Класс SynthGraphicsUtils

java.lang.Object

javax.swing.plaf.synth.SynthGraphicsUtils

public class SynthGraphicsUtils extends Object

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

Начиная с:: 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)`	Отображает значок и текст.

Методы, объявленные в классе 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 — графический объект для рисования; 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 — графический объект для рисования; 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)

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

Параметры:: icon — значок; context — SynthContext, запрашивающий значок; может иметь значение null.
Возвращает:: значение int, задающее ширину значка.

getIconHeight

public static int getIconHeight(Icon icon, SynthContext context)

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

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

paintIcon

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

Отображает значок. Для SynthIcon вызывается метод paintIcon(context, g, x, y, width, height).

Параметры:: 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/plaf/synth/SynthGraphicsUtils.html