KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > jgoodies > forms > factories > ComponentFactory


1 /*
2  * Copyright (c) 2003 JGoodies Karsten Lentzsch. All Rights Reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are met:
6  *
7  * o Redistributions of source code must retain the above copyright notice,
8  * this list of conditions and the following disclaimer.
9  *
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.
13  *
14  * o Neither the name of JGoodies Karsten Lentzsch 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.
17  *
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.
29  */
30
31 package com.jgoodies.forms.factories;
32
33 import javax.swing.JComponent JavaDoc;
34 import javax.swing.JLabel JavaDoc;
35
36 /**
37  * An interface that defines the factory methods as used
38  * by the {@link com.jgoodies.forms.builder.PanelBuilder}.
39  *
40  * @author Karsten Lentzsch
41  * @version $Revision: 1.2 $
42  * @see DefaultComponentFactory
43  * @see com.jgoodies.forms.builder.PanelBuilder
44  */
45
46 public interface ComponentFactory {
47     
48     /**
49      * Creates and answers a label with an optional mnemonic.
50      *
51      * @param textWithMnemonic the label's text - may contain a mnemonic
52      * @return an label with optional mnemonic
53      */
54     public JLabel JavaDoc createLabel(String JavaDoc textWithMnemonic);
55   
56     
57     /**
58      * Creates and answers a label that uses the foreground color
59      * and font of a <code>TitledBorder</code>.
60      *
61      * @param textWithMnemonic the title's text - may contain a mnemonic
62      * @return an emphasized title label
63      */
64     public JLabel JavaDoc createTitle(String JavaDoc textWithMnemonic);
65     
66
67     /**
68      * Creates and answers a label with separator on the left hand side.
69      * Useful to separate paragraphs in a panel. This is often a better choice
70      * than a <code>TitledBorder</code>.
71      *
72      * @param text the title's text
73      * @param alignment text alignment: left, center, right
74      * @return a title label with separator on the side
75      */
76     public JComponent JavaDoc createSeparator(String JavaDoc text, int alignment);
77     
78     
79 }
Popular Tags