JavaTM Platform
Standard Ed. 6

java.awt
�� TextArea

java.lang.Object
  �̳��� java.awt.Component
      �̳��� java.awt.TextComponent
          �̳��� java.awt.TextArea
������ʵ�ֵĽӿڣ�
ImageObserver, MenuContainer, Serializable, Accessible

public class TextArea
extends TextComponent

TextArea ��������ʾ�ı��Ķ������򡣿��Խ�������Ϊ�����༭��ֻ����

��ͼ��ʾ���ı�������ۣ�

��ʾ���� 'Hello!' �� TextArea

���ı�������ʹ�����´�������������


 new TextArea("Hello", 5, 40);
 

�����°汾��ʼ��
JDK1.0
������
�������

Ƕ����ժҪ
protected  class TextArea.AccessibleAWTTextArea
          ����ʵ�� TextArea ��Ŀɷ�����֧�֡�
 
���� java.awt.TextComponent �̳е�Ƕ����/�ӿ�
TextComponent.AccessibleAWTTextComponent
 
���� java.awt.Component �̳е�Ƕ����/�ӿ�
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
�ֶ�ժҪ
static int SCROLLBARS_BOTH
          ��������ʾ��ֱ��ˮƽ��������
static int SCROLLBARS_HORIZONTAL_ONLY
          ֻ��������ʾˮƽ��������
static int SCROLLBARS_NONE
          ��Ϊ�ı�����������ʾ�κι�������
static int SCROLLBARS_VERTICAL_ONLY
          ֻ��������ʾ��ֱ��������
 
���� java.awt.TextComponent �̳е��ֶ�
textListener
 
���� java.awt.Component �̳е��ֶ�
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
�ӽӿ� java.awt.image.ImageObserver �̳е��ֶ�
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
���췽��ժҪ
TextArea()
          ����һ�������ַ�����Ϊ�ı������ı�����
TextArea(int rows, int columns)
          ����һ�����ı��������ı�������ָ�����������������������ַ�����Ϊ�ı���
TextArea(String text)
          �������ָ���ı������ı�����
TextArea(String text, int rows, int columns)
          ����һ�����ı��������ı�������ָ�����ı����Լ�ָ����������������
TextArea(String text, int rows, int columns, int scrollbars)
          ����һ�����ı��������ı�������ָ�����ı����Լ�ָ���������������͹������ɼ��ԡ�
 
����ժҪ
 void addNotify()
          ���� TextArea ��ͬλ�塣
 void append(String str)
          �������ı�׷�ӵ��ı����ĵ�ǰ�ı���
 void appendText(String str)
          �ѹ�ʱ�� �� JDK version 1.1 ��ʼ���� append(String) ȡ����
 AccessibleContext getAccessibleContext()
          ������� TextArea ��ص� AccessibleContext��
 int getColumns()
          ���ش��ı����е�������
 Dimension getMinimumSize()
          ȷ�����ı�������С��С��
 Dimension getMinimumSize(int rows, int columns)
          ȷ������ָ���������������ı�������С��С��
 Dimension getPreferredSize()
          ȷ�����ı�������ѡ��С��
 Dimension getPreferredSize(int rows, int columns)
          ȷ������ָ���������������ı�������ѡ��С��
 int getRows()
          ���ش��ı�����������
 int getScrollbarVisibility()
          ����ָʾ�ı���ʹ�ú��ֹ�������ö��ֵ��
 void insert(String str, int pos)
          �ڴ��ı�����ָ��λ�ò���ָ���ı���
 void insertText(String str, int pos)
          �ѹ�ʱ�� �� JDK version 1.1 ��ʼ���� insert(String, int) ȡ����
 Dimension minimumSize()
          �ѹ�ʱ�� �� JDK version 1.1 ��ʼ���� getMinimumSize() ȡ����
 Dimension minimumSize(int rows, int columns)
          �ѹ�ʱ�� �� JDK version 1.1 ��ʼ���� getMinimumSize(int, int) ȡ����
protected  String paramString()
          ���ر�ʾ�� TextArea ״̬���ַ�����
 Dimension preferredSize()
          �ѹ�ʱ�� �� JDK version 1.1 ��ʼ���� getPreferredSize() ȡ����
 Dimension preferredSize(int rows, int columns)
          �ѹ�ʱ�� �� JDK version 1.1 ��ʼ���� getPreferredSize(int, int) ȡ����
 void replaceRange(String str, int start, int end)
          ��ָ���滻�ı��滻ָ����ʼλ�������λ��֮����ı���
 void replaceText(String str, int start, int end)
          �ѹ�ʱ�� �� JDK version 1.1 ��ʼ���� replaceRange(String, int, int) ȡ����
 void setColumns(int columns)
          ���ô��ı�����������
 void setRows(int rows)
          ���ô��ı�����������
 
���� java.awt.TextComponent �̳еķ���
addTextListener, enableInputMethods, getBackground, getCaretPosition, getInputMethodRequests, getListeners, getSelectedText, getSelectionEnd, getSelectionStart, getText, getTextListeners, isEditable, processEvent, processTextEvent, removeNotify, removeTextListener, select, selectAll, setBackground, setCaretPosition, setEditable, setSelectionEnd, setSelectionStart, setText
 
���� java.awt.Component �̳еķ���
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, disableEvents, dispatchEvent, doLayout, enable, enable, enableEvents, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paint, paintAll, postEvent, prepareImage, prepareImage, print, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, update, validate
 
���� java.lang.Object �̳еķ���
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

�ֶ���ϸ��Ϣ

SCROLLBARS_BOTH

public static final int SCROLLBARS_BOTH
��������ʾ��ֱ��ˮƽ��������

�����°汾��ʼ��
JDK1.1
������
�����ֶ�ֵ

SCROLLBARS_VERTICAL_ONLY

public static final int SCROLLBARS_VERTICAL_ONLY
ֻ��������ʾ��ֱ��������

�����°汾��ʼ��
JDK1.1
������
�����ֶ�ֵ

SCROLLBARS_HORIZONTAL_ONLY

public static final int SCROLLBARS_HORIZONTAL_ONLY
ֻ��������ʾˮƽ��������

�����°汾��ʼ��
JDK1.1
������
�����ֶ�ֵ

SCROLLBARS_NONE

public static final int SCROLLBARS_NONE
��Ϊ�ı�����������ʾ�κι�������

�����°汾��ʼ��
JDK1.1
������
�����ֶ�ֵ
���췽����ϸ��Ϣ

TextArea

public TextArea()
         throws HeadlessException
����һ�������ַ�����Ϊ�ı������ı��������ı������ڹ������ɼ��Ե��� SCROLLBARS_BOTH ������´����ģ����Դ�ֱ��������ˮƽ�����������ı��������ǿ��ӵġ�

�׳���
HeadlessException - ��� GraphicsEnvironment.isHeadless ���� true
������
GraphicsEnvironment.isHeadless()

TextArea

public TextArea(String text)
         throws HeadlessException
�������ָ���ı������ı������ı������ڹ������ɼ��Ե��� SCROLLBARS_BOTH ������´����ģ����Դ�ֱ��������ˮƽ�����������ı��������ǿ��ӵġ�

������
text - Ҫ��ʾ���ı������ text Ϊ null������ʾ���ַ��� ""
�׳���
HeadlessException - ��� GraphicsEnvironment.isHeadless ���� true
������
GraphicsEnvironment.isHeadless()

TextArea

public TextArea(int rows,
                int columns)
         throws HeadlessException
����һ�����ı��������ı�������ָ�����������������������ַ�����Ϊ�ı������ǽ���ƽ���ַ����ȣ�����ƽ̨�йء��ı������ڹ������ɼ��Ե��� SCROLLBARS_BOTH ������´����ģ����Դ�ֱ��������ˮƽ�����������ı��������ǿ��ӵġ�

������
rows - ����
columns - ����
�׳���
HeadlessException - ��� GraphicsEnvironment.isHeadless ���� true
������
GraphicsEnvironment.isHeadless()

TextArea

public TextArea(String text,
                int rows,
                int columns)
         throws HeadlessException
����һ�����ı��������ı�������ָ�����ı����Լ�ָ�������������������ǽ���ƽ���ַ����ȣ�����ƽ̨�йء��ı������ڹ������ɼ��Ե��� SCROLLBARS_BOTH ������´����ģ����Դ�ֱ��������ˮƽ�����������ı��������ǿ��ӵġ�

������
text - Ҫ��ʾ���ı������ text Ϊ null������ʾ���ַ��� ""
rows - ����
columns - ����
�׳���
HeadlessException - ��� GraphicsEnvironment.isHeadless ���� true
������
GraphicsEnvironment.isHeadless()

TextArea

public TextArea(String text,
                int rows,
                int columns,
                int scrollbars)
         throws HeadlessException
����һ�����ı��������ı�������ָ�����ı����Լ�ָ���������������͹������ɼ��ԡ����� TextArea ���췽����������һ�涨��

TextArea �ඨ��һЩ������Ϊ scrollbars ����ֵ�ṩ�ij�����

������������ scrollbars ������ֵ������Ч�ģ�����ʹ�������ı���ʱʹ�õĹ������ɼ��Ե��� SCROLLBARS_BOTH ��Ĭ��ֵ��

������
text - Ҫ��ʾ���ı������ text Ϊ null������ʾ���ַ��� ""
rows - ��������� rows С�� 0���� rows ����Ϊ 0
columns - ��������� columns С�� 0���� columns ����Ϊ 0
scrollbars - ȷ��Ϊ�鿴�ı��������Ĺ��������͵ij���
�׳���
HeadlessException - ��� GraphicsEnvironment.isHeadless ���� true
�����°汾��ʼ��
JDK1.1
������
GraphicsEnvironment.isHeadless()
������ϸ��Ϣ

addNotify

public void addNotify()
���� TextArea ��ͬλ�塣��ͬλ�������޸� TextArea ����ۣ����������书�ܡ�

���ǣ�
�� TextComponent �е� addNotify
������
TextComponent.removeNotify()

insert

public void insert(String str,
                   int pos)
�ڴ��ı�����ָ��λ�ò���ָ���ı���

ע�⣬���� null ��һ�µIJ�������Ч�ģ����ҽ����²�ȷ������Ϊ��

������
str - Ҫ����ķ� null �ı�
pos - ������
�����°汾��ʼ��
JDK1.1
������
TextComponent.setText(java.lang.String), replaceRange(java.lang.String, int, int), append(java.lang.String)

insertText

@Deprecated
public void insertText(String str,
                                  int pos)
�ѹ�ʱ�� �� JDK version 1.1 ��ʼ���� insert(String, int) ȡ����


append

public void append(String str)
�������ı�׷�ӵ��ı����ĵ�ǰ�ı���

ע�⣬���� null ��һ�µIJ�������Ч�ģ����ҽ����²�ȷ������Ϊ��

������
str - Ҫ׷�ӵķ� null �ı�
�����°汾��ʼ��
JDK1.1
������
insert(java.lang.String, int)

appendText

@Deprecated
public void appendText(String str)
�ѹ�ʱ�� �� JDK version 1.1 ��ʼ���� append(String) ȡ����


replaceRange

public void replaceRange(String str,
                         int start,
                         int end)
��ָ���滻�ı��滻ָ����ʼλ�������λ��֮����ı������������ı����ᱻ�滻����ʼλ�ô����ı��ᱻ�滻�����ǿ�ʼλ�������λ����ͬ�����ı�λ���Ǵ��㿪ʼ�ġ��������ַ����ij��ȿ��������滻�ı��ij��Ȳ�ͬ��

ע�⣬���� null ��һ�µIJ�������Ч�ģ����ҽ����²�ȷ������Ϊ��

������
str - �����滻�ķ� null �ı�
start - ��ʼλ��
end - �����
�����°汾��ʼ��
JDK1.1
������
insert(java.lang.String, int)

replaceText

@Deprecated
public void replaceText(String str,
                                   int start,
                                   int end)
�ѹ�ʱ�� �� JDK version 1.1 ��ʼ���� replaceRange(String, int, int) ȡ����


getRows

public int getRows()
���ش��ı�����������

���أ�
���ı����е�����
�����°汾��ʼ��
JDK1
������
setRows(int), getColumns()

setRows

public void setRows(int rows)
���ô��ı�����������

������
rows - ����
�׳���
IllegalArgumentException - ���Ϊ rows �ṩ��ֵС�� 0
�����°汾��ʼ��
JDK1.1
������
getRows(), setColumns(int)

getColumns

public int getColumns()
���ش��ı����е�������

���أ�
���ı����е�����
������
setColumns(int), getRows()

setColumns

public void setColumns(int columns)
���ô��ı�����������

������
columns - ����
�׳���
IllegalArgumentException - ���Ϊ columns �ṩ��ֵС�� 0
�����°汾��ʼ��
JDK1.1
������
getColumns(), setRows(int)

getScrollbarVisibility

public int getScrollbarVisibility()
����ָʾ�ı���ʹ�ú��ֹ�������ö��ֵ��

TextArea �ඨ�����ĸ���������������ָ����Щ�������ǿ��õġ�TextArea ��һ�������������ϵ�Ӧ�÷���Ĺ��췽����

���أ�
ָʾʹ�����ֹ�����������
�����°汾��ʼ��
JDK1.1
������
SCROLLBARS_BOTH, SCROLLBARS_VERTICAL_ONLY, SCROLLBARS_HORIZONTAL_ONLY, SCROLLBARS_NONE, TextArea(java.lang.String, int, int, int)

getPreferredSize

public Dimension getPreferredSize(int rows,
                                  int columns)
ȷ������ָ���������������ı�������ѡ��С��

������
rows - ����
columns - ����
���أ�
��ʾ����ָ���������������ı����������ѡ�ߴ�
�����°汾��ʼ��
JDK1.1
������
Component.getPreferredSize()

preferredSize

@Deprecated
public Dimension preferredSize(int rows,
                                          int columns)
�ѹ�ʱ�� �� JDK version 1.1 ��ʼ���� getPreferredSize(int, int) ȡ����


getPreferredSize

public Dimension getPreferredSize()
ȷ�����ı�������ѡ��С��

���ǣ�
�� Component �е� getPreferredSize
���أ�
���ı����������ѡ�ߴ�
�����°汾��ʼ��
JDK1.1
������
Component.getPreferredSize()

preferredSize

@Deprecated
public Dimension preferredSize()
�ѹ�ʱ�� �� JDK version 1.1 ��ʼ���� getPreferredSize() ȡ����

���ǣ�
�� Component �е� preferredSize

getMinimumSize

public Dimension getMinimumSize(int rows,
                                int columns)
ȷ������ָ���������������ı�������С��С��

������
rows - ����
columns - ����
���أ�
��ʾ����ָ���������������ı����������С�ߴ�
�����°汾��ʼ��
JDK1.1
������
Component.getMinimumSize()

minimumSize

@Deprecated
public Dimension minimumSize(int rows,
                                        int columns)
�ѹ�ʱ�� �� JDK version 1.1 ��ʼ���� getMinimumSize(int, int) ȡ����


getMinimumSize

public Dimension getMinimumSize()
ȷ�����ı�������С��С��

���ǣ�
�� Component �е� getMinimumSize
���أ�
���ı����������ѡ�ߴ�
�����°汾��ʼ��
JDK1.1
������
Component.getPreferredSize()

minimumSize

@Deprecated
public Dimension minimumSize()
�ѹ�ʱ�� �� JDK version 1.1 ��ʼ���� getMinimumSize() ȡ����

���ǣ�
�� Component �е� minimumSize

paramString

protected String paramString()
���ر�ʾ�� TextArea ״̬���ַ������˷��������ڵ���Ŀ�ģ����ڸ���ʵ�֣����ص��ַ��������ݺ͸�ʽ����������ͬ�����ص��ַ�������Ϊ�գ���������Ϊ null��

���ǣ�
�� TextComponent �е� paramString
���أ�
���ı����IJ����ַ���

getAccessibleContext

public AccessibleContext getAccessibleContext()
������� TextArea ��ص� AccessibleContext�������ı�����AccessibleContext ���� AccessibleAWTTextArea ����ʽ�����б�Ҫ���ɴ���һ���µ� AccessibleAWTTextArea ʵ����

ָ���ߣ�
�ӿ� Accessible �е� getAccessibleContext
���ǣ�
�� TextComponent �е� getAccessibleContext
���أ�
������ TextArea �� AccessibleContext �� AccessibleAWTTextArea
�����°汾��ʼ��
1.3

JavaTM Platform
Standard Ed. 6

�ύ��������
�йظ���� API �ο����ϺͿ�����Ա�ĵ�������� Java SE ������Ա�ĵ������ĵ���������ϸ�ġ����򿪷���Ա���������Լ�������������ﶨ�塢ʹ�ü��ɺ͹�������ʾ����

��Ȩ���� 2007 Sun Microsystems, Inc. ��������Ȩ���� ����������֤��������������ĵ����·ַ�������