JList, JTree, JTable. JList

Transkript

1 JList, JTree, JTable JList

2 JList ListModel ListSelectionModel ListCellRenderer

3 JList View lese vha. get-metoder MVC Modellen Model Controller endre vha. set/ add-metoder endringshendelser

4 JList ListModel JList sitt modell-grensesnitt, altså den delen som fyller modell-rollen ListSelectionModel Håndtering av bruker-interaksjon, altså en del av controller-rollen ListCellRenderer Styrer visning av elementene i lista, altså en del av view-rollen

5 Scrolling JList støtter ikke scrolling. Det må legges på eksplisitt. Det gjøres ved å pakke den inn i en JScrollPane JScrollPane myjscrollpane = new JScrollPane(myJList); myjscrollpane.setverticalscrollbarpolicy( JScrollPane.VERTICAL_SCROLLBAR_ALWAYS); add(myjscrollpane);

6 Objekt- : ListDataListener diagram modell : ListModel list : JList model : ListSelectionListener renderer renderer : ListCellRenderer selectionmodel selection : ListSelectionModel : Component

7 Interface ListModel, JList sin modell get-metoder (gir tilgang til data) getsize() størrelsen til lista getelementat(index) elementene i lista lyttere og hendelser registrering av lytter: add/removelistdatalistener(listdatalistener l)

8 Interface ListDataListener JList implementerer denne Void contentschanged(listdataevent e) Sent when the contents of the list has changed in a way that's too complex to characterize with the previous methods. Void intervaladded(listdataevent e) Sent after the indices in the index0,index1 interval have been inserted in the data model. Void intervalremoved(listdataevent e) Sent after the indices in the index0,index1 interval have been removed from the data model.

9 DefaultListModel Alle JList får automatisk en modell av klassen DefaultListModel. Vi kan legge inn en slik direkte: private JList myjlist; private DefaultListModel model; public JListExample_1() { model = new DefaultListModel(); myjlist = new JList(model); model.addelement("linje 1"); model.addelement("linje 2"); model.addelement("linje 3"); add(myjlist); }

10 JList og ListModel... Sentrale teknikk delegering Hendelse-lytter-pattern XxxEvent-klasse XxxListener-interface add/removexxxlistener Sentrale klasser/objekter ListModel ListDataListener ListDataEvent Sentrale metoder : ListDataListener list : JList addlistdatalistener og contentschanged getsize og getelementat 1: addlistdatalistener(listdatalistener) 2: contentschanged(listdataevent) 3: getsize( ) model 4: getelementat(int) mo de ll : Li stmo de l

11 ListSelectionModel Den eneste interaksjonen en JList støtter er tre typer seleksjon: seleksjon av enkelt element seleksjon av sekvens av elementer seleksjon av sett av sekvenser, altså ingen begrensning på seleksjonen Det er JList sin listselectionmodel-property, som håndterer seleksjonen objektet inneholder og manipulerer seleksjonen, basert på brukerens interaksjon modusen (selectionmode-property en) angir hvilken av de tre typene seleksjonslogikk som gjelder

12 Seleksjon ListSelectionModel-klassen håndterer logikken SINGLE_SELECTION Valg av kun ett elemenent Valg av nytt element fjerner eksisterende valg SINGLE_INTERVAL_SELECTION Valg av flere etterfølgende elementer Shift-klikk for å utvide seleksjonen i begge retninger MULTIPLE_INTERVAL_SELECTION Valg uten begrensninger på antall eller intervaller Control-klikk toggler enkelt-elementer Shift-klikk utvider seleksjonen

13 ListSelectionListener JList kringkaster endringer i seleksjonen til sine ListSelectionListenerlyttere Ved å registrere en slik lytter, kan andre klasser/objekter reagere på brukerens endringer i seleksjonen Typisk bruk 1 list-detail- pattern : liste med elementer, med ekstra panel med detaljer Viktige egenskaper vises i lista, med detaljer i et panel ved siden av. Når seleksjonen endres, oppdateres detalj-panelet Typisk bruk 2 Action-objekter bruker seleksjon for å utføre oppgaven sin, dvs. hente ut objekt å utføre aksjon på Seleksjonen brukes også for å aktivere/deaktivere aksjonen

14 ...seleksjon Sentrale teknikker delegering Hendelse-lytter-pattern XxxEvent-klasse XxxListener-interface add/removexxxlistener Sentrale klasser/objekter ListSelectionModel ListSelectionListener ListSelectionEvent Sentrale metoder JList.addListSelectionListener ListSelectionListener.valueChanged list : JList 8: ad dl istse le cti on Liste ne r(l istse le cti on Liste ne r) : L istse le cti on Liste ne r 10: valuechanged(listselectionevent) 9: addlistselectionlistener(listselectionlistener) selectionmodel : ListSelectionModel

15 View-delen av JList ListCellRenderer interface som bygger bro mellom JList sine behov for å tegne rader i lista og Componentsubklasser gjenbruker en eksisterende Component-subklasse for å tegne hver linje i en JList ved å skrive egne komponenter for visning av liste-elementer, kan JList skreddersys visning av egne data

16 JList og ListCellRenderer JList delegerer tegning av hver element i lista til en ListCellRenderer getcellrenderer ListCellRenderer configurerer og returnerer en Component getlistcellrenderercomponent Component-objektet har en (foretrukket) størrelse og kan tegne seg selv getpreferredsize paintcomponent Siste Swing-versjon støtter layout i flere kolonner

17 JList og ListCellRenderer... list : JList 5: getlistcellrenderercomponent(jlist, Object, int, boolean, boolean) renderer renderer : ListCellRenderer 6: getpreferredsize( ) Sentral teknikk delegering Sentrale klasser/objekter ListCellRenderer Component 7: paint(graphics) : Component

18 JList og ListCellRenderer... Omtrentlig sekvens av operasjoner spør ListModel om størrelse getsize() itererer over alle elementene spør om verdi getelementat(int) ber renderer konfigurere og returnere komponent spør om størrelsen og gir plass ber komponenten tegne seg selv posisjon og størrelse huskes slik at en vet hvilke linjer som er hvor for hver linje som endres, gjentas dette, f.eks. verdi, seleksjon og fokus

19 Modeller kan ha modeller Noen ganger ønsker man å ha en felles datamodell for SWING komponenter som har forskjellig type modeller. De kan følgelig ikke ha samme modell direkte. For hver type komponent må det da lages en mellommodell som videreformidler meldinger ned til den egentlige modellen. En slik mellommodeller kalles ofte en adapter eller en wrapper. Generelt er dette et eksempel på design pattern adapter. Se:

20 SliderSpinnerModelExample Design JSlider og JSpinner instanser Når den ene manipuleres følger de andre etter Konstruksjon basert på MVC og SliderSpinnerModel Example-koden JSlider JSpinner

21 AbstractSpinnerModel public abstract class AbstractSpinnerModel extends Object implements SpinnerModel This class provides the ChangeListener part of the SpinnerModel interface that should be suitable for most concrete SpinnerModel implementations. Subclasses must provide an implementation of the minimum, maximum, and value properties and the getnextvalue and getpreviousvalue methods.

22 SpinnerModel A SpinnerModel has three properties, only the first is read/write. Value The current element of the sequence. nextvalue The following element or null if value is the last element of the sequence. previousvalue The preceeding element or null if value is the first element of the sequence. When the the value property changes, ChangeListeners are notified. SpinnerModel may choose to notify the ChangeListeners under other circumstances.

23 DefaultBoundedRangeModel

24 Forskjellige grensesnitt JSlider JSpinner DefaultBoundedRangeModel getmaximum() getminimum() getvalue() getvalueisadjusting() setmaximum(int n) setminimum(int n) setrangeproperties( ) setvalue(int n) setvalueisadjusting(..) firestatechanged() AbstractSpinnerModel getnextvalue() getpreviousvalue() getvalue() setvalue(object value) firestatechanged()

25 SliderSpinnerModelExample Konfigurere instanser felles IntervalValueModel-instans IntervalValueBoundedRangeModel og IntervalValueSpinnerModel lytter begge på IntervalValueModel-instansen JSlider- og JSpinner-instansene lytter på sine modeller SliderSpinnerModelExample lytter ikke på noe! JSlider-instansen manipuleres modellens verdi endres underliggende og felles modell endres hendelser om endring i felles modell sendes til lytterne

26 IntervalValueSpinnerModel Oversetter kall og hendelser mellom JSpinner og IntervalValueModel get-metoder, f.eks. getvalue set-metoder, f.eks. setvalue Hendelser: firepropertychange propertychange JSpinner IntervalValue SpinnerModel IntervalValue Model IntervalValue BoundedRange Model JSlider Tilsvarende for IntervalValueBoundedRangeModel

27 IntervalValueSpinnerModel getvalue JSpinner getvalue IntervalValue SpinnerModel getvalue IntervalValue Model setvalue JSpinner setvalue IntervalValue SpinnerModel setvalue IntervalValue Model propertychange til firestatechanged JSpinner firestatechanged IntervalValue SpinnerModel propertychange IntervalValue Model

28 Forskjellige grensesnitt JSlider JSpinner DefaultBoundedRangeModel getmaximum() getminimum() getvalue() getvalueisadjusting() setmaximum(int n) setminimum(int n) setrangeproperties( ) setvalue(int n) setvalueisadjusting(..) firestatechanged() IntervalValueModel getmaximum() getminimum() getvalue() setmaximum(int n) setminimum(int n) setvalue(int n) AbstractSpinnerModel getnextvalue() getpreviousvalue() getvalue() setvalue(object value) firestatechanged()

29 Class SliderSpinnerModelExample // internal components private JSlider slider; private JSpinner spinner; private IntervalValueModel model; /** * Constructor for objects of class SliderSpinnerModelExample */ public SliderSpinnerModelExample() { // create common model model = new IntervalValueModel(0, 10, 20); // create and configure slider slider = new JSlider(new IntervalValueBoundedRangeModel(model)); slider.setmajortickspacing(5); slider.setminortickspacing(1); slider.setpaintticks(true); slider.setpaintlabels(true); // make new spinner with value 10 spinner = new JSpinner(new IntervalValueSpinnerModel(model)); } // remember to add them to the panel add(slider); add(spinner);

30 Class SliderSpinnerModelExample // internal components private JSlider slider; private JSpinner spinner; private IntervalValueModel model; /** * Constructor for objects of class SliderSpinnerModelExample */ public SliderSpinnerModelExample() { // create common model model = new IntervalValueModel(0, 10, 20); // create and configure slider slider = new JSlider(new IntervalValueBoundedRangeModel(model)); slider.setmajortickspacing(5); slider.setminortickspacing(1); slider.setpaintticks(true); slider.setpaintlabels(true); // make new spinner with value 10 spinner = new JSpinner(new IntervalValueSpinnerModel(model)); Modell } // remember to add them to the panel add(slider); add(spinner); Mellommodeller

31 slider : JSlider boundedrangemodel : IntervalValueBoundedRangeModel spinner : JSpinner spinnermodel : IntervalValueSpinnerModel intervaluevalue : IntervalValueModel addpropertychangelistener() addchangelistener(changelistener) addpropertychangelistener() addchangelistener(changelistener) Bruker drar slider setvalue(int) setvalue(int) propertychange() statechanged(changeevent) propertychange() statechanged(changeevent)

32 SliderSpinnerModelExample 2: addpropertychangelistener() 5: setvalue(int) slider : JSlider 8: statechanged(changeevent) boundedrangemodel : IntervalValueBoundedRangeModel 1: addpropertychangelistener() 6: setvalue(int) 7: propertychange() 3: addintervalvaluelistener(intervalvaluelistener) intervaluevalue : IntervalValueModel 4: addchangelistener(changelistener) 9: propertychange() spinner : JSpinner spinnermodel : IntervalValueSpinnerModel 10: statechanged(changeevent)