Класс 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
C тех пор:: 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
C тех пор:: 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

C тех пор:

См. также:

getStringWidth(javax.swing.JComponent, java.awt.FontMetrics, java.lang.String)

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

C тех пор:

См. также:

getStringWidth(javax.swing.JComponent, java.awt.FontMetrics, java.lang.String)

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, 2021, 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/17/docs/api/java.desktop/javax/swing/plaf/basic/BasicGraphicsUtils.html