Класс BasicGraphicsUtils

java.lang.Object

javax.swing.plaf.basic.BasicGraphicsUtils

public class BasicGraphicsUtils extends Object

Вспомогательный класс для удобной работы.

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

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

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

Модификатор и тип	Метод	Описание
`static void`	`drawBezel(Graphics g, int x, int y, int w, int h, boolean isPressed, boolean isDefault, Color shadow, Color darkShadow, Color highlight, Color lightHighlight)`	Рисует выпуклую рамку.
`static void`	`drawDashedRect(Graphics g, int x, int y, int width, int height)`	Рисует пунктирный прямоугольник.
`static void`	`drawEtchedRect(Graphics g, int x, int y, int w, int h, Color shadow, Color darkShadow, Color highlight, Color lightHighlight)`	Рисует прямоугольник с эффектом травления.
`static void`	`drawGroove(Graphics g, int x, int y, int w, int h, Color shadow, Color highlight)`	Рисует желобок.
`static void`	`drawLoweredBezel(Graphics g, int x, int y, int w, int h, Color shadow, Color darkShadow, Color highlight, Color lightHighlight)`	Рисует утопленную рамку.
`static void`	`drawString(Graphics g, String text, int underlinedChar, int x, int y)`	Рисует строку с помощью графического контекста `g` в точке (x,y), так же, как это сделал бы `g.drawString`.
`static void`	`drawString(JComponent c, Graphics2D g, String string, float x, float y)`	Рисует заданную строку в указанной точке, используя текстовые свойства и параметры сглаживания из переданного компонента.
`static void`	`drawStringUnderlineCharAt(Graphics g, String text, int underlinedIndex, int x, int y)`	Рисует строку с помощью графического контекста `g` в точке (`x`, `y`), так же, как это сделал бы `g.drawString`.
`static void`	`drawStringUnderlineCharAt(JComponent c, Graphics2D g, String string, int underlinedIndex, float x, float y)`	Рисует заданную строку в указанной точке, подчеркивая указанный символ.
`static String`	`getClippedString(JComponent c, FontMetrics fm, String string, int availTextWidth)`	Обрезает переданную строку по доступной ширине.
`static Insets`	`getEtchedInsets()`	Возвращает пространство, занимаемое рамкой, нарисованной методом `drawEtchedRect()`
`static Insets`	`getGrooveInsets()`	Возвращает пространство, занимаемое рамкой, нарисованной методом `drawGroove()`
`static Dimension`	`getPreferredButtonSize(AbstractButton b, int textIconGap)`	Возвращает предпочтительный размер кнопки.
`static float`	`getStringWidth(JComponent c, FontMetrics fm, String string)`	Возвращает ширину переданной строки, используя текстовые свойства и параметры сглаживания из переданного компонента.

Методы, объявленные в классе 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, либо до истечения заданного промежутка реального времени.

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

BasicGraphicsUtils

public BasicGraphicsUtils()

Создает BasicGraphicsUtils.

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

drawEtchedRect

public static void drawEtchedRect(Graphics g, int x, int y, int w, int h, Color shadow, Color darkShadow, Color highlight, Color lightHighlight)

Рисует прямоугольник с эффектом травления.

Параметры:: g — экземпляр Graphics; x — координата X; y — координата Y; w — ширина; h — высота; shadow — цвет тени; darkShadow — цвет темной тени; highlight — цвет подсветки; lightHighlight — цвет светлой подсветки

getEtchedInsets

public static Insets getEtchedInsets()

Возвращает пространство, занимаемое рамкой, нарисованной методом drawEtchedRect()

Возвращает:: отступы прямоугольника с эффектом травления

drawGroove

public static void drawGroove(Graphics g, int x, int y, int w, int h, Color shadow, Color highlight)

Рисует желобок.

Параметры:: g — экземпляр Graphics; x — координата X; y — координата Y; w — ширина; h — высота; shadow — цвет тени; highlight — цвет подсветки

getGrooveInsets

public static Insets getGrooveInsets()

Возвращает пространство, занимаемое рамкой, нарисованной методом drawGroove()

Возвращает:: отступы рамки-желобка

drawBezel

public static void drawBezel(Graphics g, int x, int y, int w, int h, boolean isPressed, boolean isDefault, Color shadow, Color darkShadow, Color highlight, Color lightHighlight)

Рисует выпуклую рамку.

Параметры:: g — экземпляр Graphics; x — координата X; y — координата Y; w — ширина; h — высота; isPressed — находится ли компонент в нажатом состоянии; isDefault — является ли рисование рисованием по умолчанию; shadow — цвет тени; darkShadow — цвет темной тени; highlight — цвет подсветки; lightHighlight — цвет светлой подсветки

drawLoweredBezel

public static void drawLoweredBezel(Graphics g, int x, int y, int w, int h, Color shadow, Color darkShadow, Color highlight, Color lightHighlight)

Рисует утопленную рамку.

Параметры:: g — экземпляр Graphics; x — координата X; y — координата Y; w — ширина; h — высота; shadow — цвет тени; darkShadow — цвет темной тени; highlight — цвет подсветки; lightHighlight — цвет светлой подсветки

drawString

public static void drawString(Graphics g, String text, int underlinedChar, int x, int y)

Рисует строку с помощью графического контекста g в точке (x,y), так же, как это сделал бы g.drawString. Первый экземпляр underlineChar в тексте будет подчеркнут. При поиске совпадений регистр не учитывается.

Параметры:: g — экземпляр Graphics; text — текст; underlinedChar — подчеркиваемый символ; x — координата X; y — координата Y

drawStringUnderlineCharAt

public static void drawStringUnderlineCharAt(Graphics g, String text, int underlinedIndex, int x, int y)

Рисует строку с помощью графического контекста g в точке (x, y), так же, как это сделал бы g.drawString. Символ с индексом underlinedIndex в тексте будет подчеркнут. Если index выходит за границы text (в том числе если меньше 0), ни один символ не будет подчеркнут.

Параметры:: g — графический контекст для рисования; text — строка для рисования; underlinedIndex — индекс символа в тексте, который нужно подчеркнуть; x — координата x для рисования; y — координата y для рисования
Начиная с версии:: 1.4

drawDashedRect

public static void drawDashedRect(Graphics g, int x, int y, int width, int height)

Рисует пунктирный прямоугольник.

Параметры:: g — экземпляр Graphics; x — координата X; y — координата Y; width — ширина прямоугольника; height — высота прямоугольника

getPreferredButtonSize

public static Dimension getPreferredButtonSize(AbstractButton b, int textIconGap)

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

Параметры:: b — экземпляр AbstractButton; textIconGap — расстояние между текстом и значком
Возвращает:: предпочтительный размер кнопки

drawString

public static void drawString(JComponent c, Graphics2D g, String string, float x, float y)

Рисует заданную строку в указанной точке, используя текстовые свойства и параметры сглаживания из переданного компонента. Если строка равна null, ничего не рисуется.

Параметры:: c — компонент, отображающий строку; может быть null; g — графический контекст; не должен быть null; string — отображаемая строка; может быть null; x — координата x для рисования текста; y — координата y для рисования текста
Выбрасывает:: NullPointerException — если указанный g равен null
Начиная с версии:: 9

drawStringUnderlineCharAt

public static void drawStringUnderlineCharAt(JComponent c, Graphics2D g, String string, int underlinedIndex, float x, float y)

Рисует заданную строку в указанной точке, подчеркивая указанный символ. Переданный компонент используется для получения текстовых свойств и параметров сглаживания.

Параметр underlinedIndex указывает на значение типа char (кодовую единицу Unicode) в заданной строке. Если значение char по указанному индексу подчеркивания входит в диапазон старших суррогатов, а значение char по следующему индексу — в диапазон младших суррогатов, подчеркивается дополнительный символ, соответствующий этой суррогатной паре.

Символ не подчеркивается, если индекс отрицательный или превышает длину строки (index < 0 || index >= string.length()), либо если значение char по указанному индексу входит в диапазон младших суррогатов.

Параметры:

c — компонент, отображающий строку; может быть null

g — графический контекст; не должен быть null

string — отображаемая строка; может быть null

underlinedIndex — индекс значения char (кодовой единицы Unicode) в строке, которое нужно подчеркнуть

x — координата x для рисования текста

y — координата y для рисования текста

Выбрасывает:

NullPointerException — если указанный g равен null

Начиная с версии:

См. также:

getClippedString

public static String getClippedString(JComponent c, FontMetrics fm, String string, int availTextWidth)

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

Параметры:

c — компонент; может быть null

fm — объект FontMetrics, используемый для измерения ширины строки; должен быть получен с правильными шрифтом и графическим контекстом. Не должен быть null.

string — строка для обрезки; может быть null

availTextWidth — пространство, в котором можно нарисовать строку

Возвращает:

обрезанную строку, которая помещается в доступное пространство; пустую строку, если заданная строка равна null или пуста

Выбрасывает:

NullPointerException — если указанный fm равен null

Начиная с версии:

См. также:

getStringWidth

public static float getStringWidth(JComponent c, FontMetrics fm, String string)

Возвращает ширину переданной строки, используя текстовые свойства и параметры сглаживания из переданного компонента. Если переданная строка равна null, возвращает ноль.

Параметры:: c — компонент; может быть null; fm — объект FontMetrics, используемый для измерения ширины строки с учетом продвижения; должен быть получен с правильными шрифтом и графическим контекстом. Не должен быть null.; string — строка, ширину с учетом продвижения которой нужно получить; может быть null
Возвращает:: ширину с учетом продвижения указанной строки; для строки null возвращается ноль
Выбрасывает:: NullPointerException — если указанный fm равен null
Начиная с версии:: 9

© 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.