Proz-S12

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 1

12. Swing - kontenery

12.1

JApplet

12.2

JFrame

12.3

JRootPane

12.4 Panel warstwowy -

JLayeredPane, JDesktopPane

12.5

JInternalFrame

12.6 Kontenery ogólne pośredniego poziomu -

JPanel

i inne:

JScrollPane, JSplitPane, JTabbedPane, JToolBar

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 2

12.1 Klasa

JApplet

dy aplet zawieraj

cy komponenty

Swing

-a musi by

utworzony jako

klasa pochodna od klasy

JApplet

, która dziedziczy z klasy

java.applet.Applet

1) Cechy

JApplet

Jako kontener główny klasa

JApplet

posiada "

root pane

", "

content pane

" i

opcjonalnie

pasek menu

Ró

nice pomi

dzy apletem w Swing-u a apletem

Applet

komponenty dodawane s

do "content pane" apletu;

menad

er układu ustawiany jest dla "content pane" a nie dla apletu

bezpo

rednio;

domy

lnym menad

erem układu dla "content pane" apletu jest

BorderLayout

(dla

Applet

jest nim

FlowLayout

);

kod malowania nie powinien znajdowa

bezpo

rednio w obiekcie

klasy

JApplet

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 3

2) W

tki w apletach

Typowa

konstrukcja

apletów

korzysta

tków,

tymczasem

komponenty Swing-a nie s

zabezpieczone przed w

tkami.

Komponenty tworzymy i ustawiamy w metodzie

init

- takie rozwi

zanie

uznaje si

za bezpieczne.

Metody

start, stop, destroy

mog

sprawia

kłopoty i nale

y je

zabezpieczy

przed w

tkami. Np. nie powinny by

one wołane z w

tku

rozdziału zdarze

i nie powinny odwoływa

do komponentów

bezpo

rednio. Zamiast tego powinny posłu

one metod

SwingUtilities.invokeLater

przy dost

pie do komponentu.

3) Korzystanie z obrazów w aplecie Swing-a

Klasa

Applet

posiada metod

getImage

dla ładowania obrazów do

apletu. Tworzy ona obiekt klasy

Image

reprezentuj

cy załadowany

obraz. W Swing-u zamiast

Image

stosuje si

klas

Icon

- aplety Swing-a

z zasady nie korzyst

getImage

. Zamiast tego aplety Swing-a tworz

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 4

obiekty klasy

ImageIcon

- ikona załadowana z pliku z obrazem. Zalet

stosowania

ImageIcon

jest to,

e klasa automatycznie

ledzi ładowanie

obrazu.

Przykład 12.1.

tek apletu implementowany w postaci obiektu pewnej

klasy

SwingWorker

odpowiada za załadowanie 17 ró

nych obrazów

stosuj

c jeden obiekt ImageIcon dla jednego obrazu. Aplet ładuje obrazy

w metodzie

init

public void init() {
    ...
    imgs = new ImageIcon[nimgs];
    ...
    final SwingWorker worker = new SwingWorker() {
        public Object construct() {

// Indeksy obrazów: od 1 do nimgs, indeksy tablicy - od 0 do nimgs-1.

            for (int i = 0; i < nimgs; i++) {
                imgs[i] = createFrame(i+1);
            }
            finishedLoading = true;

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 5

            return imgs;
        }
  ...
    };
    worker.start();
}
protected ImageIcon createFrame(int imageNum) {
    String path = dir + "/T" + imageNum + ".gif";
    URL imgURL = this.getClass().getResource(path);
    if (imgURL != null) {
         return new ImageIcon(imgURL);
    }
    else {
        System.err.println("Couldn't find file: " + path);
        return null;
           }
}

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 6

12.2 Klasa

JFrame

(klasa głównego okna)

Typowy obiekt klasy

JFrame

(ramka) posiada okno udekorowane

brzegiem, tytułem, przyciskami dla zamykania, zmniejszania i
powi

kszania okna.

Aplikacje posiadaj

ce GUI korzystaj

z przynajmniej jednej ramki.

Równie

aplety

mog

korzysta

z ramek.

Okna zale

ne od innego okna (okno zanika, gdy inne jest zmniejszane

lud zamykane) mo

na uzyska

stosuj

JDialog

zamiast

JFrame

Umieszczenie jednego okna w drugim oknie umo

liwia klasa

JInternalFrame

1) Reakcje na zdarzenie zamkni

cia okna

li u

ytkownik zamyka okno, zostaje ono ukryte, ale obiekt mo

istnie

dalej w programie i okno mo

e zosta

pó

niej przywrócone.

Jest to domy

lna reakcja, która mo

e zosta

zmieniona:

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 7

przez zarejestrowanie procedury obsługi zdarzenia zamkni

cia okna;

przez

specyfikacj

reakcji

zamkni

cie

okna

metod

setDefaultCloseOperation

;

lub podanie obu rozwi

jednocze

nie – pierwsza wykona sie

obsługa zdarzenia a nast

pnie domy

lna reakcja na zamkni

cie.

Argumentem metody

setDefaultCloseOperation

musi by

jedna z

podanych ni

ej warto

ci (3 pierwsze zdefiniowano w interfejsie

WindowConstants

implementowanym przez

JFrame, JInternalPane,

JDialog

DO_NOTHING_ON_CLOSE ,

HIDE_ON_CLOSE

(domy

lne dla

JDialog

JFrame

) ,

DISPOSE_ON_CLOSE

(domy

lne dla

JInternalFrame

EXIT_ON_CLOSE

(zdefiniowana w

JFrame

) – zako

czy aplikacj

wywołaniem

System.exit(0)

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 8

2) Reakcja na inne zmiany stanu

Procedury obsługi zdarze

mog

reagowa

na zdarzenia zmiany

stanu okna takie, jak zmniejszenie i aktywowanie okna.

Utworzenie i pokazanie ramki

Przykład 12.2

//1. Opcjonalnie: dekoracje ramki zgodne z domy

lnym

rodowiskiem

// "look and feel". Domy

lnie dekoracje dostarczane s

przez system

// zarz

dzaj

cy oknami.

JFrame.setDefaultLookAndFeelDecorated(true);

//2. Utwórz ramk

podaj

c jako argument tytuł ramki.

JFrame frame = new JFrame("FrameDemo");

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 9

//3. Opcjonalnie: co dzieje si

z programem w chwili zamykania ramki –

// ma on si

zako

czy

frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

//4. Utwórz komponenty i dodaj je do ramki.

//...utwórz pustą etykietę ... dodaj ją do panelu zawartości dla ramki

frame.getContentPane().add(emptyLabel, BorderLayout.CENTER);

// Opcjonalnie: umieść na środku ekranu

frame.setLocationRelativeTo(null);

//5. Realizacja ramki - wyznacz rozmiar i układ ramki.

frame.pack();

//6. Poka

ramk

- narysuj j

frame.setVisible(true);

Ustawienie dekoracji ramki

Domy

lnie za dekoracje okna odpowiada system nadzoruj

cy okna.

na zastosowa

dekoracje zgodne z domy

lnym „look and feel”.

liwe s

rozwi

zania:

bez dekoracji,

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 10

z własnymi dekoracjami u

ytkownika,

tryb pełnego ekranu.

liwy jest zawsze powrót do domy

lnych dekoracji systemu okien:

JFrame.setDefaultLookAndFeelDecorated(false).

Przykład 12.3

. Poni

sze 3 ramki posiadaj

ró

ne dekoracje okien.

Korzystaj

one z "Java look and feel" co wida

po postaci przycisku.

rodkowa ramka korzysta z dekoracji okien dostarczanych przez system

zarz

dzania oknami - w tym przypadku jest nim MS Windows ale mógłby

to by

dy inny system dysponuj

cy platform

Javy.

Dekoracje zgodne z

“look and feel”

Dekoracje zgodne z

systemem okien

Ikona u

ytkownika.

Dekoracje zgodne z

“look and feel”

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 11

Trzecia ramka posiada ikonk

dostarczon

przez u

ytkownika.

// Ustawienie dekoracji okna zgodnych z “look and feel”.

JFrame.setDefaultLookAndFeelDecorated(true);

// Utwórz ramk

JFrame frame = new JFrame("A window");

// Ustaw ikonk

w postaci obrazu ładowanego z pliku.

frame.setIconImage(new ImageIcon(imgURL).getImage());

Przykład 12.4

Program

FrameDemo2.java

ilustruje tworzenie ramek o

ró

nych dekoracjach i ikonkach. Opcjonalnie korzysta z pliku:

images/FD.jpg

import javax.swing.*;
import java.awt.*;
import java.awt.event.*;
import java.awt.image.BufferedImage;
public class FrameDemo2 extends WindowAdapter
                        implements ActionListener {
    private Point lastLocation = null;

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 12

    private int maxX = 500;
    private int maxY = 500;
    … //

// Konstruktor:

    public FrameDemo2() {
        Dimension screenSize = Toolkit.getDefaultToolkit().getScreenSize();
        maxX = screenSize.width - 50;
        maxY = screenSize.height - 50;
    }

// Utwórz i poka

obiekt obiekt klasy MyFrame

public void showNewWindow() {
JFrame frame = new MyFrame();

// Gdy nie są potrzebne dekoracje okna moŜna teŜ uŜyć Window lub JWindow

if (noDecorations) {
frame.setUndecorated(true);

// Brak dekoracji okna

}

// Ustaw połoŜenie okna:

if (lastLocation != null) {

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 13

// Przesuń okno o 40 pikseli:

            lastLocation.translate(40, 40);
            if ((lastLocation.x > maxX) || (lastLocation.y > maxY)) {
                lastLocation.setLocation(0, 0);
            }
            frame.setLocation(lastLocation);
        }
        else {  lastLocation = frame.getLocation(); }

// Wywołanie

setIconImage

- ustawia ikonk

wietlan

wtedy, gdy

// okno jest w stanie zminimalizowanym a tak

e ikonk

w dekoracjach

// kontrolowanych przez „look and feel”:

        if (specifyIcon) {
            if (createIcon) {
                frame.setIconImage(createFDImage());

// Nowa ikonka

                }
                else {
                       frame.setIconImage(getFDImage());

// Ikonka z pliku

}

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 14

}

// Realizuj i poka

ramk

        frame.setSize(new Dimension(170, 100));
        frame.setVisible(true);
    }

// Utwórz kontrolki dla opcji dekoracji i ikonek głównego okna

    protected JComponent createOptionControls() {
      JLabel label1 = new JLabel("Opcje dekoracji ramek:");
        ButtonGroup bg1 = new ButtonGroup();
        JLabel label2 = new JLabel("Icon options:");
        ButtonGroup bg2 = new ButtonGroup();

// Utwórz przyciski

        JRadioButton rb1 = new JRadioButton();
        rb1.setText("Look and feel decorated");
        rb1.setActionCommand(LF_DECORATIONS);
        rb1.addActionListener(this);
        rb1.setSelected(true);
        bg1.add(rb1);

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 15

JRadioButton rb2 = new JRadioButton();
rb2.setActionCommand(WS_DECORATIONS);

// ...

JRadioButton rb3 = new JRadioButton();
rb3.setActionCommand(NO_DECORATIONS);

// ...

JRadioButton rb4 = new JRadioButton();
rb4.setActionCommand(DEFAULT_ICON);

// ...

JRadioButton rb5 = new JRadioButton();
rb5.setActionCommand(FILE_ICON);

// ...

        JRadioButton rb6 = new JRadioButton();
        rb6.setActionCommand(PAINT_ICON);
        // ...

// Dodaj komponenty do kontenera .

…//

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 16

// Dodaj puste obramowanie

        box.setBorder(BorderFactory.createEmptyBorder(10,10,10,10));
        return box;
    }

// Utwórz przycisk widoczny w głównym oknie

    protected JComponent createButtonPane() {
        JButton button = new JButton("New window");
        button.setActionCommand(CREATE_WINDOW);
        button.addActionListener(this);
        defaultButton = button;

// Domyślny przycisk ramki

// Środkowe połoŜenie przycisku w panelu i obramowanie.

JPanel pane = new JPanel();

// Korzysta z domyślnego FlowLayout

        pane.setBorder(BorderFactory.createEmptyBorder(5,5,5,5));
        pane.add(button);
        return pane;

}

// Obsługa zdarze

typu akcji ze wszystkich przycisków.

public void actionPerformed(ActionEvent e) {

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 17

String command = e.getActionCommand();

// Obsługa przycisku “New window”.

if (CREATE_WINDOW.equals(command)) {
showNewWindow();

// Obsługa 1-szej grupy przycisków radiowych.

        } else if (NO_DECORATIONS.equals(command)) {
            noDecorations = true;
            JFrame.setDefaultLookAndFeelDecorated(false);
        } else if (WS_DECORATIONS.equals(command)) {
            noDecorations = false;
            JFrame.setDefaultLookAndFeelDecorated(false);
        } else if (LF_DECORATIONS.equals(command)) {
            noDecorations = false;
            JFrame.setDefaultLookAndFeelDecorated(true);

// Obsługa 2-giej grupy przycisków radiowych

        } else if (DEFAULT_ICON.equals(command)) {
            specifyIcon = false;
        } else if (FILE_ICON.equals(command)) {

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 18

            specifyIcon = true;     createIcon = false;
        } else if (PAINT_ICON.equals(command)) {
            specifyIcon = true;     createIcon = true;

}
}

// Utworzenie nowego obrazu

protected static Image createFDImage() {

// Utwórz obraz 16x16 pikseli.

BufferedImage bi = new BufferedImage(16, 16,
BufferedImage.TYPE_INT_RGB);

// Narysuj grafikę w obrazie.

        Graphics g = bi.getGraphics();
        g.setColor(Color.BLACK);
        g.fillRect(0, 0, 15, 15);
        g.setColor(Color.RED);
        g.fillOval(5, 3, 6, 6);

// Wyczyść obiekt graficzny.

g.dispose();

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 19

return bi;
}

// Zwraca

Image

lub

null

    protected static Image getFDImage() {
        java.net.URL imgURL =
                        FrameDemo2.class.getResource("images/FD.jpg");
        if (imgURL != null) {
           return new ImageIcon(imgURL).getImage();
        } else {
            return null;

}
}

// Uruchamia program demonstracyjny.

public static void main(String[] args) {

// Korzystaj z “Java look and feel”.

        try {
            UIManager.setLookAndFeel(
                UIManager.getCrossPlatformLookAndFeelClassName());

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 20

} catch (Exception e) { }

// Obiekt klasy steruj

cej .

FrameDemo2 demo = new FrameDemo2();

// Zapewnij dekoracje domy

lne

JFrame.setDefaultLookAndFeelDecorated(true);
JDialog.setDefaultLookAndFeelDecorated(true);

// Utwórz główne okno (o sterowanych dekoracjach)

JFrame frame = new JFrame("FrameDemo2");
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

// Dodaj komponenty

        Container contentPane = frame.getContentPane();
        contentPane.add(demo.createOptionControls(),  BorderLayout.CENTER);
        contentPane.add(demo.createButtonPane(),  BorderLayout.PAGE_END);
        frame.getRootPane().setDefaultButton(defaultButton);

// Wyświetl okno demonstracyjne.

frame.pack();
frame.setLocationRelativeTo(null);

// Ulokuj pośrodku

frame.setVisible(true);

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 21

}

// Klasa MyFrame

class MyFrame extends JFrame implements ActionListener {

// Utwórz ramkę z przyciskiem .

        public MyFrame() {
            super("A window");
            setDefaultCloseOperation(DISPOSE_ON_CLOSE);

// Przyciskiem tym mo

emy zamkn

ąć

okno – nawet nieudekorowane

            JButton button = new JButton("Close window");
            button.addActionListener(this);
            Container contentPane = getContentPane();
            contentPane.setLayout(new BoxLayout(contentPane,
                                                BoxLayout.PAGE_AXIS));
            contentPane.add(Box.createVerticalGlue());

// Wypełnia wolne miejsce

contentPane.add(button);
button.setAlignmentX(Component.CENTER_ALIGNMENT);

// Wyśrodkowany w poziomie

contentPane.add(Box.createVerticalStrut(5));

// spacje

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 22

}

// Obsługa zdarzenia dla przycisku realizuje to samo co domyślna operacja
// dla zamknięcia okna – (DISPOSE_ON_CLOSE).

        public void actionPerformed(ActionEvent e) {
            setVisible(false);
            dispose();

}
}

// Koniec MyFrame

}

// Koniec FrameDemo2

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 23

12.3

JRootPane

1) Obiekt klasy

JRootPane

tworzony jest wraz z obiektem klasy

JInternalFrame

lub kontenera głównego Swing-a

: JApplet, JDialog,

JFrame.

Obiekt klasy

JRootPane

zawiera cztery dalsze obiekty:

“Glass pane” - jest domy

lnie przezroczysty i ukryty.

“Layered pane” – rozmieszcza “content pane” i opcjonalny pasek menu

oraz dalsze komponenty w porz

dku odpowiadaj

cym „głebi” – o

“Content pane” –

zawiera wszystkie widoczne komponenty kontenera.

Pasek menu – miejsce dla menu kontenera panelu “root pane”.

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 24

Przykład 12.5.

Program

GlassPaneDemo.java

- je

li “glass pane” staje si

“widoczny” wtedy blokuje on wszelkie zdarzenia dla “zasłanianych”
komponentów zawartych w “content pane”, w przeciwnym razie maluje
czerwon

kropk

w miejscu wyst

pienia ostatniej wykrytej akcji.

W programie tworzony jest własny obiekt typu “glass pane” i ustawiany
metod

klasy

JFrame -

setGlassPane

. W ten sposób zdefiniujemy własny

kod malowania tego komonentu – w domy

lnym „glass pane” wyst

puje

pusty kod malowania.

...// Inicjalizacja własnego “glass pane” w miejscu inicjalizacji GUI:

myGlassPane = new MyGlassPane(...);
frame.setGlassPane(myGlassPane);
...

// W naszej klasie

MyGlassPane

definiujemy metod

paint

class MyGlassPane extends JComponent {
Point point = null;

// Będzie ustawiany aktualną pozycją kursora

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 25

public void paint(Graphics g) {

if (point != null) {

g.setColor(Color.red);

g.fillOval(point.x - 10, point.y - 10, 20, 20);

}

}
...
}

// Wizualizacja “glass pane” po wci

ciu przycisku.

JCheckBox changeButton = new JCheckBox("Glass pane \"visible\"");
changeButton.setSelected(false);
changeButton.addItemListener(new ItemListener() {
public void itemStateChanged(ItemEvent e) {
myGlassPane.setVisible(e.getStateChange()

ItemEvent.SELECTED);

}
});

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 26

Alernatywne rozwi

zanie dla poprzednego przykładu to doł

czenie

własnych metod obsługi zdarze

do domy

lnego “glass pane”

pobranego uprzednio metod

getGlassPane

Przykład 12.5A.

Własna obsługa

zdarze

zwi

zanych z mysz

dla

domy

lego panelu “glass pane”. Niech nasza obsługa polega na

ponownym „rozesłaniu” zdarzenia do wła

ciwych komponentów

kontenera „root pane” – listy wysuwnej lub menu.

...// Obsługa zdarzenia w “glass pane” :

public void mouseMoved(MouseEvent e) {
redispatchMouseEvent(e, false);
}

.../* Metody :

mouseDragged,

      mouseClicked,
      mouseEntered,
      mouseExited,

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 27

mousePressed

implementowane s

w identyczny sposób

jak powy

sza metoda

mouseMoved

*/.

// Implementacja metody

mouseReleased

public void mouseReleased(MouseEvent e) {
redispatchMouseEvent(e, true);
inDrag = false;
}

// Definicja metody obsługi – rozesłania obsług do komponentów:

private void redispatchMouseEvent(MouseEvent e, boolean repaint) {
    boolean inButton = false;
    boolean inMenuBar = false;
    Point glassPanePoint = e.getPoint();
    Component component = null;
    Container container = contentPane;
    Point containerPoint = SwingUtilities.convertPoint(
                                    glassPane,  glassPanePoint,  contentPane);
    int eventID = e.getID();
    if (containerPoint.y < 0) {

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 28

inMenuBar = true;

//... tu ustawić naleŜy odpowiednio container i containerPoint ...

        testForDrag(eventID);
    }
    component = SwingUtilities.getDeepestComponentAt(
                                    container, containerPoint.x,  containerPoint.y);
    if (component.equals(liveButton)) {
        inButton = true;
        testForDrag(eventID);
    }
    if (inMenuBar || inButton || inDrag) {

...// wyślij zdarzenie do komponentu ...

    }
    if (repaint) {
        toolkit.beep();
        glassPane.setPoint(glassPanePoint);
        glassPane.repaint();
    }

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 29

}
private void testForDrag(int eventID) {
    if (eventID == MouseEvent.MOUSE_PRESSED) {
        inDrag = true;
    }
}

2) Warstwy funkcjonalne w GUI

Panel typu “

root pane

” przekazuje swoje komponenty – pasek menu i

komponenty zawarte w panelu typu “content pane” – do obiektu obiektu
klasy

panelu warstwowego

JLayeredPane

pełni

cego rol

zarz

dcy

„gł

bi poło

enia” komponentu w GUI za pomoc

wyró

nienia

warstw

malowania

Im wy

szy

indeks warstwy

"tym pó

niej" i "tym bli

ej wierzchu" jest ona

malowana.

W ramach tej samej warstwy o kolejno

ci malowania komponentów

decyduje indeks ich

poło

w ramach warstwy

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 30

Dodaj

c komponent do panelu zawarto

ci kontenera głównego mo

emy

okre

jego przynale

ść

do warstwy malowania.

panelWarstwowy.add(label, new Integer(i));

// Dodaj komponent do

warstwy

panelu warstwowego.

Do zmiany warstwy komponentu słu

y metoda

setLayer

panelWarstwowy.setLayer(komponent, indeksWarstwy);

panelWarstwowy.setLayer(komponent, indeksWarstwy, pozycjaWWarstwie);

Pewne warto

ci warstw

zarezerwowane s

dla

specyficznych obiektów.

Nazwa zarezerwowanej warstwy i odpowiadaj

ca jej stała, zdefiniowana

w klasie

JLayeredPane

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 31

FRAME_CONTENT_LAYER

new Integer(-30000)

To warstwa przeznaczona dla “content pane” i paska menu ramki.

DEFAULT_LAYER

new Integer(0)

Tutaj umieszczane s

komponenty u

ytkownika, którym nie nadał on

indeksu warstwy.

PALETTE_LAYER

new Integer(100)

Ta warstwa jest dogodna dla tymczasowo widocznych pasków narz

dzi

i zestawów danych.

MODAL_LAYER

new Integer(200)

W tej warstwie umieszczane s

okna dialogowe otwierane w trybie

wył

czno

ci (modalne) dla obiektu klasy

JInternalFrame

POPUP_LAYER

new Integer(300)

W tej warstwie wyst

puj

wysuwane menu typu „pop-up”, powinny one

wyst

nad wszystkimi pozostałymi komponentami.

DRAG_LAYER

new Integer(400)

W tej warstwie umieszczany jest “uchwycony” mysz

komponent

(„drag”). Po „porzuceniu” („drop”) komponentowi powinna by

przywrócona jego normalna warstwa.

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 32

12.4 Panel warstwowy ("layered pane")

1) Klasy paneli warstwowych

W Swingu zdefiniowano dwie klasy paneli warstwowych:

JLayeredPane

- klasa dla panelu "

root pane

" kontenera głównego;

JDesktopPane

- klasa pochodna od

JLayeredPane

, specjalizowana dla

zawierania "wewn

trznych ramek".

Utworzenie własnego panelu warstwowego lub korzystanie z
domy

lnego dla kontenera typu

JFrame

// Własny

// Domy

lny

panelWarstw = new JLayeredPane();

panelWarstw = getLayeredPane();

... // Ustawienia panelu warstw

// Własny panel warstwowy kontenera

frame.setLayeredPane(panelWarstw);

frame.pack();

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 33

Przykład 12.6.

Program

LayeredPaneDemo

tworzy panel warstwowy i

rozmieszcza ró

nokolorowe etykiety w ró

nych warstwach.

W danej chwili obrazek “Duke”
rysowany jest

pod

zielon

i czerwon

etykiet

ale

nad

pozostałymi trzema.

W kontrolce wysuwnych opcji mo

zmieni

warstw

Duke-a

przyciskiem

radiowym

–

przenie

ść

go na pierwsze miejsce w

danej warstwie (pozycja 0).

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 34

// Utworzenie panelu warstwowego:

layeredPane = new JLayeredPane();

// Jedyny konstruktor w tej klasie

layeredPane.setPreferredSize(new Dimension(300, 310));

// Rozmiar

layeredPane.setBorder(BorderFactory.createTitledBorder(

// Brzeg

"Move the Mouse to Move Duke"));

// z tytułem

layeredPane.addMouseMotionListener(new MouseMotionAdapter() {

... // Obsługa zdarze

myszy

});

// Dodaj komponent do okre

lonej warstwy komponentów

for (int i = 0; i < ...number of labels...; i++) {
JLabel label = createColoredLabel(...);

// Metoda własna – tworzy

// obiekt klasy JLabel o pewnym kolorze, z brzegiem i tekstem.

layeredPane.add(label, new Integer(i));

// Dodaj komponent do

warstwy i panelu warstwowego

...
}

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 35

// Dynamiczna zmiana pozycji dla obiektu “dukeLabel” – w procedurze
//

actionPerformed

zarejestrowanej dla listy wysuwanych opcji:

public void actionPerformed(ActionEvent e) {
int position = onTop.isSelected() ? 0 : -1;

// Ustaw 0 lub -1

layeredPane.setLayer(dukeLabel,

// Komponent, który ustawiamy

layerList.getSelectedIndex(),

// Nowa warstwa

position);

// Nowa pozycja w warstwie – „góra” lub „dół

”

}

// Ustawienie pozycji w ramach warstwy

final ImageIcon icon = createImageIcon("images/dukeWaveRed.gif");
...
dukeLabel = new JLabel(icon);

// Utwórz etykiet

zawieraj

ikon

...
dukeLabel.setBounds(15, 225,

// Ustaw brzeg obiektu

icon.getIconWidth(),
icon.getIconHeight());

...

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 36

// Trzy-argumentowa wersja metody

add

layeredPane.add(dukeLabel,

// dodawany komponent

new Integer(2),

// obiekt Integer podaje indeks warstwy

0);

// warto

ść

int podaje pozycj

w ramach warstwy

Pozycje w ramach warstwy numerowane
s

od -1 do (n - 1), gdzie n jest liczb

komponentów

warstwy.

mniejsza

pozycja tym „wy

ej” znajduje si

dany

komponent. -1 jest równowa

ne (n – 1) –

wskazuje „najni

” pozycj

// Metoda

actionPerformed

zarejestrowana dla listy wysuwanych opcji:

public void actionPerformed(ActionEvent e) {
if (onTop.isSelected())
layeredPane.moveToFront(dukeLabel);

// Ustaw pozycję 0

else
layeredPane.moveToBack(dukeLabel);

// Ustaw pozycje -1

}

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 37

2) Romieszczanie komponentów w warstwowym panelu

Domy

lnie warstwowy panel

nie posiada menad

era układu

. Nale

samemu ustawi

rozmiary i poło

enia komponentów.

Np. z wykorzystaniem metody

setBounds

dukeLabel.setBounds(15, 225,
icon.getIconWidth(),
icon.getIconHeight());
...
label.setBounds(origin.x, origin.y, 140, 140);

Np. dynamiczna zmiana poło

enia metod

setLocation

dukeLabel.setLocation(e.getX()-XFUDGE, e.getY()-YFUDGE);

na te

nada

menad

era układu panelowi warstwowemu. B

dzie

on traktował komponenty tak, jakby wszystkie nale

ały do jednej

warstwy.

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 38

Np.

Program

LayeredPaneDemo2

ustawia

menad

era

układu

dla

panelu

warstwowego

obiekt

typu

GridLayout

i korzysta z niego dla

rzmieszczenia 6 kolorowych etykiet (z
poprzedniego przykładu).

Rozwi

zanie z wykorzystaniem menad

erów układu dla warstw:

Stosujemy kontenery po

redniego poziomu (jak np. panele) - po jednym

dla ka

dej warstwy komponentów –

- mo

na skorzysta

z menad

erów układu ka

dego panelu dla osobnego

ustawienia komponentów ka

dej warstwy;

- poszczególne panele rozmieszczamy stosuj

c bezwgl

dne warto

poło

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 39

12.5 Klasa

JInternalFrame

1) Klasa

JInternalFrame

umo

liwia malowanie ramki wewn

trz innej

ramki. Zwykle "ramki wewn

trzne" dodawane s

do panelu

warstwowego typu

JDesktopPane

, który z kolei staje si

panelem

zawarto

ci dla ramki typu

JFrame

(klasa

JDesktopPane

jest klas

pochodn

od klasy

JLayeredPane

Przykład 12.7

Program

InternalFrameDemo.java

tworzy poni

szy GUI - posiada 2

wewn

trzne ramki (jedna

została zminimalizowana)
wewn

trz regularnej ramki.

// Tworzenie GUI -
// kod zawarty w konstruktorze klasy

InternalFrameDemo

, b

cej

// klas

pochodn

od klasy

JFrame

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 40

desktop = new JDesktopPane();

// Utwórz nowy obiekt typu

JDesktopPane

...
createFrame();

// Utwórz okno wewn

trzne i doł

cz do panelu

desktop

...
setContentPane(desktop);

// Ustaw panel zawarto

ci ramki na

desktop

...

// Zmie

tryb "uchwycenia" komponentów. Tylko obrys ramki a nie jej

// cała zawarto

ść

rysowane podczas przeci

gania. To

// przyspieszy od

wie

anie kosztem wygl

du.

desktop.setDragMode(JDesktopPane.OUTLINE_DRAG_MODE);
...

.. // Metoda

createFrame()

protected void createFrame() {
MyInternalFrame frame = new MyInternalFrame();

// Klasa

// programisty - pochodna od

JInternalFrame

frame.setVisible(true);

// Ustaw widoczno

ść

wewn

trznej ramki

desktop.add(frame);

// Doł

cz wewn

trzn

ramk

do ramki głównej

try {

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 41

frame.setSelected(true);
} catch (java.beans.PropertyVetoException e) {}
}

// W konstruktorze klasy

MyInternalFrame

pochodnej od

JInternalFrame

static int openFrameCount = 0;
static final int xOffset = 30, yOffset = 30;
public MyInternalFrame() {
super("Document #" + (++openFrameCount),
true,

// b

dzie mo

liwa zmiana rozmiaru

true,

// b

dzie mo

liwe zamkni

cie

true,

// b

dzie mo

liwa maksymalizacja rozmiaru

true);

// b

dzie mo

liwa minimalizacja rozmiaru

    //... Tworzy GUI i dodaje do ramki ...
    //  ... -  jak na poczatku przykładu
    //... Ustawia rozmiar ramki lub woła

pack()

...

// Ustaw poło

enie ramki

setLocation(xOffset*openFrameCount, yOffset*openFrameCount);
}

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 42

2) Zasady korzystania z wewn

trznych ramek

Korzystanie z wewn

trznych ramek przypomina korzystanie z

regularnych ramek. Ramka wewn

trzna posiada panel "root pane" i

dlatego tworzenie z niej GUI jest niemal identyczne jak dla

JFrame

Ale

JInternalFrame

nie jest

klas

typu

Windows

ani kontenerem

głównym

- wewn

trzna ramka nie jest korzeniem hierarchii

komponentów - musi by

dodana do kontenera (np. typu

JDesktopPane

JInternalFrame

posiada metody takie, jak np.

moveToFront

, która

wymaga, aby kontenerem ramki był wła

nie panel warstwowy taki, jak

JDesktopPane.

Wybieraj

c wewn

trzne ramki w GUI u

ytkownik nie generuje zdarze

dla okien systemu, lecz zdarzenia dla okna ramki głównej.

Wewn

trzne ramki s

zaimplementowane w

kodzie niezale

nym od

platformy

i dlatego daj

pewne mo

liwo

ci u

ytkownikowi, których nie

posiadaj

zwykłe ramki:

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 43

programowo minimalizowa

lub

maksymalizowa

ramk

na poda

ikonk

dla paska

z tytułem.

na okre

, czy ramka posiada

dekoracje okien

dla zmiany

rozmiaru, minimalizacji, zamykania i maksymalizacji.

Zasady korzystania z wewn

trznych ramek

1. Ustawi

rozmiar wewn

trznej ramki -

w przeciwnym razie b

dzie ona

mie

rozmiar zerowy. Metody:

setSize, pack, setBounds

2. Ustawi

poło

enie

- w przeciwnym razie lokalizacja wyniesie (0, 0)

(lewy górny róg jej kontenera). Metody:

setLocation , setBounds

3. Doda

komponenty do "panelu zawarto

" wewn

trznej ramki - jak

dla ramki

JFrame

4. Okna dialogowe

wewn

trznym ramkami

powinny by

implementowane jako

JOptionPane

lub

JInternalFrame

, a nie

JDialog

Dla prostych dialogów nale

y u

metod klasy

JOptionPane

w rodzaju:

showInternalXxxDialog.

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 44

5. Wewn

trzna ramka

musi by

dodana do kontenera

- w przeciwnym

razie nie b

dzie widoczna.

6. Nale

wywoła

show

lub

setVisible

dla wewn

trznej ramki -

wewn

trzne ramki s

domy

lnie niewidoczne. Metody:

setVisible(true)

lub

show()

7. Wewn

trzne ramki

zgłaszaj

charakterystyczne dla nich zdarzenia

Chocia

zdarzenia te nie s

zwi

zane z oknami systemu, to jednak

obsługa tych zdarze

jest prawie identyczna z obsług

zdarze

dla okien

systemu.

8. Dla zwi

kszenia szybko

ci od

wie

ania przy wielu wewn

trznych

ramkach mo

na zmieni

tryb od

wie

ania podczas przeci

gania.

Metoda klasy

JDesktopPane

setDragMode

- umo

liwia ustawienie trybu

wie

ania podczas przeci

gania. Np.

desktop.setDragMode(JDesktopPane.OUTLINE_DRAG_MODE);

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 45

12.6 Klasa

JPanel

jest klas

ogólnego kontenera po

redniego poziomu:

zasadniczo rysuje tylko swoje tło;

na doda

brzeg;

na doda

komponenty;

komponenty rozmieszczane s

przez menad

era układu zwi

zanego

z panelem;

panel jest domy

lnie nieprzezroczysty i mo

e wtedy słu

jako

„content pane” dla ramki lub apletu.

Przykład 12.8

W programie Converter zastosowano kilka obiektów klasy

JPanel

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 46

Czerwony

panel – pełni rol

“content pane” dla ramki. Korzysta z

menad

era układu typu

BoxLayout

dla rozmieszczenia w pionie swoich

komponentów. Posiada pusty brzeg o szeroko

ci 5 pikseli.

Dwa panele

typu ConversionPanel (definiowanego przez u

ytkownika)

– zawieraj

komponenty i koordynuj

wymian

informacji mi

dzy

odpwiadaj

cymi sobie komponentami w obu panelach. Oba panele

posiadaj

brzegi opatrzone w tytuł i kraw

dzie. Korzystaj

menad

erów układu typu

BoxLayout

(rozmieszcza od lewej do prawej).

Po jednym panelu

- wyst

puje w ka

dym panelu konwersji dla

rozmieszczenia listy wysuwanych opcji z wykorzystaniem menad

erów

konwersji typu

BoxLayout

(rozmieszczanie w pionie) (dodatkowo

wyst

puje niewidoczny komponent wypełniaj

cy obszar panelu).

Po jednym panelu

dla ka

dego panelu konwersji grupuje dwa dalsze

komponenty – pole edycyjne i suwak — rozmieszczane w pionie
menad

erem układu typu

BoxLayout

Menad

er układu dla panelu

Domyslny menad

er jest typu FlowLayout – rozmieszczanie w wierszu.

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 47

Ustawienie innego menad

era układu – podczas konstrukcji panelu lub

metod

setLayout. Np.

JPanel p = new JPanel(new BorderLayout()); // preferowane rozwiązanie

// ale BoxLayout wymaga istnienia panelu:

JPanel p = new JPanel();
p.setLayout(new BoxLayout(p, BoxLayout.PAGE_AXIS));

Dodanie komponentów

// Dla menad

erów układu typu FlowLayout, BoxLayout, GridLayout,

// lub SpringLayout wystarczy 1-argumentowa metoda add():

aFlowPanel.add(aComponent);
aFlowPanel.add(anotherComponent);

// Dla BorderLayout potrzebny jest argument podaj

cy pozycj

aBorderPanel.add(aComponent, BorderLayout.CENTER);
aBorderPanel.add(anotherComponent, BorderLayout.PAGE_END);

// Dla GridBagLayout mo

na u

obu wersji metody add()

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 48

12.7

JScrollPane

Panel przewijany zapewnia przewijany widok komponentu, co ma
znaczenie wtedy, gdy dost

pny obszar ekranu nie wystarcza na

pokazanie całego komponentu na raz.

Przykład 12.9

Program dodaje obszar tekstowy do panelu przewijania,

gdy

obszar tekstowy dynamicznie ro

nie.

// W konterze z menad

erem układu typu Border Layout

// Utworzenie panelu przewijania z klientem – obszarem tekstowym::

textArea = new JTextArea(5, 30); // 5 wierszy i 30 kolumn tekstu
...

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 49

JScrollPane scrollPane = new JScrollPane(textArea);
...
setPreferredSize(new Dimension(450, 120)); // Rozmiar kontenera
...
add(scrollPane, BorderLayout.CENTER);

Kod dotycz

cy panelu przewijania jest minimalny, gdy

wszystko jest

wykonywane automatycznie przez metody klasy

JScrollPane

Przykład 12.10

Program

ScrollDemo

zapewnia zmodyfikowany przez

ytkownika panel przewijania dla prezentacji du

ej fotografii.

Poza obszarem centralnym – widokiem
dla komponentu – klienta (w tym
przypadku jest nim obraz) panel
przewijania zawiera te

2 paski

przesuwne, nagłówek wierszy,
nagłówek kolumn i cztery rogi.

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 50

// Deklaracja pola klasy:

private ScrollablePicture picture;
...

// Tworzenie GUI :

picture = new ScrollablePicture( ... ); // Utworzenie klienta
JScrollPane pictureScrollPane = new JScrollPane(picture);

Pó

niejsza zmiana klienta panelu jest mo

liwa metod

setViewportView

JScrollPane

nie posiada metody getViewportView – w celu pobrania

obiektu

klienta

nale

posłu

wywołaniem

getViewport().getViewportView()

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 51

Widocznym obszarem klienta zarz

dza obiekt klasy

JViewport

–

przeliczaj

c aktualne poło

enia pasków przewijania na ograniczenia

widocznego obszaru klienta.
Panel przewijania korzysta z dwóch obiektów klasy

JScrollBar

dla

zapewnienia pasków przewijania. Trzy obszary paska to:

„gałka” (“knob”) lub „kciuk” (“thumb”),
„przyciski strzałek” - ruch o 1 jednostk

„tor” („track”) - ruch o 1 blok.

Ustawianie opcji przewijania

dy pasek przewijania posiada własne ustawienia opcji. Konstruktory

klasy

JScrollPane,

umo

liwiaj

ce ustawienie opcji przewijania, to:

JScrollPane(Component, int, int)
JScrollPane(int, int)

Pierwszy parametr typu

int

okre

la opcj

dla pionowego paska a drugi

parametr typu

int

dla poziomego paska.

Dynamiczne ustawienie opcji przewijania – metodami:

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 52

setHorizontalScrollBarPolicy
setVerticalScrollBarPolicy.

W interfejsie

ScrollPaneConstants

(implementowanym przez

JScrollPane

)

zdefiniowano nast

puj

ce stałe:

VERTICAL_SCROLLBAR_AS_NEEDED
HORIZONTAL_SCROLLBAR_AS_NEEDED

Domy

lne ustawienie – pasek przewijania pojawia si

w razie potrzeby

wtedy, gdy obszar widoku jest mniejszy ni

obszar klienta a znika, gdy

widok jest wi

kszy ni

obszar klienta.

VERTICAL_SCROLLBAR_ALWAYS
HORIZONTAL_SCROLLBAR_ALWAYS

Zawsze wy

wietla pasek przewijania – jedynie

rodkowa cz

ęść

paska

(gałka) znika, gdy widok mo

e pomie

całego klienta.

VERTICAL_SCROLLBAR_NEVER
HORIZONTAL_SCROLLBAR_NEVER

Nigdy nie wy

wietla paska przewijania.

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 53

Dekoracje u

ytkownika

Obszar panelu przewijania mo

e składa

9 cz

ęś

ci:

obszaru centralnego,

czterech boków i

czterech naro

ników.

Jedynie obszar centralny musi zawsze wyst

– pozostałe s

opcjonalne. W obszarach bocznych mog

wyst

paski przewijania i

nagłówki wierszy oraz kolumn. Naro

niki s

widoczne tylko wtedy, gdy

przecinaj

w nich po dwa widoczne komponenty.

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 54

Przykład 12.11

W powy

szym przykładzie 3 z 4 naro

ników s

wykorzystane przez u

ytkownika – jeden zawiera dwustanowy przycisk,

a dwa dalsze s

jedynie wypełniane kolorem linijek. Ostatni naro

nik, na

przeci

ciu pasków przewijania jest domy

lnej postaci – mo

e on zanika

wtedy, gdy zaniknie przynajmniej jeden z pasków.

Nagłówki kolumn i wierszy zrealizowane s

za pomoc

komponentu

ytkownika

Rule

(linijka). Mo

na w tym celu u

dowolnego

komponentu. Panel przewijania umieszcza komponenty dla nagłówków
kolumn i wierszy w ich własnych widokach -

JViewport

. Te komponenty

przesuwaj

podczas przewijania synchronicznie z widokiem obszaru

klienta.

// Miejsce deklaracji pól klasy panelu:

private Rule columnView;
private Rule rowView;
...

// Miejsce inicjalizacji GUI :

ImageIcon david = createImageIcon("images/youngdad.jpeg");

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 55

...

// Utwórz nagłówki wierszy i kolumn:

columnView = new Rule(Rule.HORIZONTAL, true);
rowView = new Rule(Rule.VERTICAL, true);
if (david != null) {
columnView.setPreferredWidth(david.getIconWidth());
rowView.setPreferredHeight(david.getIconHeight());
}
...
pictureScrollPane.setColumnHeaderView(columnView);
pictureScrollPane.setRowHeaderView(rowView);

Jako klasa pochodna od

JComponent

klasa u

ytkownika

Rule

definiuje

metod

paintComponent

dla rysowania obiektu na ekranie. Metoda ta

sprawdza aktualny widok dla obiektu tak, aby nie rysowa

ęś

ci, które

wykraczaj

poza ten widok.

W dwóch naro

nikach umieszczane s

obiekty klasy u

ytkownika

Corner

a w trzecim – dwustanowy przycisk klasy

JToggleButton

// Utwórz obiekt dla naro

nika z przyciskiem

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 56

JPanel buttonCorner = new JPanel();

// korzysta z FlowLayout

isMetric = new JToggleButton("cm", true);
isMetric.setFont(new Font("SansSerif", Font.PLAIN, 11));
isMetric.setMargin(new Insets(2,2,2,2));
isMetric.addItemListener(this);
buttonCorner.add(isMetric);
...

// Ustaw naro

niki panelu przewijania

pictureScrollPane.setCorner(JScrollPane.UPPER_LEFT_CORNER,
                            buttonCorner);
pictureScrollPane.setCorner(JScrollPane.LOWER_LEFT_CORNER,
                            new Corner());
pictureScrollPane.setCorner(JScrollPane.UPPER_RIGHT_CORNER,
                            new Corner());

Rozmiar naro

nika wyznaczany jest przez rozmiary boków panelu

przewijania przecinaj

cych si

w danym naro

niku.

Stałe definiowane w interfejsie

ScrollPaneConstants

wyznaczaj

poło

enie naro

nika:

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 57

Klient implementuj

cy interfejs

Scrollable

Dla zapewnienia lepszej współpracy klienta z panelem przewijania klasa
komponentu klienta powinna implementowa

interfejs

Scrollable

Wtedy klient okre

li rozmiar widoku potrzebnego dla ogl

dania go i

jednostki dla przewijania za pomoc

ró

nych cz

ęś

ci paska.

Innym sposobem na ustawienie jednostek paska przewijania jest
wywołanie metod w klasie

JScrollBar

setUnitIncrement
setBlockIncrement .

Np. ustawienie jednostki pionowego przewijania na 10 pikseli:

scrollPane.getVerticalScrollBar().setUnitIncrement(10);

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 58

W powy

szym programie

ScrollDemo

klientem jest obiekt klasy

ytkownika

ScrollablePicture

, klasy pochodnej od

JLabel

. Implementuje

ona wszystkie 5 metod interfejsu

Scrollable

getScrollableBlockIncrement

getScrollableUnitIncrement

getPreferredScrollableViewportSize

getScrollableTracksViewportHeight

getScrollableTracksViewportWidth

Metoda klienta

getScrollableUnitIncrement

jest wołana wtedy, gdy

ytkownik klika jeden z przycisków na pasku przewijania. Sensown

implementacj

tej metody byłoby zwrócenie liczby pikseli pomi

dzy

kolejnymi działkami na linijce. W klasie

ScrollablePicture

podano jednak

troch

inn

implementacj

: zwracana jest liczba pikseli potrzebna do

umieszczenia obrazu na najbli

szym znaczniku podziałki.

public int getScrollableUnitIncrement(Rectangle visibleRect,
int orientation,
int direction) {

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 59

// Pobierz aktualne poło

enie.

    int currentPosition = 0;
    if (orientation == SwingConstants.HORIZONTAL) {
        currentPosition = visibleRect.x;
    } else {
        currentPosition = visibleRect.y;
    }

// Wynikiem jest liczba pikseli pomi

dzy

currentPosition

// a najbli

szym znacznikiem w podanym kierunku .

    if (direction < 0) {
        int newPosition = currentPosition -
                         (currentPosition / maxUnitIncrement)
                          * maxUnitIncrement;
        return (newPosition == 0) ? maxUnitIncrement : newPosition;
    } else {
        return ((currentPosition / maxUnitIncrement) + 1)
                 * maxUnitIncrement   - currentPosition;
    }

}

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 60

li obraz znajduje si

na znaczniku linijki ta metoda zwraca liczb

pikseli pomi

dzy dwoma znacznikami.

Panel przewijania wywołuje metod

klienta

getScrollableBlockIncrement

li potrzebna jest jednostka przewini

cia o blok. Implementacja tej

metody w przykładowej klasie u

ytkownika:

public int getScrollableBlockIncrement(Rectangle visibleRect,
                                       int orientation,
                                       int direction) {
    if (orientation == SwingConstants.HORIZONTAL)
        return visibleRect.width - maxUnitIncrement;
    else
        return visibleRect.height - maxUnitIncrement;
}

Powy

sza metoda zwraca wysoko

ść

widoku zmniejszon

o odległo

ść

pomi

dzy znacznikami linijki. Jest to typowe podej

cie. W ten sposób

pozostaje widoczny jeszcze w

ski fragment poprzedniego widoku.

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 61

Klasa u

ytkownika

ScrollablePicture

implementuje te

procedur

obsługi

zdarzenia myszy, która pozwala na przewijanie obrazu metod

“uchwycenia” i wyj

cia kursorem poza obszar obrazu:

public class ScrollablePicture extends JLabel
                               implements Scrollable,  MouseMotionListener {
    ...
    public ScrollablePicture(...) {
        ...
        setAutoscrolls(true);

// Dla zdarzenia sztucznego przesuni

cia

addMouseMotionListener(this);

// Obsługa przesuni

cia mysz

}

...

public void mouseDragged(MouseEvent e) {

// U

ytkownik “przeci

ga” klienta, wi

c przewijaj go:

        Rectangle r = new Rectangle(e.getX(), e.getY(), 1, 1);
        scrollRectToVisible(r);
    }
...
}

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 62

Metoda

setAutoscrolls,

zdefiniowana w

JComponent,

ma na celu

asystowanie przy procesie “przewijania przez przeci

ganie”. Po nadaniu

własno

autoscrolls

warto

true

komponent b

dzie zgłaszał zdarzenia

typu “

mouse-dragged

” wtedy, gdy mysz jest zatrzymana poza

komponentem w stanie „uchwycenia” klienta komponentu.

Okre

lenie rozmiaru panelu przewijania

li rozmiar panelu przewijania nie jest ustawiony jawnie to zostanie on

obliczony na podstawie preferowanych rozmiarów jego 9 cz

ęś

ci.

Najistotniejszy jest tu rozmiar widoku klienta.
Je

li klient nie jest przygotowany do przewijania (nie implementuje

Scrollable) wtedy stosowanie panelu przewijanie staje si

nadmiarowe –

rozmiar panelu jest wystarczaj

co du

y, aby prezentowa

preferowany

rozmiar klienta, czyli cało

ść

li klient jest przygotowany do przewijania to panel przewijania

pobiera

jego

preferowany

rozmiar

widoku

metod

klienta

getPreferredScrollableViewportSize .

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 63

Np. w klasie

JList

implementacja

getPreferredScrollableViewportSize

umo

liwia widok 8 wierszy.

Dynamiczna zmiana rozmiaru klienta

li w czasie wykonywania programu rozmiar klienta musi ulec zmianie

to nale

y o tym równie

powiadomi

panel przewijania:

najpierw nadawany jest nowy preferowany rozmiar klientowi,

nast

pnie wywołana jest metoda

revalidate

dla klienta co zmusi panel

przewijania do od

wie

enia swojego wygl

du, w tym pasków .

Np. klient nazywa si

drawingArea

if (changed) {
drawingArea.setPreferredSize(/*nowy rozmiar*/);
drawingArea.revalidate();

// Powiadom o zmianie panel przewijania

}

Do zmiany rozmiaru klienta dopasowuj

suwaki panelu przewijania,

ale ani panel przewijania ani rozmiar widoku klienta nie ulegaj

zmianie.

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 64

12.8

JSplitPane

– panel dzielony

Obiekt klasy

JSplitPane

rysuje dwa poł

czone ze sob

komponenty,

jeden obok drugiego lub jeden nad drugim.
Przesuwaj

c podziałk

oddzielaj

komponenty mo

na zmienia

podział obszaru panelu na dwie jego cz

ęś

ci.

Panele dzielone mog

zagnie

ane co pozwala na dzielenie

obszaru ekranu na wi

ksz

liczb

ęś

ci.

Komponenty składowe dodawane s

zwykle najpierw do paneli

przesuwnych a dopiero te staj

ęś

ciami panelu dzielonego.

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 65

Przykład 12.12

. Aplikacja korzysta z panelu dzielonego dla prezentacji

listy i obrazu obok siebie. Program pobiera dane – wektor nazw plików i
umo

liwia prezentacj

obrazów odpowiadaj

cych nazwom.

// Utworzymy panel dzielony zawieraj

cy dwa panele przewijane

splitPane = new JSplitPane (
JSplitPane.HORIZONTAL_SPLIT,

// Kierunek podziału

listScrollPane,

// 1-szy komponent składowy

pictureScrollPane);

// 2-gi komponent składowy

splitPane.setOneTouchExpandable(true);

// Przywró

strzałki

splitPane.setDividerLocation(150);

// Ustal poło

enie podziałki

// Okre

lamy minimalne rozmiary dla składowych panelu

Dimension minimumSize = new Dimension(100, 50);
listScrollPane.setMinimumSize(minimumSize);
pictureScrollPane.setMinimumSize(minimumSize);

Kierunek podziału:

JSplitPane.HORIZONTAL_SPLIT

lub

JSplitPane.VERTICAL_SPLIT

pó

niejsza zmiana metod

setOrientation( ).

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 66

Dwie małe strzałki na górze podziałce:

pojedynczym klikni

ciem mo

na zupełnie zwin

ąć

lub przywróci

ze składników .

rodowisku “Java Look & Feel” s

one domy

lnie niewidoczne;

na przywróci

strzałki metod

setOneTouchExpandable( )

Dynamiczne ustawianie składników panelu dzielonego

Metody

słu

ace

zmiany

komponentu

składowego:

setLeftComponent

setRightComponent

setTopComponent,

setBottomComponent

Interpretacja metod zale

y od aktualnego kierunku podziału panelu

dzielonego. Lewy odpowiada górnemu a prawy dolnemu poło

eniu i na

odwrót.

na korzysta

z metody

add()

dziedziczonej po JComponent ale po

uprzednim usuni

ciu zast

powanych komponentów metod

remove()

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 67

Przekazanie tylko jednego komponentu do panelu dzielonego sprawi,

e zajmie on miejsce lewe lub górne a podziałka znajdzie si

odpowiednio z prawej strony lub na dole obszaru panelu.

Ustawianie podziałki i ograniczanie jego zakresu

Metoda

setDividerLocation

słu

y do ustawiania podziałki – w pikselach

lub w procentach.

Dla pobrania aktualnego poło

enia podziałki wyra

onego w pikselach

słu

y metoda

getDividerLocation

Np.

// Ustaw podziałke na pikselu 150

splitPane.setDividerLocation(150);

// Ustaw podziałk

na 25% cało

ci dla lewego lub górnego składnika

splitPane.setDividerLocation(0.25);

Metoda

resetToPreferredSizes

ustawia podziałk

, tak aby składowe

posiadały preferowane rozmiary. Taka jest te

pocz

tkowa, domy

lna

podziałka.

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 68

Podziałk

na przesuwa

za pomoc

myszy. Ograniczeniem sa

minimalne rozmiary składników panelu. Zwykle nalezy ustawi

minimalne rozmiary (metoda

setMinimumSize

), gdy

w przeciwnym

razie panel kieruje si

preferowanymi rozmiarami i nie zezwala na

zmian

podziałki.

Zagnie

anie paneli dzielonych

Przykład 12.13

. Kolejny program dzieli obszar UI aplikacji na trzy

ęś

ci zagnie

c jeden panel

dzielony (utworzony w poprzednim
przykładzie w kierunku poziomym) w
drugim

(tworzonym

kierunku

pionowym).  Pierwszym  składnikiem
nowego  panelu  dzielonego  jest
poprzedni  panel  dzielony  a  drugim
zwykła etykieta.

// Utwórz obiekt klasy SplitPaneDemo zawieraj

cy panel dzielony

// z poprzedniego przykładu

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 69

SplitPaneDemo splitPaneDemo = new SplitPaneDemo();
JSplitPane top = splitPaneDemo.getSplitPane();

...

// Utwórz zwykł

etykiet

label = new JLabel("Click on an image name in the list.",
JLabel.CENTER);

// Utwórz panel dzielony i dodaj do niego panel oraz etykiet

JSplitPane splitPane = new JSplitPane(JSplitPane.VERTICAL_SPLIT,

top, label);

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 70

12.9

JTabbedPane

Klasa

JTabbedPane

umo

liwia zgrupowanie szeregu komponentów

(zwykle s

nimi panele) dziel

cych mi

dzy sob

ten sam obszar ekranu.

ytkownik otwiera jedn

z kart odpowiadaj

jednemu panelowi

wybieraj

c zwi

zan

z ni

metk

(„tab”).

Przykład 12.14.

GUI aplikacji o jednym obiekcie

JTabbedPane

zawieraj

cym cztery metki.

Metka mo

e wy

wietla

ikonk

i tekst a tak

e zawiera

wskazówk

(„tool

tip”). Do zmiany poło

enia metek słu

y metoda

setTabPlacement

Nie jest wymagana własna obsługa zdarze

, gdy

klasa

JTabbedPane

obsługuje zdarzenia myszy.

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 71

// Konstrukcja obiektu klasy JTabbedPane

ImageIcon icon = new ImageIcon("images/middle.gif");
JTabbedPane tabbedPane = new JTabbedPane();

// Dodaj karty z panelami

Component panel1 = makeTextPanel("Blah");
tabbedPane.addTab("One", icon, panel1, "Does nothing");
tabbedPane.setSelectedIndex(0);

Component panel2 = makeTextPanel("Blah blah");
tabbedPane.addTab("Two", icon, panel2, "Does twice as much nothing");

Component panel3 = makeTextPanel("Blah blah blah");
tabbedPane.addTab("Three", icon, panel3, "Still does nothing");

Component panel4 = makeTextPanel("Blah blah blah blah");
tabbedPane.addTab("Four", icon, panel4, "Does nothing at all");

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 72

12.10

Klasa JToolBar –

pasek narz

dzi

Kontener klasy

JToolBar

grupuje i ustawia komponenty (zwykle s

przyciski zaopatrzone w ikony) w wierszu lub w kolumnie. Jej zdaniem
jest ułatwienie wyboru i wywołania operacji przez u

ytkownika – zbli

one

zadanie do menu (klasy

JMenu

JMenuItem

Przykład 12.15

. GUI aplikacji

ToolBarDemo

posiadaj

cej zestaw narz

dzi

umieszczony nad obszarem tekstowym.

ytkownik mo

e przeci

zestaw do ró

nych kraw

dzi kontenera, w

którym jest zawarty, a tak

e przeci

zestaw do własnego okna.

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 73

Ograniczenia:

Dla zapewnienia operacji “przeci

gnij do własnego okna” (“drag-out”)

kontener zawieraj

cy zestaw musi posiada

menad

era BorderLayout.

Zestaw narz

dzi musi by

obok komponentu dla centralnego obszaru,

jedynym pozostałym komponentem w kontenerze i nie mo

e by

centralnym obszarze.

// Ikonki powinny by

pobrane z magazynu np. dla „Java Look and Feel”

String imgLocation = "toolbarButtonGraphics/navigation/Back24.gif";
URL imageURL = getClass().getResource(imgLocation);

if (imageURL != null) {
button = new JButton(new ImageIcon(imageURL));
}

// Utwórz i dodaj oba komponenty do kontenera

public ToolBarDemo() {
    ...
    JToolBar toolBar = new JToolBar();
    addButtons(toolBar); // Metoda własna uŜytkownika

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 74

    ...
    JPanel contentPane = new JPanel();
    contentPane.setLayout(new BorderLayout());
    ...
    contentPane.add(toolBar, BorderLayout.NORTH);
    contentPane.add(scrollPane, BorderLayout.CENTER);
    ...
}

// Dodaj przyciski do zestawu narz

dzi

protected void addButtons(JToolBar toolBar) {
    JButton button = null;
    // 1-szy przycisk
    button = new JButton(new ImageIcon("images/left.gif"));
    ...
    toolBar.add(button);
    // 2-gi przycisk
    button = new JButton(new ImageIcon("images/middle.gif"));
    ...

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 75

    toolBar.add(button);
    // Trzeci przycisk
    button = new JButton(new ImageIcon("images/right.gif"));
    ...
    toolBar.add(button);
}

Przykład 12.16.

Program

ToolBarDemo2

. Kilka dodatkowych własno

zestawu

narz

dzi:

unieruchomienie

zestawu

(metoda

setFloatable(false)), dodanie separatora , dodanie komponentu innego
ni

przycisk.

W widoku zestawu narz

dzi nie ma

„zderzaka”, gdy

zestaw nie

e by

przeci

gany.

Wył

czenie „przeci

galno

ci” zestawu narz

dzi:

toolBar.setFloatable(false);

Dodanie separatora – spacji:

toolBar.addSeparator();

12. Swing – kontenery.

W. Kasprzak: Programowanie zdarzeniowe

12 - 76

Dodanie nowych komponentów:

// Czwarty przycisk

button = new JButton("Another button");
...
toolBar.add(button);

// Piąty komponent

JTextField textField = new JTextField("A text field");
...
toolBar.add(textField);

Komponenty ustawione s

w sposób

rodkowany

wzgl

dem siebie.

Mog

dopasowane swoimi dolnymi lub górnymi kraw

dziami (przy

ustawieniu ich w poziomie) metod

setAlignmentY

Np. wywoła

nale

setAlignmentY(TOP_ALIGNMENT)

dla ka

dego

komponentu.
Podobnie metoda

setAlignmentX

słu

y do zwi

zania bokami wtedy, gdy

komponenty ustawione s

w pionie.

Generalnie zestaw narz

dzi korzysta z menad

era układu

BoxLayout