com.alee.extended.collapsible.AbstractTitleLabel Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of weblaf-ui Show documentation
WebLaF UI components
There is a newer version: 1.2.14
/*
 * This file is part of WebLookAndFeel library.
 *
 * WebLookAndFeel library is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * WebLookAndFeel library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with WebLookAndFeel library.  If not, see .
 */

package com.alee.extended.collapsible;

import com.alee.api.annotations.NotNull;
import com.alee.api.annotations.Nullable;
import com.alee.api.data.BoxOrientation;
import com.alee.extended.label.WebStyledLabel;
import com.alee.managers.language.LM;
import com.alee.managers.style.StyleId;
import com.alee.painter.decoration.DecorationState;
import com.alee.painter.decoration.DecorationUtils;
import com.alee.painter.decoration.Stateful;

import javax.swing.*;
import java.awt.*;
import java.util.ArrayList;
import java.util.List;

/**
 * Custom {@link WebStyledLabel} used as default {@link WebCollapsiblePane} title component.
 *
 * @author Mikle Garin
 * @see WebCollapsiblePane#createTitleComponent()
 * @see WebCollapsiblePane#setIcon(Icon)
 * @see WebCollapsiblePane#setTitle(String)
 * @see WebCollapsiblePane#setTitleComponent(Component)
 */
public abstract class AbstractTitleLabel extends WebStyledLabel implements Stateful
{
    /**
     * Constructs new {@link AbstractTitleLabel}.
     */
    public AbstractTitleLabel ()
    {
        this ( StyleId.auto );
    }

    /**
     * Constructs new {@link AbstractTitleLabel}.
     *
     * @param id style ID
     */
    public AbstractTitleLabel ( final StyleId id )
    {
        super ( id );
    }

    @Override
    public void setIcon ( @Nullable final Icon icon )
    {
        super.setIcon ( icon );
        DecorationUtils.fireStatesChanged ( this );
    }

    @Override
    public void setText ( @Nullable final String text )
    {
        if ( LM.contains ( text ) )
        {
            setLanguage ( text );
        }
        else
        {
            super.setText ( text );
        }
    }

    /**
     * Returns header panel position.
     *
     * @return header panel position
     */
    @NotNull
    public abstract BoxOrientation getHeaderPosition ();

    /**
     * Returns whether or not {@link WebCollapsiblePane} is expanded.
     *
     * @return {@code true} if {@link WebCollapsiblePane} is expanded, {@code false} otherwise
     */
    public abstract boolean isExpanded ();

    /**
     * Returns whether or not {@link WebCollapsiblePane} is in transition to either of two expansion states.
     *
     * @return {@code true} if {@link WebCollapsiblePane} is in transition, {@code false} otherwise
     */
    public abstract boolean isInTransition ();

    @Nullable
    @Override
    public List getStates ()
    {
        final List states = new ArrayList ( 3 );

        // Header position state
        states.add ( getHeaderPosition ().name () );

        // Expansion state
        states.add ( isExpanded () || isInTransition () ? DecorationState.expanded : DecorationState.collapsed );

        // Icon state
        if ( getIcon () != null )
        {
            states.add ( DecorationState.hasIcon );
        }

        return states;
    }

    /**
     * A subclass of {@link AbstractTitleLabel} that implements {@link javax.swing.plaf.UIResource}.
     * This subclass is used by {@link WebCollapsiblePaneUI} to setup default style.
     * If you want to customize {@link AbstractTitleLabel} with your own style do not use this subclass.
     */
    public static abstract class UIResource extends AbstractTitleLabel implements javax.swing.plaf.UIResource
    {
        /**
         * Implementation is used completely from {@link AbstractTitleLabel}.
         */
    }
}