在任何一款桌面應(yīng)用中，都難免會(huì)遇到讓用戶(hù)輸入文字或者特殊字符的情況發(fā)生，所以輸入法的支持與文本框組件的存在就變得必不可少。

由于Java具有桌面應(yīng)用開(kāi)發(fā)能力，它的圖形組件中也當(dāng)然配備有文本框，因而無(wú)論是繼承自TextComponent的Text系組件抑或繼承自JTextComponent的JText系組件都提供了讓用戶(hù)輸入數(shù)據(jù)的功能。

現(xiàn)在的疑問(wèn)是，雖然TextComponent與JTextComponent相類(lèi)似，但兩者的父類(lèi)卻并不同級(jí)。TextComponent直接繼承自Component，但Component已經(jīng)是所有Java圖形組件的公共父類(lèi)，JTextComponent的父類(lèi)JComponent卻繼承自Container，而Container的父類(lèi)才是Component。

為什么會(huì)這樣呢？如果JTextComponent直接繼承TextComponent難道不好嗎？沒(méi)錯(cuò)，不好，或者說(shuō)不能。除了Swing與AWT運(yùn)行原理造成的差異與組件關(guān)系的統(tǒng)一性需求外，造成這樣情況的理由中還有一點(diǎn)至關(guān)重要，那就是不光JTextComponent不能，即便我們想在java.awt包外重載TextComponent也不能。原因在于，雖然TextComponent類(lèi)并非final，但它的唯一構(gòu)造函數(shù)卻是default的，這意味著即便不同包中的類(lèi)繼承了它，也不能構(gòu)造，根本無(wú)法重載。

更何況，就算可以重載的JTextComponent，也與TextComponent一樣存在著一些很麻煩的默認(rèn)配置問(wèn)題（就更不要說(shuō)重載JTextField抑或TextField了）。最主要的是，用它們制作標(biāo)準(zhǔn)文本框固然游刃有余，但如果我們需要的文本框不那么標(biāo)準(zhǔn)，甚至需要某些“奇形怪狀”到只要求輸入文字，但根本就算不上文本框的組件時(shí)，那么它們勢(shì)必更加捉襟見(jiàn)肘。

那么，我們要怎樣才能滿(mǎn)足這種近乎于“變態(tài)”的要求呢？

很簡(jiǎn)單，自己“畫(huà)”個(gè)文本框出來(lái)就好了，因?yàn)槭恰爱?huà)”的，所以想它怎樣，便是怎樣，因?yàn)槭菓{空繪制，也沒(méi)有利用現(xiàn)成Swing組件繪制時(shí)的不便。

所以能這樣做，就在于Java獲得輸入法支持的關(guān)鍵點(diǎn)不在TextComponent與JTextComponent，而是java.awt.im包下的相關(guān)組件，更具體地說(shuō)，只要你實(shí)現(xiàn)了InputMethodListener與InputMethodRequests兩尊大神，那么所有Component都可以支持輸入法，又何必專(zhuān)情于TextComponent與JTextComponent？

閑話少說(shuō)，現(xiàn)在我就直接用Canvas來(lái)“畫(huà)”個(gè)文本框，給大家瞧瞧。

TextCanvas.java

package org.test; import java.awt.Canvas; import java.awt.Color; import java.awt.Dimension; import java.awt.Font; import java.awt.FontMetrics; import java.awt.Frame; import java.awt.Graphics; import java.awt.Graphics2D; import java.awt.Point; import java.awt.Rectangle; import java.awt.Toolkit; import java.awt.event.FocusEvent; import java.awt.event.FocusListener; import java.awt.event.InputMethodEvent; import java.awt.event.InputMethodListener; import java.awt.event.KeyEvent; import java.awt.event.KeyListener; import java.awt.event.WindowAdapter; import java.awt.event.WindowEvent; import java.awt.font.FontRenderContext; import java.awt.font.TextAttribute; import java.awt.font.TextHitInfo; import java.awt.font.TextLayout; import java.awt.im.InputMethodRequests; import java.text.AttributedCharacterIterator; import java.text.AttributedString; import java.text.AttributedCharacterIterator.Attribute; import sun.awt.InputMethodSupport; /** * * Copyright 2009 * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the * License for the specific language governing permissions and limitations under * the License. * * @project loonframework * @author chenpeng * @email：ceponline@yahoo.com.cn * @version 0.1 */ public class TextCanvas extends Canvas implements KeyListener, FocusListener, InputMethodListener, InputMethodRequests { /** * */ private static final long serialVersionUID = 1L; // 空的字符信息迭代器 private static final AttributedCharacterIterator EMPTY_TEXT = (new AttributedString( "")).getIterator(); // 空的輸入法信息 private static final Attribute[] IM_ATTRIBUTES = { TextAttribute.INPUT_METHOD_HIGHLIGHT }; // 判定當(dāng)前組件是否具有焦點(diǎn) private transient boolean haveFocus; // 用戶(hù)已輸入數(shù)據(jù)緩存 private StringBuffer messageText = new StringBuffer(); // 文本布局器，用以限定輸入后顯示的具體位置 private transient TextLayout textLayout = null; // 判定是否驗(yàn)證輸入法布局器 private transient boolean validTextLayout = false; // 文本顯示位置的坐標(biāo)修正值 private static final int textOffset = 5; // 已輸入文本定位器 private Point textOrigin = new Point(0, 0); // 已輸入信息的字符串構(gòu)成數(shù)據(jù) private AttributedString composedTextString; // 已輸入信息的字符構(gòu)成數(shù)據(jù) private AttributedCharacterIterator composedText; // 插入符定位器，用以記載游標(biāo)所在位置 private TextHitInfo caret = null; /** * 構(gòu)造一個(gè)TextCanvas，用以通過(guò)純繪制的方式輸入文本信息 * */ public TextCanvas() { super(); this.setForeground(Color.black); this.setBackground(Color.white); this.setFontSize(12); this.setVisible(true); this.setEnabled(true); this.addInputMethodListener(this); this.addKeyListener(this); this.addFocusListener(this); try { Toolkit toolkit = Toolkit.getDefaultToolkit(); boolean shouldEnable = false; // 驗(yàn)證當(dāng)前環(huán)境是否支持輸入法調(diào)用 if (toolkit instanceof InputMethodSupport) { shouldEnable = ((InputMethodSupport) toolkit) .enableInputMethodsForTextComponent(); } enableInputMethods(shouldEnable); } catch (Exception e) { } } /** * 重載Component的輸入法調(diào)用接口，因?yàn)榇祟?lèi)為InputMethodRequests的實(shí)現(xiàn)，所以返回this即可。 */ public InputMethodRequests getInputMethodRequests() { return this; } /** * 調(diào)正當(dāng)前顯示的字體大小 * * @param size */ public void setFontSize(int size) { setFont(new Font("Dialog", Font.PLAIN, size)); textOrigin.x = 5; textOrigin.y = (textOffset + size); if (composedTextString != null) { composedTextString.addAttribute(TextAttribute.FONT, getFont()); } } /** * 返回用于顯示的輸入信息集 * * @return */ public AttributedCharacterIterator getDisplayText() { if (composedText == null) { return getDisplayTextToAttributedCharacterIterator(); } else { return EMPTY_TEXT; } } /** * 返回當(dāng)前插入符所在位置 * * @return */ public TextHitInfo getCaret() { if (composedText == null) { return TextHitInfo.trailing(messageText.length() - 1); } else if (caret == null) { return null; } else { return caret.getOffsetHit(getCommittedTextLength()); } } /** * 觸發(fā)輸入法變更事件 */ public void inputMethodTextChanged(InputMethodEvent e) { int committedCharacterCount = e.getCommittedCharacterCount(); AttributedCharacterIterator text = e.getText(); composedText = null; char c; if (text != null) { // 需要復(fù)制的字符長(zhǎng)度 int toCopy = committedCharacterCount; c = text.first(); while (toCopy-- > 0) { insertCharacter(c); c = text.next(); } if (text.getEndIndex() - (text.getBeginIndex() + committedCharacterCount) > 0) { composedTextString = new AttributedString(text, text .getBeginIndex() + committedCharacterCount, text.getEndIndex(), IM_ATTRIBUTES); composedTextString.addAttribute(TextAttribute.FONT, getFont()); composedText = composedTextString.getIterator(); } } e.consume(); invalidateTextLayout(); caret = e.getCaret(); repaint(); } /** * 修改插入符所在位置 */ public void caretPositionChanged(InputMethodEvent event) { caret = event.getCaret(); event.consume(); repaint(); } /** * 獲得指定定位符對(duì)應(yīng)的文本顯示位置 */ public Rectangle getTextLocation(TextHitInfo offset) { Rectangle rectangle; if (offset == null) { rectangle = getCaretRectangle(); } else { TextHitInfo globalOffset = offset .getOffsetHit(getCommittedTextLength()); rectangle = getCaretRectangle(globalOffset); } Point location = getLocationOnScreen(); rectangle.translate(location.x, location.y); return rectangle; } /** * 獲得偏移指定坐標(biāo)的插入符信息 */ public TextHitInfo getLocationOffset(int x, int y) { Point location = getLocationOnScreen(); Point textOrigin = getTextOrigin(); x -= location.x + textOrigin.x; y -= location.y + textOrigin.y; TextLayout textLayout = getTextLayout(); if (textLayout != null && textLayout.getBounds().contains(x, y)) { return textLayout.hitTestChar(x, y).getOffsetHit( -getCommittedTextLength()); } else { return null; } } public int getInsertPositionOffset() { return getCommittedTextLength(); } /** * 返回指定范圍內(nèi)的字符信息迭代器 */ public AttributedCharacterIterator getCommittedText(int beginIndex, int endIndex, Attribute[] attributes) { return getMessageText(beginIndex, endIndex); } public AttributedCharacterIterator cancelLatestCommittedText( Attribute[] attributes) { return null; } public AttributedCharacterIterator getSelectedText(Attribute[] attributes) { return EMPTY_TEXT; } public synchronized void update(Graphics g) { paint(g); } /** * 繪制目標(biāo)界面 */ public synchronized void paint(Graphics g) { g.setColor(getBackground()); Dimension size = getSize(); g.fillRect(0, 0, size.width, size.height); g.setColor(Color.black); g.drawRect(0, 0, size.width - 1, size.height - 1); if (haveFocus) { g.drawRect(1, 1, size.width - 3, size.height - 3); } g.setColor(getForeground()); TextLayout textLayout = getTextLayout(); if (textLayout != null) { textLayout.draw((Graphics2D) g, textOrigin.x, textOrigin.y); } Rectangle rectangle = getCaretRectangle(); if (haveFocus && rectangle != null) { g.setXORMode(getBackground()); g.fillRect(rectangle.x, rectangle.y, 1, rectangle.height); g.setPaintMode(); } } /** * 將messageText轉(zhuǎn)化為指定范圍內(nèi)的字符信息迭代器 * * @param beginIndex * @param endIndex * @return */ public AttributedCharacterIterator getMessageText(int beginIndex, int endIndex) { AttributedString string = new AttributedString(messageText.toString()); return string.getIterator(null, beginIndex, endIndex); } /** * 返回已輸入的字符串信息長(zhǎng)度 */ public int getCommittedTextLength() { return messageText.length(); } public AttributedCharacterIterator getDisplayTextToAttributedCharacterIterator() { AttributedString string = new AttributedString(messageText.toString()); if (messageText.length() > 0) { string.addAttribute(TextAttribute.FONT, getFont()); } return string.getIterator(); } /** * 返回當(dāng)前文本布局器 * * @return */ public synchronized TextLayout getTextLayout() { if (!validTextLayout) { textLayout = null; AttributedCharacterIterator text = getDisplayText(); if (text.getEndIndex() > text.getBeginIndex()) { FontRenderContext context = ((Graphics2D) getGraphics()) .getFontRenderContext(); textLayout = new TextLayout(text, context); } } validTextLayout = true; return textLayout; } /** * 強(qiáng)制文本布局器驗(yàn)證無(wú)效化 * */ public synchronized void invalidateTextLayout() { validTextLayout = false; } /** * 返回文本繪制點(diǎn) * * @return */ public Point getTextOrigin() { return textOrigin; } /** * 返回對(duì)應(yīng)插入點(diǎn)的矩形選框 * * @return */ public Rectangle getCaretRectangle() { TextHitInfo caret = getCaret(); if (caret == null) { return null; } return getCaretRectangle(caret); } /** * 返回對(duì)應(yīng)插入點(diǎn)的矩形選框 * * @param caret * @return */ public Rectangle getCaretRectangle(TextHitInfo caret) { TextLayout textLayout = getTextLayout(); int caretLocation; if (textLayout != null) { caretLocation = Math.round(textLayout.getCaretInfo(caret)[0]); } else { caretLocation = 0; } FontMetrics metrics = getGraphics().getFontMetrics(); return new Rectangle(textOrigin.x + caretLocation, textOrigin.y - metrics.getAscent(), 0, metrics.getAscent() + metrics.getDescent()); } /** * 插入指定字符串 * * @param c */ public void insertCharacter(char c) { messageText.append(c); invalidateTextLayout(); } /** * 用戶(hù)輸入 */ public void keyTyped(KeyEvent event) { char keyChar = event.getKeyChar(); // 處理文字刪除 if (keyChar == '/b') { int len = messageText.length(); if (len > 0) { messageText.setLength(len - 1); invalidateTextLayout(); } } else { insertCharacter(keyChar); } event.consume(); repaint(); } public void keyPressed(KeyEvent event) { } public void keyReleased(KeyEvent event) { } public void focusGained(FocusEvent event) { haveFocus = true; repaint(); } public void focusLost(FocusEvent event) { haveFocus = false; repaint(); } public static void main(String[] args) { Frame frame = new Frame("繪制一個(gè)輸入框"); TextCanvas text = new TextCanvas(); frame.add(text); frame.addWindowListener(new WindowAdapter() { public void windowClosing(WindowEvent e) { System.exit(0); } }); frame.pack(); frame.setSize(300, 300); frame.setLocationRelativeTo(null); frame.setVisible(true); } }

運(yùn)行效果如下圖：

怎么樣？這時(shí)你在TextCanvas中進(jìn)行輸入操作，是不是與JTextField或TextField里相差無(wú)幾呢？——什么？你說(shuō)就算“重復(fù)發(fā)明輪子”也應(yīng)該有個(gè)限度，已經(jīng)有JTextField與TextField了，你再寫(xiě)一個(gè)有什么用？

嗯，您很聰明，單純的繪制文本框確實(shí)沒(méi)有任何意義，但是，如果有一系列直接通過(guò)AWT繪制的組件與其相呼應(yīng)呢？——比如，偶在LGame-Simple中制作的那一系列UI組件……

那么事情，就會(huì)變成如下這個(gè)樣子。

怎么樣呢？如上圖所示，這是一個(gè)純繪制的界面，無(wú)論文本框的字體，大小，顏色乃至透明度，貼圖都可以隨性切換（甚至逆天的將兩個(gè)文本框疊在一起也可以）， 而這樣一個(gè)純繪制出的文本框能夠獲得輸入法支持，意味著什么呢？這意味著，一個(gè)相對(duì)于Swing能耗更少，效率更高的類(lèi)Swing體系已經(jīng)搭建成型了！(當(dāng)然，相對(duì)的功能也更少，不過(guò)事無(wú)兩利嘛……)

PS:如上所述，LGame-Simple-0.2.5版Text系組件將獲得輸入法支持，中文或其它語(yǔ)言的輸入已經(jīng)沒(méi)有任何問(wèn)題。（此版預(yù)計(jì)同Android版LGame一道于12月中下旬發(fā)布……不過(guò)，那是理想狀態(tài)，事實(shí)上偶欠著的事情挺多，盡力看看……）

嗯，其實(shí)PS中的話才是最主要的……

讓繪制的Java文本框響應(yīng)輸入法事件