Класс 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)`	Возвращает ширину переданной строки с использованием свойств текста и параметров сглаживания по антиалиасингу из предоставленного компонента.

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

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

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

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)

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

Параметры:: 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 указывает на значение символа (код единицы Юникода) в заданной строке. Если значение символа, указанное по индексу подчеркивания, находится в диапазоне высоких суррогатных значений, а значение символа в следующем индексе - в диапазоне низких суррогатных значений, то соответствующий дополнительный символ подчеркивается.

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

Параметры:

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

g - контекст графики, не должен быть null

string - строка для отображения, может быть null

underlinedIndex - индекс символа для подчеркивания

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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/plaf/basic/BasicGraphicsUtils.html