Subversion Repositories eFlore/Applications.cel

package org.tela_botanica.client.vues;

import org.tela_botanica.client.image.ImageMediateur;

import org.tela_botanica.client.interfaces.Rafraichissable;

import com.google.gwt.user.client.ui.ClickListener;

import com.google.gwt.user.client.ui.Image;

import com.google.gwt.user.client.ui.MouseListenerAdapter;

import com.google.gwt.user.client.ui.Widget;

import com.gwtext.client.widgets.Panel;

/**

 * Une barre de notation avec des étoiles, tout ce qu'il ya de plus classique,

 * utilisant Ajax (et pas CSS)

 * @author aurelien

 *

 */

public class BarreNotationVue extends Panel implements Rafraichissable {

	/**

	 * Le médiateur associé

	 */

	@SuppressWarnings("unused")

	private ImageMediateur iMediateur = null ;

	/**

	 * La note actuellement affichée

	 */

	private int noteEnCours = 0 ;

	/**

	 * La note maximum

	 */

	private int noteMax = 0 ;

	/**

	 * Booléen indiquant si une note est affectée à la barre en ce moment

	 */

	private boolean estNote = false ;

	/**

	 * Tablmeau d'images contenant les étoiles affichées

	 */

	private Image[] etoiles = null ;

	/**

	 * Constructeur sans argument (privé car ne doit pas être utilisé)

	 */

	@SuppressWarnings("unused")

	private BarreNotationVue()

	{

		super() ;

	}

	/**

	 * Constructeur avec arguments

	 * @param im le médiateur à associer à la vue

	 * @param noteMax la note maximale

	 */

	public BarreNotationVue(ImageMediateur im, int noteMax)

	{

		iMediateur = im ;

		setNoteMax(noteMax) ;

		this.setSize(200, 100) ;

		this.setBodyBorder(false) ;

		this.setBorder(false) ;

		this.setCls("x-view-notation") ;

		ajouterListeners() ;

	}

	public void ajouterListeners()

	{

		for (int i = 0; i < etoiles.length; i++) {

			etoiles[i].addMouseListener(new MouseListenerAdapter() {

				// si la souris passe sur la barre

				public void onMouseEnter(Widget sender) {

					Image enCours = (Image)sender ;

					// on met en surbrillance toutes les étoiles allant de la première jusqu'à

					// celle sous le curseur

					for(int i = 0 ; etoiles[i] != enCours ; i++)

					{

						etoiles[i].setUrl("note-hover.gif") ;

					}

						enCours.setUrl("note-hover.gif") ;

				}

				// si la souris sort de la barre

				public void onMouseLeave(Widget sender) {

					// on affiche la véritable note

					afficherNote() ;

				}

			}) ;

			etoiles[i].addClickListener(new ClickListener() {

				// si on clique sur une étoiles

				public void onClick(Widget sender) {

					int i = 0 ;

					// on récupère le numéro de l'étoile sur laquelle on a cliqué

					while(etoiles[i] != (Image)sender)

					{

						i++ ;

					}

					// et on affecte la note

					noter(i) ;

				}

			}) ;

		}

	}

	/**

	 * Fonction héritée de l'interface rafraichissable

	 */

	public void rafraichir(Object nouvelleDonnees,

			boolean repandreRaffraichissement) {

		// si on recoit un tableau de string

		if(nouvelleDonnees instanceof String[])

		{

			// on récupère le premier élément (un entier, qui contient la note)

			String[] note = (String[])nouvelleDonnees ;

			int noteInt = Integer.parseInt(note[0]) ;

			// si l'entier est une note valide

			if(noteInt != -1 && noteInt >= 0)

			{

				noter(noteInt) ;

			}

			// sinon si l'entier vaut -1

			else

			{

				// alors on note avec 0

				// et on met le booleen de notation a false (qui signifie que l'image n'est pas encore notée)

				estNote = false ;

				noteEnCours = 0 ;

				// et demande l'affichage

				afficherNote() ;

			}

		}

	}

	/**

	 * Affecte une note à la barre et rafraichit l'affichage

	 * @param note la nouvelle note

	 */

	public void noter(int note)

	{

		// on affecte la note

		noteEnCours = note ;

		// on met le boolean de notation à true (l'image est notée)

		estNote = true ;

		// et on demande l'affichage

		afficherNote() ;

	}

	/**

	 * Setteur pour la note maximale

	 * @param nMax la nouvelle note maximale

	 */

	public void setNoteMax(int nMax)

	{

		// on affecte la note

		noteMax = nMax ;

		// on prépare le tableau d'image

		etoiles = new Image[noteMax] ;

		// qu'on remplit par defaut avec des images d'étoiles vides

		for(int i = 0 ; i < noteMax ; i++)

		{

			etoiles[i] = new Image("etoile_vide.jpg") ;

			etoiles[i].setStylePrimaryName("x-view-notation-bar") ;

			this.add(etoiles[i]) ;

		}

	}

	/**

	 * Affiche la note d'une image sous la forme d'étoiles

	 */

	public void afficherNote()

	{

		// si l'image est notée

		if(estNote)

		{

			// on affiche autant d'étoiles que le chiffre de la note

			for(int i = 0 ; i <= noteEnCours ; i++)

			{

				etoiles[i].setUrl("note-on.gif") ;

			}

			// et si elle est inférieure à la note maximale, on remplit le reste par des étoiles vides

			for (int j = noteEnCours + 1 ; j < noteMax ; j++)

			{

				etoiles[j].setUrl("note-off.gif") ;

			}

		}

		// sinon

		else

		{

			// on remplit toute la barre avec des étoiles vides

			for(int i = 0 ; i < noteMax ; i++)

			{

				etoiles[i].setUrl("note-off.gif") ;

			}

		}

	}

	/**

	 * Accesseur pour la note en cours sous forme de string

	 * @return

	 */

	public String getNote()

	{

		return ""+noteEnCours ;

	}

}