book

Java Swing

by Robert Eckstein, Marc Loy, Dave Wood

September 1998

Intermediate to advanced

1258 pages

42h 57m

English

O'Reilly Media, Inc.

Read now

Unlock full access

Java Swing
Preface
What This Book Covers
About the Source Code
Conventions
Acknowledgments
1. Introducing Swing
What Is Swing?What Are the Java Foundation Classes (JFC)?Is Swing a Replacement for AWT?Rethinking the AWTJFC vs. AFC
Swing Features
Pluggable Look-and-FeelsLightweight ComponentsAdditional FeaturesHow Can I Use Swing?
Swing Packages and Classes
Swing PackagesClass Hierarchy
The Model-View-Controller Architecture
MVC InteractionMVC in Swing
Working with Swing
MultithreadingThe Z-Order Caveat: Lightweight and Heavyweight Components

The Swing Set Demo
Reading this Book
2. Jump Starting a Swing Application
Upgrading Your ProgramsA Simple AWT ApplicationIncluding Your First Swing Component
Beyond Buttons
What Is an Internal Frame?
A Bigger Application
3. Swing Component Basics
Understanding ActionsActions and ContainersThe Action InterfacePropertyMethodsEventsThe AbstractAction ClassPropertiesEventsProtected FieldsConstructorsMethodsUsing an Action
Sending Change Events in Swing
The ChangeEvent ClassConstructorThe ChangeListener InterfaceMethod
The JComponent Class
Inherited PropertiesOther MethodsJComponent PropertiesUI Delegates and UIClassIDsInvalidating and RepaintingThe paint( ) Method and OpaquenessPosition, Size, and AlignmentAdding BordersWorking with TooltipsClient PropertiesDouble BufferingSerializationDebug GraphicsFocus and Focus CycleKeyboard EventsAccessibilityEventsEvent MethodsFields and MethodsProtected FieldsConstructorGraphicsFocusKeyboard ActionsTooltipsClient PropertiesEvent HandlersMiscellaneous
4. Labels and Icons
LabelsThe JLabel ClassPropertiesdisplayedMnemonic and labelFor PropertiesAlignmentWorking with ImagesEventsConstantFieldConstructorsUser Interface MethodOther Public MethodProtected Methods
Icons
The Icon InterfacePropertiesMethodImplementing Your Own IconsDynamic IconsThe ImageIcon ClassPropertiesSerializationProtected ConstantsConstructorsUser Interface MethodProtected Method
5. Buttons
ButtonsThe ButtonModel InterfacePropertiesEventsThe DefaultButtonModel ClassPropertiesEventsConstantsProtected FieldsConstructorThe AbstractButton ClassPropertiesEventsConstantsProtected FieldsConstructorUser Interface MethodsOther Public MethodsProtected MethodsThe JButton ClassPropertiesUsing the Default ButtonEventsConstructorsUser Interface MethodUsing MnemonicsFancy ButtonsThe JToggleButton ClassPropertiesEventsConstructorsUser Interface MethodThe JToggleButton.ToggleButtonModel ClassPropertiesThe JCheckBox ClassPropertiesEventsConstructorsUser Interface MethodThe JRadioButton ClassPropertiesEventsConstructorsUser Interface MethodOpaque JRadioButtons and JCheckBoxesThe ButtonGroup ClassPropertiesVoting with a Button GroupProtected FieldConstructorMethods
6. Bounded Range Components
The Bounded-Range ModelPropertiesEventsMethodThe DefaultBoundedRangeModel ClassPropertiesEventsFieldsConstructorsMiscellaneousWorking with the Bounded-Range Model
The JScrollBar Class
PropertiesEventsProtected FieldsConstructorsMiscellaneousHandling Events from a Scrollbar
The JSlider Class
PropertiesClient PropertiesEventsProtected FieldsConstructorsLabelsMiscellaneousCreating a Slider
The JProgressBar Class
PropertiesEventsProtected FieldsConstructorsMiscellaneousWorking with Progress Bars
Monitoring Progress
The ProgressMonitor ClassPropertiesConstructorMiscellaneousUsing a Progress MonitorThe ProgressMonitorInputStreamPropertyConstructorMethodsUsing a ProgressMonitorInputStream
7. Lists and Combo Boxes
ListsAnatomy of a Swing ListWhere To Go from Here?
Representing List Data
The ListModel InterfacePropertiesEventsThe AbstractListModel ClassProtected FieldsMethodsThe DefaultListModel ClassPropertiesConstructorMethodsA JList with Changing ContentsListDataEventPropertiesConstantsConstructorThe ListDataListener InterfaceMethods
Handling Selections
The ListSelectionModel InterfacePropertiesConstantsMethodsEventsThe DefaultListSelectionModel ClassPropertiesEventsProtected FieldConstructorMethodWorking with the ListSelectionModelListSelectionEventPropertiesConstructorMethodsListSelectionListenerListening for ListSelectionEvents
Displaying Cell Elements
The ListCellRenderer InterfaceImplementing a Cell RendererThe DefaultListCellRenderer Class
The JList Class
PropertiesConstructorsMiscellaneousSelection ModelScrollingData ModelUser InterfaceEventsThe Java Books Example
Combo Boxes
The ComboBoxModel InterfacePropertyEventsThe MutableComboBoxModel InterfaceThe DefaultComboBoxModel ClassConstructorsMethodsEventsComboBoxEditorPropertiesEventsImplementing a Custom Editor
The JComboBox Class
The Key Selection ManagerPropertiesEventsConstructorsMethodsList MethodsKey SelectionInternal MethodsJava Books Revisited
8. Swing Containers
A Simple ContainerThe JPanel ClassPropertiesConstructorsMethodOpacityThe Box ClassThe Root PaneThe JRootPane ClassUnderstanding the Glass PaneAvoiding Unnecessary LayersPropertiesRevalidateProtected FieldsConstructorsPublic MethodsProtected MethodsInner ClassesThe RootPaneContainer InterfacePropertiesThe JLayeredPane ClassPropertiesConstantsConstructorAdding Components to LayersLayer Management MethodsOther Public MethodStatic MethodsProtected Methods
Basic RootPaneContainers
The WindowConstants InterfaceConstantsThe JFrame ClassPropertiesProtected FieldsConstructorsUser Interface MethodsProtected MethodsExiting FramesThe JWindow ClassPropertiesProtected FieldsConstructorsProtected MethodsThe JApplet ClassHiding the Warning MessageThreading IssuesPropertiesProtected FieldsConstructorUser Interface MethodsProtected Methods
9. Internal Frames
Managing a DesktopOverviewThe JInternalFrame ClassPropertiesEventsConstantsProtected FieldsConstructorsJLayeredPane MethodsMiscellaneous Public MethodsProtected MethodsUse of Glass PaneThe Metal L&F JInternalFrame.isPalette Client PropertyThe JInternalFrame.JDesktopIcon ClassPropertiesConstructorsMethodsThe InternalFrameEvent ClassConstantsConstructorMethodThe InternalFrameListener InterfaceMethodsThe InternalFrameAdapter ClassMethodsThe JDesktopPane ClassPropertiesConstructorMethodsThe DesktopManager InterfaceMethodsThe DefaultDesktopManager ClassMethodsProtected Methods
Building a Desktop
Setting Things UpVeto PowerBounding the Frames
10. Swing Dialogs
The JDialog ClassPropertiesConstructorsProtected FieldsPublic MethodsProtected Methods
The JOptionPane Class
PropertiesJOptionPane StructureUsing JOptionPaneEventsConstantsProtected FieldsFour Dialog TypesConstructorsStatic Dialog Display MethodsDialog Creation Method ParametersSimple ExamplesGetting the ResultsA Comparison: Constructors vs. Static MethodsNon-Static MethodsMiscellaneous Static MethodsUsing Internal Frame Dialogs with JDesktopPane
11. Specialty Panes and Layout Managers
The JSplitPane ClassPropertiesConstantsFieldsConstructorsControl MethodsUI MethodsMinimum and Preferred Sizes
The JScrollPane Class
PropertiesFieldsConstructorsPane Component MethodsUI MethodsHeaders and CornersThe Scrollable InterfaceIncrement MethodsViewport Dimension MethodsThe JScrollPane.ScrollBar ClassScrollPaneLayoutPropertiesFieldsInner ClassesJViewportPropertiesEventsFieldsConstructorsHelper MethodsMiscellaneous MethodsThe ViewportLayout ClassLayout Methods
The JTabbedPane Class
PropertiesEventsFieldsConstructorsTab MethodsMiscellaneous MethodsUI Methods
Layout Managers
The Box and BoxLayout ClassesThe Box ClassPropertiesConstructorsCreation MethodsSpacing and Resizing MethodsThe Box.Filler ClassPropertiesConstructorsShape MethodsThe BoxLayout ClassConstantsConstructorsMethodsOverlayLayoutConstructorLayoutManager2 MethodsThe SizeRequirements ClassFieldsConstructorsMethodsAn OverlayLayout Example
Other Panes
12. Chooser Dialogs
The JFileChooser ClassPropertiesEventsConstantsConstructorsFileFilter MethodsFile MethodsDialog MethodsMiscellaneous Methods
The File Chooser Package
The FileFilter ClassConstructorsFilter MethodsThe FileView ClassConstructorMethodsThe FileSystemView ClassConstructorClass MethodFile and Folder Methods
The Color Chooser
The ColorSelectionModel InterfacePropertyEventsThe DefaultColorSelectionModel ClassPropertyEventsFieldsConstructors
The JColorChooser Class
PropertiesEvents (Inherited from JComponent)ConstantsConstructorsDialog MethodsChooser Panel MethodsUI MethodsThe AbstractColorChooserPanel ClassPropertiesProtected Helper MethodChooser Panel MethodsThe ColorChooserComponentFactory ClassMethodsDeveloping a Custom Chooser PanelCustom Preview PanelDeveloping a Custom Dialog
13. Borders
Introducing BordersThe Border InterfaceMethodsPainting Borders CorrectlyThe AbstractBorder ClassConstructorMethods
Swing Borders
The BevelBorder and SoftBevelBorder ClassesConstantsProtected FieldsConstructorsMethodsMiscellaneousChanging Borders on the FlyThe Empty Border ClassPropertyProtected FieldsConstructorsMethodThe EtchedBorder ClassPropertiesConstantsProtected FieldsConstructorsMiscellaneousThe LineBorder ClassProtected FieldsConstructorsMethodsMiscellaneousThe MatteBorder ClassPropertyFieldsConstructorsMethodBoth Kinds of Matte BorderThe TitledBorder ClassPropertiesConstantsProtected FieldsConstructorsMiscellaneousUsing a Titled Border
The CompoundBorder Class
PropertiesConstructorsMiscellaneousThe BorderFactory ClassMethods
Creating Your Own Border
14. Menus and Toolbars
Introducing Swing MenusMenu HierarchyGetting Your Feet Wet
Menu Bar Selection Models
The SingleSelectionModel InterfacePropertiesEventsMethodsThe DefaultSingleSelectionModel ClassPropertiesEventsProtected FieldsMethod
The JMenuBar Class
Menubar PlacementPropertiesConstructorMenusMiscellaneousMenu Element Interface
The JMenuItem Class
Menu Item ShortcutsImagesEvent HandlingPropertiesConstructorsEventsMethodsMenu Element InterfaceThe MenuDragMouseEvent ClassConstructorThe MenuDragMouseListener InterfaceMethodsThe MenuKeyEvent ClassConstructorThe MenuKeyListener InterfaceMethods
The JPopupMenu Class
Displaying the Popup MenuPropertiesEventsConstructorMenu ItemsDisplayMiscellaneousMenu Element InterfaceUsing Popup MenusThe PopupMenuEvent ClassConstructorThe PopupMenuListener ClassMethods
The JMenu Class
PropertiesConstructorMenu ItemsMiscellaneousEventsMenu Element InterfaceWorking with MenusThe MenuEvent ClassConstructorThe MenuListener InterfaceMethods
Selectable Menu Items
The JCheckBoxMenuItem ClassPropertiesConstructorsMiscellaneousUsing Checkbox Menu ItemsThe JRadioButtonMenuItem ClassPropertiesConstructorsMiscellaneousEnforcing Mutual ExclusionThe JSeparator ClassPropertiesConstructorMiscellaneousUsing a Separator Outside of a MenuThe MenuElement InterfaceMaking arbitrary components into menu elements
Toolbars
The JToolBar ClassFloating ToolbarsPropertiesEventsConstructorsAdding ActionsMiscellaneousCreating a ToolbarThe MetalToolBarUI isRollover property
15. Tables
Table ColumnsThe TableColumn ClassPropertiesConstantsEventsFieldsConstructorsMiscellaneous MethodsThe TableColumnModel InterfacePropertiesEventsColumn MethodsThe DefaultTableColumnModel ClassPropertiesEventsFieldsConstructorsMethodsThe TableColumnModelEvent ClassFieldsConstructorsEvent MethodsThe TableColumnModelListener InterfaceImplementing A Column Model
Table Data
The TableModel InterfacePropertiesEventsCell MethodsThe AbstractTableModel ClassFieldsEventsTableModel MethodsThe TableModelEvent ClassConstantsFieldsConstructorsThe TableModelListener InterfaceThe DefaultTableModel ClassPropertiesEventsFieldsConstructorsData MethodsRow and Column MethodsDynamic Table DataDatabase Data
The JTable Class
PropertiesEventsConstantsFieldsConstructorsProtected Initialization and Helper MethodsEditor and Renderer MethodsSelection MethodsRow and Column MethodsCell MethodsEvent Listener Support MethodsMiscellaneous MethodsThe JTableHeader ClassPropertiesFieldsConstructorsColumn MethodsMiscellaneous MethodsTooltip and UI Methods
Editing and Rendering
The TableCellRenderer InterfaceThe DefaultTableCellRenderer ClassPropertiesProtected ConstantsConstructorsInner ClassesRenderer MethodsThe TableCellEditor Interface
Selecting Table Entries
16. Advanced Table Examples
A Table with Row Headers
Large Tables with Paging
Charting Data with a TableModel
17. Trees
A Simple TreeTree Terminology
Tree Models
The TreeModel InterfacePropertyEventsMiscellaneous MethodsThe DefaultTreeModel ClassPropertiesEventsFieldsConstructorsMiscellaneous MethodsWorking with Tree Models
Tree Nodes and Paths
The TreeNode InterfacePropertiesChild Access MethodsThe MutableTreeNode InterfacePropertiesMutation MethodsThe DefaultMutableTreeNode ClassPropertiesConstantFieldsConstructorsStructure MethodsEnumeration MethodsMiscellaneous MethodsThe TreePath ClassPropertiesFieldsConstructorsMiscellaneous Methods
The JTree Class
PropertiesEventsConstantsFieldsConstructorsTree Model MethodsSelection MethodsExpansion MethodsPath and Row MethodsEditing MethodsMiscellaneous MethodsJTree Inner ClassesUI Methods
Tree Selections
The RowMapper InterfaceThe TreeSelectionModel InterfacePropertiesConstantsEventsSelection MethodsThe DefaultTreeSelectionModel ClassPropertiesEventsConstantFieldsConstructorsAdditional Methods
Tree Events
The TreeModelEvent ClassFieldsConstructorsMethodsThe TreeModelListener InterfaceThe TreeSelectionEvent ClassFieldsConstructorsMethodsThe TreeSelectionListener InterfaceThe TreeExpansionEvent ClassFieldsConstructorsMethodsThe TreeExpansionListener InterfacePending Expansion EventsThe TreeWillExpandListener InterfaceThe ExpandVetoException ClassConstructorsFieldsImplementing the Expansion Listener Interface
Rendering and Editing
Rendering NodesBut I only want to change the icons!The DefaultTreeCellRenderer ClassPropertiesConstructorsFieldsRendering MethodsCustom RenderersThe TreeCellRenderer InterfaceEditing NodesThe TreeCellEditor InterfaceThe DefaultTreeCellEditor ClassPropertiesEventsFieldsConstructorsEvent MethodsCellEditor and TreeCellEditor MethodsHelper MethodsInner ClassesLook-and-Feel Helper Classes
What Next?
18. Undo
The Swing Undo FacilityThe UndoableEdit InterfacePropertiesEdit Merging MethodsOther MethodsThe AbstractUndoableEdit ClassPropertiesConstantsConstructorsUndoableEdit MethodsOther MethodsCreating a Toggle EditThe CompoundEdit ClassPropertiesProtected FieldsConstructorsUndoableEdit MethodsOther MethodsUsing Compound EditsThe UndoableEditEvent ClassPropertyConstructorsThe UndoableEditListener InterfaceMethodsThe UndoManager ClassA Codeless ExampleTransformer?PropertiesConstructorUndoableEditListener MethodUndoableEdit MethodsNew Public MethodsProtected MethodsOther MethodsUsing an Undo ManagerUnderstanding the UndoManager in-depthExtending UndoManagerThe StateEditable InterfaceMethodsThe StateEdit ClassState OptimizationPropertyProtected FieldsConstructorsUndoableEdit MethodsNew Public MethodsProtected MethodsStateEdit ExampleThe UndoableEditSupport ClassPropertyProtected FieldsConstructorsUndoableEditEvent/Listener Support MethodsNested Edit SupportOther MethodsUsing Undoable Edit SupportThe CannotRedoException ClassThe CannotUndoException ClassExtending UndoManager
19. Text 101
The Swing Text ComponentsThe JTextComponent ClassPropertiesEventsConstantsConstructorsClipboard MethodsSelection MethodsView MethodsWorking with KeymapsOther MethodsThe JTextComponent.KeyBinding ClassFieldsConstructorsThe JTextField ClassPropertiesEventsConstantsConstructorsPublic MethodsProtected MethodsA Simple FormUnderstanding JTextField SizingRestricting InputThe JPasswordField ClassPropertiesConstructorsData Protection MethodsMiscellaneous MethodsThe JTextArea ClassPropertiesEventsConstructorsText Manipulation MethodsLine Transformation MethodsProtected MethodsUnderstanding JTextArea SizingThe JEditorPane ClassPropertiesEventsConstructorsEditorKit MethodsMiscellaneous MethodsThe HyperlinkListener InterfaceThe HyperlinkEvent ClassPropertiesConstructorsInner ClassesThe JTextPane ClassUsing the JTextPane
More to Come
20. Document Model and Events
The Document ModelThe Document InterfacePropertiesEventsConstantsText Manipulation MethodsOther MethodsThe Element InterfacePropertiesMiscellaneous MethodThe ElementIterator ClassConstructorsMethodsThe AttributeSet InterfacePropertiesMethodsInner InterfacesThe MutableAttributeSet InterfacePropertiesMethodsThe SimpleAttributeSet ClassPropertiesConstantConstructorsAdd/Remove MethodsQuery MethodsMiscellaneous MethodsUsing a Resolving ParentThe Position InterfacePropertyAn ExampleThe Position.Bias ClassConstantsMethodsThe Segment ClassFieldsConstructorsMethodsThe AbstractDocument ClassPropertiesEventsConstantsFieldConstructorsLockingReading and WritingOther Public MethodsOther Protected MethodsDocument Locking ExampleThe AbstractDocument.AbstractElement ClassPropertiesConstructorsAttributeSet MethodsMutableAttributeSet MethodsTreeNode MethodsOther MethodsThe AbstractDocument.LeafElement ClassPropertiesConstructorMethodsThe AbstractDocument.BranchElement ClassPropertiesConstructorMethodsThe AbstractDocument.Content InterfaceMethodsThe StringContent ClassConstructorsPublic MethodsProtected MethodsThe GapContent ClassConstructorsAbstractDocument.Content MethodsThe AbstractDocument.AttributeContext InterfacePropertyAttribute ManagementThe BadLocationException ClassConstructorMethodsModel Summary So FarThe PlainDocument ClassPropertyConstantsConstructorsProtected MethodsLooking at PlainDocument’s Element StructuresFiltering JTextFields
Document Events
The DocumentEvent InterfacePropertiesChange DetailsThe DocumentEvent.EventType ClassMethodThe DocumentEvent.ElementChange InterfacePropertiesThe DocumentListener InterfaceMethodsDocument and Undo Event Example
Advanced AbstractDocument Event Model
The AbstractDocument.ElementEdit ClassPropertiesConstructorUndoableEdit MethodsThe AbstractDocument.DefaultDocumentEvent ClassPropertiesConstructorUndoableEdit MethodsDocumentEvent MethodOther Method
21. Styled Documents and JTextPane
StyleThe Style InterfacePropertyEventsThe StyleConstants ClassStyleConstants Inner ClassesAttribute ConstantsOther Attribute ConstantsAlignment Value ConstantsElement Name ConstantsLookup and Update MethodsThe TabStop ClassPropertiesAlignment ConstantsLeader ConstantsConstructorsObject MethodsThe TabSet ClassPropertiesConstructorMethodsThe StyleContext ClassPropertiesEventsConstantsConstructorAttributeContext MethodsA Look InsideStyle Management MethodsFont Management MethodsColor Accessor MethodsSerialization MethodsOther MethodsThe StyledContext.NamedStyle ClassPropertiesEventsFieldsConstructorsAttributeSet MethodsMutableAttributeSet MethodsOther MethodThe StyledDocument InterfacePropertiesSpecific Attribute AccessorsStyle ManagementElement Query MethodsAttributeSet Modification MethodsThe DefaultStyledDocument ClassPropertiesConstantConstructorsSpecific Attribute AccessorsStyle Management MethodsElement Query MethodsAttribute Modification MethodsElement Structure MethodsOther Protected MethodsThe DefaultStyledDocument.SectionElement ClassPropertiesConstructorThe DefaultStyledDocument.ElementSpec ClassPropertiesDirection ConstantsType ConstantsConstructorsMethodsThe DefaultStyledDocument.ElementBuffer ClassPropertyConstructorPublic MethodsProtected MethodsThe JTextPane ClassPropertiesConstructorsStyledDocument Delegation MethodsAttribute and Style MethodsAdding Non-Text ContentOther Public MethodProtected Methods
A Stylized Editor
22. Carets, Highlighters, and Keymaps
JTextComponent UI PropertiesThe Caret InterfacePropertiesEventsMethodsThe DefaultCaret ClassPropertiesEventsFieldsConstructorsCaret MethodsFocusListener MethodsMouse MethodsProtected MethodsAn XOR CaretThe CaretListener InterfaceMethodThe CaretEvent ClassPropertiesConstructorThe Highlighter InterfacePropertyMethodsThe Highlighter.Highlight InterfacePropertiesThe Highlighter.HighlightPainter InterfaceMethodThe DefaultHighlighter ClassPropertyConstructorMethodsThe DefaultHighlighter.DefaultHighlightPainter ClassPropertyConstructorMethodA Custom HighlighterThe Keymap InterfacePropertiesMethodsKeymap ImplementationAdding Keyboard Actions
23. Text Views
Text ViewsA Few NotesShape vs. RectangleFloatsSpan and AllocationOverview of the View ClassesThe “Root” View
The View Classes
The View ClassPropertiesConstructorConstantsMiscellaneous Public MethodsUpdate MethodsAbstract MethodThe ViewFactory InterfaceFactory MethodThe TabExpander InterfaceMethodsThe TabableView InterfaceMethodsThe Utilities ClassPublic Static MethodsThe PlainView ClassPropertiesFieldConstructorDocument Event MethodsTabExpander MethodOther Public MethodsProtected Drawing MethodsOther Protected MethodsThe FieldView ClassPropertiesConstructorsPublic MethodsProtected MethodsThe PasswordView ClassPropertiesConstructorsProtected MethodsThe LabelView ClassPropertiesConstructorTabableView MethodsOther Public MethodsProtected MethodsThe ComponentView ClassPropertiesConstructorMethodsThe IconView ClassPropertiesConstructorsMethodsThe CompositeView ClassPropertiesConstructorsView MethodsNew Public MethodsProtected MethodsAbstract Protected MethodsThe BoxView ClassPropertiesConstructorDocument Update MethodsPublic MethodsCompositeView Protected MethodsOther Protected MethodsThe ParagraphView ClassPropertiesConstructorTabExpander MethodsDocument Change MethodsNew Public MethodsBoxView (and Superclasses) MethodsNew Protected MethodsThe WrappedPlainView ClassPropertiesConstructorsTabExpander MethodsDocument Update MethodsBoxView MethodsNew Protected MethodsThe TableView ClassPropertiesConstructorBoxView MethodsNew Protected MethodsThe TableView.TableRow ClassPropertiesConstructorMethodsThe TableView.TableCell ClassPropertiesConstructorNew MethodsBoxView Method
24. EditorKits and TextActions
Overview of the Editor KitsThe EditorKit ClassPropertiesConstructorAbstract MethodsOther MethodsThe TextAction ClassConstructorStatic MethodProtected MethodsThe DefaultEditorKit ClassPropertiesConstantsUsing ActionsConstructorMethodsThe DefaultEditorKit.DefaultKeyTypedAction ClassConstructorMethodThe DefaultEditorKit.BeepAction ClassConstructorMethodThe DefaultEditorKit.CopyAction ClassConstructorMethodThe DefaultEditorKit.CutAction ClassConstructorMethodThe DefaultEditorKit.InsertBreakAction ClassConstructorMethodThe DefaultEditorKit.InsertContentAction ClassConstructorMethodThe DefaultEditorKit.InsertTabAction ClassConstructorMethodThe DefaultEditorKit.PasteAction ClassConstructorMethodA Simple Text EditorThe StyledEditorKit ClassPropertiesConstructorEditorKit MethodsThe StyledEditorKit.StyledTextAction ClassConstructorProtected MethodsThe StyledEditorKit.FontFamilyAction ClassConstructorMethodThe StyledEditorKit.FontSizeAction ClassConstructorMethodThe StyledEditorKit.ForegroundAction ClassConstructorMethodThe StyledEditorKit.AlignmentAction ClassConstructorMethodThe StyledEditorKit.BoldAction ClassConstructorMethodThe StyledEditorKit.ItalicAction ClassConstructorMethodThe StyledEditorKit.UnderlineAction ClassConstructorMethodA Better EditorSaving Styled DocumentsThe HTML PackageParsing HTMLRepresenting HTMLDisplaying HTMLWriting HTMLMuch, Much MoreRTFEditorKitPropertyConstructorMethodsGenerating RTF OutputThe AbstractWriter ClassConstantConstructorsAbstract MethodOutput Generating MethodsOther MethodsImplementing AbstractWriterBuilding Your Own EditorKitCreate the EditorKit ClassDefine the Document TypeDefine New ActionsCreate Custom View ClassesCreate a ViewFactory and View ClassesCreate a “Reader” and a “Writer”Tell JEditorPane about Your New Kit
Phew!
25. Programming with Accessibility
How Accessibility WorksJDK 1.2 AccessibilityThe Accessibility ContractHow Do I Get It?SwingAWT
The Accessibility Package
The Path to Determining AccessibilityThe Accessible InterfaceMethodThe AccessibleContext ClassPropertiesAccessible Names and DescriptionsConstructorEventsConstants
Other Accessible Objects
AccessibleStateConstructorAccessibleStateSetFieldConstructorsMethodsAccessibleRoleConstructor
The Six Types of Accessibility
The AccessibleAction InterfacePropertiesMethodThe AccessibleComponent InterfacePropertiesMethodsEventsThe AccessibleSelection InterfacePropertiesMethodsThe AccessibleText InterfacePropertiesConstantsMethodsThe AccessibleHypertext InterfacePropertiesThe AccessibleHyperlink ClassPropertiesMethodThe AccessibleValue InterfaceMethodsImplementing AccessibleAction
The Accessibility Utility Classes
The EventQueueMonitor ClassConstructorInitializationMethodsThe AWTEventMonitor ClassFieldsConstructorMethodsThe SwingEventMonitor ClassFieldsConstructorMethodsThe TopLevelWindowListener InterfaceMethodsThe GUIInitializedListener InterfaceMethod
Interfacing with Accessibility
26. Look & Feel
How Does It Work?
Key L&F Classes and Interfaces
The LookAndFeel ClassPropertiesConstructorMethodsStatic Convenience MethodsThe UIDefaults ClassEventsConstructorsMethodsThe UIDefaults.ActiveValue InterfaceMethodCreating an ActiveValueThe UIDefaults.LazyValue InterfaceMethodCreating a LazyValueThe UIResource InterfaceStatic BorderUIResource MethodsBorderUIResource Inner ClassesThe UIManager ClassLAFStateUIManager L&F ConceptsLook-and-Feel Properties FileEventsUIDefaults Convenience MethodsOther Static MethodsChanging the Look-and-FeelManaging DefaultsThe UIManager.LookAndFeelInfo ClassPropertiesConstructorMethodThe ComponentUI ClassMethodsStatic Method
The MultiLookAndFeel
Creating an Auxilliary Look-and-FeelInstalling the MultiLookAndFeel
Look-and-Feel Customization
Modification of Component PropertiesModification of the UI DefaultsMaking Global Changes with DefaultsUse of Metal’s ThemesMetalTheme PropertiesAbstract Protected MethodsBlack and WhiteAdditional CustomizationDefaultMetalTheme Font PropertiesProtected DefaultMetalTheme Base ColorsUse of Metal’s Client PropertiesReplacement of Individual UI DelegatesModifying a Scrollbar
Creation of a Custom L&F
The PlainLookAndFeelCreating the LookAndFeel ClassDefining Class DefaultsDefining L&F ColorsDefining Component DefaultsDefining an Icon FactoryDefining Custom BordersThe BasicGraphicsUtils ClassMethodsCreate the Individual UI DelegatesDefine a ConstructorDefine the Factory MethodDefine installUI() and uninstallUI() (optional)Define Component SizeOverride Component-Specific DetailsPaint the ComponentDon’t Forget to Use ItHow’s It Look?One Down...
27. Swing Utilities
General UtilitiesThe SwingUtilities ClassConstructorClass MethodsThe SwingConstants InterfaceThe Timer ClassPropertiesEventsFieldsConstructorTimer Control MethodsThe ToolTipManager ClassPropertiesFieldsMouse Event MethodsMiscellaneous MethodsThe JToolTip ClassPropertiesConstructorUI Method
Editing and Rendering Utilities
The CellRendererPane ClassPropertyFieldConstructorMethodsInner ClassesThe CellEditor InterfaceEventsMethodsThe CellEditorListener InterfaceThe DefaultCellEditor ClassPropertiesEventsConstructorsFieldsTree and Table Editor Methods
Event Utilities
The EventListenerList ClassFieldConstructorListener MethodsThe KeyStroke ClassPropertiesKey CodesInstantiation MethodsOverriden Object MethodsThe MouseInputAdapter ClassMethodsThe SwingPropertyChangeSupport ClassConstructorMethods
Image Utilities
The GrayFilter ClassConstructorsImage MethodsThe Renderer Interface
28. Swing Under the Hood
Creating Your Own ComponentCreating the ComponentYou Should Have a Model and a UI DelegateCreating a ModelReuse or Extend Existing Models Whenever PossibleDecide on Properties and Create the Model InterfaceSend Events When Bound Properties ChangeReuse the EventListenerList ClassDon’t Put Component Properties in the ModelImplement the ModelThe UI DelegateCreate an Abstract Type ClassYou Must Implement a Paint MethodBe Able To Resize YourselfCreating the Component ItselfDecide on PropertiesListen to Your ModelsSend Events When Bound Properties ChangeSome Final QuestionsThe Jog Shuttle: A Simple Swing ComponentThe ComponentThe UI DelegateA Toy Using the Shuttle
Working with Focus
Focus Cycle RootManaging FocusFocus TraversableRequest Focus EnabledNext Focusable ComponentUsing the Focus PropertiesThe FocusManager ClassConstantConstructorMethodsThe DefaultFocusManager ClassConstructorMethodsWriting Your Own Focus Manager
Lightweight vs. Heavyweight Components
Understanding the Z-OrderMixing Swing and AWTOverlapping Heavyweight and Lightweight ComponentsHeavyweight Components in Front of Lightweight MenusPopupsHeavyweight Components in JScrollPaneHeavyweight Components Inside of Internal Frames
Multithreading Issues with Swing
When Is Thread Safety an Issue?Don’t Be FooledUpdating Components in the Event Dispatch ThreadMethodsManaging Synchronization Properly
Painting and Repainting
Swing ResponsibilitiesThe RepaintManager ClassKey MethodsMethods
A. Look & Feel Resources
Index
Colophon

Content preview from Java Swing

Lightweight vs. Heavyweight Components

The issue of lightweight and heavyweight components has plagued Swing since its early days. What has confused the majority of programmers from the start is the idea of z-order, or layering, among the Swing lightweight components and the AWT heavyweight components.

Understanding the Z-Order

In Swing, it might help to think of a heavyweight component as an artist’s easel. Recall that top-level components in Swing (JWindow, JDialog, JApplet, and JFrame) are heavyweight, everything else isn’t. Lightweight components that are 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.

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 will always be on top; the lightweight components must share the same z-order as the parent container. In addition, lightweight components cannot draw themselves outside the container (easel) they reside in, or they will be clipped.

Consider heavyweight components as easels and lightweight components as drawings

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

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: 156592455XCatalog Page Errata

Cloud Computing

Data Engineering

Data Science

AI & ML

Programming Languages

Software Architecture

IT/Ops

Security

Design

Business

Soft Skills

Java Swing

by Robert Eckstein, Marc Loy, Dave Wood

Lightweight vs. Heavyweight Components

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.