<HTML>
<HEAD>

<!-- Change the Title please -->
<TITLE>AWT SHORT COURSE: TextArea</TITLE>
</HEAD>

<!-- BODY-TEMPLATE -->

<!-- NAVBAR-PULLQUOTE-TEMPLATE -->
<TR VALIGN=TOP>
<td width=178>

<BR clear=LEFT>
<TABLE ALIGN=LEFT>
<TR VALIGN=TOP>
<td width=60>
<a href="../TOC.html"><img border=0 src="/developer/images/magelang/contents.gif" alt="contents" WIDTH=147 HEIGHT=23></a>
</td>
</tr>
<tr>
<td>
<a href="TextComponent.html"><img border=0 src="/developer/images/magelang/previous.gif" hspace=10 alt="Previous" width=64 height=20></a>
</td>
<td>
<a href="TextField.html"><img border=0 src="/developer/images/magelang/next.gif" alt="Next" width=43 height=20></a>
</td>
</tr>
</table>

</TR>
</TABLE>

<!-- PAGETOP-TEMPLATE -->
<TR>
<TD WIDTH=452 ALIGN=RIGHT>
<img src=images/ShortCourse.gif>
</TD>
</TR>
<TR>
<TD WIDTH=452 COLSPAN=2 ALIGN=right>
<!--breadcrumb trail; change to reflect the current URL-->
<!-- Please change to reflect where _exactly_ you are in the site
<!-- Add more subcategories as needed  -->

<!-- Please Change these.  The Links are SubCat#, and titled SubCategory# -->
</TD>
</TR>

<!--- Please put everything you want here to the right of the navbar.
	<TR>
	<TD>
	This is the MAIN TABLE.  Put data HERE unless you need a table that
 	REQUIRES the full screen width, i.e. an event schedule table.
	Add a new table row for the data.

	If the text needs to be in two columns, use this <TR> structure:
	Make the width=452
	<TR>
	<TD WIDTH=226>
	</TD>
	<TD WIDTH=226>
	</TD>
	</TR>

	</TD>
	</TR>
--->

<TR>
<TD width=452>
<P><a name="TextArea">
<font size=+1><b>TextArea</b></font><P>
</a>

A <a href="http://java.sun.com:80/products/JDK/CurrentRelease/api/java.awt.TextArea.html">TextArea</a> is a multirow text field that displays a single string of
characters, where a newline ends each row.  The width and height of the field
is set at construction, but the text can be scrolled up and down and left and right.

<center>
<hr>
<applet code=TextAreaWidget.class CODEBASE="/applets/magelang/AWT-Training/Examples/" width=250 height=75></applet>
<hr>
</center>

<p>
Corresponding source code:

<tt><pre>
import java.applet.*;
import java.awt.*;
public class TextAreaWidget extends Applet {
    public void init() {
        TextArea disp = new TextArea("A TextArea", 3, 30);
        add(disp);
    }
}
</pre></tt>

<p>
Methods:
<ul>
<li><tt>public TextArea(String  text, int  rows, int cols)</tt><br>
Creates a TextArea with the specified number of rows and columns and some initial text.
<li><tt>public void appendText(String  str)</tt><br>
Adds some text to the end of the current text.
<li><tt>public void insertText(String  str, int  pos)</tt><br>
Inserts some text at a particular String index in the TextArea.
</ul>

<p>
There is no predefined way to set a particular row of text.  Carriage returns are used to separate the rows, which must be counted to get to the nth row.

<p>
Related exercises:
<ul>
<LI><A HREF="../Exercise/TextAreaTest/index.html"> TextAreaTest</A>
<LI><A HREF="../Exercise/CommentBoxTest/index.html"> CommentBoxTest</A>
</ul>
</TD>
</TR>
</TABLE>

<!--
        This table is for everything that goes under the 
        navbar, it is a full screen table. Use this table 
        ONLY for full screen width tables like an event 
        hourly schedule.
-->

<br clear=left>
<TABLE ALIGN=left>

<tr>
<td WIDTH=600 align=right>

<!--Last Modified and copyright message

    Please modify the date whenever significant changes are made to 
    a page; leave the copyright alone
-->

</td>
</tr>
</TABLE>

</BODY>
</HTML>
