このドキュメントには、すべての1.4.*リリースに関連する情報が含まれています。1.4.1および1.4.2に固有の情報については、Java 2 SDK, Standard Edition, v 1.4からのSwingの変更点を参照してください。
Swingに大きな影響を与えるような各機能については、通常、個別のドキュメントに分けて説明します。次のリンクをクリックして、それぞれのドキュメントを参照してください。
JTabbedPane
JSpinner
JFormattedTextField
Popup
およびPopupFactory
各セクションで、関連する一連のクラスの変更点について説明します。ほとんどのセクションでは、JEditorPane
やJTable
など、Swingの単一コンポーネントの一部であるクラスに焦点が当てられています。各APIの変更は、バグ・データベースにあるレポートへのリンクと関連付けられています。このサイトで、変更の理由となったバグやRFE (機能拡張の要求)を参照することができます。このドキュメントには、各APIの変更についての次の情報も含まれています。
Box
JButton
JComboBox
JFileChooser
JInternalFrame
JList
JOptionPane
JPopupMenu
JPanel
JRootPane
JScrollBar
JScrollPane
JTabbedPane
JTable
JTextComponent
JTree
RepaintManager
SpringLayout
この変更に関連するバグ追跡レポート: 4304100。
従来、Box
のスーパー・クラスはComponent
でした。Box
は、JComponent
から派生しなかったので、たとえば、ボーダーを設定したり、revalidate
を発行するなどで、通常のSwingコンポーネントのように使用できませんでした。これにかぎらず、視覚的な変更やその他の同様な視覚上のプロパティの変更でも、標準的なSwingコンポーネントは通常、repaint
またはrevalidate
を使用して変更しますが、Box
はこの動作に適合しませんでした。このリリースから、Box
およびBox.Filler
がJComponent
スーパー・クラスから派生するので、標準Swingコンポーネントにより近い動作をします。
この変更に関連するバグ追跡レポート: 4140833。
BoxLayout
では、レイアウトするContainer
のComponentOrientation
が考慮されませんでした。他のAWTレイアウト・マネージャは、JDK 1.2にComponentOrientation
機能が追加されたときに、コンポーネントの向きを考慮するように作成されました。この機能をBoxLayout
に追加すると、中東ロケールをサポートするプログラムで役に立ちます。BoxLayout
は、JOptionPane
、JToolBar
、JMenuBar
などの、その他のSwingコンポーネントにも内部的に使用されます。この機能を追加することは、このようなコンポーネントがComponentOrientation
をサポートするためにも必要です。
この機能をサポートするために、定数のLINE_AXIS
とPAGE_AXIS
、およびBoxLayout(Container, int)
コンストラクタがBoxLayout
に追加されました。
さらに、SizeRequirements
内のメソッドも変更されました。
calculateTiledPositions(int,SizeRequirements,SizeRequirements[],int[],int[],boolean)
calculateTiledPositions(int,SizeRequirements,SizeRequirements[],int[],int[])
calculateAlignedPositions(int,SizeRequirements,SizeRequirements[],int[],int[],boolean)
calculateAlignedPositions(int,SizeRequirements,SizeRequirements[],int[],int[])
この変更に関連するバグ追跡レポート: 4659800。
1.4.0で発生していたこのバグのため、デフォルト・ボタンは常にフォーカスに従うわけではありませんでした。これは1.4.1で修正されました。
この変更に関連するバグ追跡レポート: 4138746。
AbstractButton
とJLabel
の両方を使用することで、あるアクションを実行するためにキーボードから入力する文字(ニーモニック)を設定できます。javadocではこれらのメソッドについて、設定した文字が最初に出現したときに大文字小文字にとらわれず強調されると説明しています。この機能はほとんどの開発者に適合しますが、同じ文字がまた出現した場合にそれも強調表示する必要がある場合も、かなりの程度あります。たとえば、「メモ帳」内では、「a」が「名前をつけて保存(Save As)」のアクセラレータですが、2番目の「a」が強調される文字です。開発者には、これを指定できる方法が必要です。
この問題は、新規メソッドのAbstractButton.setDisplayedMnemonicIndex
および JLabel.setDisplayedMnemonicIndex
で解決できます。setMnemonic
またはsetDisplayedMnemonic
メソッドでニーモニックを指定すると、setDisplayedMnemonicIndex
メソッドで、強調表示される文字を変更できます。また、新しいAbstractButton.getDisplayedMnemonicIndex
およびJLabel.getDisplayedMnemonicIndex
メソッドもあります。さらに、drawStringUnderlineCharAt
が javax.swing.plaf.basic.BasicGraphicsUtils
に追加されました。
この変更に関連するバグ追跡レポート: 4457940。
これまで、AbstractButton
のconfigurePropertiesFromAction(Action)
メソッドおよびconfigurePropertiesFromAction(Action, String[])
メソッドでは、ACTION_COMMAND_KEY
プロパティが尊重されませんでした。このリリースでは、この点が対処されました。そのため、次に示すAbstractButton
のサブクラスで、configurePropertiesFromAction
メソッドのjavadocが変更されました。
JButton.configurePropertiesFromAction(Action)
JMenu.configurePropertiesFromAction(Action)
JCheckBox.configurePropertiesFromAction(Action)
JRadioButton.configurePropertiesFromAction(Action)
この変更に関連するバグ追跡レポート: 4287690。
コンボボックスのドロップ・ダウン・メニューがポップアップされたり、元に戻されたり、取り消されたりするときにリスナーに通知される機能のサポートを、多くの開発者が求めていました。アプリケーションでは、このようなリスナーを使用して、コンボボックスのモデルを各項目とともに生成することができました。
この機能は、ルック・アンド・フィールの実装のいくつかで提供されない可能性のあるドロップ・ダウン・メニュー機能用にリスナーをサポートすることについて、なんらかの、おそらくはアカデミックな懸念があったために、初期バージョンのSwingには提供されませんでした。しかし、Javaとともに出荷されるすべてのルック・アンド・フィールと、ほかのすべてのルック・アンド・フィールでも、コンボボックスのすべての項目を表示するためにドロップ・ダウン・メニューが使用されています。そのため、メニュー状態の変更通知を取得するために、移植性のないハックに頼る開発者もいました。
このリリースでは、PopupMenuListener
がJComboBox
に追加されました。基盤となるルック・アンド・フィールが項目メニューをサポートしているかぎり、このリスナーを使用して、コンボボックスのメニューが表示される前後にアクションを実行できます。この機能をサポートするには、JComboBox
の以下の新規メソッドが必要です。
public void addPopupMenuListener(PopupMenuListener l) public void removePopupMenuListener(PopupMenuListener l) public void firePopupMenuWillBecomeVisible() public void firePopupMenuWillBecomeInvisible() public void firePopupMenuCanceled()
この変更に関連するバグ追跡レポート: 4231298。
これまでJComboBox
は、表示する各項目のレンダラを構成していました。リストが大きい場合、この構成方法は時間がかかります。開発者がかわりに必要としていたのは、すべてのセルに一致するプロトタイプを指定し、そのプロトタイプだけが各セルのかわりに1回だけチェックされるような機能でした。このリリースでは、 getPrototypeDisplayValue
と setPrototypeDisplayValue
がJComboBox
に追加されました。
この変更に対応するバグ追跡レポートは、4394300です。
これまで、JComboBox
のpublic APIとそのUI委譲には、その実装方法を詳細に説明したjavadocが含まれていました。ただし、時間の経過とともに機能の再考とバグの修正を経て、このjavadocは時代遅れとなりました。実装の詳細ではなくメソッドの動作を説明するように、javadocのチェックと改訂が行われました。また、実際には非公開であるはずの「protected」メソッドやフィールドに関しては、このようなメソッドのオーバーライドや呼出しを奨励しないように、javadocがいくつか削除されました。
そのため、JComboBox
、ComboBoxModel
、MutableComboBoxModel
、javax.swing.plaf.basic.BasicComboBoxUI
、javax.swing.plaf.basic.ComboPopup
、およびjavax.swing.plaf.basic.BasicComboPopup
のドキュメントが変更されました。
この変更に対応するバグ追跡レポートは、4290709です。
SwingのJFileChooser
は、Windowsルック・アンド・フィールに基づいたMicrosoft Windowsの一般的なファイルのダイアログ・ボックスと似ていますが、多少の欠如部分があり、ご不満を頂いていました。特に、Microsoft Windowsの外観ガイドには、次のような記述があります。
通常の「開く」および「名前を付けて保存」ダイアログ・ボックスが使用できない場合は、自分で作成するダイアログ・ボックスに次の機能を組み込んで、シェル、Windowsアクセサリ、およびその他のアプリケーションと確実に一貫性を保つようにしてください。
上の箇条書きの最初の4項目をSwing内で実現するには、AWTからの追加のAPIサポートが必要です。AWT共通ファイル・ダイアログも、現在では、次の理由で受け入れ難い解決方法になりました。
新しい機能が、次のpublicメソッドをjavax.swing.filechooser.FileSystemView
クラスに追加することで実行されます。このクラスによって、File
クラスの適用範囲を超えて、ファイルとディレクトリの情報が提供されます。
public boolean isTraversable(File f) public String getSystemDisplayName(File f) public String getSystemTypeDescription public Icon getSystemIcon(File f) public boolean isParent(File folder, File file) public File getChild(File parent, String filename) public boolean isFileSystem(File f) public boolean isFileSystemRoot(File dir) public boolean isDrive(File dir) public boolean isFloppyDrive(File dir) public boolean isComputerNode(File dir) public File createFileSystemRoot(File f) public File[] getRoots()
isTraversable
メソッドがjavax.swing.plaf.basic.BasicFileChooserUI.BasicFileView
から削除されたので、そのスーパー・クラスの実装が使用されます。
createListSelectionListener
が javax.swing.plaf.metal.MetalFileChooserUI
に追加されました。
また、 javax.swing.plaf.basic.BasicDirectoryModel
には、次の変更があります。
public void intervalAdded(ListDataEvent e) public void intervalRemoved(ListDataEvent e) public void renameFile(File oldFile, File newFile)
この変更に対応するバグ追跡レポートは、4318785です。
ルック・アンド・フィールでは、JFileChooser
内でディレクトリを開くために使用するボタンのテキスト、ツールチップのテキスト、およびニーモニックを指定する機能が必要です。
この機能をサポートするために、次の定数とメソッドが plaf.basic.BasicFileChooserUI
に追加されました。
protected int directoryOpenButtonMnemonic = 0; protected String directoryOpenButtonText = null protected String directoryOpenButtonToolTipText = null protected boolean isDirectorySelected() protected void setDirectorySelected(boolean b) protected File getDirectory() protected void setDirectory(File f)
この変更に対応するバグ追跡レポートは、4218431です。
1.4リリースのJFileChooser
で複数のファイルを選択できるようになりました。ただし、setMultiSelectionEnabled
のjavadocは1.4.1リリースまで更新されていません。
この変更に対応するバグ追跡レポートは、4134077です。
以前は、内部フレームのタイトルが長すぎる場合でも、クリップされませんでした。また、タイトルがアイコン部分の上に重ねて表示され、タイトルがクリップされたことをユーザーが視覚的に検討できませんでした。この問題を解決するために、BasicInternalFrameTitlePane.getTitle
が追加されました。
この変更に関連するバグ追跡レポート: 4389209。
これを正しく実装するには、com.sun.java.swing.plaf.windows.WindowsInternalFrameTitlePane
クラスを作成する必要がありました。このクラスはjavax.swing.plaf.basic.BasicInternalFrameTitlePane
の拡張ですが、適切な場合にグラデーションを描画するために、ペイント・ルーチンがオーバーライドされています。従来のコードを再利用するもっとも適切な方法は、バックグラウンドだけをペイントする部分をペイント・メソッドから分離し、WindowsInternalFrameTitlePane
内でその部分をオーバーライドすることです。paintTitleBackground
メソッドがjavax.swing.plaf.basic.BasicInternalFrameTitlePane
に追加されました。
この変更に関連するバグ追跡レポート: 4252169。
以前のリリースでは、ImageView
(JEditorPane
内でイメージを描画するView
)がツールチップのテキストを表示することはできませんでした。View
には、JTextComponent
のために表示されるツールチップ・テキストに影響を与える手段がなかったためです。今回のリリースでは、JTextComponent
にツールチップがない場合に、マウスの下のビューがツールチップを表示するように要求されます。そのView
がALT属性のあるHTML要素に対応付けられている場合、ツールチップのテキストは、その属性の値になります。
View
がツールチップのテキストに影響を及ぼすことができるようにするには、多数のメソッドが必要でした。getToolTipText
がjavax.swing.plaf.TextUI
に追加されたので、特定の位置のツールチップのテキストを取得できるようになりました。これで、JTextComponent
のgetToolTipText
メソッドは、ツールチップがJTextComponent
に設定されていないとみなし、TextUI
にツールチップを転送します。
また、getToolTipText
がjavax.swing.text.View
に追加されました。View.getToolTipText
のデフォルトの実装では、要求が指定された位置にあるView
の子に転送されます。特定の位置にある子を簡単に判断できるように、getViewIndex
がView
に追加されました。
View
の実装では、getViewIndex
が呼び出され、次に子のView
でgetToolTipText
が呼び出されます。次にImageView
によってgetToolTipText
がオーバーライドされ、そのAttributeSet
のALT属性から値が返されます。
この変更に関連するバグ追跡レポート: 4233811。
パッケージの非公開クラスであったjavax.swing.text.html.ImageView
が公開されたので、このクラスを拡張することができるようになりました。
この変更に関連するバグ追跡レポート: 4182124。
HTMLパッケージでは、マウスがリンク上を移動したことをHyperlinkEvent
およびHyperlinkListener
クラス経由で検出する方法が、開発者に公開されました。開発者にとっては、HyperlinkListener
に通知されたときにドキュメントから情報を抽出する方法が必要な場合もあります。従来は、HyperlinkEvent
が示すドキュメント内の位置を、開発者が判断する方法がありませんでした。この問題を改善するために、HyperlinkEvent(Object, EventType, URL, String, Element)
コンストラクタとgetSourceElement
メソッドがHyperlinkEvent
に追加されました。
HTMLFrameHyperlinkEvent
によってHyperlinkEvent
が拡張され、これはすでにgetSourceElement
メソッドを定義しています。現在ではスーパー・クラスでこのメソッドを定義するため、getSourceElement
のjavadocは、HTMLFrameHyperlinkEvent
から削除されました(メソッド自体は継承されている)。
この変更に関連するバグ追跡レポート: 4241788。
HTMLパーサー(javax.swing.text.html.parser.Parser
)のセマンティックスが、NetscapeやInternet Explorerなどのブラウザにより良く適合するように若干変更されました。APIに変更はありませんが、空白の報告で多少の変更があります。どのように変更されたかを示します。strict
(javax.swing.text.html.parser.Parser
のインスタンス変数)== false
(デフォルト)の場合は、NetscapeとExplorerの動作を模倣するために、インスタンス変数が使用されます。
次に、問題のあるシナリオを示します。
'<b>blah <i> <strike> foo'
これは、次のように処理される可能性があります。
'<b>blah <i><strike>foo'
同様に、
'<p><a href="xx"> <em>Using</em></a></p>'
これは、次のように処理される可能性があります。
'<p><a href="xx"><em>Using</em></a></p>'
タグがフローを分断したり末尾の空白が検出されると、インスタンス変数はtrueに設定されます。そのため、すべての空白が無視されます。最初に空白以外の文字があったときに、インスタンス変数はfalseに設定し直されます。
この変更に関連するバグ追跡レポート: 4200439。
JDKで提供されたHTMLサポートでは、フォームの各要素の書込みが正しくサポートされませんでした。この原因の大部分は、フォームのモデル化の方法にありました。ドキュメント・オブジェクトのモデル(www.w3.orgのDOMを参照)に一層一致させるために、フォームが内部的にモデル化される方法が変更されました。以前は、フォームのすべての属性が、子の文字要素すべてのattributeSet
に格納されました。このリリースから、HTMLファイル自体に一層一致するように、フォームを表す要素が作成されます。この方法により、フォームがより良くモデル化される上に、フォームを一貫して書出せるようになります。
この変更は、厳密でないフォームの処理に依存していた開発者にとっては影響があります。たとえば、次のような無効なHTMLを処理するとします。
<table> <form> </table> </form>
これまでは、次のようにみなされていました。
<form> <table> </table> </form>
このリリースでは、代わりに次のように処理されます。
<table> <form> </form> </table>
javax.swing.text.DefaultHighlighter
クラス内の静的なDefaultPainterがFinal
になったこの変更に関連するバグ追跡レポート: 4328938。
このリリース以前は、javax.swing.text.DefaultHighlighter
のstaticフィールドDefaultPainter
はfinalではありませんでした。これには、潜在的にセキュリティ上の問題がありました。このリリースでは、これがFinal
になりました。
この変更に関連するバグ追跡レポート: 4220001。
このリリース以前は、PlainDocument(AbstractDocument.Content)
コンストラクタは保護されていました。つまり、このコンストラクタを使用しようとする開発者はサブクラス化する必要がありました。このコンストラクタはもともと公開する予定で作成され、このリリースで公開されました。
この変更に関連するバグ追跡レポート: 4304676。
JEditorPane.scrollToReference
は、不適切な理由で保護されていました。このメソッドはサブクラス化しなくても役に立つことを目的に作成されており、このリリースで公開されました。
この変更に関連するバグ追跡レポート: 4156650。
テキスト・ドキュメントの内容に効率的にアクセスするには、Document
でgetText(int, int, Segment)
メソッドを定義します。残念なことに、呼出し側には、受け手側が要求を効率的に満たすかどうかを判断する手段がありませんでした。たとえばGapContent
は、要求がドキュメントの最後に編集されたスポット(ギャップ)を超えないかぎり、要求を効率的に実装できました。内容への効率的なアクセスを促進するために、setPartialReturn
および isPartialReturn
メソッドがSegment
に追加されました。Document.getText
のセマンティックスが現在のところ保持されていますが、より効率的に使用するために、呼出し側がsegment.setPartialReturn(true)
を呼び出して、いつでもドキュメントの一部を取得し直す準備をしておく必要があります。
この変更に関連するバグ追跡レポート: 4303259。
障害を持つ方々へのユーザー補助機能(または技術)では、Accessibility APIを使用してJEditorPane
の内容にプログラムでアクセスすることが要求されます。以前のリリースでの唯一のアクセスは、ハイパーリンク・テキストへのアクセスでした。このAPIの変更によって、Accessibility APIを使用してすべてのHTMLコンポーネントにアクセスできるようになりました。
javax.swing.text.html.HTMLEditorKit
は、javax.accessibility.Accessible
を実装するようになりました。
JEditorPane
は、 getAccessibleContext()
を実装するようになりました。
この変更に関連するバグ追跡レポート: 4458513。
RFE 4431047の一部として、replace
メソッドがAbstractDocument
に追加されました。このメソッドからremove
およびinsertString
(Document
を変更するためのインタフェースに定義されているメソッドはこの2つのみ)を呼び出すことができるように、 writeLock
を呼び出すための制約が緩和されました。このため、replace
メソッドは、remove
とinsertString
をオーバーライドするだけの、古いバージョンのAbstractDocument
とも互換性があります。
この変更に関連するバグ追跡レポート: 4226644。
この前のリリースでは、デフォルトの文字列付きのテキスト・フィールドを含んだ単純な入力ダイアログ・ボックスを表示しようとする場合、7個のパラメータが必要な、複雑なJOptionPane.showInputDialog
メソッドを呼び出す必要がありました。新しい2つのshowInputDialog(Object, Object)
およびshowInputDialog(Component, Object, Object)
メソッドでは、単純な入力ダイアログ・ボックスの作成と表示がより便利になりました。
この変更に関連するバグ追跡レポート: 4265463。
JOptionPane
では、右から左の方向のレイアウトが必要でした。この変更はバグの修正であり実際のAPIは必要ありませんが、JOptionPane
およびjavax.swing.plaf.basic.BasicOptionPane
のクラス仕様が更新されました。
この変更に関連するバグ追跡レポート: 4829588。
リリース1.4.0から、サイズ変更できないダイアログを使用するためにJOptionPane
が変更されました。その結果、多くのJOptionPane
メソッドによって表示されるダイアログが多少変化するようになりました。最初の2つの変更が必要です。
このリリースから、JPopupMenu
を表示すると親のJRootPane
にフォーカスが移動するようになりました。この変更は、JPopupMenu
でキーボード・トラバーサルをサポートするために行われました(4212563)。これにより、フォーカスを失ったかどうかを検証するアプリケーションで問題が発生します。このことにより影響を受ける場合は、focusLost
通知でFocusEvent
の一時的なプロパティをチェックし、true
の場合は何も行わない、とすることをお薦めします。JPopupMenu
にフォーカスが移動することが望ましくない場合、現在のリリースではこの移動を無効にすることができません。リリース1.4.1では、フォーカスを移動するかどうかの決定は、JPopupMenu
のフォーカス可能性に基づいています。詳細は、バグ4632782を参照してください。
この変更に関連するバグ追跡レポート: 4212563。
以前は、JPopupMenu
でキー・バインドはサポートされませんでした。矢印キー、ニーモニック、Enterキー、およびEscキーは、JPopupMenuがJMenu
やJComboBox
のような複合コンポーネントの一部として使用されないかぎり、JPopupMenu
には作用しませんでした。
この動作は、JPopupMenu
には常にフォーカスが当てられず、そのためKeyEvents
を取得することができないことに原因があります。以前のリリースでは、Swingのような軽量のツールキットがフォーカスを要求し、フォーカスの変更が一時的であることを示すことは不可能でした。新しいフォーカスのアーキテクチャによってこの問題が解決され、Swingで一時的なフォーカスの変更を要求できるようになりました。このバグを修正するには、JPopupMenu
にフォーカスを取得させ、キー・バインドが処理されるようにする必要がありました。フォーカスが変更されることを今まで期待していなかったコンシューマは、コードを更新して、FocusEvent
の一時的なプロパティをチェックする必要があります。
この変更に関連するバグ追跡レポート: 4401222。
ヘッドレス・モードが新規に導入された際、 JPopupMenu.setVisible(true)
はヘッドレス・モードで呼び出されるとNullPointerException
をスローするように実装されました。このリリースからはHeadlessException
をスローするように変更され、ヘッドレス・モードでは実行できない操作であることを示すようになりました。
この変更に関連するバグ追跡レポート: 4226238。
setUI
/getUI
メソッドは、そのルック・アンド・フィールがプラガブルなルック・アンド・フィール (plaf)で定義される場合でも、JPanel
に実装されていませんでした。たとえば、javax.swing.plaf.basic.BasicPanelUI.java
を参照してください。
新しいフォーカスの仕様では、表示されていないコンポーネントでのフォーカス要求は失敗します。これにより、多少の副作用が発生します。1つの副作用として、JTabbedPane
に関連付けられているChangeListener
からのフォーカス要求が失敗する可能性があります。また、コンポーネントが現在表示されていないため、以前のリリースではフォーカス要求が機能していた状況でフォーカス要求が失敗することがChangeListener
に通知されます。JTabbedPane
でこの状況が発生した場合は、フォーカスを要求する前にコンポーネントを表示することをお薦めします。その他の状況では、異なる方法が必要となる場合があります。
この変更に関連するバグ追跡レポート: 4241787。
この変更以前は、クライアント・プログラムに、座標で示す位置をタブ付きペイン内の特定のタブへ変換する方法がありませんでした。このため、JTabbedPane
でタブの上へメニューをポップアップさせるなどの特殊なイベント処理を実装することが困難でした。
indexAtLocationメソッドがJTabbedPane
に追加されました。
この変更に関連するバグ追跡レポート: 4284674。
JTabbedPane
の各ペインでは、以前はニーモニックが使用できませんでした。この問題の解決のために、getDisplayedMnemonicIndexAt
およびsetDisplayedMnemonicIndexAt
が追加されました。
この変更に関連するバグ追跡レポート: 4287053。
JTabbedPane
クラスは、多くのメソッドを保有するコンテナであり、パラメータとして整数のインデックスをとります。これらのメソッドには、残念なことに例外のスローに一貫性がありませんでした(チェック/スローするメソッドもあれば、しないメソッドもある)。さらに、javadocにも誤りがあり、基盤となるVector
によって実際にはArrayIndexOutOfBoundsException
がスローされる場合に、IllegalParameterException
がスローされると記述されていました。
0から「タブ数 - 1」までの有効な範囲内になければならないインデックスをとるすべてのメソッドは、現在は、IndexOutOfBoundsException
をスローすると記述されています(注 - 互換性をとるという理由から、基盤のコードでは引き続きArrayIndexOutOfBoundsException
がスローされる)。
ドキュメントが次のように変更されました。
* @exception IndexOutOfBoundsException if index is out of range * (index < 0 || index >= tab count)これは、次の
JTabbedPane
メソッドに適用されます。
public String getTitleAt(int index) public Icon getIconAt(int index) public Icon getDisabledIconAt(int index) public String getToolTipTextAt(int index) public Color getBackgroundAt(int index) public Color getForegroundAt(int index) public boolean isEnabledAt(int index) public Component getComponentAt(int index) public int getDisplayedMnemonicIndexAt(int index) public Rectangle getBoundsAt(int index) public void setTitleAt(int index, String title) public void setIconAt(int index, Icon icon) public void setDisabledIconAt(int index, Icon icon) public void setToolTipTextAt(int index, String toolTipText) public void setForegroundAt(int index, Color foreground) public void setBackgroundAt(int index, Color background) public void setEnabledAt(int index, boolean enabled) public void setComponentAt(int index, Component component) public void setDisplayedMnemonicIndexAt(int tabIndex, int mnemonicIndex)
同じ例外処理が、以前は何も実行しなかった次のメソッドに追加されました。
public void setSelectedIndex(int index) public void remove(int index)
この変更に関連するバグ追跡レポート: 4144295。
JDK 1.3では、DefaultTableModel
のmoveRow
メソッドが明快に説明されていませんでした。つまり、startIndex
の行またはendIndex
の行がtoIndex
で終了するかどうかがはっきり定義されていませんでした。例から類推すると、行を下方に移動するときはstartIndex
がtoIndex
で終了し、行を上方へ移動するときはendIndex
がtoIndex
で終了することが明白です。
つまり、moveRow
の実装にはバグがあります。移動する行が複数になると、行の移動終了の位置は不定であり、移動の後に行が連続しないことさえあります。バグ4144295には、実装が仕様にある例さえも正しく実行しないとあります。実際、moveRow(1, 3, 5)
の例は、次の状態でベクトルを残します。
a|C|e|B|D|f|g|h|i|j|k新しい実装では、この操作は入力から計算できる境界間の要素の単純なローテーションであるとみなします。
以前の実装が作用しなかったため、これまでの定義を単純化する機会が与えられました。startIndex
は常にtoIndex
に移動し、toIndex
以降のすべての要素は元のままの順序に並ぶと定義されました。この定義により、単一行の移動という、前の実装で唯一正しく作用した例と同じ操作が実行されます。
新しい実装では、endIndex
がstartIndex
より小さい場合に例外はスローされません。その代わり、すべての行r
を移動する暗黙の規約、つまりstartIndex <= r <= endIndex
が満たされても、何も実行されません。
この変更に関連するバグ追跡レポート: 4274963。
Excelアプリケーションでは、ユーザーが英数字キーを押すと、フォーカスが自動的に基盤エディタに移動します。これと同じ動作をJTable
内でも実装してほしいという、200を超えるJDC要求がありました。下位互換性を考慮するという理由からデフォルトの動作を変更することはできませんが、この要求に対処するために、このリリースで新しいsurrendersFocusOnKeystroke
プロパティを追加しました。新規メソッドのsetSurrendersFocusOnKeystroke
およびgetSurrendersFocusOnKeystrok
で、この機能がサポートされます。デフォルトの動作は変更されていません。
この変更に関連するバグ追跡レポート: 4474094。
これまで、DefaultTableModel.addColumn(Object)
メソッドとDefaultTableModel.addColumn(Object, Vector)
メソッドでは、name
引数にnull
を指定することはできず、IllegalArgumentException
がスローされていました。コンストラクタを使用したり、フィールドを直接操作したりする方法では列名にnull
を設定できるため、addColumn
メソッドでもnull
値を指定できるように変更されました。
この変更に関連するバグ追跡レポート: 4264897。
DefaultTreeModel
では、null
のルート・ノードが使用できるようになりました。以前、TreeModel
のjavadocには、null
のルートは有効であるが、DefaultTreeModel
では許可されないと指定されていました。DefaultTreeModel
では現在、null
のルートが、コンストラクタ内のnull
のルートと同様に設定可能です。setRoot
のjavadocは、この変更を反映して改訂されました。
この変更に関連するバグ追跡レポート: 4284709。
ユーザーにとっては、JTree
内で英数字キーを使用してセルをナビゲートしたい場合がしばしば発生します。そのため、getNextMatch
メソッドがJTree
に追加されました。BasicTreeUI
によって、キーボードでキーが入力されたときにこのメソッドを呼び出すKeyListener
がインストールされます。
この変更に関連するバグ追跡レポート: 4134085。
開発者はしばしば、有用なデバッグ情報を求めてtoString
を使用します。ただしこれまでは、ListDataEvent
の toString
メソッドでは、真に有用な情報が提供されませんでした。このリリースで、有用な情報を返すように変更されました。
この変更に関連するバグ追跡レポート: 4284709。
ユーザーにとっては、JList
内で英数字キーを使用してセルをナビゲートしたい場合がしばしば発生します。このため、getNextMatch
がJList
に追加されました。BasicListUI
によって、選択範囲を変更するためにキーが入力されたときにこのメソッドを呼び出すKeyListener
がインストールされます。
この変更に関連するバグ追跡レポート: 4460016。
これまでJList
では、次のように、セルを垂直にしかレイアウトできませんでした。
1 2 3 4
多くのユーザーが、次に示すように、リストを水平にレイアウトできる機能を求めていました。
1 3 2 4または
1 2 3 4
この機能を実現するために、VERTICAL
、VERTICAL_WRAP
、およびHORIZONTAL_WRAP
という3つの定数がJList
に追加されました。getLayoutOrientation
メソッドと setLayoutOrientation
メソッドもJList
に追加されました。JList
のgetScrollableTracksViewportHeight
、getScrollableTracksViewportWidth
、getScrollableBlockIncrement
、およびgetPreferredScrollableViewportSize
の各メソッドについてjavadocが更新されました。同様に、javax.swing.plaf.basic.BasicListUI
内のgetPreferredSize
についてのjavadocも更新されました。
Metalのルック・アンド・フィールの2つのデフォルト設定が変更されました。
JLabel
の前景色が濃い青から黒に変更されました。DefaultListCellRenderer
のフォントが標準から太字に変更されました。この変更に関連するバグ追跡レポート: 4759306。
このメソッドを呼び出すと、新しいパネルが追加されますが、デフォルトのPreviewPanelがcolorChooserから削除されませんでした。その結果、奇妙なアーティファクトが発生していました。これは1.4.2で修正されました。
この変更に関連するバグ追跡レポート: 4668511。
1.4.0で発生したこのバグによって、アプリケーション全体がハングするデッドロックが発生しました。これは1.4.1で修正されました。
リリース1.4.1から、JFrame
内のsetDefaultCloseOperation
メソッドでSecurityException
をスローできるようになりました。
この変更に関連するバグ追跡レポート: 4419964および4668963。
このリリースより前では、DefaultMetalTheme
はWindowsデスクトップのフォント・サイズ情報を無視していました。リリース1.4.1から、DefaultMetalTheme
はWindowsデスクトップで指定されているフォント・サイズを使用できます。これは、システム・プロパティswing.useSystemFontSettings
を使用して無効にできます。このバグの一部として、Windowsルック・アンド・フィールでいくつかのコンポーネントに対して誤ったフォントが取得されるバグがありましたが、これは修正されました。
この変更に関連するバグ追跡レポート: 4615396。
Microsoft WindowsのWindowsLookAndFeel
では、特定のロケールはデスクトップのフォント・サイズだけを受け付けます。これは1.4.1で対処されました。
この変更に関連するバグ追跡レポート: 4420209。
ルック・アンド・フィールの実装の種類によっては、ルック・アンド・フィールに影響を与える可能性がある一定のプロパティを無視することができます。このリリースでは、ある種のルック・アンド・フィールに無視されるプロパティを示すために、一定のメソッドについてのドキュメントが変更されました。また、UIManager
のクラス仕様およびjavax.swing.plaf.metal
パッケージのドキュメントが、Java ルック・アンド・フィールをデフォルトのルック・アンド・フィールに指定するために変更されました。この変更は、ドキュメントにだけ影響します。
影響を受けるメソッドには、次のものがあります。
javax.swing.AbstractButton
javax.swing.JButton
javax.swing.JCheckBox
javax.swing.JColorChooser
javax.swing.JComboBox
javax.swing.JFileChooser
javax.swing.JInternalFrame
javax.swing.JList
javax.swing.JPopupMenu
javax.swing.JProgressBar
javax.swing.JSplitPane
javax.swing.JTable
javax.swing.text.JTextComponent
javax.swing.JToolBar
javax.swing.JTree
この変更に関連するバグ追跡レポート: 4175466。
SwingConstants
で、Swing全体で使用される定数を定義します。一般的なUI操作に、シーケンス内の次と前の項目の位置指定があります。これは、現在はSwingConstants
で、NEXT
およびPREVIOUS
の定数を定義することで指定されます。
この変更に関連するバグ追跡レポート: 4344900。
Swingには、特定のキー・ストロークに関連付けられたアクションをサポートする精巧なインフラストラクチャがあります。つまり、ユーザーがある文字を入力すると、該当するアクションが実行されます。これらのイベントの処理は、JComponent.processKeyEvent
内から引き起こされます(processKeyEvent
はjava.awt.Component
からオーバーライドされる)。これらのアクションの処理はJComponent
内で発生するため、以前は開発者にとって、フォーカスを取得しているJComponent
以外のサブクラス内からバインドを処理する方法がありませんでした。このため、processKeyBindings
メソッドがSwingUtilities
に追加されました。
この変更に関連するバグ追跡レポート: 4290988。
注: サウンド・パッケージにいくつかバグがあるため、デフォルトでは、サウンドは再生されません。サウンドを有効にするには、次のようにします。
UIManager.put("AuditoryCues.playList", UIManager.get("AuditoryCues.allAuditoryCues"));
以前のSwingコンポーネントでは、多くのプラットフォームでのネイティブ・コンポーネントとして、同じ音声フィードバックが提供されませんでした。SwingのPLAFへの変更セットであるMALF2は、主として、出力専用のノンスピーチ・オーディオ・ユーザーのフィードバック・メカニズムとしての使用を目的としています。MALF2プロジェクトは、Swing/JFCおよび、基盤プラットフォームでの厳密なユーザー・インタフェース統合という、Javaプラットフォームの目標の視点から重要です。MALF2プロジェクトでは、ネイティブ・アプリケーションとSwing/JFCアプリケーションによるユーザーの経験が、音声によるユーザーへのフィードバックに関して同一であることを保証します。
この実装は、APIをBasicLookAndFeel
に追加して、サウンドを再生するAction
を含むActionMap
のロードをサポートすることが目的としています。これで、サウンドの再生に適切なときに、多様なBasicComponentUI
の実装がAction
に対してactionPerformed
を呼び出します。たとえば、BasicMenuItemUI
では、doClick
を使用してアクションを実行します。BasicLookAndFeel
がJava Sound APIを使用してサウンドを再生している間に、サブクラスが代替のメソッドを使用することができます。たとえば、WindowsLookAndFeel
はWindowsで提供されるサウンドとの統合を図るために、Toolkit.getDefaultToolkit().getDesktopProperty()
経由でStringをRunnable
にマッピングします。
サウンドを含むActionMap
へは、BasicLookAndFeel.getAudioActionMap
経由でアクセスできます。getAudioActionMap
が最初に呼び出されるときに、次の動作が実行されます。
auditoryCues.cueList
(Object[]
)が使用される。createAudioAction
に渡され、サウンドの再生を行うAction
を取得する。BasicLookAndFeel.createAudioAction
に渡されたObject
が使用されて、Java Soundでロードできるデフォルトの表からサウンド・ファイルへのパスが検索される。BasicComponentUI
クラスの1つがサウンドの再生を希望したときは、Action
内で渡されてBasicLookAndFeel.playSound
が呼び出される。Action
の名前がデフォルトのエントリAuditoryCues.playList
に含まれている場合は、BasicLookAndFeel.playSound
がAction
でactionPerformed
を呼び出す。このアーキテクチャによって、開発者は再生するサウンドをさまざまな方法でカスタマイズできます。
JComponent
に関連付けられたサウンドは、たとえば次のように、JComponent
に関連するActionMap
内のAction
を変更することで、操作することができる。
ActionMap map = menuItem.getActionMap(); map.put("MenuItem.commandSound", differentActionToPlaySound);
Component
すべてに使用されるサウンドは、たとえば次のようにして、デフォルトの表を操作して変更できる。
UIManager.put("MenuItem.commandSound", "pathToNewSoundFild");
BasicLookAndFeel
メソッドの1つをオーバーライドして、代替の方法でサウンドをロードするか、または別の方法でサウンドを再生することもできる。それとは別に、再生するサウンドのセットをデフォルト・エントリのAuditoryCues.playList
経由で操作することもできます。このObject
配列には、デフォルトの表内で再生するサウンドを示すキーが含まれます。MetalLookAndFeel
では、これを次のように定義します。
new Object[] {"OptionPane.errorSound",
"OptionPane.informationSound",
"OptionPane.questionSound",
"OptionPane.warningSound" }
この定義は、JOptionPane
がサポートするサウンドのみを有効にする効果があります。
この変更に関連するバグ追跡レポート: 4371580。
新しいフォーカス・アーキテクチャは、RFE 4290675の要請で導入されました。これにより、フォーカスの一時的な変更を開発者が要求できるようになります。要求は、保護されたComponent
のrequestFocus(boolean)
メソッドまたはrequestFocusInWindow(boolean)
メソッドを通じて行われます。この2つのメソッドは、汎用でなくSwingなどの軽量ツールキットのみに対する実装用として保護されています。Swingは、様々なパッケージ内のコードが一時的にフォーカスを要求するという方法でアーキテクチャ化されています。つまり、すべてのSwingコンポーネントの親クラスであるJComponent
は、requestFocus(boolean)
およびrequestFocusInWindow
をpublicとして公開する必要があります。
この変更に関連するバグ追跡レポート: 4337186。
大量のSwingコンポーネントをComponentOrientation
プロパティに注意を払いつつ取り扱う過程で、コンポーネントの階層全体のComponentOrientation
の設定を簡単に管理できるようにする2つの機能が必要になります。SwingUtilities
の新規メソッドであるapplyComponentOrientation(Component c, ComponentOrientation o)
を使用すると、コンポーネントの階層全体に一貫したComponentOrientation
を設定することが簡単になります。
この変更に関連するバグ追跡レポート: 4290973。
Windowsルック・アンド・フィールの更新の一部として、メソッドがLookAndFeel
とgetDesktopPropertyValue
に追加され、デスクトップ関連のプロパティにアクセスしやすくなりました。
このメソッドは、実際には不確定な状態をサポートするために、JProgressBar
の更新の一部として追加されました。この変更に関連するバグ追跡レポート: 4290717。
新しいメソッドは、calculateInnerArea(Component, Rectangle)
で、SwingUtilities
に追加されました。
この変更に関連するバグ追跡レポート: 4356268。
マウスの中央ボタンとしてスクロール・ホイールが付いたホイール・マウスは、一般的になりつつあります。この提案では、マウス・ホイールを使用してスクロールさせる組込みのJavaサポートのほかに、新しいホイール・イベント・リスナーも提供されるので、マウス・ホイールの動作を開発者がカスタマイズできるようになります。
新しいクラスであるMouseWheelListener
と、新しいインタフェースであるMouseWheelEvent
が追加されました。定数のMOUSE_WHEEL_EVENT_MASK
がAWTEvent
に追加されました。AWTEventMulticaster
には、mouseWheelMoved
、add
、およびremove
の3つの新しいメソッドがあります。Component
には、addMouseWheelListener
およびremoveMouseWheelListener
の2つの新しいメソッドがあります。ScrollPane
にも、setWheelScrollingEnabled
および isWheelScrollingEnabled
の2つの新しいメソッドがあります。最後に、Robot
には、新しいmouseWheel
メソッドがあります。
この変更に関連するバグ追跡レポート: 4462408。
Swingは、JComponent
にキー・バインディングを登録するオプションをサポートしています。以前のリリースでは、Swingのトップ・レベルのコンポーネント(JFrame
、JDialog
、およびJApplet
)の1つにフォーカスがある場合、キー・バインディングを有効にするには、これらのトップ・レベルのコンポーネントでprocessKeyEvent
(java.awt.Component
で定義されている)をオーバーライドする必要がありました。java.awt.KeyEventPostProcessor
が追加され、Swingでこれを利用することにより(RFE 4389332)、Swingのトップ・レベルのコンポーネントでこれらのメソッドをオーバーライドする必要はなくなりました。このリリースでは、これらのメソッドはトップ・レベルから削除され、継承されるようになりました。
この変更に関連するバグ追跡レポート: 4483258。
このリリースではヘッドレス・モードが追加されましたが、JWindow
の2つのコンストラクタで、HeadlessException
がスローされる可能性が示されていませんでした。Window(Window, GraphicsConfiguration)
およびJWindow(GraphicsConfiguration)
のドキュメントで、この点が修正されました。
この変更に関連するバグ追跡レポート: 4532517。
一部のユーザーに問題を発生させている入力ベリファイアのバグが最近発見されました。1.4のshouldYieldFocus
メソッドでは、OptionPane
をポップアップさせるなどの副作用は許可されません。
これには、次のような回避策があります。
public boolean shouldYieldFocus(JComponent input) { if (verify(input)) { return true; } // According to the documentation, should yield focus is allowed to cause // side effects. So temporarily remove the input verifier on the text // field. input.setInputVerifier(null); System.out.println("Removed input verifier"); // Pop up the message dialog. String message = "Roll over the 'JButton1' with mouse pointer " + "after closing this dialog.\nIt sometimes behaves correctly " + "for the first time\n but repeating action brings incorrect " + "behaviour of button."; JOptionPane.showMessageDialog(null, message , "invalid value", JOptionPane.WARNING_MESSAGE); System.out.println("Showed message."); // Reinstall the input verifier. input.setInputVerifier(this); System.out.println("Reinstalled input verifier"); // Tell whomever called us that we don't want to yield focus. return false; }
この変更に関連するバグ追跡レポート: 4338458。
javax.swing.plaf.multi
内のクラスは、複数のルック・アンド・フィールを多重化するために使用されます。このクラスは通常、聴覚情報などの追加情報を提供するための補助ルック・アンド・フィールを使用するユーザー補助機能として使用されます。現在のところ、補助ルック・アンド・フィールの使用を不安定にするRootPaneUI
の複数の実装はありません。
新規クラスのjavax.swing.plaf.multi.MultiRootPaneUI
が追加されました。
この変更に関連するバグ追跡レポート: 4290471。
AWTでは最近、Window
の装飾を取り除くAPIを提供しました。つまり、非装飾に設定されている場合、ウィンドウを閉じたり、移動したり、サイズを変更したりするときに、Window
はどのようなウィジェットも描画もしません。その意味で、Swingではルック・アンド・フィール機能がウィンドウの装飾を描画できるようになりました。
この機能は主としてjavax.swing.JRootPane
でサポートされますが、javax.swing.JFrame
およびjavax.swing.JDialog
で提供されるスイッチを使用することをお薦めします。
次の変更がJRootPane
に対して行われました。
public static final int NONE; public static final int FRAME; public static final int PLAIN_DIALOG; public static final int INFORMATION_DIALOG; public static final int ERROR_DIALOG; public static final int COLOR_CHOOSER_DIALOG; public static final int FILE_CHOOSER_DIALOG; public static final int QUESTION_DIALOG; public static final int WARNING_DIALOG; public void setWindowDecorationStyle(int style) public int getWindowDecorationStyle()
すべてのルック・アンド・フィールがウィンドウの装飾スタイルをサポートするわけではないので、getSupportsWindowDecorations
メソッドがjavax.swing.LookAndFeel
に追加されて、ルック・アンド・フィールがこの動作をサポートするかどうかを示す方法が提供されました。
isDefaultLookAndFeelDecorated()
およびsetDefaultLookAndFeelDecoratedメソッドがJFrame
に追加されました。
また、isDefaultLookAndFeelDecorated()
およびsetDefaultLookAndFeelDecoratedメソッドがJDialog
に追加されました。
この変更に関連するバグ追跡レポート: 4213298。
JScrollBar
は以前、setUI
メソッドをオーバーライドしませんでした。このリリースでは、オーバーライドするように変更されました。
これは、マウス・ホイールのサポートの一部として実装されました。ここでは、JScrollPane
に対する変更だけを説明します。その他の変更に関する詳細は、このセクションを参照してください。この変更に関連するバグ追跡レポート: 4356268。
isWheelScrollingEnabled
およびsetWheelScrollingEnabled
メソッドがJScrollPane
に追加されました。
新しいprotected内部クラスのMouseWheelHandler
がjavax.swing.plaf.basic.BasicScrollPaneUI
に追加されました。この内部クラスに関連するメソッドは、mouseWheelMoved
です。また、新しいcreateMouseWheelListener
メソッドがBasicScrollPaneUI
に追加されました。
この変更に関連するバグ追跡レポート: 4363288。
Java 2Dチームでは、Image
のグラフィックスとスクリーン組立て操作にハードウェア高速化を利用できる、新しいVolatileImage
メカニズムを実装しました。
特に指定しないかぎり、Swingはダブル・バッファを使用してGUIコンポーネントの内容をペイントします。これは、オフスクリーン・イメージへ描画して、その後そのイメージをスクリーンにコピーすることで行われます。この過程が、新しいVolatileImage
サポートを利用するために変更されました。
ペイントを実行するためにSwingが使用するダブル・バッファは、getOffscreenBuffer
メソッドを使用してRepaintManager
から取得します。VolatileImage
オブジェクトには失敗条件をテストするための特殊な操作が必要なため、VolatileImage
を返すこのメソッドを簡単に変更することはできませんでした。それは、このメソッドを呼び出す既存のコードが存在する可能性があり、この追加の処理が実装されていないためです。したがって、特にVolatileImage
オブジェクトを返すために、getVolatileOffscreenBuffer
メソッドがjavax.swing.RepaintManager
に追加されました。
この変更に関連するバグ追跡レポート: 4290203。
このリリースでは、新しいレイアウト・マネージャSpringLayout
が導入されました。
SpringLayout
の使用例については、「The Java Tutorial」の「How to Use SpringLayout」を参照してください。