Класс 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения указанного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения указанного промежутка реального времени.

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

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.