Package swingtree.api

Interface AnimatedStyler<C extends JComponent>

Type Parameters:

C - the type of the JComponent that the ComponentStyleDelegate is delegating to.

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface AnimatedStyler<C extends JComponent>

An AnimatedStyler is conceptually a union of the Animation and Styler functions, which is to say that it takes both an AnimationState and a ComponentStyleDelegate to produce a new ComponentStyleDelegate with some style properties applied to it (usually based on the AnimationState).
Note that both paramters are immutable value oriented objects, so the function is pure and does not modify the original ComponentStyleDelegate or AnimationState objects.
This design makes the underlying style engine of SwingTree very flexible and scalable because it allows for the composition of styles and reuse of style logic across many components (see StyleSheet for more advanced usage).

This interface is typically used in AbstractDelegate.animateStyleFor(LifeTime, AnimatedStyler) and AbstractDelegate.animateStyleFor(double, TimeUnit, AnimatedStyler).

Method Summary

Modifier and Type	Method	Description
default AnimatedStyler<C>	andThen(AnimatedStyler<C> other)	Returns a new AnimatedStyler that applies the style of this AnimatedStyler and then applies the style of the given AnimatedStyler.
static <C extends JComponent> AnimatedStyler<C>	none()	A AnimatedStyler that does nothing, meaning it simply returns the given ComponentStyleDelegate without applying any style to it.
ComponentStyleDelegate<C>	style(AnimationState state, ComponentStyleDelegate<C> delegate)	Applies some style to the given ComponentStyleDelegate and returns a new ComponentStyleDelegate that has the style applied (if any).

Method Details

none

static <C extends JComponent> AnimatedStyler<C> none()

A AnimatedStyler that does nothing, meaning it simply returns the given ComponentStyleDelegate without applying any style to it. Conceptually speaking, this returns the null object of the AnimatedStyler type.

Type Parameters:

C - The type of the JComponent that the ComponentStyleDelegate is delegating to.

Returns:

A AnimatedStyler that does nothing.

style

ComponentStyleDelegate<C> style(AnimationState state,
 ComponentStyleDelegate<C> delegate)

Applies some style to the given ComponentStyleDelegate and returns a new ComponentStyleDelegate that has the style applied (if any).

Parameters:

state - The AnimationState which is used to configure the style (usually based on the AnimationState.progress).

delegate - The ComponentStyleDelegate to apply the style to.

Returns:

A new ComponentStyleDelegate that has the style applied.

andThen

default AnimatedStyler<C> andThen(AnimatedStyler<C> other)

Returns a new AnimatedStyler that applies the style of this AnimatedStyler and then applies the style of the given AnimatedStyler.
This method is conceptually equivalent to the Function.andThen(java.util.function.Function).

Parameters:

other - the AnimatedStyler to apply after this AnimatedStyler.

Returns:

a new AnimatedStyler that applies the style of this AnimatedStyler and then applies the style of the given AnimatedStyler.