Spec-Zone .ru
спецификации, руководства, описания, API
След: Создание GUI С JFC/Swing
Урок: Используя Компоненты Swing
Раздел: Используя текстовые Компоненты
Текстовый Компонентный API
Домашняя страница > Создание GUI С JFC/Swing > Используя Компоненты Swing

Текстовый Компонентный API

Этот раздел перечисляет обычно используемые части API, которые совместно используются текстовыми компонентами. Большая часть этого API определяется JTextComponent class. Текстовые Компонентные Функции обсуждают, как использовать часть этого API.

Класс JComponent описывает API, от которого наследовались текстовые компоненты JComponent. Для получения информации о API, связанном с определенными текстовыми компонентами, см. страницу с практическими рекомендациями для того компонента: текстовое поле, поле пароля, отформатированное текстовое поле, текстовая область, или область редактора и текстовая область.

Для полных деталей о текстовом API см. документацию API для JTextComponent и для различных классов и интерфейсов в текстовом пакете.

API, перечисленный в этом разделе, включает следующие категории:

Установка Атрибутов
Эти методы определяются в JTextComponent class.
Метод Описание
освободите (булев) setEditable
булев isEditable ()
Наборы или указывают, может ли пользователь отредактировать текст в текстовом компоненте.
освободите (булев) setDragEnabled
булев getDragEnabled ()
Наборы или добираются dragEnabled свойство, которое должно быть истиной, чтобы включить, перетаскивает обработку на этом компоненте. Значение по умолчанию является ложью. См. Перетаскивают и Отбрасывание и Передача данных для большего количества деталей.
освободите setDisabledTextColor (Цвет)
Покрасьте getDisabledTextColor ()
Наборы или использовали цвет, чтобы вывести на экран текст, когда текстовый компонент отключается.
освободите setMargin (Вставки)
Вставки getMargin ()
Наборы или получают поле между текстом и текстовой компонентной границей.
Управление Выбором
Эти методы определяются в JTextComponent class.
Метод Описание
Представьте getSelectedText в виде строки () Получает в настоящий момент выбранный текст.
освободите selectAll ()
освободите избранный (интервал, интервал)
Выбирает весь текст или выбирает текст в пределах диапазона конца и запуска.
освободите setSelectionStart (интервал)
освободите setSelectionEnd (интервал)
интервал getSelectionStart ()
интервал getSelectionEnd ()
Наборы или добираются, степень текущего выбора индексируют.
освободите setSelectedTextColor (Цвет)
Покрасьте getSelectedTextColor ()
Наборы или получают цвет выбранного текста.
освободите setSelectionColor (Цвет)
Покрасьте getSelectionColor ()
Наборы или получают цвет фона выбранного текста.
Преобразование Позиций Между Моделью и Представлением
Эти методы определяются в JTextComponent class.
Метод Описание
интервал viewToModel (Точка) Преобразовывает указанную точку в системе координат представления к позиции в пределах текста.
Прямоугольник modelToView (интервал) Преобразовывает указанную позицию в пределах текста к прямоугольнику в системе координат представления.
Команды Редактирования текста
Класс или Метод Описание
освободите сокращение ()
освободите копию ()
освободите вставку ()
освободите replaceSelection (Строка)
JTextComponent)
Сокращения, копии, и текст вставок, используя системный буфер обмена, или замены выбранный текст со строкой, определенной параметром, соответственно.
EditorKit Обеспечивает текстовую компонентную фабрику представления, документ, каре, и действия, так же как читающие и пишущие документы определенного формата.
DefaultEditorKit Конкретный подкласс EditorKit это обеспечивает основные возможности редактирования текста.
StyledEditorKit Подкласс Default EditorKit это обеспечивает дополнительные возможности редактирования стилизованного текста.
Строка xxxxAction
DefaultEditorKit)
Имена всех действий поддерживаются редактором значения по умолчанию набор. См. Связывающиеся текстовые Действия с Меню и Кнопками.
BeepAction
CopyAction
CutAction
DefaultKeyTypedAction
InsertBreakAction
InsertContentAction
InsertTabAction
PasteAction
DefaultEditorKit)
Внутренние классы, которые реализуют различные команды редактирования текста.
AlignmentAction
BoldAction
FontFamilyAction
FontSizeAction
ForegroundAction
ItalicAction
StyledTextAction
UnderlineAction
StyledEditorKit)
Внутренние классы, которые реализуют различные команды редактирования для стилизованного текста.
Действие [] getActions ()
JTextComponent)
Поддерживали действия этим компонентом. Этот метод получает массив действий от набора редактора, если Вы используетесь компонентом.
InputMap getInputMap ()
JComponent)
Получает входную карту, которая связывает нажатия клавиш с действиями. См. Связывающиеся текстовые Действия с Нажатиями клавиш.
пусто помещенный (KeyStroke, Объект)
InputMap)
Связывает указанный ключ с указанным действием. Вы обычно определяете действие его именем, которое для стандартных действий редактирования представляется строковой константой такой как DefaultEditorKit.backwardAction.
Классы и Интерфейсы, Которые Представляют Документы
Интерфейс или Класс Описание
Документ Интерфейс, который определяет API, который должен быть реализован всеми документами.
AbstractDocument Абстрактная реализация суперкласса Document интерфейс. Это - суперкласс для всех документов, обеспеченных текстовым пакетом Swing.
PlainDocument class, который реализует Document интерфейс. Это - документ значения по умолчанию для компонентов простого текста (текстовое поле, поле пароля, и текстовая область). Дополнительно, этот class используется областями редактора и текстовыми областями, загружая простой текст или текст неизвестного формата.
StyledDocument A Document подынтерфейс. Определяет API, который должен быть реализован документами та поддержка разработанный текст. JTextPane требует, чтобы его документ имел этот тип.
DefaultStyledDocument class, который реализует StyledDocument интерфейс. Документ значения по умолчанию для JTextPane.
Работа С Документами
Класс или Метод Описание
DocumentFilter Суперкласс всех фильтров документа. Можно использовать фильтр документа, чтобы изменить то, что вставляется или удалило из документа, не имея необходимость реализовывать документ самостоятельно. См. Реализацию Фильтра Документа.
освободите setDocumentFilter (DocumentFilter)
AbstractDocument)
Устанавливает фильтр документа.
освободите setDocument (Документ)
Документ getDocument ()
JTextComponent)
Наборы или получают документ для текстового компонента.
Документ createDefaultModel ()
JTextField)
Создает значение по умолчанию модель PlainDocument. Переопределите этот метод, чтобы создать пользовательский документ вместо значения по умолчанию PlainDocument.
освободите addDocumentListener (DocumentListener)
освободите removeDocumentListener (DocumentListener)
Document)
Добавляет или удаляет слушателя документа. См. Прислушивание к Изменениям на Документе.
освободите addUndoableEditListener (UndoableEditListener)
освободите removeUndoableEditListener (UndoableEditlistener)
Document)
Добавляет или удаляет невыполнимого слушателя редактирования. Невыполнимые слушатели редактирования используются в Реализации Отмены и Восстановления.
интервал getLength ()
Позиция getStartPosition ()
Позиция getEndPosition ()
Представьте getText в виде строки (интервал, интервал)
Document)
Document методы, которые возвращают различную дескриптивную информацию о документе.
Возразите getProperty (Объект)
освободите putProperty (Объект, Объект)
Document)
освободите setDocumentProperties (Словарь)
Словарь getDocumentProperties ()
AbstractDocument)
A Document поддерживает ряд свойств, которыми можно управлять с этими методами.
Управление Каре и Маркерами Выбора
Эти методы определяются в JTextComponent class.
Интерфейс, Класс, или Метод Описание
Каре Интерфейс, который определяет API для объектов, которые представляют точку вставки в пределах документов.
DefaultCaret Каре значения по умолчанию используется всеми текстовыми компонентами.
освободите setCaret (Каре)
Каре getCaret ()
Наборы или использовали объект каре текстовым компонентом.
освободите setCaretColor (Цвет)
Покрасьте getCaretColor ()
Наборы или получают цвет каре.
освободите setCaretPosition (интервал)
освободите moveCaretPosition (интервал)
интервал getCaretPosition ()
Наборы или получают текущую позицию каре в пределах документа.
освободите addCaretListener (CaretListener)
освободите removeCaretListener (CaretListener)
Добавляет или удаляет слушателя каре из текстового компонента.
NavigationFilter Суперкласс для всех фильтров навигации. Фильтр навигации позволяет Вам изменять изменения каре, которые собираются произойти для текстового компонента.
освободите setNavigationFilter (NavigationFilter) Присоединяет фильтр навигации к текстовому компоненту.
Маркер Интерфейс, который определяет API для объектов, используемых, чтобы выделить текущий выбор.
DefaultHighlighter Маркер значения по умолчанию используется всеми текстовыми компонентами.
освободите setHighlighter (Маркер)
Маркер getHighlighter ()
Наборы или использовали маркер текстовым компонентом.
Чтение и Запись текста
Метод Описание
освободите чтение (Читатель, Объект)
освободите запись (Писатель)
JTextComponent)
Чтения или текст записей.
освободите чтение (Читатель, Документ, интервал)
освободите чтение (InputStream, Документ, интервал)
EditorKit)
Текст чтений от потока в документ.
освободите запись (Писатель, Документ, интервал, интервал)
освободите запись (OutputStream, Документ, интервал, интервал)
EditorKit)
Текст записей от документа до потока.

Проблемы с примерами? Попытайтесь Компилировать и Выполнить Примеры: FAQ.
Жалобы? Поздравление? Предложения? Дайте нам свою обратную связь.

Предыдущая страница: текстовые Компонентные Функции
Следующая страница: Как Использовать Различные Компоненты