Deprecated API

Contents

• Classes
• Methods

Deprecated Classes

Class	Description
swingtree.style.LibraryInternalCrossPackageStyleUtil

Deprecated Methods

Method	Description
swingtree.AbstractDelegate.setMaxSize(Dimension)	Use AbstractDelegate.setMaxSize(Size) instead!
swingtree.AbstractDelegate.setMinSize(Dimension)	Use AbstractDelegate.setMinSize(Size) instead!
swingtree.AbstractDelegate.setPrefSize(Dimension)	Use AbstractDelegate.setPrefSize(Size) instead of this method.
swingtree.AbstractDelegate.setSize(Dimension)	Use AbstractDelegate.setSize(Size) instead of this method!
swingtree.components.JSplitButton.addSplitButtonActionListener(SplitButtonActionListener)	Use JSplitButton.addButtonClickedActionListener(swingtree.components.action.ButtonClickedActionListener) or JSplitButton.addSplitButtonClickedActionListener(swingtree.components.action.SplitButtonClickedActionListener) instead.
swingtree.components.JSplitButton.removeSplitButtonActionListener(SplitButtonActionListener)	Use JSplitButton.removeButtonClickedActionListener(swingtree.components.action.ButtonClickedActionListener) or JSplitButton.removeSplitButtonClickedActionListener(swingtree.components.action.SplitButtonClickedActionListener) instead.
swingtree.style.ComponentStyleDelegate.component()	because it introduces the following two issues: SwingTree styles are expected to be side effect free functions. The JComponent however is mutable and very sensitive to repaints. Mutating a component in a styler can lead to things like endless repaints and other bugs which are extremely hard to track... A developer may want to access the dimensions of a component to perform rendering in a custom Painter. Unfortunately, the dimensions of a component are not in "developer pixels"! Instead, they are already scaled to the current UI.scale(). To prevent scaling issues, use ComponentStyleDelegate.componentWidth() and ComponentStyleDelegate.componentHeight() for the current size, or ComponentStyleDelegate.componentPrefWidth() and ComponentStyleDelegate.componentPrefHeight() for the preferred size. These are all scaled down to "developer pixel". This matters in particular when the size you read here is fed back into the styling API (e.g. ComponentStyleDelegate.minHeight(double) or ComponentStyleDelegate.maxHeight(double)), because those methods scale their inputs up again. Reading component().getPreferredSize() directly and passing it back in would scale the value twice.
swingtree.style.ComponentStyleDelegate.parent()	because it introduces the following two issues: SwingTree styles are expected to be side effect free functions. The parent of a JComponent however is mutable and very sensitive to repaints. Mutating a component in a styler can lead to things like endless repaints and other bugs which are extremely hard to track... A developer may want to access the dimensions of a component to perform rendering in a custom Painter. Unfortunately, the dimensions of a parent component are not in "developer pixels"! Instead, they are already scaled to the current UI.scale().
swingtree.style.ComponentStyleDelegate.peek(Peeker<C>)	because it introduces the following two issues: SwingTree styles are expected to be side effect free functions. The parent of a JComponent however is mutable and very sensitive to repaints. Mutating a component in a styler can lead to things like endless repaints and other bugs which are extremely hard to track... A developer may want to access the dimensions of a component to perform rendering in a custom Painter. Unfortunately, the dimensions of a parent component are not in "developer pixels"! Instead, they are already scaled to the current UI.scale().
swingtree.style.LibraryInternalCrossPackageStyleUtil._findComponentUIOf(JComponent)
swingtree.style.LibraryInternalCrossPackageStyleUtil._onlyBorderInsetsOf(Border, Component)
swingtree.style.LibraryInternalCrossPackageStyleUtil.applyFontConfAlignmentsToComponent(FontConf, JComponent)