File	Doc	Category	Size	Date	Package
MatteBorder.java	API Doc	Java SE 6 API	8299	Tue Jun 10 00:26:42 BST 2008	javax.swing.border

MatteBorder

• java.lang.Object
  • javax.swing.border.AbstractBorder
    • javax.swing.border.EmptyBorder

Fields Summary
protected Color	color
protected Icon	tileIcon

Constructors Summary
public MatteBorder(int top, int left, int bottom, int right, Color matteColor) Creates a matte border with the specified insets and color. param top the top inset of the border param left the left inset of the border param bottom the bottom inset of the border param right the right inset of the border param matteColor the color rendered for the border super(top, left, bottom, right); this.color = matteColor;
public MatteBorder(Insets borderInsets, Color matteColor) Creates a matte border with the specified insets and color. param borderInsets the insets of the border param matteColor the color rendered for the border since 1.3 super(borderInsets); this.color = matteColor;
public MatteBorder(int top, int left, int bottom, int right, Icon tileIcon) Creates a matte border with the specified insets and tile icon. param top the top inset of the border param left the left inset of the border param bottom the bottom inset of the border param right the right inset of the border param tileIcon the icon to be used for tiling the border super(top, left, bottom, right); this.tileIcon = tileIcon;
public MatteBorder(Insets borderInsets, Icon tileIcon) Creates a matte border with the specified insets and tile icon. param borderInsets the insets of the border param tileIcon the icon to be used for tiling the border since 1.3 super(borderInsets); this.tileIcon = tileIcon;
public MatteBorder(Icon tileIcon) Creates a matte border with the specified tile icon. The insets will be calculated dynamically based on the size of the tile icon, where the top and bottom will be equal to the tile icon's height, and the left and right will be equal to the tile icon's width. param tileIcon the icon to be used for tiling the border this(-1,-1,-1,-1, tileIcon);

Methods Summary
private java.awt.Insets	computeInsets(java.awt.Insets insets) if (tileIcon != null && top == -1 && bottom == -1 && left == -1 && right == -1) { int w = tileIcon.getIconWidth(); int h = tileIcon.getIconHeight(); insets.top = h; insets.right = w; insets.bottom = h; insets.left = w; } else { insets.left = left; insets.top = top; insets.right = right; insets.bottom = bottom; } return insets;
public java.awt.Insets	getBorderInsets(java.awt.Component c) Returns the insets of the border. param c the component for which this border insets value applies since 1.3 return getBorderInsets();
public java.awt.Insets	getBorderInsets(java.awt.Component c, java.awt.Insets insets) Reinitialize the insets parameter with this Border's current Insets. param c the component for which this border insets value applies param insets the object to be reinitialized since 1.3 return computeInsets(insets);
public java.awt.Insets	getBorderInsets() Returns the insets of the border. since 1.3 return computeInsets(new Insets(0,0,0,0));
public java.awt.Color	getMatteColor() Returns the color used for tiling the border or null if a tile icon is being used. since 1.3 return color;
public javax.swing.Icon	getTileIcon() Returns the icon used for tiling the border or null if a solid color is being used. since 1.3 return tileIcon;
public boolean	isBorderOpaque() Returns whether or not the border is opaque. // If a tileIcon is set, then it may contain transparent bits return color != null;
public void	paintBorder(java.awt.Component c, java.awt.Graphics g, int x, int y, int width, int height) Paints the matte border. Insets insets = getBorderInsets(c); Color oldColor = g.getColor(); g.translate(x, y); // If the tileIcon failed loading, paint as gray. if (tileIcon != null) { color = (tileIcon.getIconWidth() == -1) ? Color.gray : null; } if (color != null) { g.setColor(color); g.fillRect(0, 0, width - insets.right, insets.top); g.fillRect(0, insets.top, insets.left, height - insets.top); g.fillRect(insets.left, height - insets.bottom, width - insets.left, insets.bottom); g.fillRect(width - insets.right, 0, insets.right, height - insets.bottom); } else if (tileIcon != null) { int tileW = tileIcon.getIconWidth(); int tileH = tileIcon.getIconHeight(); int xpos, ypos, startx, starty; Graphics cg; // Paint top matte edge cg = g.create(); cg.setClip(0, 0, width, insets.top); for (ypos = 0; insets.top - ypos > 0; ypos += tileH) { for (xpos = 0; width - xpos > 0; xpos += tileW) { tileIcon.paintIcon(c, cg, xpos, ypos); } } cg.dispose(); // Paint left matte edge cg = g.create(); cg.setClip(0, insets.top, insets.left, height - insets.top); starty = insets.top - (insets.top%tileH); startx = 0; for (ypos = starty; height - ypos > 0; ypos += tileH) { for (xpos = startx; insets.left - xpos > 0; xpos += tileW) { tileIcon.paintIcon(c, cg, xpos, ypos); } } cg.dispose(); // Paint bottom matte edge cg = g.create(); cg.setClip(insets.left, height - insets.bottom, width - insets.left, insets.bottom); starty = (height - insets.bottom) - ((height - insets.bottom)%tileH); startx = insets.left - (insets.left%tileW); for (ypos = starty; height - ypos > 0; ypos += tileH) { for (xpos = startx; width - xpos > 0; xpos += tileW) { tileIcon.paintIcon(c, cg, xpos, ypos); } } cg.dispose(); // Paint right matte edge cg = g.create(); cg.setClip(width - insets.right, insets.top, insets.right, height - insets.top - insets.bottom); starty = insets.top - (insets.top%tileH); startx = width - insets.right - ((width - insets.right)%tileW); for (ypos = starty; height - ypos > 0; ypos += tileH) { for (xpos = startx; width - xpos > 0; xpos += tileW) { tileIcon.paintIcon(c, cg, xpos, ypos); } } cg.dispose(); } g.translate(-x, -y); g.setColor(oldColor);