+2003-08-01 Sascha Brawer <brawer@dandelis.ch>
+
+ * javax/swing/border/BevelBorder.java,
+ javax/swing/border/EtchedBorder.java,
+ javax/swing/border/LineBorder.java,
+ javax/swing/border/MatteBorder.java,
+ javax/swing/border/SoftBevelBorder.java,
+ javax/swing/plaf/BorderUIResource.java,
+ javax/swing/plaf/ComponentUI.java,
+ javax/swing/plaf/TreeUI.java,
+ javax/swing/plaf/basic/BasicBorders.java,
+ javax/swing/plaf/basic/BasicGraphicsUtils.java,
+ javax/swing/plaf/basic/BasicTreeUI.java:
+ Prepend "doc-files" to all paths to embedded Javadoc images, so
+ that the generated documentation contains the correct URL.
+
2003-08-01 Tom Tromey <tromey@redhat.com>
* configure: Rebuilt.
* constructed by this method will automatically reflect a change
* to the component’s background color.
*
- * <p><img src="BevelBorder-1.png" width="500" height="150"
+ * <p><img src="doc-files/BevelBorder-1.png" width="500" height="150"
* alt="[An illustration showing raised and lowered BevelBorders]" />
*
* @param bevelType the desired appearance of the border. The value
* Constructs a BevelBorder given its appearance type and two colors
* for its highlight and shadow.
*
- * <p><img src="BevelBorder-2.png" width="500" height="150"
+ * <p><img src="doc-files/BevelBorder-2.png" width="500" height="150"
* alt="[An illustration showing BevelBorders that were constructed
* with this method]" />
*
* Constructs a BevelBorder given its appearance type and all
* colors.
*
- * <p><img src="BevelBorder-3.png" width="500" height="150"
+ * <p><img src="doc-files/BevelBorder-3.png" width="500" height="150"
* alt="[An illustration showing BevelBorders that were constructed
* with this method]" />
*
* explicitly specify the border colors, or to let the colors derive
* from the background color of the enclosed Component.
*
- * <p><img src="EtchedBorder-1.png" width="500" height="200"
+ * <p><img src="doc-files/EtchedBorder-1.png" width="500" height="200"
* alt="[An illustration of the two EtchedBorder variants]" />
*
* @author Sascha Brawer (brawer@dandelis.ch)
* colors will be derived from the background color of the enclosed
* Component when the border gets painted.
*
- * <p><img src="EtchedBorder-1.png" width="500" height="200"
+ * <p><img src="doc-files/EtchedBorder-1.png" width="500" height="200"
* alt="[An illustration of the two EtchedBorder variants]" />
*
* @param etchType the desired appearance of the border. The value
* explicitly selecting the colors that will be used for
* highlight and shadow.
*
- * <p><img src="EtchedBorder-2.png" width="500" height="200"
+ * <p><img src="doc-files/EtchedBorder-2.png" width="500" height="200"
* alt="[An illustration that shows which pixels get painted
* in what color]" />
*
* Constructs a LineBorder given its color, thickness, and whether
* it has rounded corners.
*
- * <p><img src="LineBorder-1.png" width="500" height="200"
+ * <p><img src="doc-files/LineBorder-1.png" width="500" height="200"
* alt="[An illustration of two LineBorders] />
*
* <p>Note that the enlarged view in the right-hand picture shows
* A border that is filled with either a solid color or with repeated
* icon tiles.
*
- * <p><img src="MatteBorder-1.png" width="500" height="150"
+ * <p><img src="doc-files/MatteBorder-1.png" width="500" height="150"
* alt="[Two MatteBorders]" />
*
* @author Sascha Brawer (brawer@dandelis.ch)
* Constructs a MatteBorder given the width on each side
* and a fill color.
*
- * <p><img src="MatteBorder-2.png" width="500" height="150"
+ * <p><img src="doc-files/MatteBorder-2.png" width="500" height="150"
* alt="[A picture of a MatteBorder made by this constructor]" />
*
* @param top the width of the border at its top edge.
/**
* Constructs a MatteBorder given its insets and fill color.
*
- * <p><img src="MatteBorder-3.png" width="500" height="150"
+ * <p><img src="doc-files/MatteBorder-3.png" width="500" height="150"
* alt="[A picture of a MatteBorder made by this constructor]" />
*
* @param borderInsets an Insets object whose <code>top</code>,
* Constructs a MatteBorder given the width on each side
* and an icon for tiling the border area.
*
- * <p><img src="MatteBorder-4.png" width="500" height="150"
+ * <p><img src="doc-files/MatteBorder-4.png" width="500" height="150"
* alt="[A picture of a MatteBorder made by this constructor]" />
*
* @param top the width of the border at its top edge.
* Constructs a MatteBorder given its insets and an icon
* for tiling the border area.
*
- * <p><img src="MatteBorder-5.png" width="500" height="150"
+ * <p><img src="doc-files/MatteBorder-5.png" width="500" height="150"
* alt="[A picture of a MatteBorder made by this constructor]" />
*
* @param borderInsets an Insets object whose <code>top</code>,
* at the left and right edge, the icon height for the top and
* bottom edge.
*
- * <p><img src="MatteBorder-6.png" width="500" height="150"
+ * <p><img src="doc-files/MatteBorder-6.png" width="500" height="150"
* alt="[A picture of a MatteBorder made by this constructor]" />
*
* @param tileIcon an icon for tiling the border area.
* constructed by this method will automatically reflect a change
* to the component’s background color.
*
- * <p><img src="SoftBevelBorder-1.png" width="500" height="200"
+ * <p><img src="doc-files/SoftBevelBorder-1.png" width="500" height="200"
* alt="[An illustration showing raised and lowered SoftBevelBorders]" />
*
* @param bevelType the desired appearance of the border. The value
* Constructs a SoftBevelBorder given its appearance type and two
* colors for its highlight and shadow.
*
- * <p><img src="SoftBevelBorder-2.png" width="500" height="150"
+ * <p><img src="doc-files/SoftBevelBorder-2.png" width="500" height="150"
* alt="[An illustration showing SoftBevelBorders that were
* constructed with this method]" />
*
* Constructs a SoftBevelBorder given its appearance type and all
* colors.
*
- * <p><img src="SoftBevelBorder-3.png" width="500" height="150"
+ * <p><img src="doc-files/SoftBevelBorder-3.png" width="500" height="150"
* alt="[An illustration showing SoftBevelBorders that were
* constructed with this method]" />
*
* constructed by this method will automatically reflect a change
* to the component’s background color.
*
- * <p><img src="../border/BevelBorder-1.png" width="500" height="150"
+ * <p><img src="../border/doc-files/BevelBorder-1.png"
+ * width="500" height="150"
* alt="[An illustration showing raised and lowered BevelBorders]" />
*
* @param bevelType the desired appearance of the border. The value
* Constructs a BevelBorderUIResource given its appearance type
* and two colors for its highlight and shadow.
*
- * <p><img src="../border/BevelBorder-2.png" width="500" height="150"
- * alt="[An illustration showing BevelBorders that were constructed
- * with this method]" />
+ * <p><img src="../border/doc-files/BevelBorder-2.png" width="500"
+ * height="150" alt="[An illustration showing BevelBorders that were
+ * constructed with this method]" />
*
* @param bevelType the desired appearance of the border. The value
* must be either {@link javax.swing.border.BevelBorder#RAISED}
* Constructs a BevelBorderUIResource given its appearance type
* and all its colors.
*
- * <p><img src="../border/BevelBorder-3.png" width="500" height="150"
- * alt="[An illustration showing BevelBorders that were constructed
- * with this method]" />
+ * <p><img src="../border/doc-files/BevelBorder-3.png" width="500"
+ * height="150" alt="[An illustration showing BevelBorders that
+ * were constructed with this method]" />
*
* @param bevelType the desired appearance of the border. The value
* must be either {@link javax.swing.border.BevelBorder#RAISED}
* always install borders that implement <code>UIResource</code>,
* such as the borders provided by this class.
*
- * <p><img src="../border/EmptyBorder-1.png" width="290" height="200"
+ * <p><img src="../border/doc-files/EmptyBorder-1.png"
+ * width="290" height="200"
* alt="[An illustration of EmptyBorder]" />
*
* @author Brian Jones (cbj@gnu.org)
* always install borders that implement <code>UIResource</code>,
* such as the borders provided by this class.
*
- * <p><img src="../border/EtchedBorder-1.png" width="500" height="200"
- * alt="[An illustration of the two EtchedBorder variants]" />
+ * <p><img src="../border/doc-files/EtchedBorder-1.png" width="500"
+ * height="200" alt="[An illustration of the two EtchedBorder
+ * variants]" />
*
* @author Brian Jones (cbj@gnu.org)
* @author Sascha Brawer (brawer@dandelis.ch)
* appearance. The colors will be derived from the background
* color of the enclosed Component when the border gets painted.
*
- * <p><img src="../border/EtchedBorder-1.png" width="500" height="200"
- * alt="[An illustration of the two EtchedBorder variants]" />
+ * <p><img src="../border/doc-files/EtchedBorder-1.png"
+ * width="500" height="200" alt="[An illustration of the two
+ * EtchedBorder variants]" />
*
* @param etchType the desired appearance of the border. The value
* must be either {@link javax.swing.border.EtchedBorder#RAISED}
* appearance, explicitly selecting the colors that will be used
* for highlight and shadow.
*
- * <p><img src="../border/EtchedBorder-2.png" width="500"
+ * <p><img src="../border/doc-files/EtchedBorder-2.png" width="500"
* height="200" alt="[An illustration that shows which pixels get
* painted in what color]" />
*
* always install borders that implement <code>UIResource</code>,
* such as the borders provided by this class.
*
- * <p><img src="../border/LineBorder-1.png" width="500" height="200"
- * alt="[An illustration of two LineBorders] />
+ * <p><img src="../border/doc-files/LineBorder-1.png" width="500"
+ * height="200" alt="[An illustration of two LineBorders] />
*
* @author Brian Jones (cbj@gnu.org)
* @author Sascha Brawer (brawer@dandelis.ch)
* always install borders that implement <code>UIResource</code>,
* such as the borders provided by this class.
*
- * <p><img src="../border/MatteBorder-1.png" width="500" height="150"
- * alt="[An illustration of two MatteBorders] />
+ * <p><img src="../border/doc-files/MatteBorder-1.png" width="500"
+ * height="150" alt="[An illustration of two MatteBorders] />
*
* @author Brian Jones (cbj@gnu.org)
* @author Sascha Brawer (brawer@dandelis.ch)
* Constructs a MatteBorderUIResource given the width on each side
* and a fill color.
*
- * <p><img src="../border/MatteBorder-2.png" width="500" height="150"
- * alt="[A picture of a MatteBorder made by this constructor]" />
+ * <p><img src="../border/doc-files/MatteBorder-2.png" width="500"
+ * height="150" alt="[A picture of a MatteBorder made by this
+ * constructor]" />
*
* @param top the width of the border at its top edge.
* @param left the width of the border at its left edge.
* Constructs a MatteBorderUIResource given the width on each side
* and an icon for tiling the border area.
*
- * <p><img src="../border/MatteBorder-4.png" width="500"
+ * <p><img src="../border/doc-files/MatteBorder-4.png" width="500"
* height="150" alt="[A picture of a MatteBorder made by this
* constructor]" />
*
* the left and right edge, the icon height for the top and bottom
* edge.
*
- * <p><img src="../border/MatteBorder-6.png" width="500" height="150"
- * alt="[A picture of a MatteBorder made by this constructor]" />
+ * <p><img src="../border/doc-files/MatteBorder-6.png" width="500"
+ * height="150" alt="[A picture of a MatteBorder made by this
+ * constructor]" />
*
- * @param tileIcon an icon for tiling the border area.
+ * @param tileIcon an icon for tiling the border area.
*/
public MatteBorderUIResource(Icon tileIcon)
{
* should not need to access this class; it is internal to Swing
* and the look-and-feel implementations.
*
- * <p><img src="ComponentUI-1.png" width="700" height="550"
+ * <p><img src="doc-files/ComponentUI-1.png" width="700" height="550"
* alt="[UML diagram illustrating the architecture for pluggable
* look and feels]" />
*
/**
* Finds the path that is closest to the specified position.
*
- * <p><img src="TreeUI-1.png" width="300" height="250"
+ * <p><img src="doc-files/TreeUI-1.png" width="300" height="250"
* alt="[A screen shot of a JTree] />
*
* <p>As shown by the above illustration, the bounds of the
* <code>“Button.light”</code>, and
* <code>“Button.highlight”</code>.
*
- * <p><img src="BasicBorders.ButtonBorder-1.png" width="300"
+ * <p><img src="doc-files/BasicBorders.ButtonBorder-1.png" width="300"
* height="170" alt="[A screen shot of the returned border]" />
*
* @return a {@link
* <code>“RadioButton.light”</code>, and
* <code>“RadioButton.highlight”</code>.
*
- * <p><img src="BasicBorders.RadioButtonBorder-1.png" width="300"
+ * <p><img src="doc-files/BasicBorders.RadioButtonBorder-1.png" width="300"
* height="135" alt="[A screen shot of the returned border]" />
*
* @return a {@link
* <code>“ToggleButton.light”</code>, and
* <code>“ToggleButton.highlight”</code>.
*
- * <p><img src="BasicBorders.ToggleButtonBorder-1.png" width="270"
+ * <p><img src="doc-files/BasicBorders.ToggleButtonBorder-1.png" width="270"
* height="135" alt="[A screen shot of the returned border]" />
*
* @return a {@link
* using the keys <code>“MenuBar.shadow”</code> and
* <code>“MenuBar.highlight”</code>.
*
- * <p><img src="BasicBorders.MenuBarBorder-1.png" width="500"
+ * <p><img src="doc-files/BasicBorders.MenuBarBorder-1.png" width="500"
* height="140" alt="[A screen shot of a JMenuBar with this border]" />
*
* @return a {@link #MenuBarBorder}.
* using the keys <code>“SplitPane.darkShadow”</code> and
* <code>“SplitPane.highlight”</code>.
*
- * <p><img src="BasicBorders.SplitPaneBorder-1.png" width="520"
+ * <p><img src="doc-files/BasicBorders.SplitPaneBorder-1.png" width="520"
* height="200" alt="[A screen shot for JSplitPane.HORIZONTAL_SPLIT]" />
*
- * <p><img src="BasicBorders.SplitPaneBorder-2.png" width="520"
+ * <p><img src="doc-files/BasicBorders.SplitPaneBorder-2.png" width="520"
* height="200" alt="[A screen shot for JSplitPane.VERTICAL_SPLIT]" />
*
* @return a {@link #SplitPaneBorder}.
* <code>“SplitPane.highlight”</code>. The color of the
* other two edges is the background color of the divider.
*
- * <p><img src="BasicBorders.SplitPaneDividerBorder-1.png" width="520"
- * height="200" alt="[A screen shot for JSplitPane.HORIZONTAL_SPLIT]" />
+ * <p><img src="doc-files/BasicBorders.SplitPaneDividerBorder-1.png"
+ * width="520" height="200" alt=
+ * "[A screen shot for JSplitPane.HORIZONTAL_SPLIT]" />
*
* @return an instance of <code>SplitPaneDividerBorder</code>, which is
* not a public API class of this package.
* <code>“TextField.light”</code>, and
* <code>“TextField.highlight”</code>.
*
- * <p><img src="BasicBorders.FieldBorder-1.png" width="500"
+ * <p><img src="doc-files/BasicBorders.FieldBorder-1.png" width="500"
* height="200" alt="[A screen shot of a border returned by
* this method]" />
*
* feels better use different borders for their progress bars, or
* they will look really terrible.
*
- * <p><img src="BasicBorders-1.png" width="120" height="80"
+ * <p><img src="doc-files/BasicBorders-1.png" width="120" height="80"
* alt="[A screen shot of a border returned by this method]" />
*/
public static Border getProgressBarBorder()
* Returns a border that is composed of a raised bevel border and a
* one-pixel thick line border.
*
- * <p><img src="BasicBorders-2.png" width="300" height="200"
+ * <p><img src="doc-files/BasicBorders-2.png" width="300" height="200"
* alt="[A screen shot of a border returned by this method]" />
*
* <p>The colors of the border are retrieved from the
* A border whose appearance depends on the state of
* the enclosed button.
*
- * <p><img src="BasicBorders.ButtonBorder-1.png" width="300"
+ * <p><img src="doc-files/BasicBorders.ButtonBorder-1.png" width="300"
* height="170" alt="[A screen shot of this border]" />
*
* @see javax.swing.plaf.basic.BasicGraphicsUtils#drawBezel
* A border that makes its enclosed component appear as lowered
* into the surface. Typically used for text fields.
*
- * <p><img src="BasicBorders.FieldBorder-1.png" width="500"
+ * <p><img src="doc-files/BasicBorders.FieldBorder-1.png" width="500"
* height="200" alt="[A screen shot of this border]" />
*
* @see javax.swing.plaf.basic.BasicGraphicsUtils#drawEtchedRect
* component. If the enclosed component has no such method,
* this border will not occupy any space.
*
- * <p><img src="BasicBorders.MarginBorder-1.png" width="325"
+ * <p><img src="doc-files/BasicBorders.MarginBorder-1.png" width="325"
* height="200" alt="[An illustration that shows how MarginBorder
* determines its borders]" />
*
/**
* A border for drawing a separator line below JMenuBar.
*
- * <p><img src="BasicBorders.MenuBarBorder-1.png" width="500"
+ * <p><img src="doc-files/BasicBorders.MenuBarBorder-1.png" width="500"
* height="140" alt="[A screen shot of a JMenuBar with this border]" />
*
* @author Sascha Brawer (brawer@dandelis.ch)
* Constructs a new MenuBarBorder for drawing a JMenuBar in
* the Basic look and feel.
*
- * <p><img src="BasicBorders.MenuBarBorder-1.png" width="500"
+ * <p><img src="doc-files/BasicBorders.MenuBarBorder-1.png" width="500"
* height="140" alt="[A screen shot of a JMenuBar with this
* border]" />
*
/**
* A border for drawing radio buttons in the Basic look and feel.
*
- * <p><img src="BasicBorders.RadioButtonBorder-1.png" width="300"
+ * <p><img src="doc-files/BasicBorders.RadioButtonBorder-1.png" width="300"
* height="135" alt="[A screen shot of this border]" />
*
* <p>Note about the screen shot: Normally, the
* in the middle of the JSplitPane has its own border class, of which
* an instance can be obtained with {@link #getSplitPaneDividerBorder()}.
*
- * <p><img src="BasicBorders.SplitPaneBorder-1.png" width="520"
+ * <p><img src="doc-files/BasicBorders.SplitPaneBorder-1.png" width="520"
* height="200" alt="[A screen shot for JSplitPane.HORIZONTAL_SPLIT]" />
*
- * <p><img src="BasicBorders.SplitPaneBorder-2.png" width="520"
+ * <p><img src="doc-files/BasicBorders.SplitPaneBorder-2.png" width="520"
* height="200" alt="[A screen shot for JSplitPane.VERTICAL_SPLIT]" />
*
* <p>In contrast to the other borders of the Basic look and feel,
/**
* Paints the border around a <code>JSplitPane</code>.
*
- * <p><img src="BasicBorders.SplitPaneBorder-1.png" width="520"
+ * <p><img src="doc-files/BasicBorders.SplitPaneBorder-1.png" width="520"
* height="200" alt="[A screen shot for JSplitPane.HORIZONTAL_SPLIT]" />
*
- * <p><img src="BasicBorders.SplitPaneBorder-2.png" width="520"
+ * <p><img src="doc-files/BasicBorders.SplitPaneBorder-2.png" width="520"
* height="200" alt="[A screen shot for JSplitPane.VERTICAL_SPLIT]" />
*
* @param c the <code>JSplitPane</code> whose border is to be painted.
/**
* A border for the divider inside a JSplitPane.
*
- * <p><img src="BasicBorders.SplitPaneDividerBorder-1.png"
+ * <p><img src="doc-files/BasicBorders.SplitPaneDividerBorder-1.png"
* width="520" height="200" alt="[A screen shot of this border]" />
*
* @author Sascha Brawer (brawer@dandelis.ch)
/**
* Paints the border around the divider of a <code>JSplitPane</code>.
*
- * <p><img src="BasicBorders.SplitPaneDividerBorder-1.png" width="520"
- * height="200" alt="[A picture that shows which pixels get painted
- * in what color]" />
+ * <p><img src="doc-files/BasicBorders.SplitPaneDividerBorder-1.png"
+ * width="520" height="200" alt="[A picture that shows which pixels
+ * get painted in what color]" />
*
* @param c the <code>JSplitPane</code> whose divider’s border
* is to be painted.
/**
* A border for toggle buttons in the Basic look and feel.
*
- * <p><img src="BasicBorders.ToggleButtonBorder-1.png" width="270"
- * height="135" alt="[A screen shot of this border]" />
+ * <p><img src="doc-files/BasicBorders.ToggleButtonBorder-1.png"
+ * width="270" height="135" alt="[A screen shot of this border]" />
*
* <p>The Sun implementation always seems to draw exactly
* the same border, irrespective of the state of the button.
* Draws a rectangle that appears etched into the surface, given
* four colors that are used for drawing.
*
- * <p><img src="BasicGraphicsUtils-1.png" width="360"
+ * <p><img src="doc-files/BasicGraphicsUtils-1.png" width="360"
* height="200" alt="[An illustration that shows which pixels
* get painted in what color]" />
*
* Draws a rectangle that appears etched into the surface, given
* two colors that are used for drawing.
*
- * <p><img src="BasicGraphicsUtils-2.png" width="360"
+ * <p><img src="doc-files/BasicGraphicsUtils-2.png" width="360"
* height="200" alt="[An illustration that shows which pixels
* get painted in what color]" />
*
* Draws a border that is suitable for buttons of the Basic look and
* feel.
*
- * <p><img src="BasicGraphicsUtils-3.png" width="500"
+ * <p><img src="doc-files/BasicGraphicsUtils-3.png" width="500"
* height="300" alt="[An illustration that shows which pixels
* get painted in what color]" />
*
* Draws a rectangle that appears lowered into the surface, given
* four colors that are used for drawing.
*
- * <p><img src="BasicGraphicsUtils-4.png" width="360"
+ * <p><img src="doc-files/BasicGraphicsUtils-4.png" width="360"
* height="200" alt="[An illustration that shows which pixels
* get painted in what color]" />
*
* drawn without underlining. Drawing is performed in the current
* color and font of <code>g</code>.
*
- * <p><img src="BasicGraphicsUtils-5.png" width="500"
+ * <p><img src="doc-files/BasicGraphicsUtils-5.png" width="500"
* height="100" alt="[An illustration showing how to use the
* method]" />
*
* at the specified index. Drawing is performed in the current color
* and font of <code>g</code>.
*
- * <p><img src="BasicGraphicsUtils-5.png" width="500"
+ * <p><img src="doc-files/BasicGraphicsUtils-5.png" width="500"
* height="100" alt="[An illustration showing how to use the
* method]" />
*
* those pixels is the current color of the Graphics <code>g</code>.
* Any other pixels are left unchanged.
*
- * <p><img src="BasicGraphicsUtils-7.png" width="360"
+ * <p><img src="doc-files/BasicGraphicsUtils-7.png" width="360"
* height="200" alt="[An illustration that shows which pixels
* get painted]" />
*
/**
* Finds the path that is closest to the specified position.
*
- * <p><img src="../TreeUI-1.png" width="300" height="250"
+ * <p><img src="../doc-files/TreeUI-1.png" width="300" height="250"
* alt="[A screen shot of a JTree] />
*
* <p>As shown by the above illustration, the bounds of the