Java API 分類導覽 - java.awt.TextArea insert()

TextArea 類別 (class) 的 insert() 方法 (method) 用來在文字輸入框內插入新的文字。



修飾子與參數

public void insert(String str, int pos)

insert() 沒有回傳值 (return value) ，需要兩個參數 (paramenter) ，第一個為 String 型態 (type) 的字串物件 (object) ，也就是要插入的文字，第二個為 int 型態的整數常數，也就是索引值。



舉例如下

import java.awt.*;
import java.awt.event.*;

public class TextAreaDemo implements TextListener, ActionListener {
    Frame frame;
    TextArea text;
    
    public static void main(String[] args) {
        new TextAreaDemo();
    }
    
    public TextAreaDemo() {
        frame = new Frame("AWTDemo");
        frame.addWindowListener(new AdapterDemo());
        frame.setLayout(new BorderLayout());
        frame.setSize(640, 480);
         
        text = new TextArea();
        text.addTextListener(this);
        text.setColumns(40);
        text.setRows(30);
        text.insert("There is no spoon.", 0);
        
        Button button = new Button("Change");
        button.addActionListener(this);

        frame.add(text, BorderLayout.CENTER);
        frame.add(button, BorderLayout.SOUTH);
        
        frame.setVisible(true);
        
        System.out.println("Columns: " + text.getColumns());
        System.out.println("Rows: " + text.getRows());
        System.out.println("Scrollbar visibility: " + text.getScrollbarVisibility());
    }
    
    public void textValueChanged(TextEvent e) {
        System.out.print("!");
    }

    public void actionPerformed(ActionEvent e) {
        text.replaceRange("xxx", 0, 2);
        text.append("(new)");
    }
}

class AdapterDemo extends WindowAdapter {
    public void windowClosing(WindowEvent e) {
        System.exit(0);
    }
}

/* 《程式語言教學誌》的範例程式
    http://pydoing.blogspot.com/
    檔名：TextAreaDemo.java
    功能：示範 Java 程式 
    作者：張凱慶
    時間：西元 2012 年 3 月 */

此例的 TextAreaDemo 實作 TextListener 及 ActionListener 介面

public class TextAreaDemo implements TextListener, ActionListener {

建立 TextArea 物件後，呼叫 TextComponent 的 addTextListener() 處理文字輸入框內容改變的事件，並以 this 當參數，其後依序呼叫 setColumns() 設定可輸入字元行數，也就是文字輸入框的寬度， setRows() 設定可輸入列數，也就是文字輸入框的高度，最後 insert() 在文字輸入框起始處插入字串

text = new TextArea();
text.addTextListener(this);
text.setColumns(40);
text.setRows(30);
text.insert("There is no spoon.", 0);

另外設置了一個 Change 按鈕

Button button = new Button("Change");
button.addActionListener(this);

建構子最後工作是在命令列印出相關訊息，依序呼叫 TextArea 的 getColumns() 印出文字輸入框的寬度， getRows() 印出文字輸入框的高度， getScrollbarVisibility() 印出文字輸入框的捲軸是否可見

System.out.println("Columns: " + text.getColumns());
System.out.println("Rows: " + text.getRows());
System.out.println("Scrollbar visibility: " + text.getScrollbarVisibility());

由於 TextAreaDemo 實作 TextListener 介面，因此要寫出 textValueChanged()

public void textValueChanged(TextEvent e) {
    System.out.print("!");
}

這裡，只要文字輸入框的內容有任何變動，命令列就會印出一個驚嘆號 "!" 。


也由於 TextAreaDemo 實作 ActionListener 介面，因此要寫出 actionPerformed()

public void actionPerformed(ActionEvent e) {
    text.replaceRange("xxx", 0, 2);
    text.append("(new)");
}

利用滑鼠點擊 Change 時，就會呼叫 TextArea 的 replaceRange() 更換索引值 0 到 2 的子字串，然後呼叫 append() 在輸入字串的結尾加上 "(new)" 。


編譯後執行，結果如下

中英文術語對照
類別	class
方法	method
回傳值	return value
型態	type
物件	object
參數	parameter

您可以繼續參考

AWT 元件

• CheckboxGroup
• Component
• Button
• Canvas
• Checkbox
• Choice
• Container
• Panel
• ScrollPane
• Window
• Dialog
• FileDialog
• Frame
• Label
• List
• Scrollbar
• TextComponent
• TextArea
• TextField
• MenuComponent
• MenuBar
• MenuItem
• Menu
• PopupMenu
• MenuShortcut

相關目錄

Java API 分類導覽
Java 教材
首頁

參考資料

http://docs.oracle.com/javase/6/docs/api/java/awt/TextArea.html