11 Grafiske komponenter

getMultipleMode()

Er multipleMode slået til, kan man løbe gennem antallet af indgange og for hver indgang bruge isIndexSelected(int indeks) til at se, om indgangen er valgt.

11.3 Eksempel

Herunder et eksempel med komponenterne omtalt i forrige afsnit.

import javax.swing.*;
public class BenytOverblikOverKomponenter
{
  public static void main(String[] arg)
  {
    JFrame vindue = new JFrame( "OverblikOverKomponenter" ); 
    vindue.add( new OverblikOverKomponenter() );
    vindue.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE); 
    vindue.setSize(500,150);
    vindue.setVisible(true);
  }
}

import java.awt.*;
import javax.swing.*;

public class OverblikOverKomponenter extends JPanel
{
  // opret alle komponenterne og husk dem i nogle felter
  JLabel label1 = new JLabel();
  JButton button1 = new JButton();
  JCheckBox checkbox1 = new JCheckBox();
  JCheckBox checkbox2 = new JCheckBox();
  JCheckBox checkbox3 = new JCheckBox();
  JRadioButton radio1 = new JRadioButton();
  JRadioButton radio2 = new JRadioButton();
  ButtonGroup buttonGroup1 = new ButtonGroup();
  JTextField textField1 = new JTextField();
  JTextArea textArea1 = new JTextArea();
  JComboBox comboBox1 = new JComboBox();

  String[] listedata = {"List rød", "List grøn", "List blå"};
  JList list1 = new JList(listedata);

  FlowLayout flowLayout1 = new FlowLayout(); // layout-manager (se senere)

  public OverblikOverKomponenter() {
    try {
      jbInit();
    }
    catch(Exception e) {
      e.printStackTrace();
    }
  }

  private void jbInit() throws Exception {
    label1.setText("En Label");

    button1.setText("OK");

    checkbox1.setText("En");    // sæt afkrydsningsfelternes navne
    checkbox2.setText("To");
    checkbox3.setText("Tre");

    radio1.setText("Radio1");   // sæt radioknappernes navne og
    radio2.setText("Radio2");
    buttonGroup1.add(radio1);   // gruppe - så de gensidigt udelukker hinanden
    buttonGroup1.add(radio2);
    radio1.setSelected(true);

    comboBox1.addItem("ComboBox Rød");
    comboBox1.addItem("ComboBox Grøn");
    comboBox1.addItem("ComboBox Blå");

    textField1.setColumns(10);
    textField1.setText("Et TextField");

    textArea1.setColumns(15);
    textArea1.setRows(5);
    textArea1.setText("Et TextArea");

    this.setLayout(flowLayout1);// sæt layout-manager (se senere)

    this.add(label1);     // til sidst skal komponenterne føjes
    this.add(button1);    // til containeren (se senere)
    this.add(checkbox1);
    this.add(checkbox2);
    this.add(checkbox3);
    this.add(radio1);
    this.add(radio2);
    this.add(textField1);
    this.add(textArea1);
    this.add(comboBox1);
    this.add(list1);
  }
}

11.4 Overblik over containere

En container er beregnet til at indeholde komponenter og styre, hvordan de vises på skærmen. Alle containere har en såkaldt layout-manager tilknyttet, der hjælper containeren med at afgøre, hvor og med hvilken størrelse komponenterne skal vises.

For at en komponent bliver vist, skal den tilføjes en container. I eksemplet ovenfor er panelet den container, komponenterne bliver tilføjet og derfor står der sidst i initialiseringen:

    this.add(button1);

11.4.1 JWindow

JWindow repræsenterer et bart vindue uden en titellinje eller lukkeknap øverst. Det bruges meget sjældent direkte. Man bruger i stedet arvingerne JFrame og JDialog.

11.4.2 JDialog

Dialog bruges til dialog-bokse, vinduer, der dukker op med et eller andet spørgsmål, som skal besvares, før man kan gå videre. Egenskaben modal angiver, om dialog-boksen er modal, dvs. om man skal lukke den, før man kan få adgang til ejer-vinduet. Den sættes med setModal(boolean m) og aflæses med isModal(). Hvis vinduet er modalt vil et kald til setVisible(true) vente, indtil brugeren har udfyldt og lukket dialog-boksen igen.

I mange tilfælde vil JOptionPane, der er beskrevet i afsnit 2.12.1, være nemmere at bruge. Således kunne man f.eks. vise panelet OverblikOverKomponenter i en dialog med koden:

import javax.swing.*;
public class DialogMedOverblikOverKomponenter
{
  public static void main(String[] arg)
  {
    JOptionPane.showMessageDialog(null,new OverblikOverKomponenter());
  }
}

11.4.3 JFrame

En JFrame er den simpleste og oftest brugte måde at definere et "normalt" vindue med titel, luk-knap, minimér-knap etc. Den er brugt i næsten alle eksempler i denne bog.

11.4.4 JPanel

Et panel er den simpleste og oftest brugte container. Den indeholder simpelthen komponenterne (i henhold til layout-manageren).

Kan ens vindue opdeles i flere logiske dele (f.eks. har JBuilder i afsnit 11.1 en komponentpalette, designvindue og egenskabstabel) er det god praksis at lægge disse i hver sit panel.

11.4.5 Egne paneler som komponenter

JPanel er en meget fleksibel container og er samtidig også en komponent, dvs. man kan tilføje den til enhver anden container (et vindue eller endda til et andet JPanel).

Det gælder også dine egne nedarvninger af JPanel – at de kan bruges som komponenter og bruges i designeren på linje med f.eks. JButton og JTextField. Har du lavet dine egne nogle get- og set-metoder kan disse endda også ses i designeren.

Det er et ekstremt kraftigt værktøj at kunne definere sine egne 'komponenter', da det kan hjælpe med at strukturere den visuelle del af dit program på en fornuftig måde.

I Eclipse skal du vælge 'Choose component' i paletten.

I NetBeans kan du trække javafiler fra projektfanen til venstre direkte over i designeren til højre og anvende dem som komponenter.

11.4.6 JApplet

En applet er et panel, der er beregnet til at blive vist i en browser. Se kapitel 10, Appletter.

11.4.7 JTabbedPane

Et panel, der viser et sæt af faneblade, der hver kan indeholde én komponent – som næsten altid er et et JPanel. Herunder viser vi alle eksemplerne fra dette kapitel i hver sit faneblad:

import javax.swing.*;
public class BenytFaneblade
{
  public static void main(String[] arg)
  {
    JTabbedPane faneblade = new JTabbedPane();

    faneblade.add("GrafikpanelMedKomponenter", new GrafikpanelMedKomponenter());
    faneblade.add("OverblikOverKomponenter", new OverblikOverKomponenter());
    faneblade.add("PanelMedBorderLayout", new PanelMedBorderLayout());
    faneblade.add("PanelMedGridBagLayout", new PanelMedGridBagLayout());

    JFrame vindue = new JFrame("Faneblade");
    vindue.add( faneblade );
    vindue.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE); // reagér på luk
    vindue.pack();                  // lad vinduet selv bestemme sin størrelse
    vindue.setVisible(true);                                  // åbn vinduet

  }
}

11.5 Layout-managere

En layout-manager styrer layoutet af komponenterne på et JPanel eller en anden container. Alle containere har egenskaben layout, der kan sættes med metoden setLayout(Layout l).

For mere info, se: http://docs.oracle.com/javase/tutorial/uiswing/layout/

11.5.1 Ingen styring (null-layout)

I udviklingsfasen er det mest bekvemt at sætte layout-manageren til null. Dette tillader udvikleren at sætte komponenterne, som han vil på en hvilken som helst (x,y)-position og med en hvilken som helst højde og bredde. Koden ser således ud:

    this.setLayout(null);                              // sæt null-layout
    this.add(button1);                                 // tilføj knap
    button1.setBounds(new Rectangle(231, 60, 91, 32)); // sæt position/størrelse

null-layout tager slet ikke højde for vinduets størrelse, så hvis vinduet bliver for lille, vil nogle af komponenterne ikke blive vist. Når programmet er ved at være færdigt, bør man derfor ændre programmet til at bruge en layout-manager, der kan styre komponenternes størrelse og indbyrdes placering ud fra deres behov.

11.5.2 FlowLayout

FlowLayout placerer komponenterne ligesom tekst, der er centreret: Øverst fra venstre mod højre og på en ny linje nedenunder, når der ikke er mere plads.

I eksemplet OverblikOverKomponenter ovenfor blev FlowLayout brugt (egentligt var det overflødigt at angive, for angiver man ikke nogen layout-manager i et panel/applet, vil FlowLayout blive brugt automatisk).

11.5.3 BorderLayout

BorderLayout tager højde for vinduets størrelse og tilpasser komponenternes størrelse efter den tilgængelige plads. Komponenterne kan placeres på 5 mulige positioner, nemlig NORTH, SOUTH, EAST, WEST og CENTER.

Den mest almindelige måde at lave det grafiske layout af et skærmbillede er med BorderLayout. I de områder, hvor man ønsker at placere flere komponenter, sætter man først et JPanel og komponenterne tilføjes så panelet.

Angiver man ikke nogen layout-manager i et vindue, vil BorderLayout blive brugt (i eksemplet nedenfor kunne de to linjer omkring BorderLayout strengt taget fjernes).

import java.awt.*;
import javax.swing.*;

public class PanelMedBorderLayout extends JPanel
{
  JButton button1 = new JButton();
  JButton button2 = new JButton();
  JButton button3 = new JButton();
  JButton button4 = new JButton();
  JButton button5 = new JButton();

  BorderLayout borderLayout1 = new BorderLayout();

  public PanelMedBorderLayout() {
    try {
      jbInit();
    }
    catch(Exception e) {
      e.printStackTrace();
    }
  }

  private void jbInit() throws Exception {
    button1.setText("NORTH");
    button2.setText("SOUTH");
    button3.setText("EAST");
    button4.setText("WEST");
    button5.setText("CENTER");

    this.setLayout(borderLayout1);

    this.add(button1, BorderLayout.NORTH);
    this.add(button2, BorderLayout.SOUTH);
    this.add(button3, BorderLayout.EAST);
    this.add(button4, BorderLayout.WEST);
    this.add(button5, BorderLayout.CENTER);
  }
}

Man sætter altså først layoutet ved at kalde setLayout() med et BorderLayout-objekt. Derefter kan add() kaldes med komponenterne og deres placering på borderlayoutet.

Bemærk, at når man bruger en layout-manager, bør man lade den afgøre vinduets størrelse ud fra komponenternes behov, ved at kalde pack() i stedet for setSize() på vinduet. Denne metode pakker komponenterne i vinduet optimalt og sætter vinduesstørrelsen passende.

import javax.swing.*;
public class BenytPanelMedBorderLayout
{
  public static void main(String[] arg)
  {
    JFrame vindue = new JFrame( "PanelMedBorderLayout" ); 
    vindue.add( new PanelMedBorderLayout() );
    vindue.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE); 
    vindue.pack();// sætter en rimelig vinduesstørrelse (i stedet for setSize())
    vindue.setVisible(true);
  }
}

11.5.4 GridBagLayout

En anden måde at lave layout er med GridBagLayout, som lægger komponenterne efter et usynligt gitter. Hver komponent kan fylde en eller flere celler i højden eller bredden.

import java.awt.*;
import javax.swing.*;

public class PanelMedGridBagLayout extends JPanel
{
  GridBagLayout gridBagLayout1 = new GridBagLayout();
  JButton   knap1 = new JButton();
  JButton   knap2 = new JButton();
  JButton   knap3 = new JButton();
  JButton   knap4 = new JButton();
  JButton   knap5 = new JButton();
  JCheckBox chkHø = new JCheckBox();
  JCheckBox chkVe = new JCheckBox();
  JCheckBox chkCe = new JCheckBox();
  JTextArea tekst = new JTextArea();

  public PanelMedGridBagLayout() {
    try {
      jbInit();
    }
    catch(Exception e) {
      e.printStackTrace();
    }
  }

  private void jbInit() throws Exception {
    knap1.setText("knap1 (på 3x1 celler)");
    knap2.setText("knap2 (1x2)");
    knap3.setText("knap3 (på 1x1 celle)");
    knap4.setText("knap4 (1x1)");
    knap5.setText("knap5 (1x1)");
    chkHø.setText("Højre");
    chkVe.setText("Venstre");
    chkCe.setText("Centreret");
    tekst.setColumns(15);
    tekst.setRows(2);
    tekst.setText("Tekstfelt (3x3 celler)");

    this.setLayout(gridBagLayout1);

    // til sidst skal komponenterne føjes til containeren
    this.add(knap1, new GridBagConstraints(0, 0, 3, 1, 0.0, 0.0, 
    GridBagConstraints.CENTER,GridBagConstraints.BOTH,new Insets(0,0,0,0),0,0));
    this.add(knap2, new GridBagConstraints(3, 0, 1, 2, 0.0, 0.0,
    GridBagConstraints.CENTER,GridBagConstraints.BOTH,new Insets(0,0,0,0),0,0));
    this.add(knap3, new GridBagConstraints(0, 1, 1, 1, 0.0, 0.0,
    GridBagConstraints.CENTER,GridBagConstraints.BOTH,new Insets(0,0,0,0),0,0));
    this.add(knap4, new GridBagConstraints(1, 1, 1, 1, 0.0, 0.0,
    GridBagConstraints.CENTER,GridBagConstraints.BOTH,new Insets(0,0,0,0),0,0));
    this.add(knap5, new GridBagConstraints(2, 1, 1, 1, 0.0, 0.0,
    GridBagConstraints.CENTER,GridBagConstraints.BOTH,new Insets(0,0,0,0),0,0));
    this.add(chkHø, new GridBagConstraints(0, 2, 1, 1, 0.0, 0.0,
    GridBagConstraints.EAST,  GridBagConstraints.NONE,new Insets(0,0,0,0),0,0));
    this.add(chkVe, new GridBagConstraints(0, 3, 1, 1, 0.0, 0.0,
    GridBagConstraints.WEST,  GridBagConstraints.NONE,new Insets(0,0,0,0),0,0));
    this.add(chkCe, new GridBagConstraints(0, 4, 1, 1, 0.0, 0.0,
    GridBagConstraints.CENTER,GridBagConstraints.NONE,new Insets(0,0,0,0),0,0));
    this.add(tekst, new GridBagConstraints(1, 2, 3, 3, 0.0, 0.0,
    GridBagConstraints.CENTER,GridBagConstraints.BOTH,new Insets(0,0,0,0),0,0));
  }
}

Når en komponent tilføjes, angives i et GridBagConstraints-objekt:

• Komponentens position (cellekolonne og -række)

• Komponentens spændvidde i højde og bredde

• Vægt i højde og bredde (komponenter med størst værdi får mest af eventuel overskydende plads)

• Justering i tilfælde af overskydende plads (CENTER, EAST, WEST, NORTHEAST, ...)

• Om komponenten skal strækkes til at fylde overskydende plads (BOTH, NONE,
  HORIZONTAL, VERTICAL)

• Til sidst nogle parametre til indsættelse af ekstra plads.

Her er koden, der viser vinduet.

import javax.swing.*;
public class BenytPanelMedGridBagLayout
{
  public static void main(String[] arg)
  {
    JFrame vindue = new JFrame( "PanelMedGridBagLayout" ); 
    vindue.add( new PanelMedGridBagLayout() );
    vindue.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE); 
    vindue.pack();
    vindue.setVisible(true);
  }
}

11.6 Menuer

En JFrame, JApplet og JDialog (men ikke JPanel og andre containere som ikke er selvstændige vinduer) kan have en menubjælke med rullegardiner tilknyttet.

Herunder har vi puttet en menu på vinduet, der viser GrafikpanelMedKomponenter.

Menuer er relativt enkle at lave: En menubjælke laves med new JMenuBar(), en menu (et rullegardin) med new JMenu() og et menupunkt med new JMenuItem(). Derefter skal menupunkterne tilføjes menuerne, og menuerne føjes til menubjælken (er det en undermenu føjes den til overmenuen) med add(). Man sætter teksterne med setText(). Til sidst sættes menubjælken på vinduet ved at kalde vindue.setJMenuBar(menubjælke).

import java.awt.event.*;
import javax.swing.*;

public class BenytGrafikpanelMedKomponenterOgMenu
{
  public static void main(String[] arg)
  {
    JFrame vindue = new JFrame( "GrafikpanelMedKomponenterOgMenu" ); 
    final GrafikpanelMedKomponenter panel = new GrafikpanelMedKomponenter();
    vindue.add( panel );
    vindue.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE); 
    vindue.setSize(350,300);

    JMenuBar  menubjælke = new JMenuBar();

    JMenu     rullegardinFil   = new JMenu();
    JMenuItem menupunktOpdat   = new JMenuItem();
    JMenuItem menupunktAfslut  = new JMenuItem();

    JMenu     rullegardinHjælp = new JMenu();

    rullegardinFil.setText("Fil");
    rullegardinFil.setMnemonic(KeyEvent.VK_F);
    menupunktOpdat.setText("Opdater");
    menupunktAfslut.setText("Afslut");
    menupunktAfslut.setMnemonic(KeyEvent.VK_A);

    rullegardinHjælp.setText("Hjælp");

    rullegardinFil.add(menupunktOpdat);
    rullegardinFil.add(menupunktAfslut);
    menubjælke.add(rullegardinFil);
    menubjælke.add(rullegardinHjælp);

    vindue.setJMenuBar(menubjælke);

    menupunktOpdat.addActionListener(new java.awt.event.ActionListener() {
      public void actionPerformed(java.awt.event.ActionEvent e) {
        panel.buttonOpdater_actionPerformed(e);
      }
    });

    menupunktAfslut.addActionListener(new java.awt.event.ActionListener() {
      public void actionPerformed(java.awt.event.ActionEvent e) {
        System.out.println("Farvel!");
        System.exit(0);
      }
    });

    vindue.setVisible(true); // som det allersidste: vis vinduet
  }
}

Man kan også sætte genvejstaster på menuer, med setMnemonic(). Disse aktiveres, som andre genvejstaster, med Alt-tasten, sådan at Alt-F åbner Fil-menuen.

For at fange når brugeren vælger et menupunkt, skal man lytte efter actionPerformed ligesom med JButton-klassen (det blev diskuteret i afsnit 11.1.1).

Mere info: http://docs.oracle.com/javase/tutorial/uiswing/components/menu.html

11.7 Test dig selv

11.8 Resumé

11.9 Avanceret

11.9.1 HTML-kode i komponenter

11.9.2 Flertrådet komponentprogrammering

11.9.3 Brug af komponenter vs. paintComponent()