book

Java Swing, 2nd Edition

by Marc Loy, Robert Eckstein, Dave Wood, James Elliott, Brian Cole

November 2002

Intermediate to advanced

1280 pages

38h 26m

English

O'Reilly Media, Inc.

Read now

Unlock full access

Java Swing, 2nd Edition
A Note Regarding Supplemental Files
Preface
What This Book Covers
What’s New in This Edition?
On the Web Site
Conventions
Properties TablesClass Diagrams
How to Contact Us
Acknowledgments
Marc LoyBrian ColeJames Elliott
1. Introducing Swing

1.1. What Is Swing?
1.1.1. What Are the Java Foundation Classes?1.1.2. Is Swing a Replacement for AWT?1.1.3. Rethinking the AWT
1.2. Swing Features
1.2.1. Pluggable Look-and-Feels1.2.2. Lightweight Components1.2.3. Additional Features1.2.4. How Can I Use Swing?
1.3. Swing Packages and Classes
1.3.1. Class Hierarchy
1.4. The Model-View-Controller Architecture
1.4.1. MVC Interaction1.4.2. MVC in Swing
1.5. Working with Swing
1.5.1. Multithreading1.5.2. The Z-Order Caveat: Lightweight and Heavyweight Components
1.6. The Swing Set Demo
1.7. Reading This Book
2. Jump-Starting a Swing Application
2.1. Upgrading Your AWT Programs
2.2. A Simple AWT Application
2.3. Including Your First Swing Component
2.4. Beyond Buttons
2.5. What Is an Internal Frame?
2.6. A Bigger Application
3. Swing Component Basics
3.1. Understanding Actions
3.1.1. Actions and Containers3.1.2. The Action Interface3.1.2.1. Property3.1.2.2. Methods3.1.2.3. Events3.1.3. The AbstractAction Class3.1.3.1. Properties3.1.3.2. Events3.1.3.3. Constructors3.1.3.4. Methods3.1.3.5. Using an Action
3.2. Graphical Interface Events
3.3. Graphics Environments
3.3.1. Headless Modes
3.4. Sending Change Events in Swing
3.4.1. The ChangeEvent Class3.4.1.1. Constructor3.4.2. The ChangeListener Interface3.4.2.1. Method
3.5. The JComponent Class
3.5.1. Inherited Properties3.5.2. Common Methods3.5.3. JComponent Properties3.5.3.1. New properties in the 1.3 and 1.4 SDKs3.5.4. UI Delegates and UIClassIDs3.5.5. Invalidating and Repainting3.5.5.1. The paint( ) method and opaqueness3.5.6. Position, Size, and Alignment3.5.7. Adding Borders3.5.8. Working with Tooltips3.5.9. Client Properties3.5.10. Double Buffering3.5.11. Serialization3.5.12. The DebugGraphics Class3.5.13. Focus and Focus Cycle Methods3.5.14. Keyboard Events3.5.15. Accessibility3.5.16. Events3.5.16.1. Event methods3.5.17. Constructor3.5.18. Graphics Methods3.5.19. Focus Methods3.5.20. Tooltip Methods3.5.21. Client Properties Methods3.5.22. Miscellaneous Methods
3.6. Responding to Keyboard Input
3.6.1. The InputMap Class3.6.1.1. Property3.6.1.2. Constructor3.6.1.3. Methods3.6.2. The ActionMap Class3.6.2.1. Property3.6.2.2. Constructor3.6.2.3. Methods
4. Labels and Icons
4.1. Labels
4.1.1. Properties4.1.1.1. displayedMnemonic and labelFor properties4.1.2. Alignment
4.2. Working with Images
4.2.1. Events4.2.2. Constant4.2.3. Constructors4.2.4. Public Method
4.3. Support for HTML
4.4. Icons
4.4.1. Properties4.4.2. Method
4.5. Implementing Your Own Icons
4.6. Dynamic Icons
4.7. The ImageIcon Class
4.7.1. Properties4.7.2. Serialization4.7.3. Constructors4.7.4. User Interface Method
5. Buttons
5.1. The ButtonModel Interface
5.1.1. Properties5.1.2. Events
5.2. The DefaultButtonModel Class
5.2.1. Properties5.2.2. Events5.2.3. Constants5.2.4. Constructor
5.3. The AbstractButton Class
5.3.1. Properties5.3.2. Events5.3.3. Constants5.3.4. Public Methods5.3.5. Action Configuration Methods
5.4. The JButton Class
5.4.1. Properties5.4.2. Using the Default Button5.4.3. Events5.4.4. Constructors5.4.5. Using Actions5.4.6. Fancy Buttons
5.5. The JToggleButton Class
5.5.1. Properties5.5.2. Events5.5.3. Constructors
5.6. The JToggleButton.ToggleButtonModel Class
5.6.1. Properties
5.7. The JCheckBox Class
5.7.1. Properties5.7.2. Events5.7.3. Constant5.7.4. Constructors
5.8. The JRadioButton Class
5.8.1. Properties5.8.1.1. Events5.8.2. Constructors5.8.3. Opaque JRadioButtons and JCheckBoxes
5.9. The ButtonGroup Class
5.9.1. Properties5.9.2. Voting with a Button Group5.9.3. Constructor5.9.4. Methods
6. Bounded-Range Components
6.1. The Bounded-Range Model
6.1.1. Properties6.1.2. Events6.1.3. Method6.1.4. The DefaultBoundedRangeModel Class6.1.4.1. Properties6.1.4.2. Events6.1.4.3. Constructors6.1.4.4. Working with the bounded-range model
6.2. The JScrollBar Class
6.2.1. Properties6.2.2. Events6.2.3. Constructors6.2.4. Miscellaneous6.2.5. Handling Events from a Scrollbar
6.3. The JSlider Class
6.3.1. Properties6.3.1.1. Client properties6.3.2. Events6.3.3. Constructors6.3.4. Labels6.3.5. Miscellaneous6.3.6. Creating a Slider
6.4. The JProgressBar Class
6.4.1. Properties6.4.2. Events6.4.3. Constructors6.4.4. Working with Progress Bars
6.5. Monitoring Progress
6.5.1. The ProgressMonitor Class6.5.1.1. Properties6.5.1.1.1. UIManager properties6.5.1.2. Constructor6.5.1.3. Miscellaneous6.5.1.4. Using a progress monitor6.5.2. The ProgressMonitorInputStream6.5.2.1. Property6.5.2.2. Constructor6.5.2.3. InputStream methods6.5.2.4. Using a ProgressMonitorInputStream
7. Lists, Combo Boxes, and Spinners
7.1. Lists
7.1.1. Anatomy of a Swing List7.1.2. Where to Go from Here?
7.2. Representing List Data
7.2.1. The ListModel Interface7.2.1.1. Properties7.2.1.2. Events7.2.2. The AbstractListModel Class7.2.2.1. Methods7.2.3. The DefaultListModel Class7.2.3.1. Properties7.2.3.2. Constructor7.2.3.3. Methods7.2.3.4. A JList with changing contents7.2.4. ListDataEvent7.2.4.1. Properties7.2.4.2. Constants7.2.4.3. Constructor7.2.4.4. Method7.2.5. The ListDataListener Interface7.2.5.1. Methods
7.3. Handling Selections
7.3.1. The ListSelectionModel Interface7.3.1.1. Properties7.3.1.2. Constants7.3.1.3. Methods7.3.1.4. Events7.3.2. The DefaultListSelectionModel Class7.3.2.1. Properties7.3.2.2. Events7.3.2.3. Constructor7.3.2.4. Method7.3.2.5. Working with the ListSelectionModel7.3.3. ListSelectionEvent7.3.3.1. Properties7.3.3.2. Constructor7.3.3.3. Methods7.3.4. ListSelectionListener7.3.4.1. Listening for ListSelectionEvents
7.4. Displaying Cell Elements
7.4.1. The ListCellRenderer Interface7.4.2. Implementing a Cell Renderer7.4.3. The DefaultListCellRenderer Class
7.5. The JList Class
7.5.1. Properties7.5.2. Constants7.5.3. Constructors7.5.4. Miscellaneous7.5.5. Selection Model7.5.6. Scrolling7.5.7. Data Model7.5.8. User Interface7.5.9. Events7.5.10. The Java Books Example
7.6. Combo Boxes
7.6.1. The ComboBoxModel Interface7.6.1.1. Property7.6.1.2. Events7.6.2. The MutableComboBoxModel Interface7.6.3. The DefaultComboBoxModel Class7.6.3.1. Constructors7.6.3.2. Methods7.6.3.3. Event7.6.4. ComboBoxEditor7.6.4.1. Properties7.6.4.2. Events7.6.4.3. Method7.6.5. Implementing a Custom Editor
7.7. The JComboBox Class
7.7.1. The Key Selection Manager7.7.1.1. Properties7.7.1.2. Events7.7.1.3. Constructors7.7.1.4. Methods7.7.1.5. List methods7.7.1.6. Key selection7.7.1.7. Internal methods7.7.2. Java Books Revisited
7.8. Spinners
7.8.1. Properties7.8.2. Events7.8.3. Constructors7.8.4. Editing Methods7.8.5. Simple Spinners
7.9. Spinner Models
7.9.1. The SpinnerModel Interface7.9.1.1. Properties7.9.1.2. Events7.9.2. The AbstractSpinnerModel Class7.9.3. The SpinnerDateModel7.9.3.1. Properties7.9.3.2. Constructors7.9.4. The SpinnerListModel Class7.9.4.1. Properties7.9.4.2. Constructors7.9.5. The SpinnerNumberModel Class7.9.5.1. Properties7.9.5.2. Constructors7.9.6. A Custom Model: Rollover Lists
7.10. Spinner Editors
7.10.1. DefaultEditor7.10.1.1. Constructors7.10.1.2. Properties7.10.1.3. Editing methods7.10.2. DateEditor7.10.2.1. Constructors7.10.2.2. Properties7.10.3. ListEditor7.10.3.1. Constructor7.10.3.2. Property7.10.4. NumberEditor7.10.4.1. Constructors7.10.4.2. Properties7.10.5. A Custom Editor
8. Swing Containers
8.1. A Simple Container
8.1.1. The JPanel Class8.1.1.1. Properties8.1.1.2. Constructors8.1.1.3. Opacity
8.2. The Root Pane
8.2.1. The JRootPane Class8.2.2. The Glass Pane8.2.3. Avoiding Unnecessary Layers8.2.3.1. Properties8.2.4. Revalidate8.2.4.1. Constructor8.2.5. The RootPaneContainer Interface8.2.5.1. Properties8.2.6. The JLayeredPane Class8.2.6.1. Properties8.2.6.2. Constants8.2.6.3. Constructor8.2.7. Adding Components to Layers8.2.7.1. Layer management methods8.2.7.2. Static methods
8.3. Basic RootPaneContainers
8.3.1. The WindowConstants Interface8.3.1.1. Constants
8.4. The JFrame Class
8.4.1. Properties8.4.2. Constructors8.4.3. Protected Methods8.4.4. Exiting Frames
8.5. The JWindow Class
8.5.1. Properties8.5.2. Constructors
8.6. The JApplet Class
8.6.1. Hiding the Warning Message8.6.2. Threading Issues8.6.3. Properties8.6.4. Constructor8.6.5. User Interface Method
9. Internal Frames
9.1. Simulating a Desktop
9.1.1. Overview
9.2. The JInternalFrame Class
9.2.1. Properties9.2.2. Events9.2.3. Constants9.2.4. Constructors9.2.5. JLayeredPane Methods9.2.6. Miscellaneous Public Methods9.2.7. Use of the Glass Pane9.2.8. The Metal Look-and-Feel JInternalFrame.isPalette Client Property9.2.9. The JInternalFrame.JDesktopIcon Class9.2.10. The InternalFrameEvent Class9.2.10.1. Constants9.2.11. The InternalFrameListener Interface9.2.11.1. Methods9.2.12. The InternalFrameAdapter Class9.2.12.1. Methods
9.3. The JDesktopPane Class
9.3.1. Properties9.3.2. Constructor9.3.3. Methods
9.4. The DesktopManager Interface
9.4.1. Methods9.4.2. The DefaultDesktopManager Class9.4.2.1. Methods9.4.2.2. Protected methods
9.5. Building a Desktop
9.5.1. Setting Things Up9.5.2. Adding Frames to the Desktop9.5.3. Veto Power9.5.3.1. Bounding the frames9.5.4. Moving Things Around9.5.5. Source Code
10. Swing Dialogs
10.1. The JDialog Class
10.1.1. Properties10.1.2. Constructors10.1.3. Public Methods
10.2. The JOptionPane Class
10.2.1. Properties10.2.2. JOptionPane Structure
10.3. Using JOptionPane
10.3.1. Events10.3.2. Constants10.3.3. Four Dialog Types10.3.4. Constructors10.3.5. Static Dialog Display Methods10.3.6. Dialog Creation Method Parameters
10.4. Simple Examples
10.5. Getting the Results
10.6. A Comparison: Constructors Versus Static Methods
10.6.1. Nonstatic Methods10.6.2. Miscellaneous Static Methods
10.7. Using Internal Frame Dialogs with JDesktopPane
11. Specialty Panes and Layout Managers
11.1. The JSplitPane Class
11.1.1. Properties11.1.2. Constants11.1.3. Constructors11.1.4. Control Methods11.1.5. Minimum and Preferred Sizes
11.2. The JScrollPane Class
11.2.1. Properties11.2.2. Constructors11.2.3. Pane Component Methods11.2.4. Headers and Corners11.2.5. The Scrollable Interface11.2.5.1. Increment methods11.2.5.2. Viewport dimension methods11.2.5.3. The JScrollPane.ScrollBar class11.2.6. The ScrollPaneLayout Class11.2.6.1. Properties11.2.7. JViewport11.2.7.1. Properties11.2.7.2. Events11.2.7.3. Constructor11.2.7.4. Useful methods11.2.8. The ViewportLayout Class
11.3. The JTabbedPane Class
11.3.1. Constants11.3.2. Properties11.3.3. Events11.3.4. Constructors11.3.5. Tab Methods11.3.6. Miscellaneous Methods
11.4. Layout Managers
11.4.1. The Box Class11.4.1.1. Properties11.4.1.2. Constructor11.4.1.3. Creation method11.4.1.4. Spacing and resizing methods11.4.2. The Box.Filler Class11.4.2.1. Properties11.4.2.2. Constructor11.4.2.3. Shape method11.4.3. The BoxLayout Class11.4.3.1. Constants11.4.3.2. Constructor11.4.3.3. Box alignments11.4.4. The OverlayLayout Class11.4.4.1. Constructor11.4.5. An OverlayLayout Example11.4.6. The SizeRequirements Class11.4.6.1. Fields11.4.6.2. Constructors11.4.6.3. Methods
11.5. The SpringLayout Class
11.5.1. Springs and Struts11.5.2. Constants11.5.3. Constructor11.5.4. Constraint Methods11.5.5. The SpringLayout.Constraints Inner Class11.5.5.1. Properties11.5.5.2. Constructors11.5.6. The Spring Class11.5.6.1. Constant11.5.6.2. Properties11.5.6.3. Creating springs11.5.6.4. Manipulation methods11.5.6.5. Other operations11.5.7. Arranging Components11.5.8. Custom Springs
11.6. Other Panes
12. Chooser Dialogs
12.1. The JFileChooser Class
12.1.1. Properties12.1.2. File Chooser Accessories12.1.3. Events12.1.4. Constants12.1.5. Constructors12.1.6. FileFilter Methods12.1.7. File and Directory Methods12.1.8. Dialog Methods
12.2. The File Chooser Package
12.2.1. The FileFilter Class12.2.1.1. Constructor12.2.1.2. Filter methods12.2.2. The FileView Class12.2.2.1. Constructor12.2.2.2. Methods12.2.3. The FileSystemView Class12.2.3.1. Class instantiation method12.2.3.2. File and folder methods
12.3. The Color Chooser
12.3.1. The ColorSelectionModel Interface12.3.1.1. Property12.3.1.2. Events12.3.2. The DefaultColorSelectionModel Class12.3.2.1. Properties12.3.2.2. Events12.3.2.3. Constructors
12.4. The JColorChooser Class
12.4.1. Properties12.4.2. Events (Inherited from JComponent)12.4.3. Constants12.4.4. Constructors12.4.5. Dialog Methods12.4.6. Chooser Methods12.4.7. The AbstractColorChooserPanel Class12.4.7.1. Properties12.4.7.2. Protected helper method12.4.7.3. Chooser panel methods12.4.8. The ColorChooserComponentFactory Class12.4.8.1. Methods
12.5. Developing a Custom Chooser Panel
12.6. Developing a Custom Preview Panel
12.7. Developing a Custom Dialog
13. Borders
13.1. Introducing Borders
13.1.1. The Border Interface13.1.1.1. Methods
13.2. Painting Borders Correctly
13.2.1. The AbstractBorder Class13.2.1.1. Property13.2.1.2. Constructor13.2.1.3. Methods
13.3. Swing Borders
13.3.1. The BevelBorder and SoftBevelBorder Classes13.3.1.1. Properties13.3.1.2. Constants13.3.1.3. Default colors13.3.1.4. Constructors13.3.1.5. Methods13.3.1.6. Changing borders on the fly13.3.2. The Empty Border Class13.3.2.1. Properties13.3.2.2. Constructors13.3.2.3. Method13.3.3. The EtchedBorder Class13.3.3.1. Properties13.3.3.2. Constants13.3.3.3. Constructors13.3.3.4. Miscellaneous13.3.4. The LineBorder Class13.3.4.1. Properties13.3.4.2. Constructors13.3.4.3. Methods13.3.4.4. Miscellaneous13.3.5. The MatteBorder Class13.3.5.1. Properties13.3.5.2. Constructors13.3.5.3. Methods13.3.5.4. Two kinds of matte borders13.3.6. The TitledBorder Class13.3.6.1. Properties13.3.6.2. Constructors13.3.6.3. Miscellaneous13.3.6.4. Using a titled border13.3.7. The CompoundBorder Class13.3.7.1. Properties13.3.7.2. Constructors13.3.7.3. Miscellaneous13.3.8. The BorderFactory Class13.3.8.1. Methods
13.4. Creating Your Own Border
14. Menus and Toolbars
14.1. Introducing Swing Menus
14.1.1. Menu Hierarchy14.1.2. Getting Your Feet Wet
14.2. Menu Bar Selection Models
14.2.1. The SingleSelectionModel Interface14.2.1.1. Properties14.2.1.2. Events14.2.1.3. Method14.2.2. The DefaultSingleSelectionModel Class14.2.2.1. Properties14.2.2.2. Events and methods
14.3. The JMenuBar Class
14.3.1. Menu Bar Placement14.3.2. Properties14.3.2.1. Constructor14.3.2.2. Menu14.3.2.3. Miscellaneous
14.4. The JMenuItem Class
14.4.1. Menu Item Shortcuts14.4.2. Images14.4.3. Event Handling14.4.4. Properties14.4.5. Constructors14.4.6. Events14.4.7. Method14.4.8. Menu Element Interface14.4.9. The MenuDragMouseEvent Class14.4.9.1. Properties14.4.9.2. Constructor14.4.10. The MenuDragMouseListener Interface14.4.10.1. Methods14.4.11. The MenuKeyEvent Class14.4.11.1. Constructor14.4.12. The MenuKeyListener Interface14.4.12.1. Methods
14.5. The JPopupMenu Class
14.5.1. Displaying the Pop-up Menu14.5.2. Properties14.5.3. Events14.5.4. Constructors14.5.5. Menu Items14.5.6. Display14.5.7. Miscellaneous14.5.8. Menu Element Interface14.5.9. Using Pop-up Menus14.5.10. The PopupMenuEvent Class14.5.10.1. Constructor14.5.11. The PopupMenuListener Interface14.5.11.1. Methods
14.6. The JMenu Class
14.6.1. Properties14.6.2. Constructor14.6.3. Menu Items14.6.4. Miscellaneous14.6.5. Event14.6.6. MenuElement Interface14.6.7. Working with Menus14.6.8. The MenuEvent Class14.6.8.1. Constructor14.6.9. The MenuListener Interface14.6.9.1. Methods
14.7. Selectable Menu Items
14.7.1. The JCheckBoxMenuItem Class14.7.1.1. Properties14.7.1.2. Constructors14.7.1.3. Miscellaneous14.7.2. Using Checkbox Menu Items14.7.3. The JRadioButtonMenuItem Class14.7.3.1. Properties14.7.3.2. Constructor14.7.3.3. Miscellaneous14.7.4. Enforcing Mutual Exclusion14.7.5. The JSeparator Class14.7.5.1. Properties14.7.5.2. Constructor14.7.5.3. Miscellaneous14.7.6. Using a Separator Outside of a Menu14.7.7. The MenuElement Interface14.7.7.1. Methods14.7.8. Making Arbitrary Components into Menu Elements
14.8. Toolbars
14.8.1. The JToolBar Class14.8.1.1. Floating toolbars14.8.1.2. Properties14.8.1.3. Event14.8.1.4. Constructor14.8.1.5. Adding actions14.8.1.6. Miscellaneous14.8.2. Creating a Toolbar
15. Tables
15.1. The JTable Class
15.1.1. Table Columns15.1.2. Properties15.1.2.1. Examples15.1.3. Events15.1.4. Constants15.1.5. Constructors15.1.6. Other Interesting Methods15.1.7. The TableColumn Class15.1.7.1. Properties15.1.7.2. Constants15.1.7.3. Event15.1.7.4. Constructors15.1.7.5. Another useful method15.1.8. The TableColumnModel Interface15.1.8.1. Properties15.1.8.2. Event15.1.8.3. Column methods15.1.9. The DefaultTableColumnModel Class15.1.9.1. Properties15.1.9.2. Events15.1.9.3. Constructor15.1.9.4. Other useful methods15.1.10. The TableColumnModelEvent Class15.1.10.1. Event methods15.1.11. The TableColumnModelListener Interface
15.2. Implementing a Column Model
15.3. Table Data
15.3.1. The TableModel Interface15.3.1.1. Properties15.3.1.2. Events15.3.1.3. Cell methods15.3.2. The AbstractTableModel Class15.3.2.1. Events15.3.2.2. Another useful method15.3.3. The DefaultTableModel Class15.3.3.1. Properties15.3.3.2. Events15.3.3.3. Constructors15.3.3.4. Other useful methods15.3.4. The TableModelEvent Class15.3.4.1. Properties15.3.4.2. Constants15.3.5. The TableModelListener Interface15.3.6. Dynamic Table Data15.3.7. Database Data15.3.8. Yet More Useful Methods15.3.9. The JTableHeader Class15.3.9.1. Properties
15.4. Selecting Table Entries
15.5. Rendering Cells
15.5.1. The TableCellRenderer Interface15.5.2. The DefaultTableCellRenderer Class15.5.2.1. Properties15.5.3. The CellRendererPane Class
15.6. Editing Cells
15.6.1. The CellEditor Interface15.6.1.1. Events15.6.1.2. Methods15.6.2. The TableCellEditor Interface15.6.3. The CellEditorListener Interface15.6.4. The DefaultCellEditor Class15.6.4.1. Properties15.6.4.2. Events15.6.4.3. Constructors15.6.4.4. Tree and table editor methods
15.7. Next Steps
16. Advanced Table Examples
16.1. A Table with Row Headers
16.2. Large Tables with Paging
16.3. A Table with Custom Editing and Rendering
16.3.1. A Custom Renderer16.3.2. A Custom Editor
16.4. Charting Data with a TableModel
17. Trees
17.1. A Simple Tree
17.1.1. Tree Terminology
17.2. Tree Models
17.2.1. The TreeModel Interface17.2.1.1. Property17.2.1.2. Events17.2.1.3. Miscellaneous methods17.2.2. The DefaultTreeModel Class17.2.2.1. Properties17.2.2.2. Events17.2.2.3. Constructors17.2.2.4. Miscellaneous methods17.2.3. Working with Tree Models
17.3. The JTree Class
17.3.1. Properties17.3.2. Events17.3.3. Constants17.3.4. Constructors17.3.5. Selection Methods17.3.6. Expansion Methods17.3.7. Path and Row Methods17.3.8. Editing Methods17.3.9. JTree Inner Classes
17.4. Tree Nodes and Paths
17.4.1. The TreeNode Interface17.4.1.1. Properties17.4.1.2. Child access methods17.4.2. The MutableTreeNode Interface17.4.2.1. Properties17.4.2.2. Mutation methods17.4.3. The DefaultMutableTreeNode Class17.4.3.1. Constant17.4.3.2. Constructors17.4.3.3. Structure methods17.4.3.4. Enumeration methods17.4.4. The TreePath Class17.4.4.1. Properties17.4.4.2. Constructors17.4.4.3. Miscellaneous methods
17.5. Tree Selections
17.5.1. The RowMapper Interface17.5.2. The TreeSelectionModel Interface17.5.2.1. Properties17.5.2.2. Constants17.5.2.3. Events17.5.2.4. Selection methods17.5.3. The DefaultTreeSelectionModel Class17.5.3.1. Properties17.5.3.2. Events17.5.3.3. Constant17.5.3.4. Constructor
17.6. Tree Events
17.6.1. The TreeModelEvent Class17.6.1.1. Properties17.6.1.2. Constructors17.6.2. The TreeModelListener Interface17.6.3. The TreeSelectionEvent Class17.6.3.1. Properties17.6.3.2. Constructors17.6.3.3. Methods17.6.4. The TreeSelectionListener Interface17.6.5. The TreeExpansionEvent Class17.6.5.1. Property17.6.5.2. Constructor17.6.6. The TreeExpansionListener Interface17.6.7. Pending Expansion Events17.6.7.1. The TreeWillExpandListener interface17.6.7.2. The ExpandVetoException class
17.7. Rendering and Editing
17.7.1. Rendering Nodes17.7.1.1. But I just want to change the icons!17.7.2. The DefaultTreeCellRenderer Class17.7.2.1. Properties17.7.2.2. Constructor17.7.3. Custom Renderers17.7.4. The TreeCellRenderer Interface17.7.5. Editing Nodes17.7.6. The TreeCellEditor Interface17.7.7. The DefaultTreeCellEditor Class17.7.7.1. Properties17.7.7.2. Events17.7.7.3. Constructors17.7.7.4. CellEditor and TreeCellEditor methods17.7.8. Look-and-Feel Helper Classes
17.8. What Next?
18. Undo
18.1. The Swing Undo Facility
18.1.1. The UndoableEdit Interface18.1.1.1. Properties18.1.1.2. Edit-merging methods18.1.1.3. Other methods18.1.2. The AbstractUndoableEdit Class18.1.2.1. Properties18.1.2.2. Constants18.1.2.3. Constructor18.1.2.4. UndoableEdit methods18.1.2.5. Creating a toggle edit18.1.3. The CompoundEdit Class18.1.3.1. Properties18.1.3.2. Protected field18.1.3.3. Constructor18.1.3.4. UndoableEdit methods18.1.3.5. Other methods18.1.4. Using Compound Edits18.1.5. The UndoableEditEvent Class18.1.5.1. Property18.1.5.2. Constructor18.1.6. The UndoableEditListener Interface
18.2. The UndoManager Class
18.2.1. A Codeless Example18.2.2. Transformer?18.2.3. Properties18.2.4. Constructor18.2.5. UndoableEditListener Method18.2.6. UndoableEdit Methods18.2.7. Public Methods18.2.8. Protected Methods18.2.9. Using an Undo Manager18.2.10. Understanding the UndoManager18.2.11. The StateEditable Interface18.2.11.1. Methods18.2.12. The StateEdit Class18.2.12.1. State optimization18.2.12.2. Property18.2.12.3. Protected fields18.2.12.4. Constructors18.2.12.5. UndoableEdit methods18.2.12.6. New public method18.2.12.7. Protected methods18.2.12.8. StateEdit example18.2.13. The UndoableEditSupport Class18.2.13.1. Properties18.2.13.2. Protected fields18.2.13.3. Constructors18.2.13.4. UndoableEditEvent/listener support methods18.2.13.5. Nested edit support18.2.14. Using Undoable Edit Support18.2.15. The CannotRedoException Class18.2.16. The CannotUndoException Class
18.3. Extending UndoManager
19. Text 101
19.1. The Swing Text Components
19.2. The JTextComponent Class
19.2.1. Properties19.2.2. Events19.2.3. Constants19.2.4. Constructor19.2.5. Clipboard Methods19.2.6. Selection Methods19.2.7. View Methods19.2.8. Working with Keymaps19.2.9. Other Methods
19.3. The JTextField Class
19.3.1. Properties19.3.2. Events19.3.3. Constant19.3.4. Constructors19.3.5. Methods
19.4. A Simple Form
19.4.1. Understanding JTextField Sizing19.4.1.1. Restricting input
19.5. The JPasswordField Class
19.5.1. Properties19.5.2. Constructors19.5.3. Data Protection Methods19.5.4. Miscellaneous Methods
19.6. The JTextArea Class
19.6.1. Properties19.6.2. Events19.6.3. Constructors19.6.4. Text Manipulation Methods19.6.5. Line Transformation Methods19.6.6. Understanding JTextArea Layout
19.7. How It All Works
20. Formatted Text Fields
20.1. The JFormattedTextField Class
20.1.1. Properties20.1.2. Events20.1.3. Constants20.1.4. Constructors20.1.5. Public Method
20.2. Handling Numerics
20.2.1. The JFormattedTextField.AbstractFormatter Class20.2.1.1. Public methods20.2.1.2. Protected methods
20.3. The DefaultFormatter Class
20.3.1. Properties20.3.2. Constructor20.3.3. Public Methods20.3.4. Example
20.4. The MaskFormatter Class
20.4.1. Properties20.4.2. Constructors20.4.3. Public Methods
20.5. The InternationalFormatter Class
20.5.1. Properties20.5.2. Constructors20.5.3. Public Methods
20.6. The DateFormatter Class
20.6.1. Properties20.6.2. Constructors
20.7. The NumberFormatter Class
20.7.1. Properties20.7.2. Constructors20.7.3. Public Method20.7.4. The JFormattedTextField.AbstractFormatterFactory Class20.7.4.1. Public method
20.8. The DefaultFormatterFactory Class
20.8.1. Properties20.8.2. Constructors20.8.3. Public Method20.8.4. Example
20.9. Formatting with Regular Expressions
20.10. The InputVerifier Class
20.10.1. Public Methods
21. Carets, Highlighters, and Keymaps
21.1. Carets
21.1.1. The Caret Interface21.1.1.1. Properties21.1.1.2. Events21.1.1.3. Methods21.1.2. The DefaultCaret Class21.1.2.1. Properties21.1.2.2. Events21.1.2.3. Constructor21.1.2.4. Caret methods21.1.2.5. FocusListener methods21.1.2.6. Mouse methods21.1.2.7. Protected methods21.1.3. Custom Carets21.1.4. The CaretListener Interface21.1.4.1. Method21.1.5. The CaretEvent Class21.1.5.1. Properties21.1.5.2. Constructor
21.2. Highlighters
21.2.1. The Highlighter.HighlightPainter Interface21.2.1.1. Method21.2.2. A Custom HighlightPainter21.2.3. The Highlighter.Highlight Interface21.2.3.1. Properties21.2.4. The Highlighter Interface21.2.4.1. Property21.2.4.2. Methods21.2.5. Adding Multiple Highlights21.2.6. The LayeredHighlighter Class21.2.6.1. Method21.2.7. The DefaultHighlighter Class21.2.7.1. Properties21.2.7.2. Static field21.2.7.3. Constructor21.2.7.4. Methods21.2.8. The DefaultHighlighter.DefaultHighlightPainter Class21.2.8.1. Property21.2.8.2. Constructor21.2.8.3. Methods
21.3. Keymaps
21.3.1. The Keymap Interface21.3.1.1. Properties21.3.1.2. Methods21.3.2. Keymap Implementation21.3.3. Adding Keyboard Actions
22. Styled Text Panes
22.1. The JTextPane Class
22.1.1. Properties22.1.2. Constructors22.1.3. Attribute and Style Methods22.1.4. Insertion/Replacement Methods22.1.5. Named Style Methods
22.2. AttributeSets and Styles
22.2.1. The AttributeSet Interface22.2.1.1. Properties22.2.1.2. Constants22.2.1.3. Methods22.2.1.4. Inner interfaces22.2.2. The MutableAttributeSet Interface22.2.2.1. Property22.2.2.2. Methods22.2.3. The Style Interface22.2.3.1. Property22.2.3.2. Constants22.2.3.3. Events22.2.4. The SimpleAttributeSet Class22.2.4.1. Properties22.2.4.2. Constant22.2.4.3. Constructors22.2.4.4. Add/remove methods22.2.4.5. Query methods22.2.5. The StyleConstants Class22.2.5.1. Attribute key constants and utility methods22.2.5.1.1. Character attribute keys22.2.5.1.2. Paragraph attribute keys22.2.5.1.3. Other attribute keys22.2.5.2. Attribute value constants22.2.5.3. StyleConstants inner classes22.2.6. The StyleContext Class22.2.6.1. Properties22.2.6.2. Events22.2.6.3. Constant22.2.6.4. Constructor22.2.6.5. Static default accessor method22.2.6.6. AttributeContext methods22.2.6.7. Font and color accessor methods22.2.6.8. Style management methods22.2.6.9. Serialization methods22.2.7. A Stylized Editor22.2.8. The TabStop Class22.2.8.1. Properties22.2.8.2. Alignment constants22.2.8.3. Leader constants22.2.8.4. Constructors22.2.9. The TabSet Class22.2.9.1. Properties22.2.9.2. Constructor22.2.9.3. Methods22.2.9.4. Example
22.3. The Document Model
22.3.1. The Element Interface22.3.1.1. Properties22.3.1.2. Element lookup method22.3.2. The Document Interface22.3.2.1. Properties22.3.2.2. Events22.3.2.3. Constants22.3.2.4. Text manipulation methods22.3.2.5. Other methods22.3.3. The AbstractDocument Class22.3.3.1. Properties22.3.3.2. Events22.3.3.3. Constants22.3.3.4. Constructors22.3.3.5. Locking methods22.3.3.6. Text manipulation methods22.3.3.7. Other public methods22.3.4. The PlainDocument Class22.3.4.1. Properties22.3.4.2. Constants22.3.4.3. Constructors22.3.4.4. Public methods22.3.4.5. Restriction example22.3.5. The StyledDocument Interface22.3.5.1. Properties22.3.5.2. Style application methods22.3.5.3. Query methods22.3.5.4. StyleContext delegation methods22.3.6. The DefaultStyledDocument Class22.3.6.1. Properties22.3.6.2. Events22.3.6.3. Constant22.3.6.4. Constructors22.3.6.5. Content style methods22.3.6.6. StyleContext delegation methods22.3.6.7. StyledDocument example
22.4. Document Events
22.4.1. The DocumentListener Interface22.4.1.1. Methods22.4.2. The DocumentEvent Interface22.4.2.1. Properties22.4.2.2. Element tree details22.4.3. The DocumentEvent.EventType Class22.4.4. The DocumentEvent.ElementChange Interface22.4.4.1. Properties22.4.5. The ElementIterator Class22.4.5.1. Constructors22.4.5.2. Methods22.4.6. The Segment Class22.4.6.1. Properties22.4.6.2. Constant22.4.6.3. Fields22.4.6.4. Constructors22.4.6.5. Methods22.4.7. The AbstractDocument.Content Interface22.4.7.1. Methods22.4.8. The StringContent Class22.4.8.1. Constructors22.4.9. The GapContent Class22.4.9.1. Constructors22.4.9.2. AbstractDocument.Content methods22.4.10. Undo Event Example22.4.11. The BadLocationException Class22.4.11.1. Constructor22.4.11.2. Method22.4.12. The Position Interface22.4.12.1. Property22.4.13. The Position.Bias Class22.4.13.1. Constants
22.5. Views
22.5.1. The ViewFactory Interface22.5.1.1. Method22.5.2. The View Class22.5.2.1. Float coordinates22.5.2.2. Shape versus Rectangle22.5.2.3. Span and allocation22.5.2.4. Axis22.5.2.5. Bias22.5.2.6. Properties22.5.2.7. Constructor22.5.2.8. Constants22.5.2.9. Abstract methods22.5.2.10. Translation methods22.5.2.11. Break methods22.5.2.12. Tree management methods22.5.2.13. Layout methods22.5.2.14. Update methods22.5.3. The View Classes22.5.4. The TabExpander Interface22.5.4.1. Method22.5.5. The TabableView Interface22.5.5.1. Methods22.5.6. The Utilities Class22.5.6.1. Public static methods
22.6. The DocumentFilter Class
22.6.1. Constructor22.6.1.1. Methods22.6.1.2. DocumentFilter.FilterBypass methods
22.7. The NavigationFilter Class
22.7.1. Constructor22.7.1.1. Methods22.7.1.2. NavigationFilter.FilterBypass methods
23. Editor Panes and Editor Kits
23.1. The JEditorPane Class
23.1.1. Properties23.1.2. Events23.1.3. Constructors23.1.4. EditorKit Methods23.1.5. Miscellaneous Methods
23.2. Overview of the Editor Kits
23.2.1. The EditorKit Class23.2.1.1. Properties23.2.1.2. Abstract methods23.2.1.3. Other methods23.2.2. The TextAction Class23.2.2.1. Constructor23.2.2.2. Static method23.2.2.3. Protected methods23.2.3. The DefaultEditorKit Class23.2.3.1. Properties23.2.3.2. Constants23.2.3.3. Using actions23.2.3.4. Constructor23.2.3.5. Methods23.2.4. Useful Actions23.2.5. A Simple Text Editor23.2.6. The StyledEditorKit Class23.2.6.1. Properties23.2.6.2. Constructor23.2.6.3. EditorKit methods23.2.7. The StyledEditorKit.StyledTextAction Class23.2.7.1. Constructor23.2.7.2. Protected methods23.2.7.3. The StyledEditorKit.FontFamilyAction class23.2.7.4. The StyledEditorKit.FontSizeAction class23.2.7.5. The StyledEditorKit.ForegroundAction class23.2.7.6. The StyledEditorKit.AlignmentAction class23.2.7.7. The StyledEditorKit.BoldAction class23.2.7.8. The StyledEditorKit.ItalicAction class23.2.7.9. The StyledEditorKit.UnderlineAction class23.2.8. A Better Editor23.2.8.1. Saving styled documents
23.3. HTML and JEditorPane
23.3.1. A Quick Browser Example
23.4. Hyperlink Events
23.4.1. The HyperlinkListener Interface23.4.2. The HyperlinkEvent Class23.4.2.1. Properties23.4.2.2. Constructors23.4.2.3. Inner classes23.4.3. The HTMLFrameHyperlinkEvent Class
23.5. The HTMLEditorKit Class
23.5.1. Inner Classes23.5.2. Properties23.5.3. Constructor23.5.4. Editor Kit Methods23.5.5. HTML Document Methods
23.6. Extending HTMLEditorKit
23.6.1. The HTMLDocument Class23.6.1.1. Properties23.6.1.2. Constructors23.6.1.3. Public content methods23.6.2. The HTML Class23.6.2.1. Inner classes23.6.3. The StyleSheet Class23.6.3.1. Properties
23.7. Editing HTML
23.7.1. Hyperlink Actions23.7.2. Inserting Images23.7.3. Saving as HTML
23.8. Writing HTML
23.8.1. The AbstractWriter Class23.8.1.1. Properties23.8.1.2. Constant23.8.1.3. Constructors23.8.1.4. Output-generating methods23.8.1.5. Formatting methods23.8.2. The HTMLWriter Class23.8.2.1. Constructors23.8.2.2. Writing method23.8.3. MinimalHTMLWriter23.8.3.1. Constructors23.8.3.2. Public writing method
23.9. Reading HTML
23.9.1. Document Parsers
23.10. A Custom EditorKit
23.10.1. Create the EditorKit Class23.10.2. Define the Document Type23.10.3. Define New Actions23.10.4. Create Custom View Classes23.10.5. Create a ViewFactory Interface and View Classes23.10.6. Create a “Reader” and a “Writer”23.10.7. Tell JEditorPane About Your New Kit
24. Drag and Drop
24.1. What Is Drag and Drop?
24.1.1. DnD and SDK 1.424.1.2. Programming with DnD
24.2. The Drop API
24.2.1. The DropTarget Class24.2.1.1. Properties24.2.1.2. Events24.2.1.3. Constructors24.2.2. The DnDConstants Class24.2.3. The DropTargetContext Class24.2.3.1. Properties24.2.4. The DropTargetListener Interface24.2.4.1. Methods24.2.5. The DropTargetAdapter Class24.2.6. The DropTargetEvent Class24.2.7. The DropTargetDragEvent Class24.2.7.1. Properties24.2.7.2. Drag methods24.2.7.3. Transfer data method24.2.8. The DropTargetDropEvent Class24.2.8.1. Properties24.2.8.2. Drop methods24.2.8.3. Transfer data method24.2.9. Drop Example24.2.10. Transferable Contents24.2.11. The TransferHandler Class24.2.11.1. Constants24.2.11.2. Properties24.2.11.3. Constructors24.2.11.4. Methods
24.3. The Drag Gesture API
24.3.1. The DragGestureRecognizer Class24.3.1.1. Properties24.3.1.2. Events24.3.1.3. Fields24.3.1.4. Constructors24.3.1.5. Trigger event list methods24.3.2. The MouseDragGestureRecognizer Class24.3.2.1. Constructors24.3.2.2. Mouse methods24.3.2.3. Listener methods24.3.3. The Drag Gesture Events and Listeners24.3.3.1. Properties24.3.3.2. Event list methods24.3.3.3. Drag initiation methods24.3.4. A Simple Gesture
24.4. The Drag API
24.4.1. The DragSource Class24.4.1.1. Properties24.4.1.2. Constants24.4.1.3. Events24.4.1.4. Constructor24.4.1.5. Helper creation methods24.4.1.6. Start methods24.4.2. The DragSourceContext Class24.4.2.1. Properties24.4.2.2. Events24.4.2.3. Protected constants24.4.2.4. Constructors24.4.2.5. Event methods24.4.2.6. Miscellaneous methods24.4.3. The DragSourceListener Interface24.4.3.1. Event methods24.4.4. The DragSourceMotionListener Interface24.4.4.1. Event method24.4.5. The DragSourceAdapter Class24.4.6. Drag Source Events24.4.6.1. Constructors24.4.7. The DragSourceDragEvent Class24.4.7.1. Properties24.4.8. The DragSourceDropEvent Class24.4.8.1. Properties24.4.9. Completing the Gesture
24.5. Rearranging Trees
24.5.1. A TransferHandler Example24.5.2. A Rearranging Example
24.6. Finishing Touches
24.6.1. Dynamic Cursors24.6.2. Changing the Drop Action24.6.3. Autoscrolling24.6.4. The Autoscroll Interface24.6.4.1. Methods24.6.5. The DropTarget.DropTargetAutoScroller Class24.6.5.1. Constructor24.6.5.2. Methods
25. Programming with Accessibility
25.1. How Accessibility Works
25.1.1. Evolving Accessibility Support25.1.1.1. Version 1.1 accessibility25.1.1.2. Version 1.2 accessibility25.1.1.3. Version 1.3 accessibility25.1.1.4. Version 1.4 accessibility25.1.2. The Accessibility Contract25.1.3. How Do I Get It?25.1.3.1. Swing25.1.3.2. AWT
25.2. The Accessibility Package
25.2.1. The Path to Determining Accessibility25.2.2. The Accessible Interface25.2.2.1. Method25.2.3. The AccessibleContext Class25.2.3.1. Properties25.2.3.2. Accessible names and descriptions25.2.3.3. Events25.2.3.4. Constants
25.3. Other Accessible Objects
25.3.1. The AccessibleState Class25.3.1.1. Constructor25.3.2. The AccessibleStateSet Class25.3.2.1. Constructors25.3.2.2. Methods25.3.3. The AccessibleRole Class25.3.3.1. Constructor
25.4. Types of Accessibility
25.4.1. The AccessibleAction Interface25.4.1.1. Properties25.4.1.2. Method25.4.2. The AccessibleComponent Interface25.4.2.1. Properties25.4.2.2. Events25.4.2.3. Methods25.4.3. The AccessibleSelection Interface25.4.3.1. Properties25.4.3.2. Methods25.4.4. The AccessibleText Interface25.4.4.1. Properties25.4.4.2. Constants25.4.4.3. Methods25.4.5. The AccessibleHypertext Interface25.4.5.1. Properties25.4.6. The AccessibleHyperlink Class25.4.6.1. Properties25.4.6.2. Method25.4.7. The AccessibleValue Interface25.4.7.1. Methods
25.5. Classes Added in SDK 1.3 and 1.4
25.5.1. The AccessibleIcon Interface25.5.1.1. Properties25.5.2. The AccessibleEditableText Interface25.5.2.1. Property25.5.2.2. Text manipulation methods25.5.3. The AccessibleTable Interface25.5.3.1. Properties25.5.4. Relations and Extended Information25.5.5. Implementing AccessibleAction
25.6. The Accessibility Utility Classes
25.6.1. The EventQueueMonitor Class25.6.1.1. Constructor25.6.1.2. Initialization25.6.1.3. Methods25.6.2. The AWTEventMonitor Class25.6.2.1. Constructor25.6.2.2. Methods25.6.3. The SwingEventMonitor Class25.6.3.1. Constructor25.6.3.2. Methods25.6.4. The TopLevelWindowListener Interface25.6.4.1. Methods25.6.5. The GUIInitializedListener Interface25.6.5.1. Method
25.7. Interfacing with Accessibility
25.7.1. The Java Accessibility Helper
26. Look and Feel
26.1. Mac OS X and the Default Look-and-Feel
26.2. How Does It Work?
26.3. Key Look-and-Feel Classes and Interfaces
26.3.1. The LookAndFeel Class26.3.1.1. Properties26.3.1.2. Constructor26.3.1.3. Methods26.3.1.4. Static convenience methods26.3.2. The UIDefaults Class26.3.2.1. Events26.3.2.2. Constructors26.3.2.3. Methods26.3.3. The UIDefaults.ActiveValue Interface26.3.3.1. Method26.3.3.2. Creating an ActiveValue26.3.4. The UIDefaults.LazyValue Interface26.3.4.1. Method26.3.4.2. Creating a LazyValue26.3.5. The UIResource Interface26.3.5.1. Static BorderUIResource methods26.3.5.2. BorderUIResource inner classes26.3.6. The UIManager Class26.3.6.1. LAFState26.3.6.2. UIManager look-and-feel concepts26.3.6.3. Look-and-feel properties file26.3.6.4. Events26.3.6.5. UIDefaults convenience methods26.3.6.6. Other static methods26.3.6.7. Changing the look-and-feel26.3.6.8. Managing defaults26.3.7. The UIManager.LookAndFeelInfo Class26.3.7.1. Properties26.3.7.2. Constructor26.3.7.3. Method26.3.8. The ComponentUI Class26.3.8.1. Methods26.3.8.2. Static method
26.4. The MultiLookAndFeel
26.4.1. Creating an Auxilliary Look-and-Feel26.4.2. Installing the MultiLookAndFeel
26.5. Auditory Cues
26.6. Look-and-Feel Customization
26.6.1. Modification of Component Properties26.6.2. Modification of the UI Defaults26.6.2.1. Making global changes with defaults26.6.3. Using Metal’s Themes26.6.3.1. MetalTheme properties26.6.3.2. Abstract protected methods26.6.3.3. Black and white26.6.3.4. Additional customization26.6.3.5. DefaultMetalTheme font properties26.6.3.6. Protected DefaultMetalTheme base colors26.6.4. Use of Metal’s Client Properties26.6.5. Replacement of Individual UI Delegates26.6.5.1. Modifying a scrollbar
26.7. Creation of a Custom Look-and-Feel
26.7.1. The PlainLookAndFeel26.7.2. Creating the LookAndFeel Class26.7.2.1. Defining class defaults26.7.2.2. Defining look-and-feel colors26.7.2.3. Defining component defaults26.7.3. Defining an Icon Factory26.7.4. Defining Custom Borders26.7.5. The BasicGraphicsUtils Class26.7.5.1. Methods26.7.6. Creating the Individual UI Delegates26.7.6.1. Define a constructor26.7.6.2. Define the factory method26.7.6.3. Define installUI( ) and uninstallUI( ) (optional)26.7.6.4. Define component size26.7.6.5. Override component-specific details26.7.6.6. Paint the component26.7.7. Don’t Forget to Use It26.7.8. How’s It Look?26.7.9. One Down...
27. Swing Utilities
27.1. Utility Classes
27.1.1. The SwingUtilities Class27.1.1.1. Constructor27.1.1.2. Class methods27.1.2. The SwingConstants Interface
27.2. The Timer Class
27.2.1. Properties27.2.2. Events27.2.3. Constructor27.2.4. Timer Control Methods
27.3. Tooltips
27.3.1. The ToolTipManager Class27.3.1.1. Properties27.3.1.2. Miscellaneous methods27.3.2. The JToolTip Class27.3.2.1. Properties27.3.2.2. Constructor
27.4. Rendering Odds and Ends
27.4.1. The CellRendererPane Class27.4.2. The Renderer Interface27.4.3. The GrayFilter Class27.4.3.1. Constructor27.4.3.2. Image methods
27.5. Event Utilities
27.5.1. The EventListenerList Class27.5.1.1. Constructor27.5.1.2. Listener methods27.5.2. The KeyStroke Class27.5.2.1. Properties27.5.2.2. Key codes27.5.2.3. Factory methods27.5.3. The MouseInputAdapter Class27.5.3.1. Methods27.5.4. The SwingPropertyChangeSupport Class27.5.4.1. Constructor27.5.4.2. Methods
28. Swing Under the Hood
28.1. Working with Focus
28.1.1. Overview28.1.1.1. Focus traversal28.1.1.2. Validation28.1.1.3. Temporary focus changes28.1.1.4. Focus cycles28.1.2. Using Focus Properties28.1.3. The KeyboardFocusManager Class28.1.3.1. Constants28.1.3.2. Constructor28.1.3.3. Methods28.1.3.4. Properties28.1.3.5. Listener lists28.1.4. The DefaultKeyboardFocusManager Class28.1.5. The FocusTraversalPolicy Class28.1.6. Writing Your Own Focus Traversal Policy
28.2. Multithreading Issues in Swing
28.2.1. When Is Thread Safety an Issue?28.2.1.1. Don’t be fooled28.2.2. Updating Components from the Event Dispatch Thread28.2.2.1. Methods28.2.2.2. Managing synchronization properly
28.3. Lightweight Versus HeavyweightComponents
28.3.1. Understanding the Z-Order28.3.2. Mixing Swing and AWT28.3.2.1. Overlapping heavyweight and lightweight components28.3.2.2. Heavyweight components in front of lightweight menus28.3.2.3. Pop ups28.3.2.4. Heavyweight components in JScrollPane28.3.2.5. Heavyweight components inside internal frames
28.4. Painting and Repainting
28.4.1. Swing Responsibilities28.4.2. The RepaintManager Class28.4.2.1. Key methods28.4.2.2. Methods
28.5. Creating Your Own Component
28.5.1. Getting Started28.5.1.1. You should have a model and a UI delegate28.5.2. Creating a Model28.5.2.1. Reuse or extend existing models whenever possible28.5.2.2. Decide on properties and create the model interface28.5.2.3. Send events when bound properties change28.5.2.4. Reuse the EventListenerList class28.5.2.5. Don’t put component properties in the model28.5.2.6. Implement the model28.5.3. The UI Delegate28.5.3.1. Create an abstract type class28.5.3.2. You must implement a paint method28.5.3.3. Be able to resize yourself28.5.4. Creating the Component Itself28.5.4.1. Deciding on properties28.5.4.2. Listening to your models28.5.4.3. Sending events when bound properties change28.5.5. Some Final Questions28.5.6. The Jog Shuttle: a Simple Swing Component28.5.6.1. The component28.5.6.2. The UI delegate28.5.7. A Toy Using the Shuttle
A. Look-and-Feel Resources
B. Component Actions
B.1. JButton
B.2. JCheckBox
B.3. JCheckBoxMenuItem
B.4. JComboBox
B.5. JDesktopPane
B.6. JEditorPane
B.7. JFormattedTextField
B.8. JInternalFrame
B.9. JLabel
B.10. JList
B.11. JMenu
B.12. JMenuBar
B.13. JMenuItem
B.14. JOptionPane
B.15. JPasswordField
B.16. JPopupMenu
B.17. JProgressBar
B.18. JRadioButton
B.19. JRadioButtonMenuItem
B.20. JRootPane
B.21. JScrollBar
B.22. JScrollPane
B.23. JSlider
B.24. JSpinner
B.25. JSplitPane
B.26. JTabbedPane
B.27. JTable
B.28. JTextArea
B.29. JTextField
B.30. JTextPane
B.31. JToggleButton
B.32. JToolBar
B.33. JToolTip
B.34. JTree
B.35. JViewport
B.36. Non-JComponent Containers
B.37. Auditory Feedback Actions
Index
About the Authors
Colophon
Copyright

Content preview from Java Swing, 2nd Edition

Lightweight Versus HeavyweightComponents

The issue of lightweight versus heavyweight components has complicated Swing since its inception. The concept of lightweight components managed entirely by Java code is, of course, one of the major benefits introduced by Swing. What has confused the majority of programmers from the start is the issue of z-order, or layering, between Swing lightweight components and AWT heavyweight components.

Understanding the Z-Order

In Swing, it might help to think of a heavyweight component as an artist’s easel. Top-level components in Swing (JWindow, JDialog, JApplet, and JFrame) are heavyweight, while everything else isn’t. Lightweight components added to those top-level heavyweights can be thought of as drawings on the canvas of each easel. Therefore, if another heavyweight component (another easel) is moved in front of the original easel, or even attached to it, the lightweight paintings on the original easel are obscured. Figure 28-6 demonstrates this analogy.

Figure 28-6. Consider heavyweight components as easels and lightweight components as drawings

The same is true for how Swing interprets the z-order of lightweight and heavyweight components, even in a container. If a heavyweight component is added to a container that has lightweight components, the heavyweight is always on top; the lightweight components must share the same z-order as the parent ...

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Read now

Unlock full access

More than 5,000 organizations count on O’Reilly

O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.

Julian F.

Head of Cybersecurity

I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.

Addison B.

Field Engineer

I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.

Amir M.

Data Platform Tech Lead

I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.

Mark W.

Embedded Software Engineer

Publisher Resources

ISBN: 0596004087Errata Page

Cloud Computing

Data Engineering

Data Science

AI & ML

Programming Languages

Software Architecture

IT/Ops

Security

Design

Business

Soft Skills

Java Swing, 2nd Edition

by Marc Loy, Robert Eckstein, Dave Wood, James Elliott, Brian Cole

Lightweight Versus HeavyweightComponents

Understanding the Z-Order

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

More than 5,000 organizations count on O’Reilly

Julian F.

Addison B.

Amir M.

Mark W.

You might also like

Java Projects - Second Edition

Java Threads, 3rd Edition

Java Examples in a Nutshell, 3rd Edition

Pro Java 8 Programming, Third Edition

Publisher Resources