John Zukowski's Definitive Guide to Swing for Java 2

Transcription

1 John Zukowski's Definitive Guide to Swing for Java 2 JOHN ZUKOWSKI APress Media, LLC

2 John Zukowski's Definitive Guide to Swing for Java 2 Copyright ~1999 by John Zukowski Originally published by Apress in 1999 Ali rights reserved. No part of this work may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, recording, or by any information storage or retrieval system, without the prior written permission of the copyright owner and the publisher. Library of Congress Cataloging-in-Publication Data Zukowski, John. [Definitive Swing Guide] John Zukowski's Definitive Swing Guide 1 John Zukowski. p. cm. 1. Java (Computer program language) I. Title. QA76.73.J38Z8493 OOS.13'3-dc Swing (Computer file) Additional material to this book can be downloaded from ISBN ISBN (ebook) DOI / CIP Trademarked names may appear in this book. Rather than use a trademark symbol with every occurrence of a.trademarked name, we use the names only in an editorial fashion and to the benefit of the trademark owner, with no intention of infringement of the trademark. Project Manager: Nancy DelFavero Project Editor: Carol Lombardi Technical Reviewers: Gary Cornell, Randy Kahle, Blake Ragsdell, Tim Rohaly, and Laurence Vanhelsuwe Copyeditor: Mark Woodworth Proofreaders: Valerie Cover and Christine Sabooni Production Assistance: Lori Ash Indexer: Nancy Humphreys In the United States, phone SPRINGER; orders@springer-ny.com; Cover and Interior Design: Derek Yee Design For information on translations, please contact APress directly: APress, 6400 Hollis Street, Suite 9, Emeryville, CA Phone: 510/ ; Fax: 510/ ; info@apress.com; The information in this book is distributed on an ''As Is" hasis, without warranty. Although every precaution has been taken in the preparation of this work, neither the author nor APress shal1 have any liability to any person or entity with respect to any loss or damage caused or alleged to be caused directly or indirectly by the information contained in this work. ii

3 Author's Acknowledgments WORKING WITH APRESS ON THIS BOOK has been fim. 1 would like to personally thank everyone who helped along the way, both in the formation of a new technical publisher and for the help in converting my rough manuscript into the material you have in your hands today. At APress, 1 would first like to thank Gary Cornell, Bill Pollock, and Dan Appleman for allowing me to work with them at such an early stage of company development. Now that we have Dan Appleman's book and my book, we can work at filling some spaces between the N.s and Z's. 1 would especially like to thank Nancy DelFavero and Carole Lombardi for their help in shaping what you're reading. Special thanks to the technical editors, Laurence Vanhelsuwe, Blake Ragsdell, Gary Cornell, Tim Rohaly, and Randy Kahle, who helped to ensure the technical accuracy of the content. Any remaining technical inaccuracies are my fault alone. On the graphics side, thanks to Derek Yee Design for helping to convert my rough sketches, mostly in Visio, to the quality illustrations you see in this book. For some of the images used in the example programs, 1 would like to thank Dean Jones for the JavaLobby Foundation Applications -Icon Collection ( /webart.javalobby.org/jlicons/) and Deb Felts at the Image Addict's Attic ( (There is a reason why 1 am nota graphic artist.) They retain the copyrights on their respective images, and the images are used with permission. For their ideas and assistance during development, 1 would like to thank Joe Sam Shirah, Wong Kok Wai, Tomoko Iwama, Carlos Lucasius and the Licensee Support team in Ontario, the Swing! Team, and everyone at MageLang Institute. This book is that much better because of them. As always, 1 am grateful to my wife, Lisa, for her never-ending patience during the development of this book and aur playful pup, Jaeger, who helps keep me sane (sometimes). Thanks to Mom and Dad, too, even though they don't remember getting me thatvic 20. iii

4 About the Author JOHN ZUKOWSKI IS A WELL-KNOWN FIGURE in the Java community. He is a popular columnist for ]ava World magazine and a member of the ]ava World Senior Advisory Board. Zukowski provides significant content for Sun's Java Developer Connection and is the guide for Java at About.com. In addition, he is a faculty member of the MageLang Institute, an instructor-led training firm that is the leading provider of advanced Java training to the computer industry. He is also the author of]avaawt Reference (O'Reilly), Mastering]ava 2 (Sybex), and Borland's ]Builder: No Experience Required (Sybex). iv

5 Contents Introduction... 1 Development Versions... 2 How This Book Is Structured... 2 Reading the UML Diagrams... 4 Support... 5 Chapter 1 Swing Overview...? AWT Component Replacements... 8 New Components Event Handling and Layout Management Undo Framework Using Swing Classes with JDK SwingSet Demonstration JComponent to Page Mapping Summary Chapter 2 Event Handling with the Swing Component Set Delegation-Based Event Handling Using Event Listeners as Observers A Quick Look at the JFrame Class Creating an ExitableJFrame Class Using SwingUtilities for Mouse Button Identification Using Property Change Listeners as Observers Managing Listener Lists Swing-Specific Event Handling Interface Action Class AbstractAction Class KeyStroke Using Mnemonics and Accelerators V

6 Swing Focus Management Examining Focus Cycles Customizing Component-Level Focus Management Setting the Next Focusable Component Class FocusManager and DefaultFocusManager WritingYour Own Focus Manager Multithreaded Swing Event Handling Using SwingUtilities for Thread Safety Class Timer Summary Chapter 3 The Model-View-Controller Architecture MVC Communications Sharing Data Models Understanding the Predefined Data Models Summary Chapter 4 Core Swing Components Class JComponent Component Pieces JComponent Properties Handling JComponent Events Class JTool Tip Creating a JToolTip Creating Customized JToolTip Objects Displaying Positional ToolTip Text Customizing JToolTip Look and Feei Class ToolTipManager ToolTipManager Properties Class JLabe Creating a JLabel JLabel Properties Handling JLabel Events Customizing JLabel Look and Feel vi

7 Interface Icon Creating an lcon Using an Icon Class Imagelcon Class GrayFilter Class AbstractButton AbstractButton Properties HandlingAbstractButton Events Listening to AbstractButton Events with a PropertyChangeListener Class Button Creating a JButton JButton Properties Handling JButton Events Listening to JButton Events with an ActionListener Customizing a JButton Look and Feel Class JPane Creating a JPanel Using a JPanel Customizing JPanel Look and Feel Summary Chapter 5 Toggle Buttons Class ToggleButtonModel Class ButtonGroup... 12B Class JToggleButton Creating JToggleButton Components JToggleButton Properties Handling JToggleButton Selection Events Customizing a JToggleButton Look and Feel Class JCheckBox Creating JCheckBox Components JCheckBox Properties Handling JCheckBox Selection Events Customizing a JCheckBox Look and Feel Class JRadioButton Creating JRadioButton Components JRadioButton Properties Grouping JRadioButton Components in a ButtonGroup Handling JRadioButton Selection Events Customizing a JRadioButton Look and Feel Summary vii

8 Chapter 6 Swing Menus and Toolbars Working with Menus Getting Started Menu Class Hierarchy Class JMenuBar SingleSelectionModel Interface Class JMenultem Class JMenu Class JSeparator Class JPopupMenu Class JCheckBoxMenultem Class JRadioButtonMenultem Creating Custom MenuElement Components Working with Toolbars: Class JToolBar Creating ]ToolBar Components Adding Components to a JToolBar ]ToolBar Properties Handling ]ToolBar Events Customizing JToolBar Look and Feei A Complete JToolBar Usage Example JToolBar.Separator Summary Chapter 7 Borders Some Bas ies on Working with Borders Exploring the Border lnterface Introducing BorderFactory Starting with AbstractBorder Examining the Predefined Borders Creat ing Your Own Borders Summary Chapter 8 Root Pa ne Containers Class JRootPane Creating a JRootPane JRootPane Properties Interface RootPaneContainer Class JLayeredPane viii

9 Class JFrame Creating a JFrame JFrame Properties Adding Components to a JFrame Handling JFrame Events Extending JFrame Class JWindow Creating a JWindow JWindow Properties Handling JWindow Events Extending JWindow Class JDialog Creating a }Dialog }Dialog Properties Handling }Dialog Events Extending }Dialog Class JApplet Testing JApplet Solutions Extending JApplet Working with a Desktop Class JinternalFrame Class JDesktopPane Summary Chapter 9 Pop-Ups and Choosers Class JOptionPane Creating a JOptionPane Displaying a JOptionPane Automatically Creating a JOptionPane in a Pop-up Window JOptionPane Properties Customizing JOptionPane Look and Feel Class ProgressMonitor Creating a ProgressMonitor Using a ProgressMonitor ProgressMonitor Properties Customizing ProgressMonitor Look and Feel Complete ProgressMonitor Example Class ProgressMonitorinputStream Creating a ProgressMonitorlnputStream Using a ProgressMonitorlnputStream ProgressMonitorlnputStream Properties ix

10 Class JColorChooser Creating a JColorChooser Using JColorChooser Listening for Color Selection Changes Creating and Showing a JColorChooser Pop-up Window ProvidingYour Own OK/Cancel Event Listeners JColorChooser Properties Customizing a JColorChooser Look and Feel Class JFileChooser Creating a JFileChooser Using JFileChooser Adding an ActionListener to a JFileChooser Creating and Showing a JFileChooser within a Pop-up Window JFileChooser Properties Customizing JFileChooser Look and Feel Summary Chapter 1.0 Swing Layout Managers Class BoxLayout Creating a BoxLayout Laying Out Components Class OverlayLayout Class SizeRequirements Class ScrollPaneLayout Class ViewportLayout Summary Chapter 1.1. Advanced Swing Containers Class Box Creating a Box Box Properties Working with Box.Filler Creating Areas That Grow Creating Rigid Areas Class JSplitPane Creating a JSplitPane JSplitPane Properties Listening for JSplitPane Property Changes Customizing a JSplitPane Look and Feei X

11 Class JTabbedPane Creating a JTabbedPane Adding and RemovingTabs JTabbedPane Properties Listening for Changing Tab Selection Customizing a JTabbedPane Look and Feel Class JScrollPane Cre ating a JScrollPane Changing the Viewport View Interface Scrollable JScrollPane Properties Customizing a JScrollPane Look and Feel Class JViewport Creating a Niewport Niewport Properties Scrolling the View Customizing a Niewport Look and Feel Summary Chapter 1.2 Bounded Range Components Interface BoundedRangeModel Class Defaul tboundedrangemodel Class JScrollBar Creating JScrollBar Components Handling Scrolling Events JScrollBar Properties Customizing a JScrollBar Look and Feel Class JSlider Creating JSlider Components Handling JSlider Events JSlider Properties Customizing a JSlider Look and Feel JSlider Client Properties Class JProgressBar Cre ating JProgressBar Components JProgressBar Properties Handling JProgressBar Events Customizing a JProgressBar Look and Feel Class JTextField and Interface BoundedRangeModel Summary xi

12 Chapter 1.3 List Model Controls Interface ListModel Class AbstractUstModel Class DefaultListModel Ustening for UstModel Events with a UstDataUstener Interface ComboBoxModel Interface MutableComboBoxModel Class DefaultComboBoxModel Class JList Creating JUst Components JUst Properties Scrolling JList Components Rendering JList Elements Selecting JUst Elements Customizing JUst Look and Feel DualListBox Example Class JComboBox Creating JComboBox Components JComboBox Properties Rendering JComboBox Elements Selecting JComboBox Elements Editing JComboBox Elements Customizing a JComboBox Look and Feel Shared Data Model Example Summary Chapter 1.4 Basic Text Components Class JTextComponent JTextComponent Properties JTextComponent Operations Class JTextField Creating a JTextField Using JLabel Mnemonics JTextField Properties JTextComponent Operations with a JTextField Document Interface Interface DocumentUstener/Interface DocumentEvent Interface Caret and Interface Highlighter Interface CaretUstener 1 Class CaretEvent Interface Keymap Class JTextComponent.KeyBinding xii

13 Handling JTextField Events Customizing a JTextField Look and Feel Class JPasswordField Creating a JPasswordField JPasswordField Properties Customizing JPasswordField Look and Fee Class JTextArea Creating a JTextArea JTextArea Properties Handling JTextArea Events Customizing a JTextArea Look and Feel Class JEditorPane Creating a JEditorPane JEditorPane Properties Handling JEditorPane Events Interface HyperlinkListener 1 Class HyperlinkEvent Customizing a JEditorPane Look and Feel Class JTextPane Creating a JTextPane JTextPane Properties Customizing a JTextPane Look and Feel Sample JTextPane Summary Chapter 15 Advanced Text Capabilities Class TextAction Listing Actions Using Actions Finding Actions Creating Styled Text Interface StyledDocument/ Class DefaultStyledDocument Interface AttributeSet Interface MutableAttributeSet Class SimpleAttributeSet Class StyleConstants Class TabStop and TabSet Interface Style Class StyleContext The Editor Kits Working with Views Summary xiii

14 Chapter 16 Sculpting Trees Introducing Trees Class JTree Cre ating a JTree Scrolling Trees JTree Properties Customizing a JTree Look and Feel Interface TreeCellRenderer Class DefaultTreeCellRenderer DefaultTreeCellRenderer Properties Cre ating a Custom Renderer Working with Tree Tooltips Editing Tree Nodes Interface CellEditor Interface TreeCellEditor Class DefaultCellEditor Class DefaultTreeCellEditor Creating a Proper ComboBox Editor for a Tree Creating an Editor Just for LeafNodes lnterface CellEditorListener/Class ChangeEvent Creating a Better Check Box Node Editor Working with the Nodes of the Tree lnterface TreeNode lnterface MutableTreeNode Class DefaultMutableTreeNode Traversing Trees Class JTree.DynamicUtilTreeNode DraggingTree Nodes Interface TreeModel Class DefaultTreeModel Interface TreeModelListener/Class TreeModelEvent Interface TreeSelectionModel Class DefaultTreeSelectionModel Interface TreeSelectionListener 1 Class TreeSelectionEvent Class TreePath Additional Expansion Events lnterface TreeExpansionListener /Class TreeExpansionEvent Interface TreeWillExpandListener/Class ExpandVetoException Summary xiv

15 Chapter 11 Tables Introducing Tables Class JTable Creating a JTable Scrolling JTable Components Manually Positioning the JTable View Removing Column Headers JTable Properties Rendering Table Cells Handling JTable Events Customizing a JTable Look and Feel Interface TableModel Class AbstractTableModel Class DefaultTableModel Sorting JTable Elements Interface TableColumnModel Class DefaultTableColumnModel Listening to JTable Events with a TableColumnModelListener Class TableColumn Class JTableHeader Cre ating a JTableHeader JTableHeader Properties Using Tooltips Customizing a JTableHeader Look and Feel Editing Table Cells Interface TableCellEditor 1 Class DefaultCellEditor Creating a Simple Cell Editor Creating a Complex Cell Editor Summary Chapter 18 Understanding the Pluggable Look and Feel Architecture Class LookAndFeel Listing the Installed Look and Feel Classes Changing the Current Look and Feel Customizing the Current Look and Feel Creating a New Look and Feel Using the MacLookAndFeel on a Non-Macintosh Adding UI Delegates XV

16 Working with Metal Themes Class MetalTheme DefaultMetalTheme Using an Auxiliary Look and Feel Summary Chapter 19 Becoming Undone Working with the Undo Framework Using the Undo Framework with Swing Text Components The Command Design Pattern Interface UndoableEdit Class AbstractUndoableEdit Class CompoundEdit Class UndoManager A Complete Undoable Program Example Using the StateEditable Interface and StateEdit Class Summary Appendix A UI Manager Properties Appendix 8 About the CD-ROM Loading the CD contents What"s on the CD? Some Tips on Using the CD For the Java 2 platform For the Java 1.1 platform Places to Go for More Informat ion If You Have Any CD Problems xvi