com.jidesoft.swing.Alignable Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jide-oss Show documentation

JIDE Common Layer (Professional Swing Components)

There is a newer version: 3.6.18

/*
 * @(#)Alignable.java
 *
 * Copyright 2002 - 2004 JIDE Software. All rights reserved.
 */
package com.jidesoft.swing;

/**
 * Alignable is an interface that can be implemented by any
 * components to provide information such as how to set orientation and
 * check whether a component supports vertical orientation or horizontal
 * orientation.
 * 
 * Some components support both vertical orientation and horizontal orientation.
 * For example, an icon-only JideButton. It can be put on either a vertical toolbar
 * or normal horizontal toolbar. However most components don't support both. For
 * example, a combo box. It's hard to imagine a combobox putting on a vertical toolbar.
 * 

 * By implementing this interface, a component can choose if it wants to support vertical
 * orientation or horizontal orientation. However if a component which doesn't implement this
 * interface is added to toolbar, by default, it will be treated as supportHorizontalOrientation()
 * returning true and supportVerticalOrientation() returning false.
 */
public interface Alignable {
    /**
     * Property name to indicate the orientation is changed.
     */
    public final static String PROPERTY_ORIENTATION = "orientation";

    /**
     * Checks if the component support vertical orientation.
     * doesn't consider the component orientation, it should return false.
     *
     * @return ture if it supports vertical orientation
     */
    boolean supportVerticalOrientation();

    /**
     * Checks if the component support horizontal orientation.
     *
     * @return ture if it supports horizontal orientation
     */
    boolean supportHorizontalOrientation();

    /**
     * Changes the orientation. If the component is a Swing component, the default implemenation is this.
     * 
JideSwingUtilities.setOrientationOf(this, orientation);
     *
     * @param orientation the new orientation
     */
    void setOrientation(int orientation);

    /**
     * Gets the orientation. If the component is a Swing component, the default implemenation is this.
     * 
return JideSwingUtilities.getOrientationOf(this);
     *
     * @return orientation
     */
    int getOrientation();
}