com.sksamuel.jqm4gwt.HasIcon Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of jqm4gwt-standalone Show documentation

jqm4gwt bundled with all of its dependencies

The newest version!

package com.sksamuel.jqm4gwt;

/**
 * @author Stephen K Samuel [email protected] 13 Jul 2011 23:08:58
 *
 *       * Use in UiBinder Templates
 *
 * Using components implementing HasIcon can define which Icon to use in
 * {@link com.google.gwt.uibinder.client.UiBinder UiBinder} templates in defining it in the 'icon attribute.
 * For example:
 *  * <jqm:button.JQMButton icon="RIGHT"/>
 * 
 *
 * Valid values for the icon attribute are defined in @see DataIcon
 *
 */
public interface HasIcon extends HasIconPos {

	/**
	 * Removes any icon previously set on the implementing class, i.e. reverts back to default icon (if any).
	 * 
 If no icon has been previously set then this has no effect.
	 * 
 To hide icon use {@link HasIcon#setBuiltInIcon(DataIcon)} with DataIcon.NONE parameter.
	 */
	T removeIcon();

    /**
   	 * Sets the data icon to use, overriding any previously built-in or URL-defined icons specified.
   	 *
   	 * @param icon  of the standard built in icon types
   	 */
   	void setBuiltInIcon(DataIcon icon);

   	/**
   	 * Sets the icon to be a custom URL, overriding any previously built-in or URL-defined icons specified.
   	 *
   	 * @param src
   	 *              the src of the custom icon
   	 */
   	void setIconURL(String src);

	/**
	 * Sets the data icon to use, overriding any previously built-in or URL-defined icons specified.
	 *
	 * @param icon
	 *              of the standard built in icon types
	 */
	T withBuiltInIcon(DataIcon icon);

	/**
	 * Sets the icon to be a custom URL, overriding any previously built-in or URL-defined icons specified.
	 *
	 * @param src
	 *              the src of the custom icon
	 */
	T withIconURL(String src);

}