* La posizione predefinita dei pulsanti è alla destra della casella di testo, ma tale * posizione può essere definita dall'utente, specificandola nel costruttore. * Una volta specificata, la posizione dei pulsanti non può essere modificata. *
* A ciascuna istanza di questa classe può essere associato un ascoltatore per gli eventi * generati dalla pressione dei due pulsanti. L'ascoltatore dovrà essere una classe che * implementa l'interfaccia ValueChangedListener e per associarlo al controllo SpinText * è sufficiente ricorrere al metodo setValueChangedListener. *
* E', inoltre, possibile specificare dei dettagli riguardanti la casella di testo del * controllo, come il colore di sfondo, il colore del testo, l'allineamento, ecc. *
* L'esempio seguente crea uno SpinText secondo i parametri di default: il valore iniziale * è impostato a 0, i pulsanti sono sulla destra ed è possibile editare manualmente il * valore testuale contenuto. Aggiunge, inoltre, il controllo al contenitore. *
SpinText st = new SpinText();
add(st);
*
public class MioControllo extends JPanel implements ValueChangedListener {
private SpinText st;
public MioControllo() {
st = new SpinText(0, SpinText.SINISTRA);
st.setEditabile(false);
st.setChangedValueListener(this);
add(st);
}
public void valueChanged(ValueChangedEvent vce) {
SpinText spin = (SpinText) vce.getSource();
if (vce.getType == ValueChangedEvent.VALUE_UP) {
// L'utente ha premuto il pulsante PIU
...
} else {
// L'utente ha premuto il pulsante MENO
...
}
}
}
* valore.
* Lo SpinText costruito avrà i pulsanti posizionati a destra della casella di testo ed il valore
* numerico impostato al valore corrispondente al parametro valore.
* Il controllo sarà, inoltre, editabile.
*
* @param valore il valore iniziale che verrà visualizzato nella casella di testo
*/
public SpinText(int valore) {
this(valore, DESTRA);
}
/**
* Costruisce uno SpinText con valore iniziale pari al parametro valore e con i
* pulsanti posizionati secondo il valore del parametro posizionePulsanti.
* Lo SpinText costruito avrà i pulsanti posizionati a destra della casella di testo ed il valore
* numerico impostato al valore corrispondente al parametro valore.
* Il controllo sarà, inoltre, editabile.
*
* @param valore il valore iniziale che verrà visualizzato nella casella di testo
* @param posizionePulsanti la posizione dei pulsanti rispetto alla casella di testo:
* i possibili valori per questo parametro sono SpinText.DESTRA o
* SpinText.SINISTRA
*/
public SpinText(int valore, int posizionePulsanti) {
this.valore = valore;
this.posizionePulsanti = posizionePulsanti;
listener = new SpinTextKeyListener();
enabled = true;
setLayout( new BorderLayout() );
txtTesto = new JTextField("" + valore);
pulsanti = new Pulsanti();
add(txtTesto, BorderLayout.CENTER);
add(pulsanti, (posizionePulsanti == DESTRA) ? BorderLayout.EAST : BorderLayout.WEST);
preferredSize = new Dimension(80, 22);
setPreferredSize( preferredSize );
setSize( preferredSize );
minimoValore = Integer.MIN_VALUE;
massimoValore = Integer.MAX_VALUE;
}
/**
* Associa al controllo un ascoltatore per gli eventi dei pulsanti.
* L'ascoltatore è un oggetto che implementa l'interfaccia ValueChangedListener. Ad ogni
* pressione dell'utente sui pulsanti del controllo viene generato un evento di tipo
* ValueChangedEvent che indica l'oggetto sorgente ed il tipo di evento generato in base
* al pulsante premuto.
*
* @param vcl l'ascoltatore per gli eventi di pressione sui pulsanti
*/
public void setValueChangedListener(ValueChangedListener vcl) { this.vcl = vcl; }
/**
* Permette di impostare il valore attuale del controllo.
* L'impostazione del valore non genera alcun evento ed il nuovo valore impostato
* è immediatamente disponibile nella casella di testo.
*
* @param valore il valore a cui impostare il controllo SpinText
*/
public void setValore(int valore) { settaValore(valore); }
/**
* Specifica se il controllo SpinText è editabile o meno.
*
* @param editabile valore booleano (true o false) che indica
* se il controllo deve essere editabile o meno
*/
public void setEditabile(boolean editabile) {
txtTesto.setEditable(editabile);
if ( editabile ) {
txtTesto.addKeyListener( listener );
} else {
KeyListener[] stl = txtTesto.getKeyListeners();
for (int i=0; itrue o false) che indica se il
* controllo è abilitato o meno
*/
public void setEnabled(boolean enabled) {
this.enabled = enabled;
txtTesto.setEnabled(enabled);
pulsanti.setEnabled(enabled);
}
/**
* Specifica se il pulsante PIU è abilitato o meno
*
* @param abilitato valore booleano (true o false) che indica se il
* pulsante PIU è abilitato o no
*/
public void setPulsantePiuAbilitato(boolean abilitato) { pulsanti.setPulsantePiuAbilitato(abilitato); }
/**
* Specifica se il pulsante MENO è abilitato o meno
*
* @param abilitato valore booleano (true o false) che indica se il
* pulsante MENO è abilitato o no
*/
public void setPulsanteMenoAbilitato(boolean abilitato) { pulsanti.setPulsanteMenoAbilitato(abilitato); }
/**
* Permette di impostare il valore massimo che il controllo SpinText può assumere.
* Qualsiasi tentativo di andare sopra a questo valore verrà ignorato.
*
* @param valore il valore massimo che il controllo potrà assumere
*/
public void setMassimoValore(int valore) {
massimoValore = valore;
}
/**
* Permette di impostare il valore minimo che il controllo SpinText può assumere.
* Qualsiasi tentativo di andare sotto a questo valore verrà ignorato.
*
* @param valore il valore minimo che il controllo potrà assumere
*/
public void setMinimoValore(int valore) {
minimoValore = valore;
}
/**
* Indica se il pulsante PIU è abilitato.
*
* @return true se il pulsante PIU è abilitatofalse altrimenti
*/
public boolean isPulsantePiuAbilitato() { return pulsanti.isPulsantePiuAbilitato(); }
/**
* Indica se il pulsante MENO è abilitato.
*
* @return true se il pulsante MENO è abilitatofalse altrimenti
*/
public boolean isPulsanteMenoAbilitato() { return pulsanti.isPulsanteMenoAbilitato(); }
/**
* Indica se la casella di testo del controllo SpinText è editabile.
*
* @return true se la casella di testo è editabilefalse altrimenti
*/
public boolean isEditabile() { return txtTesto.isEditable(); }
/**
* Indica se il controllo SpinText è abilitato.
*
* @return true se il controllo è abilitatofalse altrimenti
*/
public boolean isEnabled() { return enabled; }
/**
* Ritorna il valore contenuto del controllo SpinText.
* Il valore di ritorno rispecchia il valore visualizzato dalla casella di testo
*
* @return il valore contenuto nel controllo SpinText, visualizzato dalla casella
* di testo
*/
public int getValore() { return valore; }
/**
* Fornisce l'informazione relativa alla posizione dei pulsanti nel controllo SpinText.
* Il valore ritornato rispecchia lo stato del controllo SpinText impostato all'atto
* della costruzione.
*
* @return un valore che indica la posizione dei pulsanti: i possibili valori sono
* SpinText.DESTRA o SpinText.SINISTRA
*/
public int getPosizionePulsanti() { return posizionePulsanti; }
/**
* Fornisce l'informazione relativa all'allineamento del testo.
* Il valore rappresenta l'allineamento del testo nella casella di testo del controllo
* SpinText. I valori possibili sono quelli relativi alle costanti definite
* nella classe SwingConstants.
*
* @return un valore che indica l'allineamento del testo del controllo SpinText
*/
public int getTextAlignment() { return txtTesto.getHorizontalAlignment(); }
/**
* Ritorna l'oggetto impostato come Listener per gli eventi di pressione dei pulsanti.
*
* @return il Listener impostato oppure null se nessun Listener è stato
* associato al controllo SpinText
*/
public ValueChangedListener getValueChangedListener() { return vcl; }
/**
* Fornisce l'informazione relativa al colore del testo del controllo SpinText.
* L'oggetto restituito è un'istanza della classe Color che rappresenta
* il colore impostato per il testo nella casella di testo del controllo SpinText.
*
* @return un oggetto Color che rappresenta il colore del testo
*/
public Color getTextForeground() { return txtTesto.getForeground(); }
/**
* Fornisce l'informazione relativa al colore di sfondo del controllo SpinText.
* L'oggetto restituito è un'istanza della classe Color che rappresenta
* il colore impostato per lo sfondo della casella di testo del controllo SpinText.
*
* @return un oggetto Color che rappresenta il colore di sfondo della casella di testo
*/
public Color getTextBackground() { return txtTesto.getBackground(); }
/**
* Ritorna il massimo valore che il controllo SpinText può assumere.
* Se non è stato impostato alcun valore massimo, verrà ritornato
* il valore corrispondente a Integer.MAX_VALUE.
*
* @return il valore massimo che il controllo potrà assumere o
* Integer.MAX_VALUE se nessun valore massimo è impostato
*/
public int getMassimoValore() { return massimoValore; }
/**
* Ritorna il minimo valore che il controllo SpinText può assumere.
* Se non è stato impostato alcun valore minimo, verrà ritornato
* il valore corrispondente a Integer.MIN_VALUE.
*
* @return il valore minimo che il controllo potrà assumere o
* Integer.MIN_VALUE se nessun valore minimo è impostato
*/
public int getMinimoValore() { return minimoValore; }
private void aumentaValore() {
if ((valore + 1) <= massimoValore) {
settaValore(valore + 1);
if (vcl != null) vcl.valueChanged( new ValueChangedEvent(this, ValueChangedEvent.VALUE_UP) );
}
}
private void diminuisciValore() {
if ((valore - 1) >= minimoValore) {
settaValore(valore - 1);
if (vcl != null) vcl.valueChanged( new ValueChangedEvent(this, ValueChangedEvent.VALUE_DOWN) );
}
}
private boolean carattereControllo(int c) {
return (c == 8) || (c == 10) || (c == 13) || (c == 127);
}
private void settaValoreFromListener(char c) {
try {
String testo = txtTesto.getText();
if ( !carattereControllo((int) c) ) {
testo += c;
}
int val = Integer.parseInt( testo );
valore = val;
} catch (Exception e) {
valore = 0;
}
}
private void settaValore(int valore) {
this.valore = valore;
txtTesto.setText("" + valore);
}
}