2
* Copyright (c) 2005-2010 Substance Kirill Grouchnikov. All Rights Reserved.
4
* Redistribution and use in source and binary forms, with or without
5
* modification, are permitted provided that the following conditions are met:
7
* o Redistributions of source code must retain the above copyright notice,
8
* this list of conditions and the following disclaimer.
10
* o Redistributions in binary form must reproduce the above copyright notice,
11
* this list of conditions and the following disclaimer in the documentation
12
* and/or other materials provided with the distribution.
14
* o Neither the name of Substance Kirill Grouchnikov nor the names of
15
* its contributors may be used to endorse or promote products derived
16
* from this software without specific prior written permission.
18
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
20
* THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
22
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
23
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
24
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
25
* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
26
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
27
* OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
28
* EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30
package org.pushingpixels.substance.api.shaper;
34
import javax.swing.AbstractButton;
35
import javax.swing.border.Border;
37
import org.pushingpixels.substance.api.trait.SubstanceTrait;
40
* Button shaper interface for <b>Substance</b> look and feel. This class is
41
* part of officially supported API.
43
* @author Kirill Grouchnikov
45
public interface SubstanceButtonShaper extends SubstanceTrait {
49
* @see org.pushingpixels.substance.utils.SubstanceTrait#getDisplayName()
52
public String getDisplayName();
55
* Returns the outline path for the specified button.
66
* Indication whether the returned outline is used for the inner
68
* @return The outline path for the specified button.
70
public Shape getButtonOutline(AbstractButton button, Insets insets,
71
int width, int height, boolean isInner);
74
* Returns the border for the specified button.
78
* @return The border for the specified button.
80
public Border getButtonBorder(AbstractButton button);
83
* Returns the preferred size for the specified button.
87
* @param uiPreferredSize
88
* Preferred size of the button under the regular conditions
89
* (plain rectangular button).
90
* @return The preferred size for the specified button.
92
public Dimension getPreferredSize(AbstractButton button,
93
Dimension uiPreferredSize);
96
* Returns the boolean indication whether the shaper should maintain button
97
* proportions on the resize. This may be relevant for vector-based shapers
98
* (such as animals / other objects).
100
* @return <code>true</code> if <code>this</code> shaper should maintain
101
* button proportions on the resize, <code>false</code> otherwise.
104
public boolean isProportionate();