Класс PasswordView

javax.swing.text.PasswordView

Все реализуемые интерфейсы:: SwingConstants, TabExpander

public class PasswordView extends FieldView

Реализует представление, подходящее для использования в реализациях пользовательского интерфейса JPasswordField. По сути, это представление поля, отображающее его содержимое символом-заполнителем, указанным в связанном компоненте (если компонент удается привести к JPasswordField).

См. также:

Краткое описание полей

Поля, объявленные в классе PlainView

metrics

Модификатор и тип	Поле	Описание
`protected FontMetrics`	`metrics`	Метрики шрифта для текущего шрифта.

Поля, объявленные в классе View

BadBreakWeight, ExcellentBreakWeight, ForcedBreakWeight, GoodBreakWeight, X_AXIS, Y_AXIS

Модификатор и тип	Поле	Описание
`static final int`	`BadBreakWeight`	Вес, указывающий, что представление является неудачным местом для переноса при форматировании.
`static final int`	`ExcellentBreakWeight`	Вес, указывающий, что представление поддерживает перенос и является очень подходящим местом для него.
`static final int`	`ForcedBreakWeight`	Вес, указывающий, что представление поддерживает перенос и должно быть перенесено для корректного отображения внутри представления, форматирующего дочерние элементы с переносом.
`static final int`	`GoodBreakWeight`	Вес, указывающий, что представление поддерживает перенос, но, вероятно, существуют более подходящие места.
`static final int`	`X_AXIS`	Ось для операций форматирования и переноса.
`static final int`	`Y_AXIS`	Ось для операций форматирования и переноса.

Поля, объявленные в интерфейсе SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Модификатор и тип	Поле	Описание
`static final int`	`BOTTOM`	Константа ориентации блока, обозначающая его нижнюю сторону.
`static final int`	`CENTER`	Центральное положение в области.
`static final int`	`EAST`	Направление по компасу: восток (справа).
`static final int`	`HORIZONTAL`	Горизонтальная ориентация.
`static final int`	`LEADING`	Обозначает начальный край текста для языков с письмом слева направо и справа налево.
`static final int`	`LEFT`	Константа ориентации блока, обозначающая его левую сторону.
`static final int`	`NEXT`	Обозначает следующее направление в последовательности.
`static final int`	`NORTH`	Направление по компасу: север (сверху).
`static final int`	`NORTH_EAST`	Направление по компасу: северо-восток (вверху справа).
`static final int`	`NORTH_WEST`	Направление по компасу: северо-запад (вверху слева).
`static final int`	`PREVIOUS`	Обозначает предыдущее направление в последовательности.
`static final int`	`RIGHT`	Константа ориентации блока, обозначающая его правую сторону.
`static final int`	`SOUTH`	Направление по компасу: юг (снизу).
`static final int`	`SOUTH_EAST`	Направление по компасу: юго-восток (внизу справа).
`static final int`	`SOUTH_WEST`	Направление по компасу: юго-запад (внизу слева).
`static final int`	`TOP`	Константа ориентации блока, обозначающая его верхнюю сторону.
`static final int`	`TRAILING`	Обозначает конечный край текста для языков с письмом слева направо и справа налево.
`static final int`	`VERTICAL`	Вертикальная ориентация.
`static final int`	`WEST`	Направление по компасу: запад (слева).

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

Конструктор	Описание
`PasswordView(Element elem)`	Создает новое представление, обернутое вокруг элемента.

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

Модификатор и тип	Метод	Описание
`protected float`	`drawEchoCharacter(Graphics2D g, float x, float y, char c)`	Отображает символ-заполнитель или другую графику, используемую для отображения символов пароля.
`protected int`	`drawEchoCharacter(Graphics g, int x, int y, char c)`	Устарело. заменено на `drawEchoCharacter(Graphics2D, float, float, char)`
`protected int`	`drawSelectedText(Graphics g, int x, int y, int p0, int p1)`	Устарело. заменено на `PlainView.drawSelectedText(Graphics2D, float, float, int, int)`
`protected int`	`drawUnselectedText(Graphics g, int x, int y, int p0, int p1)`	Устарело. заменено на `PlainView.drawUnselectedText(Graphics2D, float, float, int, int)`
`float`	`getPreferredSpan(int axis)`	Определяет предпочтительную протяженность этого представления вдоль оси.
`Shape`	`modelToView(int pos, Shape a, Position.Bias b)`	Обеспечивает преобразование координат из пространства координат модели документа в пространство координат соответствующего ей представления.
`int`	`viewToModel(float fx, float fy, Shape a, Position.Bias[] bias)`	Обеспечивает преобразование координат из пространства координат представления в логическое пространство координат модели.

Методы, объявленные в классе FieldView

adjustAllocation, getFontMetrics, getResizeWeight, insertUpdate, paint, removeUpdate

Модификатор и тип	Метод	Описание
`protected Shape`	`adjustAllocation(Shape a)`	Корректирует выделенную представлению область, чтобы она подходила для текстового поля.
`protected FontMetrics`	`getFontMetrics()`	Получает метрики шрифта, связанного с компонентом, содержащим это представление.
`int`	`getResizeWeight(int axis)`	Определяет возможность изменения размера представления вдоль заданной оси.
`void`	`insertUpdate(DocumentEvent changes, Shape a, ViewFactory f)`	Уведомляет о вставке данных в документ в области, за которую отвечает это представление.
`void`	`paint(Graphics g, Shape a)`	Отображает содержимое на заданной поверхности и в заданной области этой поверхности.
`void`	`removeUpdate(DocumentEvent changes, Shape a, ViewFactory f)`	Уведомляет об удалении данных из документа в области, за которую отвечает это представление.

Методы, объявленные в классе PlainView

changedUpdate, damageLineRange, drawLine, drawLine, drawSelectedText, drawUnselectedText, getLineBuffer, getTabSize, lineToRect, nextTabStop, setSize, updateDamage, updateMetrics

Модификатор и тип	Метод	Описание
`void`	`changedUpdate(DocumentEvent changes, Shape a, ViewFactory f)`	Уведомляет о том, что в документе изменились атрибуты в области, за которую отвечает это представление.
`protected void`	`damageLineRange(int line0, int line1, Shape a, Component host)`	Перерисовывает заданный диапазон строк.
`protected void`	`drawLine(int lineIndex, Graphics2D g, float x, float y)`	Отображает строку текста, удаляя пробелы в конце и разворачивая табуляции.
`protected void`	`drawLine(int lineIndex, Graphics g, int x, int y)`	Устарело. заменено на `PlainView.drawLine(int, Graphics2D, float, float)`
`protected float`	`drawSelectedText(Graphics2D g, float x, float y, int p0, int p1)`	Отображает заданный диапазон модели как выделенный текст.
`protected float`	`drawUnselectedText(Graphics2D g, float x, float y, int p0, int p1)`	Отображает заданный диапазон модели как обычный невыделенный текст.
`protected final Segment`	`getLineBuffer()`	Предоставляет доступ к буферу, используемому для получения текста из связанного документа.
`protected int`	`getTabSize()`	Возвращает размер табуляции, установленный для документа; по умолчанию равен 8.
`protected Rectangle`	`lineToRect(Shape a, int line)`	Определяет прямоугольник, представляющий заданную строку.
`float`	`nextTabStop(float x, int tabOffset)`	Возвращает позицию следующей позиции табуляции после заданной исходной позиции.
`void`	`setSize(float width, float height)`	Задает размер представления.
`protected void`	`updateDamage(DocumentEvent changes, Shape a, ViewFactory f)`	Перерисовывает область изменений, затронутую заданным событием документа.
`protected void`	`updateMetrics()`	Проверяет, актуальны ли метрики шрифта и самая длинная строка.

Методы, объявленные в классе View

append, breakView, createFragment, forwardUpdate, forwardUpdateToView, getAlignment, getAttributes, getBreakWeight, getChildAllocation, getContainer, getDocument, getElement, getEndOffset, getGraphics, getMaximumSpan, getMinimumSpan, getNextVisualPositionFrom, getParent, getStartOffset, getToolTipText, getView, getViewCount, getViewFactory, getViewIndex, getViewIndex, insert, isVisible, modelToView, modelToView, preferenceChanged, remove, removeAll, replace, setParent, updateChildren, updateLayout, viewToModel

Модификатор и тип	Метод	Описание
`void`	`append(View v)`	Добавляет одно дочернее представление.
`View`	`breakView(int axis, int offset, float pos, float len)`	Пытается перенести это представление по заданной оси.
`View`	`createFragment(int p0, int p1)`	Создает представление, соответствующее части элемента.
`protected void`	`forwardUpdate(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a, ViewFactory f)`	Передает заданное `DocumentEvent` дочерним представлениям, которые должны получить уведомление об изменении модели.
`protected void`	`forwardUpdateToView(View v, DocumentEvent e, Shape a, ViewFactory f)`	Передает `DocumentEvent` заданному дочернему представлению.
`float`	`getAlignment(int axis)`	Определяет требуемое выравнивание этого представления вдоль оси.
`AttributeSet`	`getAttributes()`	Получает атрибуты для отображения.
`int`	`getBreakWeight(int axis, float pos, float len)`	Определяет, насколько подходящим является место переноса в этом представлении.
`Shape`	`getChildAllocation(int index, Shape a)`	Получает область, выделенную заданному дочернему представлению.
`Container`	`getContainer()`	Получает контейнер, содержащий представление.
`Document`	`getDocument()`	Получает модель, связанную с представлением.
`Element`	`getElement()`	Получает структурную часть объекта, с которой сопоставлено это представление.
`int`	`getEndOffset()`	Получает часть модели, за которую отвечает это представление.
`Graphics`	`getGraphics()`	Получает `Graphics` для отображения.
`float`	`getMaximumSpan(int axis)`	Определяет максимальную протяженность этого представления вдоль оси.
`float`	`getMinimumSpan(int axis)`	Определяет минимальную протяженность этого представления вдоль оси.
`int`	`getNextVisualPositionFrom(int pos, Position.Bias b, Shape a, int direction, Position.Bias[] biasRet)`	Позволяет определить следующее визуально представленное место в модели, где можно установить каретку.
`View`	`getParent()`	Возвращает родительское представление.
`int`	`getStartOffset()`	Получает часть модели, за которую отвечает это представление.
`String`	`getToolTipText(float x, float y, Shape allocation)`	Возвращает текст всплывающей подсказки в указанном месте.
`View`	`getView(int n)`	Получает n-е дочернее представление.
`int`	`getViewCount()`	Возвращает количество представлений в этом представлении.
`ViewFactory`	`getViewFactory()`	Получает реализацию `ViewFactory`, обеспечивающую иерархию представлений.
`int`	`getViewIndex(float x, float y, Shape allocation)`	Возвращает индекс дочернего представления, соответствующий заданной позиции в представлении.
`int`	`getViewIndex(int pos, Position.Bias b)`	Возвращает индекс дочернего представления, соответствующий заданной позиции в модели.
`void`	`insert(int offs, View v)`	Вставляет одно дочернее представление.
`boolean`	`isVisible()`	Возвращает логическое значение, указывающее, видно ли представление.
`Shape`	`modelToView(int pos, Shape a)`	Устарело.
`Shape`	`modelToView(int p0, Position.Bias b0, int p1, Position.Bias b1, Shape a)`	Обеспечивает для заданной области преобразование координат из пространства координат модели документа в пространство координат представления.
`void`	`preferenceChanged(View child, boolean width, boolean height)`	Дочерние представления могут вызвать этот метод у родительского представления, чтобы сообщить об изменении предпочтений, которое следует учесть при повторной компоновке.
`void`	`remove(int i)`	Удаляет дочернее представление в заданной позиции.
`void`	`removeAll()`	Удаляет все дочерние представления.
`void`	`replace(int offset, int length, View[] views)`	Заменяет дочерние представления.
`void`	`setParent(View parent)`	Задает родительское представление для этого представления.
`protected boolean`	`updateChildren(DocumentEvent.ElementChange ec, DocumentEvent e, ViewFactory f)`	Обновляет дочерние представления после получения уведомления об изменении модели, если имеется запись об изменении элемента, за который отвечает это представление.
`protected void`	`updateLayout(DocumentEvent.ElementChange ec, DocumentEvent e, Shape a)`	Обновляет компоновку после получения уведомления об изменении модели.
`int`	`viewToModel(float x, float y, Shape a)`	Устарело.

Методы, объявленные в классе 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()`	Приостанавливает текущий поток до пробуждения, обычно вследствие уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до пробуждения, обычно вследствие уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до пробуждения, обычно вследствие уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

PasswordView

public PasswordView(Element elem)

Создает новое представление, обернутое вокруг элемента.

Параметры:: elem — элемент

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

drawUnselectedText

@Deprecated(since="9") protected int drawUnselectedText(Graphics g, int x, int y, int p0, int p1) throws BadLocationException

Устарело.

заменен на PlainView.drawUnselectedText(Graphics2D, float, float, int, int)

Отображает указанный диапазон модели как обычный невыделенный текст. Устанавливает цвет переднего плана и выводит символы, используя значение, возвращаемое getEchoChar().

Переопределяет:: drawUnselectedText в классе PlainView
Параметры:: g — графический контекст; x — начальная координата X >= 0; y — начальная координата Y >= 0; p0 — начальное смещение в модели >= 0; p1 — конечное смещение в модели >= p0
Возвращает:: координату X конца диапазона >= 0
Вызывает исключение:: BadLocationException — если p0 или p1 выходят за пределы диапазона

drawSelectedText

@Deprecated(since="9") protected int drawSelectedText(Graphics g, int x, int y, int p0, int p1) throws BadLocationException

Устарело.

заменен на PlainView.drawSelectedText(Graphics2D, float, float, int, int)

Отображает указанный диапазон модели как выделенный текст. Реализация выводит текст цветом, заданным в содержащем компоненте. Предполагается, что подсветка отобразит фон выделения. Для отображения символов используется результат getEchoChar().

Переопределяет:: drawSelectedText в классе PlainView
Параметры:: g — графический контекст; x — начальная координата X >= 0; y — начальная координата Y >= 0; p0 — начальное смещение в модели >= 0; p1 — конечное смещение в модели >= p0
Возвращает:: координату X конца диапазона >= 0
Вызывает исключение:: BadLocationException — если p0 или p1 выходят за пределы диапазона

drawEchoCharacter

@Deprecated(since="9") protected int drawEchoCharacter(Graphics g, int x, int y, char c)

Устарело.

заменен на drawEchoCharacter(Graphics2D, float, float, char)

Отображает символ подстановки или другой графический элемент, используемый для отображения символов пароля. Цвет объекта Graphics устанавливается в соответствующий цвет переднего плана для выделенного или невыделенного текста.

Параметры:: g — графический контекст; x — начальная координата X >= 0; y — начальная координата Y >= 0; c — символ подстановки
Возвращает:: обновленную позицию X >= 0

drawEchoCharacter

protected float drawEchoCharacter(Graphics2D g, float x, float y, char c)

Параметры:: g — графический контекст; x — начальная координата X >= 0; y — начальная координата Y >= 0; c — символ подстановки
Возвращает:: обновленную позицию X >= 0
С версии:: 9

modelToView

public Shape modelToView(int pos, Shape a, Position.Bias b) throws BadLocationException

Преобразует координаты пространства модели документа в координаты пространства соответствующего ей представления.

Переопределяет:

modelToView в классе FieldView

Параметры:

pos — позиция для преобразования >= 0

a — выделенная область для отображения

b — смещение в сторону предыдущего или следующего символа, представленного смещением, если позиция является границей двух представлений; b может принимать одно из следующих значений:

Position.Bias.Forward
Position.Bias.Backward

Возвращает:

ограничивающую рамку указанной позиции

Вызывает исключение:

BadLocationException — если указанная позиция не соответствует допустимому расположению в связанном документе

См. также:

viewToModel

public int viewToModel(float fx, float fy, Shape a, Position.Bias[] bias)

Преобразует координаты пространства представления в логические координаты пространства модели.

Переопределяет:

viewToModel в классе FieldView

Параметры:

fx — координата X >= 0.0f

fy — координата Y >= 0.0f

a — выделенная область для отображения

bias — возвращаемое смещение

Возвращает:

позицию в модели, наилучшим образом соответствующую указанной точке в представлении

См. также:

getPreferredSpan

public float getPreferredSpan(int axis)

Определяет предпочтительную протяженность этого представления вдоль оси.

Переопределяет:: getPreferredSpan в классе FieldView
Параметры:: axis — может быть View.X_AXIS или View.Y_AXIS
Возвращает:: протяженность, в пределах которой следует отображать представление >= 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.