15.4 JPasswordField类
JPasswordField组件被设计用来处理密码输入。密码文本域会显示一个特殊的输入掩码，而不会回显用户的输入。其作用类似于具有*输入掩码的JTextField。我们不能取消掩码设置，也不能剪切或是复制密码组件的内容。其目的就是为了强强安全性。
15.4.1 创建JPasswordField
与JTextField相同，JPasswordField类有五个构造函数：
public JPasswordField() JPasswordField passwordField = new JPasswordField(); public JPasswordField(String text) JPasswordField passwordField = new JPasswordField("Initial Password"); public JPasswordField(int columnWidth) JPasswordField passwordField = new JPasswordField(14); public JPasswordField(String text, int columnWidth) JPasswordField passwordField = new JPasswordField("Initial Password", 14); public JPasswordField(Document model, String text, int columnWidth) JPasswordField passwordField = new JPasswordField(aModel, "Initial Password", 14);
使用无参数的构造函数，我们可以获得一个空的，零列宽的输入域，默认的初始化Document模型，以及*回显字符。尽管我们可以在构造函数中指定初始化文本，但是通常我们所要做的是提示用户输入密码来验证用户的标识，而不是确定用户是否可以提交一个表单。所以，JPasswordField的本意是在启动时是空的。类似于JTextField，我们也可以指定初始宽度，假定JPasswordField所在的窗口的布局管理器将处理这种请求。
我们也可以在构造函数中指定密码域的Document数据模型。当指定Document数据模型时，我们应该指定一个null初始化文本参数；否则，文档的当前内容就会被密码域的初始文本所替换。另外，我们不应尝试在JPasswordField中使用自定义的Document。因为组件在已输入多少字符之外并不会显示任何可视化的回馈，如果我们尝试将输入限制为数字数据，这会使用户感到迷惑。
15.4.2 JPasswordField属性
表15-6显示了JPasswordField的四个属性。
设置echoChar属性可以使得我们使用默认星号字符以外的掩码字符。如查echoChar属性被设置为字符\u0000(0)，public boolean echoCharIsSet()方法会返回false。在其他的情况下，方法会返回true。
注意，JPasswordField有一个受保护的只读的text属性，我们应避免使用这个属性。相反，我们应使用password属性，因为他会返回一个char[]并在使用之后立即清除。一个String必须等待垃圾回收器来翻译。
15.4.3 自定义JPasswordField观感
JPasswordField是JTextField的一个子类。在所有预定义的观感类型下，他与JTextField具有相同的外观（如图15-15所示）。一个不同就是当前的echoChar属性设置隐藏内容。如图15-16所示。顶部的文本组件是一个JTextField；而底部则是一个JPasswordField。
表15-7显示了JPasswordField的17个UIResource相关的属性。
15.5 JFormattedTextField类
JFormattedTextField提供了格式化文本输入的支持。当这个组件创建时，我们为输入定义了一个掩码。这个掩码可以是以下四种格式之一：一个java.text.Format对象，一个AbstractFormatter，一个AbstractFormatterFactory或是一个不同类型的实际值（例如3.141592）。
依据我们希望用户输入的数据类型，系统为我们的使用提供了一些抽象格式器。例如，NumberFormatter可以用来输入数字，而DateFormatter可以用来输入整个日期。同时还有一个MaskFormatter用于描述具有编辑字行串的输入，例如用于美国社会保险号码的“XXX-XX-XXX”。如果我们希望不同的显示与编辑格式，我们可以使用AbstractFormatterFactory。我们将会在第16章中了解到关于格式器与格式器工厂的更多内容。
15.5.1 创建JFormattedTextField
JFormattedTextField类有六个构造函数：
public JFormattedTextField() JFormattedTextField formattedField = new JFormattedTextField(); public JFormattedTextField(Format format) DateFormat format = new SimpleDateFormat("yyyy--MMMM--dd"); JFormattedTextField formattedField = new JFormattedTextField(format); public JFormattedTextField(JFormattedTextField.AbstractFormatter formatter) DateFormat displayFormat = new SimpleDateFormat("yyyy--MMMM--dd"); DateFormatter displayFormatter = new DateFormatter(displayFormat); JFormattedTextField formattedField = new JFormattedTextField(displayFormatter); public JFormattedTextField(JFormattedTextField.AbstractFormatterFactory factory) DateFormat displayFormat = new SimpleDateFormat("yyyy--MMMM--dd"); DateFormatter displayFormatter = new DateFormatter(displayFormat); DateFormat editFormat = new SimpleDateFormat("MM/dd/yy"); DateFormatter editFormatter = new DateFormatter(editFormat); DefaultFormatterFactory factory = new DefaultFormatterFactory( displayFormatter, displayFormatter, editFormatter); JFormattedTextField formattedField = new JFormattedTextField(factory); public JFormattedTextField(JFormattedTextField.AbstractFormatterFactory factory, Object currentValue) DateFormat displayFormat = new SimpleDateFormat("yyyy--MMMM--dd"); DateFormatter displayFormatter = new DateFormatter(displayFormat); DateFormat editFormat = new SimpleDateFormat("MM/dd/yy"); DateFormatter editFormatter = new DateFormatter(editFormat); DefaultFormatterFactory factory = new DefaultFormatterFactory( displayFormatter, displayFormatter, editFormatter); JFormattedTextField formattedField = new JFormattedTextField(factory, new Date()); public JFormattedTextField(Object value) JFormattedTextField formattedField = new JFormattedTextField(new Date());
无参数的构造函数需要我们在稍后进行配置。其他的构造函数允许我们配置内容将会接受什么以及如何接受。
15.5.2 JFormattedTextField属性
表15-8显示了JFormattedTextField的八个属性。我们不必像使用JTextField时一样，通过text属性将JFormattedTextField的内容获取为一个String，而是可以通过value属性将其获取为一个Object。所以，如果我们的格式器用于一个Date对象，我们所获得的值可以转换为java.util.Date类型。
列表15-14演示了具有自定义格式器与工厂的JFormattedTextField的用户。注意，当我们编辑底部的文本域时，显示格式与编辑格式是不同的。
/** * */ package swingstudy.ch15; import java.awt.BorderLayout; import java.awt.EventQueue; import java.awt.event.ActionEvent; import java.awt.event.ActionListener; import java.awt.event.KeyEvent; import java.text.DateFormat; import java.text.SimpleDateFormat; import java.util.Date; import javax.swing.JFormattedTextField; import javax.swing.JFrame; import javax.swing.JLabel; import javax.swing.JPanel; import javax.swing.text.DateFormatter; import javax.swing.text.DefaultFormatterFactory; /** * @author mylxiaoyi * */ public class FormattedSample { /** * @param args */ public static void main(String[] args) { // TODO Auto-generated method stub Runnable runner = new Runnable() { public void run() { JFrame frame = new JFrame("Formatted Example"); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); JPanel datePanel = new JPanel(new BorderLayout()); JLabel dateLabel = new JLabel("Date: "); dateLabel.setDisplayedMnemonic(KeyEvent.VK_D); DateFormat format = new SimpleDateFormat("yyyy--MMMM--dd"); JFormattedTextField dateTextField = new JFormattedTextField(format); dateLabel.setLabelFor(dateTextField); datePanel.add(dateLabel, BorderLayout.WEST); datePanel.add(dateTextField, BorderLayout.CENTER); frame.add(datePanel, BorderLayout.NORTH); JPanel date2Panel = new JPanel(new BorderLayout()); JLabel date2Label = new JLabel("Date 2: "); date2Label.setDisplayedMnemonic(KeyEvent.VK_A); DateFormat displayFormat = new SimpleDateFormat("yyyy--MMMM--dd"); DateFormatter displayFormatter = new DateFormatter(displayFormat); DateFormat editFormat = new SimpleDateFormat("MM/dd/yy"); DateFormatter editFormatter = new DateFormatter(editFormat); DefaultFormatterFactory factory = new DefaultFormatterFactory(displayFormatter, displayFormatter, editFormatter); JFormattedTextField date2TextField = new JFormattedTextField(factory, new Date()); date2Label.setLabelFor(date2TextField); date2Panel.add(date2Label, BorderLayout.WEST); date2Panel.add(date2TextField, BorderLayout.CENTER); frame.add(date2Panel, BorderLayout.SOUTH); ActionListener actionListener = new ActionListener() { public void actionPerformed(ActionEvent event) { JFormattedTextField source = (JFormattedTextField)event.getSource(); Object value = source.getValue(); System.out.println("Class: "+value.getClass()); System.out.println("Value: "+value); } }; dateTextField.addActionListener(actionListener); date2TextField.addActionListener(actionListener); frame.setSize(250, 100); frame.setVisible(true); } }; EventQueue.invokeLater(runner); } }
15.5.3 自定义JFormattedTextField观感
类似于JPasswordField，JFormattedTextField也是JTextField的一个子类。在所有的预定义的观感类型下，同样与JTextField具有相同的外观（如图15-15）。要自定义其显示，我们可以修改JFormattedTextField的16个UIResource相关的属性集合中的任何一个，如表15-9所示。
15.6 JTextArea类
JTextArea是用于多行输入的文本组件。类似于JTextField，JTextArea的数据模型是Document接口的PlainDocument实现。所以，JTextArea被限制为单属性文本。类似于其他的需要滚动的Swing组件，JTextArea本身不支持滚动。我们需要将JTextArea放在JScrollPane中来允许在JTextArea中进行滚动。
15.6.1 创建JTextArea
JTextArea有六个构造函数：
public JTextArea() JTextArea textArea = new JTextArea(); public JTextArea(Document document) Document document = new PlainDocument(); JTextArea textArea = new JTextArea(document); public JTextArea(String text) JTextArea textArea = new JTextArea("..."); public JTextArea(int rows, int columns) JTextArea textArea = new JTextArea(10, 40); public JTextArea(String text, int rows, int columns) JTextArea textArea = new JTextArea("...", 10, 40); public JTextArea(Document document, String text, int rows, int columns) JTextArea textArea = new JTextArea(document, null, 10, 40);
除非特别指定，文本区域也可以存储零行与零列的内容。尽管这听起来像是一个严重的限制，我们只需要告诉文本区域来使得当前的LayoutManager处理我们的文本区域的尺寸。JTextArea的内容初始时是空的，除非使用起始文本字符串或是Document模型指定。
注意，其他的JTextArea初始设置包括一个Tab为八个位置以及关闭文字换行。要了解关于Tab的更多内容，可以查看第16章中的TabStop与TabSet类。
在创建了JTextArea之后，记得将JTextArea放在JScrollPane中。然后在屏幕上如果没有足够的空间，JScrollPane就会为我们管理滚动。
JTextArea textArea = new JTextArea(); JScrollPane scrollPane = new JScrollPane(textArea); content.add(scrollPane);
图15-17显示了在JScrollPane之内以及在JScrollPane之外的JTextArea的样子。不在JScrollPanel中的JTextArea，我们不能看到超出屏幕边界的文本。依照设计，将光标移动进区域并不会使得顶部的内容向上移动。
15.6.2 JTextArea属性
表15-10显示了JTextArea的12个属性。
rows与columns属性直接来自于构造函数的参数。preferredScrollableViewportSize与scrollableTracksViewportWidth属性来自于用于滚动支持的Scrollable接口实现。font与preferredSize属性仅是自定义由JTextComponent继承的行为。
更为有趣的属性是lineCount，tabSize以及lineWrap与wrapStyledWorld。lineCount属性可以使得我们确定文本域中有多少行。这对于调整尺寸十分有用。tabSize属性可以使得我们控制文本区域中tab位置。默认情况下，这个值为8.
lineWrap与wrapStyleWord属性配合使用。默认情况下，较长行的换行是禁止的。如果我们允许换行（通过将lineWrap属性设置为true），较长行换行的时机依赖于wrapStyleWord属性设置。初始时，这个属性为false，意味着如果lineWrap属性为true，将会在字符边界处换行。如果lineWrap与wrapStyleWord都为true，那么一行中不会适的单词将会被换到下一行，类似于字处理器中的样子。所以，要获得大多数人所希望的单词换行的功能，我们应将JTextArea的两个属性都设置为true：
JTextArea textArea = new JTextArea("...");
textArea.setLineWrap(true);
textArea.setWrapStyleWord(true);
JScrollPane scrollPane = new JScrollPane(textArea);注意，Ctrl-Tab与Shift-Ctrl-Tab键的组合可以使得用户在JTextArea组件中变换焦点，而无需继承组件生成新类。
15.6.3 处理JTextArea事件
JTextArea并没有特定的事件。我们可以使用由JTextComponent继承的监听器中的一个或是关联一个InputVerifier。
有时，我们会在屏幕上放置一个JTextArea并在用户按下按钮之后获取其内容。而在另外一些时间，会涉及到更多的规划，此时我们希望在输入时监视输入，并且也许会进行相应的转换，例如:-)或是简单的笑脸。
15.6.4 自定义JTextArea观感
每一个可安装的Swing观感都提供了不同的JTextArea外观以及默认的UIResource值集合。图15-18显示在JTextArea组件在预安装的观感类型下的外观。注意，每一个外观上的基本区别在于JScrollPane的滚动条，他并不是JTextArea的实际部分。
表15-11显示了JTextArea的15个UIResource相关的属性集合。
15.7 JEditorPane类
JEditorPane类提供了显示与编辑多属性文本的功能。虽然JTextField与JTextArea只支持单颜色，单字体内容，JEditorPane允许我们使用各种风格（例如粗体，14点Helvetica，段落右对齐）或是HTML查看器的外观来标记我们的内容，如图15-19所示。
注意，JEditorPane的HTML支持只在具有某些扩展的HTML 3.2级别上可用，而编写本书时HTML 4.0x是当前的版本。级联样式表（CSS）被部分支持。
JEditorPane借助于一个特定的文本标记机制的EditorKit来支持多属性文本的显示与编辑。存在预定义的工具集来支持原始文本，HTML文档以及RTF文档。因为内容是多属性的，PlainDocument模型不再够用。相反，Swing以DefaultStyledDocument类的形式提供了一个StyledDocument来维护文档模型。其余的部分是一个新的HyperlinkListsener/HyperlinkEvent事件处理对用来监视文档中的超连接操作。
15.7.1 创建JEditorPane
JEditorPane有四个构造函数：
public JEditorPane()
JEditorPane editorPane = new JEditorPane();
public JEditorPane(String type, String text)
String content = "<H1>Got Java?</H1>";
String type = "text/html";
JEditorPane editorPane = new JEditorPane(type, content);
public JEditorPane(String urlString) throws IOException
JEditorPane editorPane = new JEditorPane("http://www.apress.com");
public JEditorPane(URL url) throws IOException
URL url = new URL("http://www.apress.com");
JEditorPane editorPane = new JEditorPane(url);无参数的构造函数创建了一个空的JEditorPane。如果我们要初始化内容，我们可以直接指定文本或是其MIME类型。或者是我们可以指定获取内容的URL。URL可以作为一个String或是一个URL对象来指定。当我们将内容指定为一个URL，JEditorPane会由响应来确定MIME类型。
15.7.2 JEditorPane属性
表15-12显示了JEditorPane的11个属性。这些属性中的大部分仅是自定义父类的行为。
注意，page属性是非标准的，因为他有两个setter方法，但是只有一个getter方法。
JEditorPane的四个有趣属性是editorKit，contentType，page与text。editorKit属性是依据编辑器面板中的内容类型来配置的。我们将会在第16章中进行详细探讨其DefaultEditorKit，StyledEditorKit与HTMLEditorKit实现。contentType属性表示文档中内容类型的MIME类型。当我们在构造函数中（或是其他位置）设置内容时，这个属性会被自动设置。如果编辑器工具集不能确定MIME类型，我们可以进行手动设置。三个内建支持的数据类型是text/html，text/plain与text/rtf，通过预定义编辑器工具集的getContentType()方示可以获取这些类型。
page属性可以使得我们修改所显示的内容来反映一个特定URL的内容，从而我们可以以某种方式使用这些内容。text属性使得我们确定哪些文本内容基于当前的Document模型。
15.7.3 处理JEditorPane事件
因为JEditorPane仅是一个具有一些特殊显示特性的另一个文本区域组件，他支持与JTextArea组件相同的用于事件处理的监听器。另外，JEditorPane提供了一个特殊的监听器事件组合来处理文档中的超链接。
HyperlinkListener接口定义了一个方法，public void hyperlinkUpdate(HyperlinkEvent hyperlinkEvent)，他使用一个HyperlinkEvent来响应－不要惊奇－超链接事件。事件包含一个报告事件类型的HyperlinkEvent.EventType并且使得我们进行不同的响应，或者是当选中时跟随链接或者是当在超链接上移动鼠标时改变光标（尽管这是默认发生的）。
下面是HyperlinkListener定义：
public interface HyperlinkListener implements EventListener { public void hyperlinkUpdate(HyperlinkEvent hyperlinkEvent); } And, here is the HyperlinkEvent definition: public class HyperlinkEvent extends EventObject { // Constructors public HyperlinkEvent(Object source, HyperlinkEvent.EventType type, URL url); public HyperlinkEvent(Object source, HyperlinkEvent.EventType type, URL url, String description); public HyperlinkEvent(Object source, HyperlinkEvent.EventType type, URL url, String description, Element sourceElement) // Properties public String getDescription(); public HyperlinkEvent.EventType getEventType(); public Element getSourceElement(); public URL getURL(); }
超链接类型将会是HyperlinkEvent.EventType类的三个常量之一：
- ACTIVATED：通常涉及到在合适的内容上进行鼠标点击
- ENTERED：在超链接内容上移动鼠标
- EXITED：将鼠标移出超链接内容
所以，如果我们希望在工具栏上创建一个显示URL的HyperlinkListener，当在超链接之前并在激活时跟随超链接，我们可以创建我们自己的最简单的HTML帮助查看器。列表15-15中的HyperlinkListener实现将会为我们实现这一技巧。在监听器中提供了一些println语句，当鼠标位于URL之上并且URL被激活时显示URL。
/** * */ package swingstudy.ch15; import java.awt.EventQueue; import java.awt.Frame; import java.io.IOException; import java.net.URL; import javax.swing.JEditorPane; import javax.swing.JOptionPane; import javax.swing.event.HyperlinkEvent; import javax.swing.event.HyperlinkListener; import javax.swing.text.Document; /** * @author mylxiaoyi * */ public class ActivatedHyperlinkListener implements HyperlinkListener { Frame frame; JEditorPane editorPane; public ActivatedHyperlinkListener(Frame frame, JEditorPane editorPane) { this.frame = frame; this.editorPane = editorPane; } /* (non-Javadoc) * @see javax.swing.event.HyperlinkListener#hyperlinkUpdate(javax.swing.event.HyperlinkEvent) */ @Override public void hyperlinkUpdate(HyperlinkEvent event) { // TODO Auto-generated method stub HyperlinkEvent.EventType type= event.getEventType(); final URL url = event.getURL(); if(type==HyperlinkEvent.EventType.ENTERED) { System.out.println("URL: "+url); } else if(type==HyperlinkEvent.EventType.ACTIVATED) { System.out.println("Activated"); Runnable runner = new Runnable() { public void run() { Document doc = editorPane.getDocument(); try { editorPane.setPage(url); } catch(IOException ioException) { JOptionPane.showMessageDialog(frame, "Error following link", "Invalid link", JOptionPane.ERROR_MESSAGE); editorPane.setDocument(doc); } } }; EventQueue.invokeLater(runner); } } }
提示，不要忘记调用setEditable(false)方法将JEditorPane设置为只读。否则，查看器就成为了编辑器。
列表15-16是使用我们新创建的ActivatedHyperlinkListener类的完整示例。他所创建的窗体类似于前面图15-19中所示的页面，尽管是在图片中，About链接已经被跟随。
/** * */ package swingstudy.ch15; import java.awt.EventQueue; import java.io.IOException; import javax.swing.JEditorPane; import javax.swing.JFrame; import javax.swing.JScrollPane; import javax.swing.event.HyperlinkListener; /** * @author mylxiaoyi * */ public class EditorSample { /** * @param args */ public static void main(String[] args) { // TODO Auto-generated method stub Runnable runner = new Runnable() { public void run() { JFrame frame = new JFrame("EditorPane Example"); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); try { JEditorPane editorPane = new JEditorPane("http://www.google.com"); editorPane.setEditable(false); HyperlinkListener hyperlinkListener = new ActivatedHyperlinkListener(frame, editorPane); editorPane.addHyperlinkListener(hyperlinkListener); JScrollPane scrollPane = new JScrollPane(editorPane); frame.add(scrollPane); } catch(IOException e) { System.err.println("Unable to load: "+e); } frame.setSize(640, 480); frame.setVisible(true); } }; EventQueue.invokeLater(runner); } }
15.7.4 自定义JEditorPane观感
JEditorPane的外观类似于JTextArea。尽管所支持的内容不同，观感相关的属性通常是不同的。
表15-13显示了JEditorPane的15个UIResource相关的属性集合。属性的名字于JTextArea设置中的属性名字。
15.8 JTextPane类
JTextPane是JEditorPane的一种特殊形式，特别设计用来编辑（与显示）格式化文本。他与JEditorPane的唯一不同在于提供显示内容的方式，因为文本并不是像在HTML或是RTF文档中一样使用格式标记的。
JTextPane依赖设置文本属性的三个接口：AttributeSet用于基本的属性集合，MutableAttributeSet用于可修改的属性集合，Style用作与StyledDocument的部分相关联的属性集合。
本节将会介绍JTextPane。要了解关于在JTextPane中配置格式化内容不同部分的格式的信息可以查看第16章。
15.8.1 创建JTextPane
JTextPane只有两个构造函数：
public JTextPane()
JTextPane textPane = new JTextPane();
JScrollPane scrollPane = new JScrollPane(textPane);
public JTextPane(StyledDocument document)
StyledDocument document = new DefaultStyledDocument();
JTextPane textPane = new JTextPane(document);
JScrollPane scrollPane = new JScrollPane(textPane);无参数的构造函数初始时没有内容。第二个构造函数使得我们先创建Document，然后在JTextPane中使用。
提示，如果内容大于可用的屏幕空间，记得将我们的JTextPane放在JScrollPane中。
15.8.2 JTextPane属性
表15-14显示了JTextPane的八个属性。我们将会在第16章中详细探讨这些属性。
15.8.3 自定义JTextPane观感
JTextPane是JEditorPane的一个子类。他在所有预定义的观感类型下与JTextArea具有相同的外观（如图15-18所示）。尽管内容也许不同，但是观感是相同的。
表15-15中显示了JTextPane UIResource相关属性的可用集合。对于JTextPane组件，有15个不同的属性。其属性名字类似于JTextArea设置中的属性名字。
15.8.4 载入具有内容的JTextPane
列表15-17提供了一个向JTextPane载入StyledDocument内容的示例。这仅是向我们展示功能。Style，SimpleAttributeSet与StyledConstants的详细使用将会在第16章中进行探讨。
/**
*
*/
package swingstudy.ch15;
import java.awt.BorderLayout;
import java.awt.EventQueue;
import javax.swing.Icon;
import javax.swing.ImageIcon;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JScrollPane;
import javax.swing.JTextPane;
import javax.swing.text.BadLocationException;
import javax.swing.text.DefaultStyledDocument;
import javax.swing.text.SimpleAttributeSet;
import javax.swing.text.Style;
import javax.swing.text.StyleConstants;
import javax.swing.text.StyleContext;
import javax.swing.text.StyledDocument;
/**
* @author mylxiaoyi
*
*/
public class TextPaneSample {
private static String message = "In the beginning, there was COBOL, then there was FORTRAN, "+
"then there was BASIC, ... and now there is Java.\n";
/**
* @param args
*/
public static void main(String[] args) {
// TODO Auto-generated method stub
Runnable runner = new Runnable() {
public void run() {
JFrame frame = new JFrame("TextPane Example");
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
StyleContext context = new StyleContext();
StyledDocument document = new DefaultStyledDocument(context);
Style style = context.getStyle(StyleContext.DEFAULT_STYLE);
StyleConstants.setAlignment(style, StyleConstants.ALIGN_RIGHT);
StyleConstants.setFontSize(style, 14);
StyleConstants.setSpaceAbove(style, 4);
StyleConstants.setSpaceBelow(style, 4);
// Inset content
try {
document.insertString(document.getLength(), message, style);
}
catch(BadLocationException badLocationException) {
System.err.println("Oops");
}
SimpleAttributeSet attributes = new SimpleAttributeSet();
StyleConstants.setBold(attributes, true);
StyleConstants.setItalic(attributes, true);
// Insert content
try {
document.insertString(document.getLength(), "Hello Java", attributes);
}
catch(BadLocationException badLocationException) {
System.err.println("Oops");
}
// Third style for icon/component
Style labelStyle = context.getStyle(StyleContext.DEFAULT_STYLE);
Icon icon = new ImageIcon("Computer.gif");
JLabel label = new JLabel(icon);
StyleConstants.setComponent(labelStyle, label);
// Insert content
try {
document.insertString(document.getLength(), "Ignored", labelStyle);
}
catch(BadLocationException badLocationException) {
System.err.println("Oops");
}
JTextPane textPane = new JTextPane(document);
textPane.setEditable(false);
JScrollPane scrollPane = new JScrollPane(textPane);
frame.add(scrollPane, BorderLayout.CENTER);
frame.setSize(300, 150);
frame.setVisible(true);
}
};
EventQueue.invokeLater(runner);
}
}上述源码的关键行是调用insertString()与其style参数：
document.insertString(document.getLength(), message, style);
图15-20显示了具有一些段落内容的JTextPane的样子。注意，内容并没有限制为仅是广西；他也可以具有图片。
15.9 小结
在本章中，我们开始对Swing文本组件的细节进行探讨。我们首先了解了根文本组件，JTextComponent，以及为其他的文本组件定义了许多操作。然后我们探讨特定的文本组件，JTextField，JPasswordField，JFormattedTextField，JTextArea，JEditorPane与JTextPane。
我们同时探讨了构成不同的组件的各种片段。我们深入了基于Document接口，用于AbstractDocument与PlaintDocument类的文本组件模型。我们同时了解了使用DocumentFilter来创建自定义的组件限制文本组件的输入。噣上，我们探讨了用于显示光标与高亮文本的Caret与Highlighter接口，用于限制文本组件中移动的NavigationFilter，以及使得文本组件作为控制器的Keymap。类似于控制器，Keymap将用户的按钮转换为影响文本组件模型的特定动作。
我们同时了解了Swing文本组件中是如何处理事件的。除了基本的AWT事件处理类，Swing添加了一些特别设计的新类，使用CaretListener来监听光标移动，使用DocumentListener监听文档内容变化。而且通过InputVerifer还有一个通用的Swing输入验证支持。
在第16章中，我们将会进一步探讨Swing文本组件。本章仅是所有组件的基本特性，而下一章将会探讨使用TextAction，JFormattedField的格式化输入以及使用StyledDocument的配置Style对象的细节。同时我们还会在HTMLDocument标记中进行探讨。
2289
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
