Spec-Zone .ru
спецификации, руководства, описания, API
|
public class JTextArea extends JTextComponent
JTextArea
многострочная область, которая выводит на экран простой текст. Это предназначается, чтобы быть легким компонентом, который предоставляет исходной совместимости java.awt.TextArea
class, где это может разумно сделать так. Можно найти информацию и примеры использования всех текстовых компонентов в У этого компонента есть возможности, не найденные в java.awt.TextArea
class. С суперклассом нужно консультироваться для дополнительных возможностей. Альтернативные многострочные текстовые классы с большим количеством возможностей JTextPane
и JEditorPane
.
java.awt.TextArea
внутренне прокрутка дескрипторов. JTextArea
отличается в этом, это не управляет прокруткой, но реализует колебание Scrollable
интерфейс. Это позволяет этому быть помещенным внутри a JScrollPane
если прокрутка поведения требуется, и используется непосредственно, если прокрутка не требуется.
java.awt.TextArea
имеет возможность сделать обертывание строки. Этим управляла политика горизонтальной прокрутки. Так как прокрутка не делается JTextArea
непосредственно, обратная совместимость должна быть обеспечена иначе. JTextArea
имеет связанное свойство для строки, переносящейся, который управляет, обернет ли она строки. По умолчанию свойство обертывания строки устанавливается в ложь (не обернутый).
java.awt.TextArea
имеет два свойства rows
и columns
это используется, чтобы определить привилегированный размер. JTextArea
использование эти свойства, чтобы указать на привилегированный размер области просмотра когда помещено внутри a JScrollPane
соответствовать функциональность, обеспеченную java.awt.TextArea
. JTextArea
имеет привилегированный размер того, что необходимо, чтобы вывести на экран весь текст, так, чтобы он функционировал должным образом в a JScrollPane
. Если значение для rows
или columns
равно нулю, привилегированный размер вдоль той оси используется для области просмотра предпочтенный размер вдоль той же самой оси.
java.awt.TextArea
мог контролироваться для изменений, добавляя a TextListener
для TextEvent
s. В JTextComponent
основанные компоненты, изменения широковещательно передаются от модели через a DocumentEvent
к DocumentListeners
. DocumentEvent
дает расположение изменения и вид изменения при желании. Фрагмент кода мог бы смотреть что-то как:
DocumentListener myListener = ??; JTextArea myArea = ??; myArea.getDocument().addDocumentListener(myListener);
Предупреждение: Swing не ориентирован на многопотоковое исполнение. Для получения дополнительной информации см., что Swing Распараллеливает Политику.
Предупреждение: Сериализированные объекты этого class не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего JavaBeansTM была добавлена к java.beans
пакет. Пожалуйста, см. XMLEncoder
.
JTextPane
, JEditorPane
Модификатор и Тип | Класс и Описание |
---|---|
protected class |
JTextArea. AccessibleJTextArea
Этот class реализует поддержку доступности
JTextArea class. |
JTextComponent.AccessibleJTextComponent, JTextComponent.DropLocation, JTextComponent.KeyBinding
JComponent. AccessibleJComponent
Контейнер. AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
DEFAULT_KEYMAP, FOCUS_ACCELERATOR_KEY
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Конструктор и Описание |
---|
JTextArea()
Создает новый TextArea.
|
JTextArea(Document doc)
Создает новый JTextArea с данной моделью документа, и значения по умолчанию для всех других параметров (нуль, 0, 0).
|
JTextArea(Document doc, String text, int rows, int columns)
Создает новый JTextArea с конкретным количеством строк и столбцов, и данной модели.
|
JTextArea(int rows, int columns)
Создает новый пустой TextArea с конкретным количеством строк и столбцов.
|
JTextArea(String text)
Создает новый TextArea с указанным выведенным на экран текстом.
|
JTextArea(String text, int rows, int columns)
Создает новый TextArea с указанным текстом и числом строк и столбцов.
|
Модификатор и Тип | Метод и Описание |
---|---|
void |
append(String str)
Добавляет данный текст до конца документа.
|
protected Document |
createDefaultModel()
Создает реализацию по умолчанию модели, которая будет использоваться в конструкции, если Вы не явно заданы.
|
AccessibleContext |
getAccessibleContext()
Связали AccessibleContext с этим JTextArea.
|
int |
getColumns()
Возвращает число столбцов в TextArea.
|
protected int |
getColumnWidth()
Получает столбец width.
|
int |
getLineCount()
Определяет число строк, содержавшихся в области.
|
int |
getLineEndOffset(int line)
Определяет смещение конца данной строки.
|
int |
getLineOfOffset(int offset)
Преобразовывает смещение в компонентный текст к номеру строки.
|
int |
getLineStartOffset(int line)
Определяет смещение запуска данной строки.
|
boolean |
getLineWrap()
Получает обертывающую строку политику текстовой области.
|
Размерность |
getPreferredScrollableViewportSize()
Возвращает привилегированный размер области просмотра, если этот компонент встраивается в JScrollPane.
|
Размерность |
getPreferredSize()
Возвращает привилегированный размер TextArea.
|
protected int |
getRowHeight()
Определяет значение height строки.
|
int |
getRows()
Возвращает число строк в TextArea.
|
boolean |
getScrollableTracksViewportWidth()
Возвращает true, если область просмотра должна всегда вынуждать width этого С возможностью прокрутки соответствовать width области просмотра.
|
int |
getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
Компоненты, которые выводят на экран логические строки или столбцы, должны вычислить инкремент прокрутки, который полностью представит одну новую строку или столбец, в зависимости от значения ориентации.
|
int |
getTabSize()
Получает число символов, используемых, чтобы развернуть вкладки.
|
Строка |
getUIClassID()
Возвращает ID class для UI.
|
boolean |
getWrapStyleWord()
Получает стиль обертывания используемого, если текстовая область обертывает строки.
|
void |
insert(String str, int pos)
Вставляет указанный текст в указанной позиции.
|
protected String |
paramString()
Возвращает строковое представление этого JTextArea.
|
void |
replaceRange(String str, int start, int end)
Текст замен от обозначенного запуска, чтобы закончить позицию новым определенным текстом.
|
void |
setColumns(int columns)
Определяет номер столбцов для этого TextArea.
|
void |
setFont(Font f)
Устанавливает текущий шрифт.
|
void |
setLineWrap(boolean wrap)
Устанавливает обертывающую строку политику текстовой области.
|
void |
setRows(int rows)
Определяет номер строк для этого TextArea.
|
void |
setTabSize(int size)
Определяет номер символов, чтобы развернуть вкладки до.
|
void |
setWrapStyleWord(boolean word)
Устанавливает стиль обертывания используемого, если текстовая область обертывает строки.
|
addCaretListener, addInputMethodListener, addKeymap, copy, cut, fireCaretUpdate, getActions, getCaret, getCaretColor, getCaretListeners, getCaretPosition, getDisabledTextColor, getDocument, getDragEnabled, getDropLocation, getDropMode, getFocusAccelerator, getHighlighter, getInputMethodRequests, getKeymap, getKeymap, getMargin, getNavigationFilter, getPrintable, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getSelectedText, getSelectedTextColor, getSelectionColor, getSelectionEnd, getSelectionStart, getText, getText, getToolTipText, getUI, isEditable, loadKeymap, modelToView, moveCaretPosition, paste, print, print, print, processInputMethodEvent, read, removeCaretListener, removeKeymap, removeNotify, replaceSelection, restoreComposedText, saveComposedText, select, selectAll, setCaret, setCaretColor, setCaretPosition, setComponentOrientation, setDisabledTextColor, setDocument, setDragEnabled, setDropMode, setEditable, setFocusAccelerator, setHighlighter, setKeymap, setMargin, setNavigationFilter, setSelectedTextColor, setSelectionColor, setSelectionEnd, setSelectionStart, setText, setUI, updateUI, viewToModel, write
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
public JTextArea()
public JTextArea(String text)
text
- текст, который будет выведен на экран, или нульpublic JTextArea(int rows, int columns)
rows
- число строк> = 0columns
- число столбцов> = 0IllegalArgumentException
- если строки или параметры столбцов отрицательны.public JTextArea(String text, int rows, int columns)
text
- текст, который будет выведен на экран, или нульrows
- число строк> = 0columns
- число столбцов> = 0IllegalArgumentException
- если строки или параметры столбцов отрицательны.public JTextArea(Document doc)
doc
- модель, чтобы использоватьpublic JTextArea(Document doc, String text, int rows, int columns)
doc
- модель, чтобы использовать, или создать тот значения по умолчанию, если нульtext
- текст, который будет выведен на экран, нуль, если ни одинrows
- число строк> = 0columns
- число столбцов> = 0IllegalArgumentException
- если строки или параметры столбцов отрицательны.public String getUIClassID()
getUIClassID
в class JComponent
JComponent.getUIClassID()
, UIDefaults.getUI(javax.swing.JComponent)
protected Document createDefaultModel()
public void setTabSize(int size)
size
- число символов, чтобы расшириться доgetTabSize()
public int getTabSize()
public void setLineWrap(boolean wrap)
PropertyChange
событие ("lineWrap") запускается, когда политика изменяется. По умолчанию это свойство является ложью.wrap
- указывает, должны ли строки быть обернутыgetLineWrap()
public boolean getLineWrap()
public void setWrapStyleWord(boolean word)
word
- указывает, должны ли границы слова использоваться для обертывания строкиgetWrapStyleWord()
public boolean getWrapStyleWord()
setWrapStyleWord(boolean)
public int getLineOfOffset(int offset) throws BadLocationException
offset
- смещение> = 0BadLocationException
- брошенный, если смещение является меньше чем нуль или больше чем длина документа.public int getLineCount()
public int getLineStartOffset(int line) throws BadLocationException
line
- номер строки, чтобы преобразовать> = 0BadLocationException
- брошенный, если строка является меньше чем нуль или больше или равный числу строк, содержавшихся в документе (как сообщающийся getLineCount).public int getLineEndOffset(int line) throws BadLocationException
line
- строка> = 0BadLocationException
- Брошенный, если строка является меньше чем нуль или больше или равный числу строк, содержавшихся в документе (как сообщающийся getLineCount).public void insert(String str, int pos)
str
- текст, чтобы вставитьpos
- позиция, в которой можно вставить> = 0IllegalArgumentException
- если на месте продажи недопустимая позиция в моделиTextComponent.setText(java.lang.String)
, replaceRange(java.lang.String, int, int)
public void append(String str)
str
- текст, чтобы вставитьinsert(java.lang.String, int)
public void replaceRange(String str, int start, int end)
str
- текст, чтобы использовать в качестве заменыstart
- позиция запуска> = 0end
- позиция конца> = запускаетсяIllegalArgumentException
- если часть диапазона является недопустимой позицией в моделиinsert(java.lang.String, int)
, replaceRange(java.lang.String, int, int)
public int getRows()
public void setRows(int rows)
rows
- число строк> = 0IllegalArgumentException
- если строки - меньше чем 0getRows()
protected int getRowHeight()
public int getColumns()
public void setColumns(int columns)
columns
- число столбцов> = 0IllegalArgumentException
- если столбцы - меньше чем 0getColumns()
protected int getColumnWidth()
public Dimension getPreferredSize()
getPreferredSize
в class JComponent
JComponent.setPreferredSize(java.awt.Dimension)
, ComponentUI
public void setFont(Font f)
setFont
в class JComponent
f
- шрифт, чтобы использовать в качестве текущего шрифтаComponent.getFont()
protected String paramString()
null
.paramString
в class JTextComponent
public boolean getScrollableTracksViewportWidth()
getScrollableTracksViewportWidth
в интерфейсе Scrollable
getScrollableTracksViewportWidth
в class JTextComponent
public Dimension getPreferredScrollableViewportSize()
getPreferredScrollableViewportSize
в интерфейсе Scrollable
getPreferredScrollableViewportSize
в class JTextComponent
JComponent.getPreferredSize()
public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
getRowHeight
и getColumnWidth
методы. Прокрутка контейнеров, как JScrollPane, будет использовать этот метод каждый раз, когда пользователь запрашивает прокрутку модуля.
getScrollableUnitIncrement
в интерфейсе Scrollable
getScrollableUnitIncrement
в class JTextComponent
visibleRect
- область представления, видимая в пределах области просмотраorientation
- Любой SwingConstants. ВЕРТИКАЛЬ или SwingConstants. ГОРИЗОНТАЛЬ.direction
- Меньше чем нуль, чтобы прокрутить/левый, больше чем нуль для вниз/право.IllegalArgumentException
- для недопустимой ориентацииJScrollBar.setUnitIncrement(int)
, getRowHeight()
, getColumnWidth()
public AccessibleContext getAccessibleContext()
getAccessibleContext
в интерфейсе Accessible
getAccessibleContext
в class JTextComponent
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92