Proz-S13n

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 1

13. Swing - obsługa zdarze

13.1 Przykłady

13.2 Zasady

13.3 Typy zdarze

13.4 Implementowanie obsługi zdarze

13.5

Action

Abstract Action

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 2

13.1 Przykłady obsługi zdarze

Przykład 13.1

. Aplet zawiera GUI w postaci pojedynczego przycisku

wydaj

cego d

k dzwonka po klikni

ciu mysz

w przycisk.

Fragment kodu obsługi zdarze

dla przycisku:

public class Beeper ... implements ActionListener {
...

// w miejscu inicjalizacji:

        button.addActionListener(this);
    ...
    public void actionPerformed(ActionEvent e) {

...// Spowoduj dźwięk dzwonka...

Toolkit.getDefaultToolkit().beep();

}
}

Komentarz:
1) Klasa u

ytkownika

Beeper

implementuje interfejs

ActionListener

– jej

jedyn

metod

actionPerformed

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 3

2) Obiekt klasy

Beeper

e si

zarejestrowa

dla obsługi zdarze

akcji

zgłaszanych przez przycisk – stosujemy w tym celu metod

klasy

Button

addActionListener

3) Teraz metoda klasy

Beeper

actionPerformed

– jest wywoływana do

obsługi zdarzenia przycisku.

W

jednym programie

e zosta

zarejestrowana

dowolna liczba

obiektów

dla obsługi ró

nych zdarze

zgłaszanych przez dowoln

liczb

obiektów.

Program mo

e posiada

po jednej obsłudze

dla ka

dego zdarzenia (a

nawet

cej ni

jedn

obsług

jednego zdarzenia).

Z drugiej strony program mógłby posiada

jedn

obsług

wspóln

dla

wszystkich zdarze

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 4

Przykład 13.2.

Aplet zawiera dwa

ródła zdarze

(obiekty klasy

JButton

) i dwa obiekty

obsługi zdarze

. Pierwszy obiekt (pewnej klasy

MultiListener

) obsługuje

zdarzenia obu przycisków – obsługa polega na dodaniu tekstu – etykiety
przycisku - w górnym obszarze przycisku. Drugi obiekt (pewnej klasy

Eavesdropper

) obsługuje jedynie zdarzenia jednego przycisku – dodaje

tekst – etykiet

przycisku - w dolnym polu tekstowym.

Fragment kodu obsługi zdarze

dla przycisku:

public class MultiListener ... implements ActionListener {
...

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 5

// W miejscu inicjalizacji:

button1.addActionListener(this);

// Pierwszy obiekt obsługujący

button2.addActionListener(this);

// Drugi obiekt obsługujący zdarzenie

button2.addActionListener(new Eavesdropper(bottomTextArea));

    }

    public void actionPerformed(ActionEvent e) {
        topTextArea.append(e.getActionCommand() + newline);
    }
}

class Eavesdropper implements ActionListener {
    ...
    public void actionPerformed(ActionEvent e) {
        myTextArea.append(e.getActionCommand() + newline);
    }
}

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 6

Przykład 13.3

Kolejny aplet ilustruje obsług

zdarzenia innego typu ni

zdarzenia typu

akcji – zdarzenia od myszy - click, press, release, enter, exit.
Obsługa zdarzenia polega na wy

wietleniu w polu tekstowym napisu

odpowiadaj

cego rodzajowi zdarzenia, które zaszło nad prostok

tnym

obszarem.

Fragment kodu obsługi zdarze

public class MouseEventDemo ... implements MouseListener {
...

// W miejscu inicjalizacji:

// Rejestracja dla zdarzeń myszy dla obszaru blankArea i apletu:

blankArea.addMouseListener(this);
addMouseListener(this);

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 9

13.2 Zasady tworzenia obsługi zdarze

Przypomnijmy,

e obsługa zdarze

i malowanie GUI wykonywane s

przez jeden ten sam w

tek.

1) Obiekty generuj

ce zdarzenia

da metoda obsługi zdarzenia posiada jeden

argument.

Jest nim

obiekt klasy pochodnej od

EventObject

. Np. dla klas zdarze

myszy

istnieje klasa

MouseEvent

Metoda klasy

EventObject

Object getSource()

zwraca obiekt, który zgłosił zdarzenie.

Inne klasy argumentów obsługi zdarze

posiadaj

metody

zwracaj

ce obiekt, w którym wystapiło zdarzenie, ale o specyficznym

typie wyniku. Np. w klasie

ComponentEvent

istnieje metoda:

Component getComponent

()

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 10

która zwraca komponent a nie generalny obiekt.
Metoda obsługi zdarzenia zwykle pobiera informacje o zdarzeniu od
swojego argumentu - obiektu klasy zdarzeniowej. Np. obiekt klasy

MouseEvent

posiada dane o tym, ile było klikni

ęć

, jakie klawisze myszy

zostały wybrane itd.

2) Zdarzenia nisko-poziomowe a zdarzenia semantyczne

Zdarzenia niskiego poziomu

reprezentuj

zjawiska generowane przez

system zarz

dzania oknami lub wprowadzanie danych. S

nimi:

•

zdarzenia myszy lub klawiatury

bezpo

rednio wynikiem

wprowadzania danych przez u

ytkownika),

•

zdarzenia

komponentu

(nadzorowanie

pozycji,

rozmiaru,

widoczno

ci),

•

zdarzenia kontenera

(gdy dodawany/usuwany jest komponent),

•

uzyskiwanie/utrata kontekstu

klawiatury przez komponent,

•

zdarzenia okna

(nadzoruj

stan okna dla komponentu).

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 11

Pozostałe zjawiska generuj

zdarzenia semantyczne. S

nimi

zdarzenia typu:

•

“

action

event”,

•

“

item

event”,

•

“

list selection

event”.

Sposób wywołania semantycznego zdarzenia zale

y od komponentu.

Np. przycisk zgłasza “action event”, gdy u

ytkownik klika w niego, a pole

tekstowe zgłasza “action event”, gdy u

ytkownik wciska klawisz Return.

Zdarzenie te zale

Ŝą

równie

rodowiska “look and feel”.

Preferowa

nale

y obsług

zdarze

semantycznych, gdy

kod obsługi

dzie ogólniejszy i przenaszalny.

Np. obsługa “action events” dla przycisku zapewni reakcj

zarówno

wtedy, gdy przycisk wybierany jest mysz

lub klawiatur

, podczas gdy

obsługa zdarze

myszy dla przycisku nie uwzgl

dni klawiatury.

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 12

3) Adaptery i klasy wewn

trzne w obsłudze zdarze

kszo

ść

interfejsów deklaruje wi

cej ni

jedn

metod

. Np.

MouseListener

deklaruje 5 metod:

mousePressed,

mouseReleased,

mouseEntered,

mouseExited,

mouseClicked

Nawet wtedy, gdy nie obsługujemy niektórych zdarze

myszy musimy

zaimplementowa

wszystkie metody implementowanego interfejsu.

Przykład 13.4.a

// Przykład kodu o niskiej czytelno

ci:

public class MojaKlasa implements MouseListener {
...

mojObiekt.addMouseListener(this);

...

/* Pusta definicja metody */

public void mousePressed(MouseEvent e) {
}

/* Pusta definicja metody */

public void mouseReleased(MouseEvent e) {

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 13

}

/* Pusta definicja metody */

public void mouseEntered(MouseEvent e) {
}

/* Pusta definicja metody */

    public void mouseExited(MouseEvent e) {
    }
    public void mouseClicked(MouseEvent e) {

...// Implementacja obsługi zdarzenia...

}
}

Istnienie wielu pustych definicji metod zmniejsza czytelno

ść

kodu.

na zastosowa

adaptery klas

z API, implementuj

ce interfejsy o

cej ni

jednej metodzie. Zawieraj

one metody o

pustym kodzie

Np. klasa

MouseAdapter

implementuje interfejs

MouseListener

Korzystanie z klasy adapteru

polega na dziedziczeniu z niej.

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 14

Przykład

13.4.b

Dziedziczenie

klasy

adapteru

zamiast

implementowania interfejsu. Definiujemy tylko 1 metod

interfejsu.

public class MojaKlasa extends MouseAdapter {
...

mojObiekt.addMouseListener(this);

...
public void mouseClicked(MouseEvent e) {

...// Obsługa zdarzenia w tym miejscu...

}
}

W przypadku

apletów

klasa u

ytkownika musi dziedziczy

z bazowej

klasy apletu a nie z adapteru interfejsu. W takiej sytuacji mo

skorzysta

klasy wewn

trznej

, która dziedziczy po klasie adapteru, np.

MouseAdapter

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 15

Przykład 13.4.c

Klasa wewn

trzna

dziedziczy z klasy adapteru.

public class MojaKlasa extends Applet {
...

mojObiekt.addMouseListener(new MyAdapter());

    ...
    class MyAdapter extends MouseAdapter {
        public void mouseClicked(MouseEvent e) {

...// Tu podamy kod obsługi zdarzenia ...

}
}
}

Przykład 13.4.d

Korzystanie z

anonimowej klasy wewn

trznej

public class MojaKlasa extends Applet {
...

mojObiekt.addMouseListener(new MouseAdapter() {

public void mouseClicked(MouseEvent e) {

...// Tu podamy kod obsługi zdarzenia ...

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 16

}

});

...
}
}

Klasa wewn

trzna (o ile nie jest statyczna) mo

e korzysta

nawet z

prywatnych pól i metod klasy obejmuj

cej. Do obiektu obejmuj

cego

na odwoła

przez:

klasaObejmująca.this .

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 17

13.3 Typy zdarze

dla komponentów Swing

Typy zdarze

generowanych przez dany komponent wynikaj

z typów

“event listeners” u których mo

na zarejestrowa

swoje obiekty obsługi.

Np. klasa

Component

definiuje nast

puj

ce metody rejestracji obiektów:

addComponentListener ,
addFocusListener ,
addKeyListener ,
addMouseListener ,
addMouseMotionListener .

Konkretny komponent generuje tylko te zdarzenia, dla których istniej

rejestracje obiektów obsługi zdarze

1) Typy zdarze

wyst

puj

ce we wszystkich komponentach Swinga

Komponenty

Swing

-a dziedzicz

klasy

Component

w AWT

, dlatego te

wyst

puj

w nich zdarzenia poni

szych 5 typów:

component listener, focus listener,
key listener, mouse events, mouse-motion events .

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 18

Wszystkie komponenty

Swing-a

dziedzicz

z klasy

Container

w AWT

chocia

kszo

ść

z nich nie pełni roli kontenera. Ale ka

dy komponent

Swing-a mo

e (teoretycznie) generowa

zdarzenia

typowe dla

kontenera

, tzn. zdarzenia powiadamiaj

ce o dodaniu lub usuni

ciu

komponentu do/z kontenera.
W praktyce tylko

kontenery

(takie jak panele i ramki) i

komponenty

zło

one

(jak lista wysuwnych opcji) generuj

zdarzenia dla kontenera.

Klasa

JComponent

posiada dalsze trzy typy obsługi zdarze

“

AncestorListener

” – obiekt obsługi jest powiadamiany, gdy dodawani

lub usuwani s

z hierarchii zawarto

ci przodkowie komponentu, a

tak

e gdy staj

oni widoczni, s

ukrywani lub przesuwani.

“

PropertyChangeListener

” – obiekt obsługi jest powiadamiany o

zmianach w ustawionych na trwałe własno

ciach komponentu (tzw.

„bound properties”).

“

VetoableChangeListener

” – obiekt obsługi jest powiadamiany o

zmianach własno

ci o zadanych ograniczeniach.

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 19

2) Inne typy obsługi zdarze

w komponentach Swinga

ActionListener
ChangeListener
CaretListener
DocumentListener
UndoableEditListener
ItemListener
WindowListener
ListSelection

i szereg indywidualnych.

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 20

13.4 Implementowanie obsługi wybranych zdarze

1) Zdarzenia akcji (Action Listener)

Zdarzenie typu “action event” powstanie np. wtedy, gdy u

ytkownik w UI

kliknie przycisk, wybierze opcj

menu lub przyci

nie klawisz

Return

dla

pola

tekstowego.

jego

wyniku

wszystkich

obiektów

zarejestrowanych na wła

ciwym komponencie zostanie rozesłane

wywołanie metody

actionPerformed

Interfejs

ActionListener

posiada tylko jedn

metod

void actionPerformed(ActionEvent)

Parametrem metody

jest obiekt klasy

ActionEvent

. W tej klasie

zdefiniowano m.in. dwie po

yteczne metody:

String getActionCommand()

Metoda zwraca napis rozkazu zwi

zany z akcj

. Wi

kszo

ść

klas, których

obiekty mog

generowa

zdarzenie typu akcji posiada metod

setActionCommand

umo

liwiaj

ustalenie tego napisu rozkazu.

li ten napis nie jest ustalony to rozkaz zwi

zany z akcj

jest tekstem

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 21

wietlanym w komponencie.

Jesli obiekt posiada wiele obiektów opcji, czyli wiele mo

liwych akcji,

które mog

zosta

wykonane, to zwykle napis rozkazu odpowiada

nazwie wybranej opcji.

int getModifiers()

Metoda zwraca warto

ść

całkowit

okre

laj

jaki klawisz specjalny

został przyci

ty przez u

ytkownika podczas generacji zdarzenia typu

akcja. Mo

liwy wynik to stałe zdefiniowane w

ActionEvent:

SHIFT_MASK, CTRL_MASK, META_MASK, ALT_MASK

Np.
gdy u

ytkownik skorzystał z przycisku

Shift

dla wyboru opcji to poni

sze

wyra

enie b

dzie prawdziwe:

actionEvent.getModifiers() & ActionEvent.SHIFT_MASK

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 22

2) Zdarzenia zmiany stanu (Change Listener)

Zdarzenie typu “zmiana” wyst

pi wtedy, gdy

dany komponent zmienia

stan

Np.

•

Przycisk

generuje takie zdarzenie za ka

dym razem gdy zostanie

przyci

ty. Domy

lna obsługa tego zdarzenia dla przycisku jest

zapewniona przez

rodowisko „look-and-feel” (np. od

wie

enie

wygl

du).

•

Zdarzenie typu “zmiana” umo

liwia podstawow

funkcjonalno

ść

dwóch

komponentów Swinga:

suwaka

i „

wyboru kolorów

”. Zdarzenie

generowane jest wtedy, gdy zmienia sie warto

c suwaka wzgl. gdy

ytkownik wybiera nowy kolor.

Przykład 13.5

. Obsługa zdarzenia typu “zmiana” dla suwaka.

//...w miejscu inicjalizacji

framesPerSecond.addChangeListener(new SliderListener());
...
class SliderListener implements ChangeListener {

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 23

    public void stateChanged(ChangeEvent e) {
        JSlider source = (JSlider)e.getSource();
        if (!source.getValueIsAdjusting()) {
            int fps = (int)source.getValue();

...

}
}
}

Interfejs

ChangeListener

deklaruje tylko jedn

metod

void stateChanged(ChangeEvent)

Parametr metody jest typu

ChangeEvent

. Wła

ciw

metod

dla pobrania

komponentu,

który

zgłosił

zdarzenie

jest

metoda

getSource

odziedziczona po klasie

EventObject

Klasa

ChangeEvent

nie definiuje dodatkowych metod.

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 24

3) Zdarzenia komponentu (Component Listener)

Zdarzenia typu “component event” s

generowane przez komponent

wtedy, gdy zostanie on:

•

ukryty

(metoda obsługi -

componentHidden

)

•

uczyniony widocznym

(metoda obsługi –

componentShown

•

przesuni

(metoda obsługi –

componentMoved

) lub nast

•

zmiana jego rozmiaru

(metod obsługi

componentResized

Obsługa tych zdarze

jest potrzebna obiektom, które

zapewniaj

informacj

o komponencie

, ale nie jest potrzebna dla zarz

dzania

widokiem lub dla malowania komponentu.
Zdarzenia generowane przy ukrywaniu lub nadaniu widoczno

komponentowi s

wynikiem wywoła

metody klasy

Component

setVisible

(lub metod

show, hide

Uwaga:

proces ikonizacji okna nie powoduje zdarzenia ukrycia

komponentu lecz zdarzenia nale

Ŝą

cego do zdarze

okna („window

event”).

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 25

Przykład 13.6.

Aplet

ComponentEventDemo

zawiera przycisk „

Start playing ...”

powoduj

wyswietlenie

okna ramki

(typu

JFrame

). W ramce jest

panel

posiadaj

etykiet

pole wyboru

(„checkbox”) nadzoruj

ce widoczno

ść

etykiety.

Dla celów kontrolnych istnieje te

pole tekstowe

wietlaj

komunikaty

dla

dego

zdarzenia

typu

“

component

event

”

wygenerowanego przez

okno, panel, etykiet

lub pole wyboru

Fragment GUI apletu zawieraj

cy:

- przycisk „Start playing”,
- pole tekstowe z komunikatami,
- przycisk zerowania pola tekstowego
„Clear”

Opuszczenie

strony apletu

powoduje

ukrycie okna

(

componentHidden

), a

jego ponowne

pojawienie

(

componentShown

) nast

puje po powrocie do

strony apletu.

public class ComponentEventDemo ... implements ComponentListener {
...

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 26

// W miejscu inicjalizacji :

        aFrame = new JFrame("A Frame");
        ComponentPanel p = new ComponentPanel(this);
        aFrame.addComponentListener(this);
        p.addComponentListener(this);
    ...
    public void componentHidden(ComponentEvent e) {

displayMessage("componentHidden event from "

+ e.getComponent().getClass().getName());

// Pobiera nazwę klasy

// obiektu zgłaszającego zdarzenie

}
public void componentMoved(ComponentEvent e) {

displayMessage("componentMoved event from "

+ e.getComponent().getClass().getName());

}
public void componentResized(ComponentEvent e) {

displayMessage("componentResized event from "

+ e.getComponent().getClass().getName());

}

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 27

public void componentShown(ComponentEvent e) {

displayMessage("componentShown event from "

+ e.getComponent().getClass().getName());

}
}

// Koniec definicji klasy głównej

class ComponentPanel extends JPanel ... {
...
ComponentPanel(ComponentEventDemo listener) {

...// Po utworzeniu etykiety i pola wyboru :

        label.addComponentListener(listener);
        checkbox.addComponentListener(listener);
    }
    ...
}

Interfejs

ComponentListener

i odpowiadaj

ca mu klasa adaptera

ComponentAdapter

deklaruj

cztery metody:

void componentHidden(ComponentEvent)

Metoda wołana po ukryciu komponentu wywołaniem setVisible(false).

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 28

void componentMoved(ComponentEvent)

Metoda wołana po przesuni

ciu komponentu wzgl

dem jego kontenera.

void componentResized(ComponentEvent)

Metoda wołana po zmianie rozmiaru komponentu (prostok

obejmuj

cego go).

void componentShown(ComponentEvent)

Metoda wołana po nadaniu widoczno

ci komponentowi wywołaniem

setVisible(true).

Ka

da z powy

szych metod posiada parametr typu

ComponentEvent

. W

tej klasie zdefiniowano po

yteczn

metod

Component getComponent() ,

- zwraca komponent, który wygerenował zdarzenie.

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 29

4) Zdarzenia kontenera (Container Listener)

Zdarzenia typu “container events” s

generowane przez kontener zaraz

po tym, jak

dodany

zostanie

do niego komponent

lub komponent

zostanie

z niego

usuni

Te zdarzenia słu

Ŝą

jedynie powiadamianiu

a nie maj

wpływu na samo

wykonanie operacji dodania lub usuni

cia komponentu.

Przykład 13.7.

Aplet

ContainerEventDemo

posiada w swoim GUI przyciski o nazwach:

„

Add a button

” i “

Remove a button

”, które umo

liwiaj

dodanie lub

usuni

cie komponentu do/z panelu poło

onego na dole obszaru apletu.

da taka operacja spowoduje wygenerowanie przez panel zdarzenia

typu „

container event

” i powiadomienie o tym metod obsługi tego

zdarzenia dla panelu

componentAdded()

lub

componentRemoved()

. W

wyniku obsługi wy

wietlany jest w górnej cz

ęś

ci apletu tekst informuj

o zdarzeniu.

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 30

public class ContainerEventDemo ... implements ContainerListener ... {

...// W kodzie inicjalizacji :

buttonPanel = new JPanel();

buttonPanel.addContainerListener(this);

...
public void componentAdded(ContainerEvent e) {

displayMessage(" added to ", e);

}
public void componentRemoved(ContainerEvent e) {

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 31

displayMessage(" removed from ", e);

}
void displayMessage(String action, ContainerEvent e) {

display.append(((JButton)e.getChild()).getText()

+ " was"

+ action

// Parametr zawiera nazwę operacji – dodano/usnięto

+ e.getContainer().getClass().getName()

// Pobierz nazwę klasy

// kontenera, który spowodował zdarzenie

+ newline);

}
...
}

Interfejs

ContainerListener

i jego klasa adapteru

ContainerAdapter

deklaruj

dwie metody:

void componentAdded(ContainerEvent)

- metoda wołana po podaniu komponentu do kontenera.

void componentRemoved(ContainerEvent)

- metoda wołana po usuni

ciu komponentu z kontenera.

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 32

Parametr obu metod jest typu

ContainerEvent

– w tej klasie

zdefiniowano dwie po

yteczne metody:

Component getChild()

– metoda zwraca komponent, którego dodanie wzgl. usuni

cie

spowodowało generacj

zdarzenia.

Container getContainer()

- metoda zwraca kontener, który zgłosił zdarzenie.

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 33

5) Zdarzenia okna (Window Listener)

Zdarzenia typu

zdarzenia okna

(“window events”) generowane s

przez

okna (typu ramka lub dialog) zaraz po tym, jak okno zostanie

otwarte,

zamkni

zminimalizowane, przywrócone, uczynione aktywnym

lub

nieaktywnym

Otwarcie okna

oznacza pierwsze namalowanie okna.

Zamkni

cie okna

oznacza usuni

cie go z ekranu.

Minimalizacja okna

oznacza zast

pienie go mał

ikonk

na pulpicie.

Przywrócenie okna

to operacja odwrotna do minimalizacji.

Aktywacja okna

oznacza,

e okno lub zawarty w nim komponent mog

przyjmowa

zdarzenia myszy lub klawiatury.

Okno

staje sie

nieaktywne,

gdy okno i zawarte w nim komponenty

trac

liwo

ść

przyjmowania zdarze

myszy i klawiatury.

Uwaga

Zdarzenia polegaj

ce na uczynieniu okna

widocznym

(show, visible) lub

ukryciu go

(hide) zaliczane s

do typu

zdarze

komponentu

(„component events”).

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 34

Obsługa zdarzenia zamykania okna

Zdarzenie

zamykania okna

(w wyniku operacji

Close

) jest głównym

zdarzeniem zwi

zanym z oknem wymagaj

cym obsługi.

Istnieje

domy

lna obsługa

zdarzenia zamykania okna polegaj

ca jedynie

ukryciu go

(uczynieniu go niewidocznym).

na ustawi

inny predefiniowany sposób obsługi tego zdarzenia

przez

domy

procedur

obsługi zdarze

okna – np. usuni

cie zasobów

okna – stosuj

c metod

klas

JFrame

lub

JDialog

o nazwie

setDefaultCloseOperation

emy te

zaimplementowa

własn

metod

obsługi

tego zdarzenia,

np. w celu zapami

tania danych zwi

zanych z oknem przed jego

usuni

ciem lub zako

czenie programu, gdy ostatnie jego okno zostanie

zamkni

te.

li implementujemy własn

procedur

obsługi zdarzenia zamykania

okna to mo

emy „

wył

czy

” domy

procedur

obsługi wywołuj

setDefaultCloseOperation(WindowConstants.DO_NOTHING_ON_CLOSE)

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 35

Obsługa zdarze

minimalizacji i przywracania okna

stym celem zada

obsługi zdarze

dla okna jest

zatrzymywanie

tków

zwalnianie zasobów

wtedy, gdy okno

jest minimalizowane

, a

nast

pnie

ponowne ich restartowanie

, gdy okno

jest przywracane

Pozwala to unikn

ąć

niepotrzebnego zajmowania procesora lub innych

zasobów przez w

tki. Np. okno zawiera animacj

– po minimalizacji

okna nale

y zatrzyma

tek animacji i zwolni

e bufory, a po

przywróceniu okna zrestartowa

tek po przywróceniu buforów.

Przykład 13.8.

Aplet

WindowEventDemo

posiada w górnej cz

ęś

ci swojego

GUI przycisk otwieraj

cy małe okno. Klasa główna „nasłuchuje” zdarze

generowanych przez to okno i wy

wietla napisy wła

ciwe dla typu

zdarzenia.
Je

li wył

czymy domy

obsług

zdarzenia zamykania okna to

zdarzenie “window closed” nie zajdzie, gdy

nasza obsługa zdarzenia

“window closing” polega jedynie na wywołaniu

setVisible(false)

(ukryciu

okna) zamiast wykonania zwolnienia zasobów obiektu metod

dispose()

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 36

public class WindowEventDemo ... implements WindowListener {

...//w kodzie inicjalizacji:

// Utwórz ale nie wy

wietlaj okna

window = new JFrame("Okno WindowEventDemo");

window.addWindowListener(this);

// Rejestracja obsługi zdarzeń okna

window.getContentPane().add(

new JLabel("Demonstracja zdarzeń okna "), BorderLayout.CENTER);

        window.pack();
    }
    public void windowClosing(WindowEvent e) {
        window.setVisible(false);
        displayMessage("Window closing", e);

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 37

    }
    public void windowClosed(WindowEvent e) {
        displayMessage("Window closed", e);
    }
    public void windowOpened(WindowEvent e) {
        displayMessage("Window opened", e);
    }
    public void windowIconified(WindowEvent e) {
        displayMessage("Window iconified", e);
    }
    public void windowDeiconified(WindowEvent e) {
        displayMessage("Window deiconified", e);
    }
    public void windowActivated(WindowEvent e) {
        displayMessage("Window activated", e);
    }
    public void windowDeactivated(WindowEvent e) {
        displayMessage("Window deactivated", e);
    }

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 38

    void displayMessage(String prefix, WindowEvent e) {
        display.append(prefix
                       + ": "
                       + e.getWindow()

// Pobierz okno, które wygenerowało zdarzenie

                       + newline);
    }
    ...
}

Interfejs

WindowListener

i klasa adaptera

WindowAdapter

deklaruj

metody:

void windowOpened(WindowEvent)

– metoda wołana wtedy, gdy nadzorowane okno zostało namalowane po
raz pierwszy.

void windowClosing(WindowEvent)

- metoda wołana po

Ŝą

daniu u

ytkownika aby zamkn

ąć

okno –

procedura obsługi powinna usun

ąć

zasoby okna lub ukry

okno metod

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 39

setVisible(false)

void windowClosed(WindowEvent)

– metoda wołana po zamkni

ciu nadzorowanego okna.

void windowIconified(WindowEvent)
void windowDeiconified(WindowEvent)

- metody wołane po minimalizacji

wzgl. przywróceniu nadzorowanego okna.

void windowActivated(WindowEvent)
void windowDeactivated(WindowEvent)

- metody wołane po uczynieniu

aktywnym wzgl. nieaktywnym nadzorowanego okna.

Ka

da z powy

szych metod posiada parametr typu

WindowEvent

Metoda

Window getWindow()

- pobiera i zwraca okno, które wygenerowało to zdarzenie.

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 40

6) Zdarzenia wewn

trznej ramki (Internal Frame Listener)

Zdarzenia typu “internal frame events” pełni

podobn

rol

dla klasy

JInternalFrame

co zdarzenia typu “window events” dla klasy

JFrame

Umo

liwiaj

one powiadomienie obiektów obsługi o tym,

e "okno"

zostało

pokazane po raz pierwszy, ma by

usuni

te, zminimalizowane,

przywrócone, uczynione aktywnym

lub

nieaktywnym

Przykład 13.9.

Aplikacja

InternalFrameEventDemo

przyci

ciu

jej

górnego

przycisku wy

wietla wewn

trzn

ramk

nasłuchuje

zdarze

generowanych przez t

ramk

Obsługa

zdarze

polega

wietleniu informacji o typie

wygenerowanego zdarzenia.

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 41

public class InternalFrameEventDemo ...

implements InternalFrameListener ... {

...

// Metoda tworząca wewnętrzną ramkę, której zdarzeń nasłuchujemy

protected void createListenedToWindow() {

listenedToWindow = new JInternalFrame("Event Generator",

true,

// zmienność rozmiaru

true,

// zamykalne

true,

// maksymalizowalne

true);

// ikonifikowalne

listenedToWindow.setDefaultCloseOperation( /

/ Domyślne zamykanie

WindowConstants.DISPOSE_ON_CLOSE);

...

}
public void internalFrameClosing(InternalFrameEvent e) {

displayMessage("Internal frame closing", e);

}
public void internalFrameClosed(InternalFrameEvent e) {

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 42

displayMessage("Internal frame closed", e);

listenedToWindow = null;

}
public void internalFrameOpened(InternalFrameEvent e) {

displayMessage("Internal frame opened", e);

}
public void internalFrameIconified(InternalFrameEvent e) {

displayMessage("Internal frame iconified", e);

}
public void internalFrameDeiconified(InternalFrameEvent e) {

displayMessage("Internal frame deiconified", e);

}
public void internalFrameActivated(InternalFrameEvent e) {

displayMessage("Internal frame activated", e);

}
public void internalFrameDeactivated(InternalFrameEvent e) {

displayMessage("Internal frame deactivated", e);

}
void displayMessage(String prefix, InternalFrameEvent e) {

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 43

// Nasza metoda wyświetlania informacji o zdarzeniach

String s = prefix + ": " + e.getSource();

// Pobierz obiekt-źródło zdarzenia

display.append(s + newline);

}

...

// W klasie jest teŜ obsługa akcji dla przycisku „Show Internal Frame”

public void actionPerformed(ActionEvent e) {

if (e.getActionCommand().equals(SHOW)) {

...

if (listenedToWindow == null) {

createListenedToWindow();

// Utwórz nową wewętrzną ramkę

listenedToWindow.addInternalFrameListener(this);

//Rejestruj w celu

// obsługi jej zdarzeń

...

}

...

}

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 44

}

interfejsie

InternalFrameListener

klasie

adaptera

InternalFrameAdapter

zadeklarowano metody:

void internalFrameOpened(InternalFrameEvent)

- wołana po pierwszym

narysowaniu nadzorowanej wewn

trznej ramki.

void internalFrameClosing(InternalFrameEvent)

– metoda wołana po

Ŝą

daniu u

ytkownika zamkni

cia wewn

trznej ramki. Domy

lna obsługa

w klasie

JInternalFrame

jedynie ukrywa okno dla zdarzenia zamykania

ramki. Metod

klasy

JInternalFrame

o nazwie

setDefaultCloseOperation

na zmieni

zachowanie tej obsługi na:

DISPOSE_ON_CLOSE

lub

DO_NOTHING_ON_CLOSE

(stałe w interfejsie

WindowConstants

implementowanym przez

JInternalFrame

void internalFrameClosed(InternalFrameEvent)

- wołana zaraz po

usuni

ciu obiektu i zasobów wewn

trznej ramki metod

dispose

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 45

void internalFrameIconified(InternalFrameEvent)
void internalFrameDeiconified(InternalFrameEvent)

– metody wołane s

po minimalizacji wzgl. przwróceniu wewn

trznej ramki.

void internalFrameActivated(InternalFrameEvent)
void internalFrameDeactivated(InternalFrameEvent)

– metody wołane s

po uczynieniu ramki aktywnej wzgl. nieaktywnej.

da metoda posiada jeden parametr typu

InternalFrameEvent

- ta

klasa nie definuje u

ytecznych metod. Dziedziczy ona metod

getSource

po klasie

EventObject

co pozwala na pobranie obiektu ramki, który

wygenerował obsługiwane zdarzenie.

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 46

7) Zdarzenia wyboru opcji (Item Listener)

Zdarzenia typu “Item events” generowane s

przez komponenty

implementuj

ce interfejs

ItemSelectable

. Takie komponenty zapewniaj

dwustanow

reprezentacj

opcji (wł

cz/wył

cz).

Np. w

Swingu

takie zdarzenia generuj

obiekty typu “

check box”, “check

box menu item”, “combo box”

Interfejs

ItemListener

deklaruje jedn

metod

void itemStateChanged(ItemEvent)

Metoda jest wołana zaraz po zmianie stanu nadzorowanego
komponentu. Parametrem metody jest obiekt klasy

ItemEvent

. W tej

klasie zdefiniowano metody:

Object getItem()

zwraca obiekt zwi

zany z opcj

o zmienionym stanie

– cz

sto jest to napis klasy

String

cy tytułem wybranej opcji.

ItemSelectable

getItemSelectable()

–

zwraca

komponent,

który

wygenerował zdarzenie.

int getStateChange()

– zwraca nowy stan opcji – w klasie

ItemEvent

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 47

zdefiniowano dwa stany:

SELECTED , DESELECTED

Przykład 13.10

. W programie

ComponentEventDemo

(przykład 13.6)

wyst

puje te

kod obsługi zdarze

wyboru opcji (“item events”):

...
// W kodzie inicjalizacji

checkbox.addItemListener(this);

// Rejestracja dla zdarzeń wyboru opcji

...
public void itemStateChanged(ItemEvent e) {
    if (e.getStateChange() == ItemEvent.SELECTED) {
        label.setVisible(true);
        label.revalidate();
        label.repaint();
    } else {
        label.setVisible(false);
    }
}

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 48

8) Zdarzenia dla klawiatury (Key Listener)

Zdarzenia typu “key events” pojawiaj

, gdy u

ytkownik

przyciska

lub

zwalnia klawisze klawiatury

. S

one generowane przez

komponent

posiadaj

cy w danej chwili

kontekst klawiatury

Zdarzenia klawiatury (“key events”):

“

key typed

” – wprowadzono znak w Unikodzie;

„

key pressed

” - przyci

cie klawisza;

“

key released

” – zwolnienie klawisza.

Najcz

ęś

ciej program obsługuje tylko zdarzenia typu “wprowadzono

znak”. Obsługa dwóch pozostałych zdarze

potrzebna jest jedynie

wtedy, gdy chcemy reagowa

na klawisze nie reprezentuj

ce znaków

widocznych lecz tzw. znaki specjalne, np.

Uwaga:

innym mechanizmem reakcji programu na klawisze specjalne

jest stosowanie skrótów do klawiszy („key bindings”) w obiektach opcji.

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 49

Proces uzyskiwania przez komponent kontekstu klawiatury:

•

metoda komponentu

isFocusTraversable

musi zwraca

true

;

•

komponent wywołuje metod

requestFocus

wtedy, gdy zostanie on

wybrany, np. klikni

ciem myszy – w obsłudze zdarzenia myszy.

Przykłady generacji zdarze

klawiaury:

•

Wprowadzenie znaku 'a' do pola tekstowego wygeneruje 3 zdarzenia:

“key pressed”, “key typed”, “key released”. Zdarzenie “key typed” nie
uzyskuje kodu klawisza ani kodu modyfikatora.

•

Wprowadzenie klawisza ‘Shift’ - pole tekstowe generuje 2 zdarzenia:

“key pressed” i “key released”.

•

Wprowadzenie znaku 'A' jednoczesnym (‘Shift’+A) – generuje

zdarzenia: “key pressed” (Shift), “key pressed” (A), “key typed” (A),
“key released” (A), “key released” (Shift).

•

Wrowadzenie znaku 'A' sekwencj

(‘Caps Lock’, A) – generuje

zdarzenia: “key pressed” (Caps Lock), “key pressed” (A), “key typed”
('A'), key released (A).

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 50

Uwaga

: dla klawisza “Caps Lock” i innych klawiszy “stanu” (Scroll

Lock, Num Lock) zdarzenie „key released” generowane jest dla
nast

pnej pary akcji – wcisni

cia i zwolnienia tego klawisza.

Przykład 13.11.

GUI apletu składa si

z edytowalnego pola tekstowego

w którym u

ytkownik wprowadza znaki z klawiatury i z obszaru

tekstowego wy

wietlaj

cego komunikaty o zdarzeniach typu “key event”.

Przycisk na dole umo

liwia wyzerowanie pola i obszaru tekstowego.

Fragment kodu obejmuj

cy obsług

zdarze

klawiatury:

public class KeyEventDemo ... implements KeyListener ... {

...// W kodzie inicjalizacji:

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 51

typingArea = new JTextField(20);

typingArea.addKeyListener(this);

...

/** Obsługa zdarzenia “key typed” dla pola tekstowego. */

public void keyTyped(KeyEvent e) {

displayInfo(e, "KEY TYPED: ");

}

/** Obsługa zdarzenia “key pressed” dla pola tekstowego. */

public void keyPressed(KeyEvent e) {

displayInfo(e, "KEY PRESSED: ");

}

/** Obsługa zdarzenia “key released” dla pola tekstowego. */

public void keyReleased(KeyEvent e) {

displayInfo(e, "KEY RELEASED: ");

}
...

// Nasza metoda analizy wprowadzonych danych i wy

wietlania

protected void displayInfo(KeyEvent e, String s){

// komunikatu

...

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 52

char c = e.getKeyChar();

// Pobierz wprowadzony znak

int keyCode = e.getKeyCode();

// Pobierz kod klawisza

int modifiers = e.getModifiers();

// Pobierz kod klawisza specjalnego

...

tmpString = KeyEvent.getKeyModifiersText(modifiers);

...// Tu wyświetlenie informacji o zdarzeniach typu KeyEvent...

}
}

W interfejsie

KeyListener

i klasie adaptera

KeyAdapter

zadeklarowano

wzgl. zdefiniowano trzy metody:

void keyTyped(KeyEvent)

– wołana po wprowadzeniu znaku Unikodu do

nadzorowanego komponentu;

void keyPressed(KeyEvent)

– wołana po naci

ciu klawisza, gdy

nadzorowany komponent posiada kontekst klawiatury;

void keyReleased(KeyEvent)

– wołana po zwolnieniu klawisza, gdy

nadzorowany komponent posiada kontekst klawiatury;

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 53

da z metod posiada jeden parametr klasy

KeyEvent

. W tej klasie

zdefiniowano po

yteczne metody dla ustalenia podczas obsługi

szczegółów zdarzenia:

int getKeyChar()
void setKeyChar(char)

- pobierz lub ustaw znak Unikodu zwi

zany z tym

zdarzeniem;

int getKeyCode()
void setKeyCode(int)

pobierz lub ustaw kod klawisza zwi

zany z tym

zdarzeniem - w klasie

KeyEvent

zdefiniowano stałe reprezentuj

ce kody

klawiszy – np.

VK_A

dla klawisza A,

VK_ESCAPE

dla klawisza

ESCAPE

void setModifiers(int)

– ustawia stan klawisza modyfikuj

cego dla tego

zdarzenia – stan mo

e by

pobrany metod

getModifiers

klasy

InputEvent

;

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 54

String getKeyText()
String getKeyModifiersText()

- zwraca opisy tekstowe klawisza wzgl.

klawisza modyfikuj

cego dla zdarzenia.

Klasa

KeyEvent

dziedziczy metody z klas

InputEvent

ComponentEvent

Metody te opisane b

dla klasy

MouseEvent

Component getComponent()
void consume()
int getWhen()
boolean isAltDown()
boolean isControlDown()
boolean isMetaDown()
boolean isShiftDown()
int getModifiers()

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 55

9) Zdarzenia dla myszy (Mouse Listener)

Zdarzenia pochodz

ce od “myszy” s

generowane w wyniku interakcji

ytkownika z komponentem za pomoc

myszy (lub podobnego

urz

dzenia wej

ciowego).

Zdarzenia zwi

zane ze zmian

stanu myszy:

kursor

wchodzi

do obszaru ekranu dla komponentu,

kursor

wychodzi

z obszaru ekranu dla komponentu,

ytkownik

wciska

przycisk myszy,

ytkownik

zwalnia

przycisk myszy,

klikni

cie

„lewym” przyciskiem myszy.

Zdarzenia zwi

zane z ruchem myszy zebrane s

w odr

bny typ

zdarze

MouseMotionListener

Klasa adaptera

MouseInputAdapter

implementuje oba interfejsy:

MouseListener

MouseMotionListener

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 56

Przykład 13.12

. Aplet

MouseEventDemo

zawiera obsług

zdarze

myszy

dla górnego obszaru (pustego) (BlankArea) i dla kontenera
zawieraj

cego ten obszar (klasa MouseEventDemo). O wygenerowanym

zdarzeniu informuje tekst pojawiaj

cy si

w dolnym obszarze tekstowym.

Kod obsługi zdarze

myszy:

public class MouseEventDemo ... implements MouseListener {

...// W kodzie inicjalizacji:

// Rejestracja obsługi zdarze

myszy dla “blankArea” i panelu.

        blankArea.addMouseListener(this);
        addMouseListener(this);
    ...
    public void mousePressed(MouseEvent e) {

// Obsługa przyciśnięcia

saySomething("Mouse pressed; # of clicks: "

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 57

                    + e.getClickCount(), e);
    }
    public void mouseReleased(MouseEvent e) { /

/ Obsługa zwolnienia

       saySomething("Mouse released; # of clicks: "
                    + e.getClickCount(), e);
    }
    public void mouseEntered(MouseEvent e) {

// Obsługa wejścia

       saySomething("Mouse entered", e);
    }
    public void mouseExited(MouseEvent e) {

// Obsługa wyjścia

       saySomething("Mouse exited", e);
    }
    public void mouseClicked(MouseEvent e) {

// Obsługa kliknięcia

       saySomething("Mouse clicked (# of clicks: "
                    + e.getClickCount() + ")", e);
    }
    void saySomething(String opis, MouseEvent e) {
        textArea.append(opis + " detected on "
                        + e.getComponent().getClass().getName()

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 58

+ "." + newline);
}
}

Interfejs

MouseListener

i jego adapter

MouseAdapter

deklaruj

metody:

void mouseClicked(MouseEvent)

– wołana zaraz po klikni

ciu przez

ytkownika nadzorowanego komponentu;

void mouseEntered(MouseEvent)

– wołana zaraz po wprowadzeniu

kursora w obszar ekranu dla nadzorowanego komponentu;

void mouseExited(MouseEvent)

– wołana zaraz po wyprowadzeniu

kursora z obszaru ekranu dla nadzorowanego komponentu;

void mousePressed(MouseEvent)

– wołana zaraz po przyci

ciu

przycisku myszy podczas, gdy kursor znajduje si

w obszaru ekranu dla

nadzorowanego komponentu;

void mouseReleased(MouseEvent)

– wołana zaraz po zwolnieniu

przycisku myszy podczas, gdy kursor znajduje si

w obszaru ekranu dla

nadzorowanego komponentu;

Uwaga.

Gdy u

ytkownik “przeci

ga” komponent – przyciska i trzyma

przyci

ty przycisk a w tym czasie przesuwa kursor myszy – zdarzenia

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 59

„

mouse

entered

”,

„

mouse

exited

”,

„

mouse

released

”

dotycz

przeci

ganego komponentu wł

cznie z ko

cowym „

mouse released

”.

da z powy

szych metod posiada parametr klasy

MouseEvent

W tej klasie zdefiniowano kilka po

ytecznych metod:

int getClickCount()

– zwraca liczb

szybko po sobie nast

puj

cych

klikni

ęć

, np. 2 dla „double click”;

int getX()
int getY()
Point  getPoint()

zwracaj

współrz

dne kursora, gdy zdarzenie zaszło,

wzgl

dem punktu odniesienia komponentu;

boolean isPopupTrigger()

zwraca warto

ść

„true”, gdy zdarzenie myszy

powinno wy

wietli

„pop-up” menu; powinno by

wołane podczas

obsługi zdarze

typu „mouse pressed” i „mouse released” dla wszystkich

komponentów, które mog

zawiera

„pop-up” menu.

Klasa

MouseEvent

dziedziczy te

yteczn

metod

z klasy

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 60

ComponentEvent

Component getComponent

– zwraca komponent, który wygenerował

zdarzenie; mo

e by

wykorzystana zamiast bardziej ogólnej metody

getSource

Klasa

MouseEvent

dziedziczy te

kilka po

ytecznych metod z klasy

InputEvent

int getWhen()

– zwraca indeks chwili czasowej, gdy zdarzenie to

wyst

piło – im wy

sza warto

ść

indeksu tym bli

sza jest ta chwila

aktualnej chwili.

boolean isAltDown()
boolean isControlDown()
boolean isMetaDown()
boolean  isShiftDown()

– zwraca stan indywidualnych klawiszy

modyfikujacych w chwili zaj

cia zdarzenia;

int getModifiers()

– zwraca stan wszystkich klawiszy modyfikuj

cych i

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 61

przycisków myszy w chwili, gdy wyst

piło to zdarzenie; w klasie

InputEvent zdefiniowano stałe dla rozpatrywanych przycisków i klawiszy:

ALT_MASK, BUTTON1_MASK, BUTTON2__MASK,
BUTTON3_MASK, CTRL_MASK, META_MASK, SHIFT_MASK.

Np. poni

sze wyra

enie jest prawdziwe gdy wci

to prawy przycisk

myszy:

(mouseEvent.getModifiers() & InputEvent.BUTTON3_MASK)
== InputEvent.BUTTON3_MASK

W klasie

SwingUtilities

istniej

metody sprawdzaj

ce, czy wci

przycisk myszy:

static boolean isLeftMouseButton(MouseEvent)
static boolean isMiddleMouseButton(MouseEvent)
static boolean isRightMouseButton(MouseEvent)

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 62

10) Zdarzenia ruchu myszy (Mouse Motion Listener)

Zdarzenia typu “mouse-motion events” s

reakcj

na ruch kursora na

ekranie sterowany mysz

(lub podobnym urz

dzeniem wej

ciowym).

Interfejs

MouseMotionListener

i klasa adaptera

MouseMotionAdapter

deklaruj

dwie metody:

•

void mouseDragged(MouseEvent)

– wołana dla ruchu myszy w

sytuacji, gdy przycisk myszy jest wci

ty – zdarzenie generowane

jest przez komponent, który uprzednio wygenerował te

zdarzenie

„mouse pressed”, nawet je

li kursor nie znajduje si

nad tym

komponentem.

•

void mouseMoved(MouseEvent)

- wołana dla ruchu myszy, gdy

przyciski myszy nie s

wci

te – zdarzenie generowane jest przez

komponent znajduj

cy sie aktualnie pod kursorem.

Uwaga: parametr obu metod jest klasy

MouseEvent

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 63

Przykład 13.13.

Aplet

MouseMotionEventDemo

ilustruje obsług

ruchu

kursora

górnym

obszarze

pustym.

Implementuje

metody

mouseDragged

mouseMoved

podaj

c w dolnym obszarze tekstowym

informacj

o współrz

dnych kursora.

Kod implementuj

cy obsług

zdarze

ruchu myszy:

public class MouseMotionEventDemo extends JApplet
implements MouseMotionListener {

//...W kodzie inicjalizacji:
// Rejestracja dla zdarze

ruchu myszy w obszarze blankArea i

// całego apletu (panelu).

        blankArea.addMouseMotionListener(this);
        addMouseMotionListener(this);
        ...

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 64

}
public void mouseMoved(MouseEvent e) {

// Ruch myszy

       saySomething("Mouse moved", e);
    }
    public void mouseDragged(MouseEvent e) {

// Pochwycenie myszą

       saySomething("Mouse dragged", e);
    }
    void saySomething(String opis, MouseEvent e) {
        textArea.append(opis
                        + " (" + e.getX() + "," + e.getY() + ")"
                        + " detected on "
                        + e.getComponent().getClass().getName()
                        + newline);
    }
}

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 65

Przykład 13.14.

Program

SelectionDemo

wyrysowuje prostok

t jako

reakcj

na zdarzenie przeci

gania mysz

. Zawiera obsług

trzech

zdarze

myszy: “

mouse press”, “mouse drag”, “mouse release

”.

Wymaga

implementacji

obu

interfejsów:

MouseListener

MouseMotionListener.

W tym celu dziedziczymy z klasy adaptera

MouseInputAdapter

...// W kodzie inicjalizacji w klasie głównej :

    MyListener myListener = new MyListener();
    addMouseListener(myListener);
    addMouseMotionListener(myListener);
...

// Klasa dla obsługi zdarze

myszy

class MyListener extends MouseInputAdapter {
    public void mousePressed(MouseEvent e) {
        int x = e.getX();
        int y = e.getY();
        currentRect = new Rectangle(x, y, 0, 0);
        updateDrawableRect(getWidth(), getHeight());
        repaint();

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 66

    }
    public void mouseDragged(MouseEvent e) {
        updateSize(e);
    }
    public void mouseReleased(MouseEvent e) {
        updateSize(e);
    }
    void updateSize(MouseEvent e) {
        int x = e.getX();
        int y = e.getY();
        ...
        repaint(...);
    }
}

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 67

13.5 Klasy

AbstractAction, Action

1) Klasa

Action

li zdarzenia dla dwóch lub wi

cej komponentów prowadz

wykonania tej samej funkcji programu to sensowne staje si

•

wprowadzenie wspólnego typu zdarzenia, np.

ActionListener

•

utworzenie jednego obiektu klasy

Action

implementuj

cego t

funkcj

Zdarzenia „akcji”

generuje szereg komponentów: przyciski, opcje menu,

pola tekstowe, pola wyboru, itd.

Klasy posiadaj

ce metody

setAction

getAction

AbstractButton , JComboBox , JTextField

Przykład 13.15.

Obsługa zdarzenia akcji dla przycisku i opcji menu

dzie wykonywa

sam

funkcj

Action leftAction = new LeftAction();
...

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 68

button = new JButton(leftAction)
...
menuItem = new JMenuItem(leftAction);

Pó

niejsze

w trakcie inicjalizacji

doł

czenie obiektu „akcji” do

komponentu

nast

puje zwykle metod

setAction

Obiekt typu

Action

doł

czony do komponentu

jest domy

lnie

zarejestrowany

dla obsługi zdarze

akcji (“action events”) komponentu.

Obiekt typu

Action

zapewnia obsług

zdarze

akcji i mo

e te

zapewni

centralne zarz

dzanie stanem

komponentu generuj

cego takie

zdarzenia:

stan komponentu

odpowiada stanowi obiektu akcji; np. obiekt akcji

przekazuje komponentowi tekst i ikonk

;

zmiana stanu obiektu akcji

powoduje odpowiedni

zmian

stanu

wszystkich komponentów, do których jest doł

czony.

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 69

Utworzenie przez programist

własnej obsługi poprzez obiekt typu

Action

polega na:

•

zdefiniowaniu klasy pochodnej od klasy

AbstractAction

•

utworzeniu jej obiektu, pod warunkiem,

•

ta klasa pochodna implementuje metod

actionPerformed

Przykład 13.15 (c.d.)

Definicja własnej klasy

LeftAction

pochodnej po

AbstractAction

i utworzenie jej obiektu

leftAction

// W klasie głównej ActionDemo

leftAction = new LeftAction("W lewo", anIcon,
"To jest lewy przycisk.",
new Integer(KeyEvent.VK_L));

// ALT + L

- klawisz skrótu

...

// Klasa LeftAction

class LeftAction extends AbstractAction {
    public LeftAction(String text, ImageIcon icon,
                      String desc, Integer mnemonic) {
        super(text, icon);

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 70

// Ustaw własno

ść

obiektu akcji

putValue(SHORT_DESCRIPTION, desc);

// Tekst wskazówki oraz

putValue(MNEMONIC_KEY, mnemonic);

// ... klawisz skrótu

}

// Obsługa zdarzenia akcji

    public void actionPerformed(ActionEvent e) {
        displayResult("Akcja dla przycisku 1 / opcji menu", e);
    }
}

Program

ActionDemo

zawiera definicje

trzech akcji

– ka

da z nich

dołaczona jest do

przycisku

opcji menu.

Skróty klawiszy aktywuj

: Alt-L

(lewy przycisk), Alt-M (

rodkowy przycisk), Alt-R (prawy przycisk).

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 71

Stany 3 obiektów akcji (dozwolona/niedozwolona) mo

na ustawia

pod-menu „Action State”. Kod realizuj

cy ustawienie stanu akcji:

boolean selected =

... // true jesli akcja jest dozwolona

;

//false, jesli akcja jest zabroniona

leftAction.setEnabled(selected);

Po utworzeniu komponentów wykorzystuj

cych obiekty akcji mo

zmieni

indywidualne komponenty. Np. przez usuni

cie ikony (w menu)

lub usuni

cie tekstu (w przyciskach):

menuItem = new JMenuItem();
menuItem.setAction(leftAction);
menuItem.setIcon(null);

Usuwa ikon

z menu.

...
button = new JButton();
button.setAction(leftAction);
button.setText("");

Na razie przycisk nie zawiera tekstu

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 72

2) Klasa

AbstractAction

AbstractAction()
AbstractAction(String)
AbstractAction(String, Icon)

Konstruktory. Parametry umo

liwiaj

ustawienie tekstu i ikonki dla

kontrolowanego przez akcj

komponentu.

void setEnabled(boolean)
boolean isEnabled()

Ustaw wzgl. sprawd

, czy zdarzenia komponentu kontrolowanego przez

akcj

dozwolone.

void putValue(String, Object)
Object getValue(String)

Ustaw własno

ść

lub pobierz obiekt zwi

zany z własno

obiektu akcji.

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 73

3) Własno

ci akcji

Obiekt klasy

AbstractAction

posiada szereg własno

ci, których

ustawianie powoduje automatycznie zmian

odpowiednich ustawie

komponentów, do których obiekt akcji jest doł

czony.

Np. ustawienie własno

ACCELERATOR_KEY

dla akcji po dołaczeniu

akcji do opcji menu spowoduje automatyczne wywołanie metody

JMenuItem.setAccelerator(KeyStroke)

, gdzie

KeyStroke

identfikuje typ dla

zestawu klawiszy – akceleratorów.

Własno

ść

Automatycznie wpływa na

obiekt klasy

(wywoływana metoda)

Cel

ACCELERATOR_KEY

JMenuItem
(setAccelerator)

Akcelerator umo

liwia

wybranie opcji niezale

nie

od jej widoczno

ci.

ACTION_COMMAND_KEY

AbstractButton, JCheckBox,
JRadioButton
(setActionCommand)

Napis rozkazu zwi

zany

ze zdarzeniem akcji.

13. Swing - obsługa zdarze

W. Kasprzak: Programowanie zdarzeniowe

13 - 74

LONG_DESCRIPTION

brak

Dłu

szy opis akcji.

MNEMONIC_KEY

AbstractButton,
JMenuItem, JCheckBox,
JRadioButton
(setMnemonic)

Skrót dla akcji

NAME

AbstractButton,
JMenuItem, JCheckBox,
JRadioButton
(setText)

Nazwa akcji.

SHORT_DESCRIPTION

AbstractButton, JCheckBox,
JRadioButton
(setToolTipText)

Wskazówka o akcji

SMALL_ICON

AbstractButton, JMenuItem
(setIcon)

Ikona akcji.