javax.swing.plaf.basic

Класс BasicTextUI

java.lang. Объект

javax.swing.plaf. ComponentUI

javax.swing.plaf. TextUI

javax.swing.plaf.basic. BasicTextUI

Все Реализованные Интерфейсы:

ViewFactory

Прямые Известные Подклассы:

BasicEditorPaneUI, BasicTextAreaUI, BasicTextFieldUI, DefaultTextUI

public abstract class BasicTextUI
extends TextUI
implements ViewFactory

Основание текстового компонентного стили. Это обеспечивает основное представление редактора и службы контроллера, которые могут быть полезными, создавая стиль для расширения JTextComponent.

Большинство состояния сохранено в связанном JTextComponent как связанные свойства, и UI устанавливает значения по умолчанию для различных свойств. Это значение по умолчанию установит что-то для всех свойств. Как правило, реализация LAF сделает больше как бы то ни было. Как минимум LAF обычно установил бы привязки клавиш.

Этот класс также оказывает некоторую поддержку параллелизма если Document связанный с JTextComponent подкласс AbstractDocument. Доступ к Представлению (или иерархия Представления) сериализируется между любым потоком, видоизменяющим модель и потоком события Swing (который, как ожидают, представит, действительно моделируйте/просмотрите координатное преобразование, и т.д.). Любой доступ к корневому представлению должен сначала получить блокировку чтения на AbstractDocument и выпуске, которые привязываются наконец блок.

Важный метод, чтобы определить getPropertyPrefix() метод, который используется в качестве основания ключей, используемых, чтобы выбрать значения по умолчанию от UIManager. Строка должна отразить тип TextUI (eg. TextField, TextArea, и т.д.) без определенной части LAF имени (eg Металл, Мотив, и т.д.).

Чтобы создать представление модели, одна из следующих стратегий может использоваться.

1. Одна стратегия состоит в том, чтобы просто пересмотреть интерфейс ViewFactory в UI. По умолчанию этот сам UI действует как фабрика для реализаций Представления. Это полезно для простых фабрик. Сделать эту перереализацию create(javax.swing.text.Element) метод.
2. Общая стратегия создания более составных типов документов состоит в том, чтобы иметь возврат реализации EditorKit фабрика. Так как EditorKit связывает все части, необходимые, чтобы поддержать тип документа, фабрика обычно является важной частью этого и должна быть произведена реализацией EditorKit.

Предупреждение: Сериализированные объекты этого класса не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего ^JavaBeansTM была добавлена к java.beans пакет. Пожалуйста, см. XMLEncoder.

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Класс и Описание
static class	BasicTextUI.BasicCaret
static class	BasicTextUI.BasicHighlighter

Сводка конструктора

Конструкторы

Конструктор и Описание
BasicTextUI() Создает новый UI.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Представление	create(Element elem) Создает представление для элемента.
Представление	create(Element elem, int p0, int p1) Создает представление для элемента.
protected Caret	createCaret() Создает объект использовать для каре.
protected Highlighter	createHighlighter() Создает объект использовать для того, чтобы добавить выделения.
protected Keymap	createKeymap() Создает контурную карту, чтобы использовать для текстового компонента, и устанавливает любую необходимую привязку в это.
void	damageRange(JTextComponent tc, int p0, int p1) Заставляет часть представления, ответственного за данную часть модели быть перекрашенной.
void	damageRange(JTextComponent t, int p0, int p1, Position.Bias p0Bias, Position.Bias p1Bias) Заставляет часть представления, ответственного за данную часть модели быть перекрашенной.
protected JTextComponent	getComponent() Выбирает текстовый компонент, связанный с этой реализацией UI.
EditorKit	getEditorKit(JTextComponent tc) Выбирает EditorKit для UI.
protected String	getKeymapName() Выбирает имя контурной карты, которая будет устанавливаться/использоваться по умолчанию для этого UI.
Размерность	getMaximumSize(JComponent c) Получает максимальный размер для компонента редактора.
Размерность	getMinimumSize(JComponent c) Получает минимальный размер для компонента редактора.
int	getNextVisualPositionFrom(JTextComponent t, int pos, Position.Bias b, int direction, Position.Bias[] biasRet) Обеспечивает способ определить следующее визуально представленное расположение модели, что можно было бы поместить каре.
Размерность	getPreferredSize(JComponent c) Получает привилегированный размер для компонента редактора.
protected abstract String	getPropertyPrefix() Завоевывает репутацию используемый в качестве ключа, чтобы искать свойства через UIManager.
Представление	getRootView(JTextComponent tc) Выбирает Представление с выделением связанного текстового компонента (то есть.
Строка	getToolTipText(JTextComponent t, Point pt) Возвращает строку, которая будет использоваться в качестве подсказки в переданном в расположении.
protected Rectangle	getVisibleEditorRect() Заставляет выделение высказывать корневое Мнение.
protected void	installDefaults() Инициализирует компонентные свойства, такие как шрифт, передний план, фон, цвет каре, цвет выбора, выбранный цвет текста, цвет недоступного текста, и цвет границы.
protected void	installKeyboardActions()
protected void	installListeners() Слушатели установок для UI.
void	installUI(JComponent c) Устанавливает UI для компонента.
protected void	modelChanged() Изменения модели флагов.
Прямоугольник	modelToView(JTextComponent tc, int pos) Преобразовывает данное расположение в модели к месту в системе координат представления.
Прямоугольник	modelToView(JTextComponent tc, int pos, Position.Bias bias) Преобразовывает данное расположение в модели к месту в системе координат представления.
void	paint(Graphics g, JComponent c) Красит интерфейс.
protected void	paintBackground(Graphics g) Красит фон для представления.
protected void	paintSafely(Graphics g) Красит интерфейс безопасно гарантией, что модель не будет изменяться от представления этого потока.
protected void	propertyChange(PropertyChangeEvent evt) Этот метод вызывают, когда связанное свойство изменяется на связанном JTextComponent.
protected void	setView(View v) Устанавливает текущий корень иерархии представления, и вызовы лишают законной силы ().
protected void	uninstallDefaults() Устанавливает компонентные свойства, которые не были явно переопределены к null.
protected void	uninstallKeyboardActions()
protected void	uninstallListeners() Слушатели удалений для UI.
void	uninstallUI(JComponent c) Деинсталлирует UI для компонента.
void	update(Graphics g, JComponent c) Суперкласс красит фон способом не поддающимся контролю (то есть.
int	viewToModel(JTextComponent tc, Point pt) Преобразовывает данное место в системе координат представления к самому близкому представительному расположению в модели.
int	viewToModel(JTextComponent tc, Point pt, Position.Bias[] biasReturn) Преобразовывает данное место в системе координат представления к самому близкому представительному расположению в модели.

Методы javax.swing.plaf унаследованный от класса. ComponentUI

contains, createUI, getAccessibleChild, getAccessibleChildrenCount, getBaseline, getBaselineResizeBehavior

Методы java.lang унаследованный от класса. Объект

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

Деталь конструктора

BasicTextUI

public BasicTextUI()

Создает новый UI.

Деталь метода

createCaret

protected Caret createCaret()

Создает объект использовать для каре. По умолчанию экземпляр BasicCaret создается. Этот метод может быть пересмотрен, чтобы обеспечить что-то еще, что реализует интерфейс InputPosition или подкласс JCaret.

Возвраты:

объект каре

createHighlighter

protected Highlighter createHighlighter()

Создает объект использовать для того, чтобы добавить выделения. По умолчанию экземпляр BasicHighlighter создается. Этот метод может быть пересмотрен, чтобы обеспечить что-то еще, что реализует интерфейс Маркера или подкласс DefaultHighlighter.

Возвраты:

маркер

getKeymapName

protected String getKeymapName()

Выбирает имя контурной карты, которая будет устанавливаться/использоваться по умолчанию для этого UI. Это реализуется, чтобы создать имя, основанное на имени класса. Имя является именем класса с удаленным префиксом пакета.

Возвраты:

имя

createKeymap

protected Keymap createKeymap()

Создает контурную карту, чтобы использовать для текстового компонента, и устанавливает любую необходимую привязку в это. По умолчанию контурная карта совместно используется всеми экземплярами этого типа TextUI. Контурной карте определил имя getKeymapName метод. Если контурная карта не находится, то DEFAULT_KEYMAP от JTextComponent используется.

Набор привязки, используемой, чтобы создать контурную карту, выбирается от UIManager использование ключа, сформированного, объединяясь getPropertyPrefix() метод и строка .keyBindings. Тип, как ожидают, будет JTextComponent.KeyBinding[].

Возвраты:

контурная карта

См. Также:

getKeymapName(), JTextComponent

propertyChange

protected void propertyChange(PropertyChangeEvent evt)

Этот метод вызывают, когда связанное свойство изменяется на связанном JTextComponent. Это - рычаг, который реализации UI могут изменить, чтобы отразить, как UI выводит на экран связанные свойства подклассов JTextComponent. Это реализуется, чтобы ничего не сделать (то есть ответ на свойства в самом JTextComponent обрабатываются до вызова этого метода). Эта реализация обновляет фон текстового компонента если доступные для редактирования и/или включенные изменения состояния.

Параметры:

evt - событие изменения свойства

getPropertyPrefix

protected abstract String getPropertyPrefix()

Завоевывает репутацию используемый в качестве ключа, чтобы искать свойства через UIManager. Это используется в качестве префикса ко всем стандартным текстовым свойствам.

Возвраты:

имя

installDefaults

protected void installDefaults()

Инициализирует компонентные свойства, такие как шрифт, передний план, фон, цвет каре, цвет выбора, выбранный цвет текста, цвет недоступного текста, и цвет границы. Шрифт, передний план, и фоновые свойства только устанавливаются, если их текущая стоимость является или нулем или UIResource, другие свойства устанавливаются, если текущая стоимость является нулем.

См. Также:

uninstallDefaults(), installUI(javax.swing.JComponent)

uninstallDefaults

protected void uninstallDefaults()

Устанавливает компонентные свойства, которые не были явно переопределены к null. Свойство считают переопределенным, если его текущая стоимость не является a UIResource.

См. Также:

installDefaults(), uninstallUI(javax.swing.JComponent)

installListeners

protected void installListeners()

Слушатели установок для UI.

uninstallListeners

protected void uninstallListeners()

Слушатели удалений для UI.

installKeyboardActions

protected void installKeyboardActions()

uninstallKeyboardActions

protected void uninstallKeyboardActions()

paintBackground

protected void paintBackground(Graphics g)

Красит фон для представления. Это только вызовут, если isOpaque () на связанном компоненте будет истиной. Значение по умолчанию должно нарисовать цвет фона компонента.

Параметры:

g - графический контекст

getComponent

protected final JTextComponent getComponent()

Выбирает текстовый компонент, связанный с этой реализацией UI. Это будет нулем, пока ui не был установлен.

Возвраты:

компонент редактора

modelChanged

protected void modelChanged()

Изменения модели флагов. Это вызывают всякий раз, когда модель изменилась. Это реализуется, чтобы восстановить иерархию представления, чтобы представить корневой элемент по умолчанию связанной модели.

setView

protected final void setView(View v)

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

Параметры:

v - корневое представление

paintSafely

protected void paintSafely(Graphics g)

Красит интерфейс безопасно гарантией, что модель не будет изменяться от представления этого потока. Это делает следующие вещи, представляющие от наоборот.

1. Если компонент отмечается как непрозрачный, фон красится в текущем цвете фона компонента.
2. Выделения (если кто-либо) красятся.
3. Иерархия представления красится.
4. Каре красится.

Параметры:

g - графический контекст

installUI

public void installUI(JComponent c)

Устанавливает UI для компонента. Это делает следующие вещи.

1. Устанавливает связанный компонент в непрозрачный, если непрозрачное свойство не было уже установлено клиентской программой. Это заставит цвет фона компонента быть нарисованным.
2. Устанавливает каре по умолчанию и маркер в связанный компонент. Эти свойства только устанавливаются, если их текущая стоимость также null или экземпляр UIResource.
3. Присоединения редактору и модели. Если нет никакой модели, по умолчанию создается.
4. Создает фабрику представления и иерархию представления, используемую, чтобы представить модель.

Переопределения:

installUI в классе ComponentUI

Параметры:

c - компонент редактора

См. Также:

ComponentUI.installUI(javax.swing.JComponent)

uninstallUI

public void uninstallUI(JComponent c)

Деинсталлирует UI для компонента. Это удаляет слушателей, удаляет маркер, удаляет представления, и обнуляет контурную карту.

Переопределения:

uninstallUI в классе ComponentUI

Параметры:

c - компонент редактора

См. Также:

ComponentUI.uninstallUI(javax.swing.JComponent)

обновление

public void update(Graphics g,
          JComponent c)

Суперкласс красит фон способом не поддающимся контролю (то есть можно было бы хотеть изображение, размещенное рядом в фон). Чтобы предотвратить это дважды, этот метод повторно реализуется, чтобы просто нарисовать.

ОТМЕТЬТЕ: ОТМЕТЬТЕ: суперкласс также не ориентирован на многопотоковое исполнение в своем рендеринге фона, хотя это не проблема с рендерингом по умолчанию.

Переопределения:

update в классе ComponentUI

Параметры:

g - Graphics контекст, в котором можно нарисовать

c - нарисованный компонент; этот параметр часто игнорируется, но мог бы использоваться, если объект UI не сохраняющий состояние и совместно используемым многократными компонентами

См. Также:

ComponentUI.paint(java.awt.Graphics, javax.swing.JComponent), JComponent.paintComponent(java.awt.Graphics)

краска

public final void paint(Graphics g,
         JComponent c)

Красит интерфейс. Это направляется к paintSafely методу под гарантией, что модель не будет изменяться от представления этого потока, в то время как это представляет (если связанная модель получается из AbstractDocument). Это позволяет модели потенциально быть обновленной асинхронно.

Переопределения:

paint в классе ComponentUI

Параметры:

g - графический контекст

c - компонент редактора

См. Также:

ComponentUI.update(java.awt.Graphics, javax.swing.JComponent)

getPreferredSize

public Dimension getPreferredSize(JComponent c)

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

Переопределения:

getPreferredSize в классе ComponentUI

Параметры:

c - компонент редактора

Возвраты:

размер

См. Также:

JComponent.getPreferredSize(), LayoutManager.preferredLayoutSize(java.awt.Container)

getMinimumSize

public Dimension getMinimumSize(JComponent c)

Получает минимальный размер для компонента редактора.

Переопределения:

getMinimumSize в классе ComponentUI

Параметры:

c - компонент редактора

Возвраты:

размер

См. Также:

JComponent.getMinimumSize(), LayoutManager.minimumLayoutSize(java.awt.Container), ComponentUI.getPreferredSize(javax.swing.JComponent)

getMaximumSize

public Dimension getMaximumSize(JComponent c)

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

Переопределения:

getMaximumSize в классе ComponentUI

Параметры:

c - компонент редактора

Возвраты:

размер

См. Также:

JComponent.getMaximumSize(), LayoutManager2.maximumLayoutSize(java.awt.Container)

getVisibleEditorRect

protected Rectangle getVisibleEditorRect()

Заставляет выделение высказывать корневое Мнение. Из-за неудачного набора исторических событий неуместно называют этот метод. Возвращенный Прямоугольник не имеет никакого отношения к видимости. У компонента должен быть ненулевой положительный размер для этого преобразования, которое будет вычислено.

Возвраты:

ограничивающий прямоугольник для корневого представления

modelToView

public Rectangle modelToView(JTextComponent tc,
                    int pos)
                      throws BadLocationException

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

Определенный:

modelToView в классе TextUI

Параметры:

tc - текстовый компонент, для которого устанавливается этот UI

pos - локальное расположение в модели, чтобы преобразовать> = 0

Возвраты:

координаты как прямоугольник, нуль, если модель не красится

Броски:

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

См. Также:

TextUI.modelToView(javax.swing.text.JTextComponent, int)

modelToView

public Rectangle modelToView(JTextComponent tc,
                    int pos,
                    Position.Bias bias)
                      throws BadLocationException

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

Определенный:

modelToView в классе TextUI

Параметры:

tc - текстовый компонент, для которого устанавливается этот UI

pos - локальное расположение в модели, чтобы преобразовать> = 0

Возвраты:

координаты как прямоугольник, нуль, если модель не красится

Броски:

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

См. Также:

TextUI.modelToView(javax.swing.text.JTextComponent, int)

viewToModel

public int viewToModel(JTextComponent tc,
              Point pt)

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

Определенный:

viewToModel в классе TextUI

Параметры:

tc - текстовый компонент, для которого устанавливается этот UI

pt - расположение в представлении, чтобы преобразовать. Это должно быть в той же самой системе координат как события от нажатия мыши.

Возвраты:

смещение от запуска документа> = 0,-1, если не нарисованный

См. Также:

TextUI.viewToModel(javax.swing.text.JTextComponent, java.awt.Point)

viewToModel

public int viewToModel(JTextComponent tc,
              Point pt,
              Position.Bias[] biasReturn)

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

Определенный:

viewToModel в классе TextUI

Параметры:

tc - текстовый компонент, для которого устанавливается этот UI

pt - расположение в представлении, чтобы преобразовать. Это должно быть в той же самой системе координат как события от нажатия мыши.

biasReturn - заполненный этим методом, чтобы указать, ближе ли данная точка к предыдущему или следующему символу в модели

Возвраты:

смещение от запуска документа> = 0,-1, если у компонента еще нет положительного размера.

См. Также:

TextUI.viewToModel(javax.swing.text.JTextComponent, java.awt.Point)

getNextVisualPositionFrom

public int getNextVisualPositionFrom(JTextComponent t,
                            int pos,
                            Position.Bias b,
                            int direction,
                            Position.Bias[] biasRet)
                              throws BadLocationException

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

Определенный:

getNextVisualPositionFrom в классе TextUI

Параметры:

t - текстовый компонент, для которого устанавливается этот UI

pos - позиция, чтобы преобразовать> = 0

b - смещение для позиции

direction - направление от текущей позиции, которая может считаться клавишами со стрелками, обычно находимыми на клавиатуре. Это может быть SwingConstants. ЗАПАД, SwingConstants. ВОСТОК, SwingConstants. СЕВЕР, или SwingConstants. ЮГ

biasRet - массив, чтобы содержать смещение для возвращенной позиции

Возвраты:

расположение в пределах модели, которая лучше всего представляет следующее расположение визуальная позиция

Броски:

BadLocationException

damageRange

public void damageRange(JTextComponent tc,
               int p0,
               int p1)

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

Определенный:

damageRange в классе TextUI

Параметры:

tc - текстовый компонент, для которого устанавливается этот UI

p0 - начало диапазона> = 0

p1 - конец диапазона> = p0

См. Также:

TextUI.damageRange(javax.swing.text.JTextComponent, int, int)

damageRange

public void damageRange(JTextComponent t,
               int p0,
               int p1,
               Position.Bias p0Bias,
               Position.Bias p1Bias)

Заставляет часть представления, ответственного за данную часть модели быть перекрашенной.

Определенный:

damageRange в классе TextUI

Параметры:

p0 - начало диапазона> = 0

p1 - конец диапазона> = p0

getEditorKit

public EditorKit getEditorKit(JTextComponent tc)

Выбирает EditorKit для UI.

Определенный:

getEditorKit в классе TextUI

Параметры:

tc - текстовый компонент, для которого устанавливается этот UI

Возвраты:

возможности редактора

См. Также:

TextUI.getEditorKit(javax.swing.text.JTextComponent)

getRootView

public View getRootView(JTextComponent tc)

Выбирает Представление с выделением связанного текстового компонента (то есть корень иерархии), который может быть пересечен, чтобы определить, как модель представляется пространственно.

Иерархия Представления NOTE:The может быть пересечена от корневого представления, и другие вещи могут быть сделаны также. Вещи, сделанные таким образом, не могут быть защищены как простые вызовы метода через TextUI. Поэтому, правильное функционирование в присутствии параллелизма должно быть расположено любой логикой, которая вызывает этот метод!

Определенный:

getRootView в классе TextUI

Параметры:

tc - текстовый компонент, для которого устанавливается этот UI

Возвраты:

представление

См. Также:

TextUI.getRootView(javax.swing.text.JTextComponent)

getToolTipText

public String getToolTipText(JTextComponent t,
                    Point pt)

Возвращает строку, которая будет использоваться в качестве подсказки в переданном в расположении. Это вперед метод на корневое Представление.

Переопределения:

getToolTipText в классе TextUI

С тех пор:

1.4

См. Также:

JTextComponent.getToolTipText(java.awt.event.MouseEvent), View.getToolTipText(float, float, java.awt.Shape)

создать

public View create(Element elem)

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

Определенный:

create в интерфейсе ViewFactory

Параметры:

elem - элемент

Возвраты:

представление

См. Также:

View

создать

public View create(Element elem,
          int p0,
          int p1)

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

Параметры:

elem - элемент

p0 - начальное смещение> = 0

p1 - смещение окончания> = p0

Возвраты:

представление