27 files changed, 1690 insertions, 651 deletions
diff --git a/src/com/wordpress/tipsforjava/swing/StretchIcon.java b/src/com/wordpress/tipsforjava/swing/StretchIcon.java
new file mode 100644
index 0000000..667f1cd
--- /dev/null
+++ b/src/com/wordpress/tipsforjava/swing/StretchIcon.java
@@ -0,0 +1,372 @@
+/**
+ * @(#)StretchIcon.java 1.0 03/27/12
+ */
+package com.wordpress.tipsforjava.swing;
+import java.awt.Component;
+import java.awt.Container;
+import java.awt.Graphics;
+import java.awt.Image;
+import java.awt.Insets;
+import java.awt.image.ImageObserver;
+import java.net.URL;
+import javax.swing.ImageIcon;
+/**
+ * An <CODE>Icon</CODE> that scales its image to fill the component area,
+ * excluding any border or insets, optionally maintaining the image's aspect
+ * ratio by padding and centering the scaled image horizontally or vertically.
+ * <P>
+ * The class is a drop-in replacement for <CODE>ImageIcon</CODE>.
+ * <P>
+ * As the size of the Icon is determined by the size of the component in which
+ * it is displayed, <CODE>StretchIcon</CODE> must only be used in conjunction
+ * with a component and layout that does not depend on the size of the
+ * component's Icon.
+ * 
+ * @version 1.0 03/22/12
+ * @author Darryl
+ */
+public class StretchIcon extends ImageIcon {
+        /**
+         * Determines whether the aspect ratio of the image is maintained. Set to
+         * <code>false</code> to distort the image to fill the component.
+         */
+        protected boolean proportionate = true;
+        /**
+         * Creates a <CODE>StretchIcon</CODE> from an array of bytes.
+         * 
+         * @param imageData
+         *            an array of pixels in an image format supported by the AWT
+         *            Toolkit, such as GIF, JPEG, or (as of 1.3) PNG
+         * 
+         * @see ImageIcon#ImageIcon(byte[])
+         */
+        public StretchIcon(byte[] imageData) {
+                super(imageData);
+        }
+        /**
+         * Creates a <CODE>StretchIcon</CODE> from an array of bytes with the
+         * specified behavior.
+         * 
+         * @param imageData
+         *            an array of pixels in an image format supported by the AWT
+         *            Toolkit, such as GIF, JPEG, or (as of 1.3) PNG
+         * @param proportionate
+         *            <code>true</code> to retain the image's aspect ratio,
+         *            <code>false</code> to allow distortion of the image to fill
+         *            the component.
+         * 
+         * @see ImageIcon#ImageIcon(byte[])
+         */
+        public StretchIcon(byte[] imageData, boolean proportionate) {
+                super(imageData);
+                this.proportionate = proportionate;
+        }
+        /**
+         * Creates a <CODE>StretchIcon</CODE> from an array of bytes.
+         * 
+         * @param imageData
+         *            an array of pixels in an image format supported by the AWT
+         *            Toolkit, such as GIF, JPEG, or (as of 1.3) PNG
+         * @param description
+         *            a brief textual description of the image
+         * 
+         * @see ImageIcon#ImageIcon(byte[], java.lang.String)
+         */
+        public StretchIcon(byte[] imageData, String description) {
+                super(imageData, description);
+        }
+        /**
+         * Creates a <CODE>StretchIcon</CODE> from an array of bytes with the
+         * specified behavior.
+         * 
+         * @see ImageIcon#ImageIcon(byte[])
+         * @param imageData
+         *            an array of pixels in an image format supported by the AWT
+         *            Toolkit, such as GIF, JPEG, or (as of 1.3) PNG
+         * @param description
+         *            a brief textual description of the image
+         * @param proportionate
+         *            <code>true</code> to retain the image's aspect ratio,
+         *            <code>false</code> to allow distortion of the image to fill
+         *            the component.
+         * 
+         * @see ImageIcon#ImageIcon(byte[], java.lang.String)
+         */
+        public StretchIcon(byte[] imageData, String description, boolean proportionate) {
+                super(imageData, description);
+                this.proportionate = proportionate;
+        }
+        /**
+         * Creates a StretchIcon from the image.
+         * 
+         * @param image
+         *            the image
+         * 
+         * @see ImageIcon#ImageIcon(java.awt.Image)
+         */
+        public StretchIcon(Image image) {
+                super(image);
+        }
+        /**
+         * Creates a StretchIcon from the image with the specifiec behavior.
+         * 
+         * @param image
+         *            the image
+         * @param proportionate
+         *            <code>true</code> to retain the image's aspect ratio,
+         *            <code>false</code> to allow distortion of the image to fill
+         *            the component.
+         * 
+         * @see ImageIcon#ImageIcon(java.awt.Image)
+         */
+        public StretchIcon(Image image, boolean proportionate) {
+                super(image);
+                this.proportionate = proportionate;
+        }
+        /**
+         * Creates a StretchIcon from the image.
+         * 
+         * @param image
+         *            the image
+         * @param description
+         *            a brief textual description of the image
+         * 
+         * @see ImageIcon#ImageIcon(java.awt.Image, java.lang.String)
+         */
+        public StretchIcon(Image image, String description) {
+                super(image, description);
+        }
+        /**
+         * Creates a StretchIcon from the image with the specified behavior.
+         * 
+         * @param image
+         *            the image
+         * @param description
+         *            a brief textual description of the image
+         * @param proportionate
+         *            <code>true</code> to retain the image's aspect ratio,
+         *            <code>false</code> to allow distortion of the image to fill
+         *            the component.
+         * 
+         * @see ImageIcon#ImageIcon(java.awt.Image, java.lang.String)
+         */
+        public StretchIcon(Image image, String description, boolean proportionate) {
+                super(image, description);
+                this.proportionate = proportionate;
+        }
+        /**
+         * Creates a StretchIcon from the specified file.

diff --git a/src/com/wordpress/tipsforjava/swing/StretchIcon.java b/src/com/wordpress/tipsforjava/swing/StretchIcon.java new file mode 100644 index 0000000..667f1cd --- /dev/null +++ b/src/com/wordpress/tipsforjava/swing/StretchIcon.java
@@ -0,0 +1,372 @@
	1	/**
	2	* @(#)StretchIcon.java 1.0 03/27/12
	3	*/
	4	package com.wordpress.tipsforjava.swing;
	5
	6	import java.awt.Component;
	7	import java.awt.Container;
	8	import java.awt.Graphics;
	9	import java.awt.Image;
	10	import java.awt.Insets;
	11	import java.awt.image.ImageObserver;
	12	import java.net.URL;
	13	import javax.swing.ImageIcon;
	14
	15	/**
	16	* An <CODE>Icon</CODE> that scales its image to fill the component area,
	17	* excluding any border or insets, optionally maintaining the image's aspect
	18	* ratio by padding and centering the scaled image horizontally or vertically.
	19	* <P>
	20	* The class is a drop-in replacement for <CODE>ImageIcon</CODE>.
	21	* <P>
	22	* As the size of the Icon is determined by the size of the component in which
	23	* it is displayed, <CODE>StretchIcon</CODE> must only be used in conjunction
	24	* with a component and layout that does not depend on the size of the
	25	* component's Icon.
	26	*
	27	* @version 1.0 03/22/12
	28	* @author Darryl
	29	*/
	30	public class StretchIcon extends ImageIcon {
	31
	32	/**
	33	* Determines whether the aspect ratio of the image is maintained. Set to
	34	* <code>false</code> to distort the image to fill the component.
	35	*/
	36	protected boolean proportionate = true;
	37
	38	/**
	39	* Creates a <CODE>StretchIcon</CODE> from an array of bytes.
	40	*
	41	* @param imageData
	42	* an array of pixels in an image format supported by the AWT
	43	* Toolkit, such as GIF, JPEG, or (as of 1.3) PNG
	44	*
	45	* @see ImageIcon#ImageIcon(byte[])
	46	*/
	47	public StretchIcon(byte[] imageData) {
	48	super(imageData);
	49	}
	50
	51	/**
	52	* Creates a <CODE>StretchIcon</CODE> from an array of bytes with the
	53	* specified behavior.
	54	*
	55	* @param imageData
	56	* an array of pixels in an image format supported by the AWT
	57	* Toolkit, such as GIF, JPEG, or (as of 1.3) PNG
	58	* @param proportionate
	59	* <code>true</code> to retain the image's aspect ratio,
	60	* <code>false</code> to allow distortion of the image to fill
	61	* the component.
	62	*
	63	* @see ImageIcon#ImageIcon(byte[])
	64	*/
	65	public StretchIcon(byte[] imageData, boolean proportionate) {
	66	super(imageData);
	67	this.proportionate = proportionate;
	68	}
	69
	70	/**
	71	* Creates a <CODE>StretchIcon</CODE> from an array of bytes.
	72	*
	73	* @param imageData
	74	* an array of pixels in an image format supported by the AWT
	75	* Toolkit, such as GIF, JPEG, or (as of 1.3) PNG
	76	* @param description
	77	* a brief textual description of the image
	78	*
	79	* @see ImageIcon#ImageIcon(byte[], java.lang.String)
	80	*/
	81	public StretchIcon(byte[] imageData, String description) {
	82	super(imageData, description);
	83	}
	84
	85	/**
	86	* Creates a <CODE>StretchIcon</CODE> from an array of bytes with the
	87	* specified behavior.
	88	*
	89	* @see ImageIcon#ImageIcon(byte[])
	90	* @param imageData
	91	* an array of pixels in an image format supported by the AWT
	92	* Toolkit, such as GIF, JPEG, or (as of 1.3) PNG
	93	* @param description
	94	* a brief textual description of the image
	95	* @param proportionate
	96	* <code>true</code> to retain the image's aspect ratio,
	97	* <code>false</code> to allow distortion of the image to fill
	98	* the component.
	99	*
	100	* @see ImageIcon#ImageIcon(byte[], java.lang.String)
	101	*/
	102	public StretchIcon(byte[] imageData, String description, boolean proportionate) {
	103	super(imageData, description);
	104	this.proportionate = proportionate;
	105	}
	106
	107	/**
	108	* Creates a StretchIcon from the image.
	109	*
	110	* @param image
	111	* the image
	112	*
	113	* @see ImageIcon#ImageIcon(java.awt.Image)
	114	*/
	115	public StretchIcon(Image image) {
	116	super(image);
	117	}
	118
	119	/**
	120	* Creates a StretchIcon from the image with the specifiec behavior.
	121	*
	122	* @param image
	123	* the image
	124	* @param proportionate
	125	* <code>true</code> to retain the image's aspect ratio,
	126	* <code>false</code> to allow distortion of the image to fill
	127	* the component.
	128	*
	129	* @see ImageIcon#ImageIcon(java.awt.Image)
	130	*/
	131	public StretchIcon(Image image, boolean proportionate) {
	132	super(image);
	133	this.proportionate = proportionate;
	134	}
	135
	136	/**
	137	* Creates a StretchIcon from the image.
	138	*
	139	* @param image
	140	* the image
	141	* @param description
	142	* a brief textual description of the image
	143	*
	144	* @see ImageIcon#ImageIcon(java.awt.Image, java.lang.String)
	145	*/
	146	public StretchIcon(Image image, String description) {
	147	super(image, description);
	148	}
	149
	150	/**
	151	* Creates a StretchIcon from the image with the specified behavior.
	152	*
	153	* @param image
	154	* the image
	155	* @param description
	156	* a brief textual description of the image
	157	* @param proportionate
	158	* <code>true</code> to retain the image's aspect ratio,
	159	* <code>false</code> to allow distortion of the image to fill
	160	* the component.
	161	*
	162	* @see ImageIcon#ImageIcon(java.awt.Image, java.lang.String)
	163	*/
	164	public StretchIcon(Image image, String description, boolean proportionate) {
	165	super(image, description);
	166	this.proportionate = proportionate;
	167	}
	168
	169	/**
	170	* Creates a StretchIcon from the specified file.