1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
|
<html>
<head>
<title>
Handbuch der Java-Programmierung, 5. Auflage
</title>
</head>
<body>
<a name="startofbody"></a>
<script language="JavaScript" src="hjp4lib.js">
</script>
<script language="JavaScript">
installKbdHandler("97,#startofbody;101,#endofbody;116,cover.html;122,k100003.html;115,search.html;105,index.html;100,JDKDOCS;112,APIDOCS;104,k100243.html;106,k100243.html;107,k100245.html;108,k100248.html");
</script>
<table border=0 cellpadding=0 cellspacing=1 width="100%">
<tr bgcolor="#EEFFCC">
<td width="7%" align=center bgcolor="#DDCC99"><a href="cover.html"> Titel </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100003.html"> Inhalt </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="search.html"> Suchen </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="index.html"> Index </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="../jdkdocs/index.html" onClick="this.href=getDocIndex()"> DOC </a>
<td align="right">Handbuch der Java-Programmierung, 5. Auflage
<tr bgcolor="#EEFFCC">
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100243.html"> << </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100243.html"> < </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100245.html"> > </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100248.html"> >> </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="../jdkdocs/api/index.html" onClick="this.href=getApiIndex()"> API </a>
<td align="right">Kapitel 38 - Swing: Komponenten II
</table>
<hr>
<!-- Section -->
<a name="sectlevel2id038001"></a>
<h2>38.1 Spezielle Panels </h2>
<hr>
<ul>
<li><a href="k100244.html#sectlevel2id038001">38.1 Spezielle Panels</a>
<ul>
<li><a href="k100244.html#jscrollpane">38.1.1 JScrollPane</a>
<li><a href="k100244.html#sectlevel3id038001002">38.1.2 JSplitPane</a>
<li><a href="k100244.html#sectlevel3id038001003">38.1.3 JTabbedPane</a>
</ul>
</ul>
<hr>
<!-- Section -->
<a name="jscrollpane"></a>
<h3>38.1.1 JScrollPane </h3>
<p>
Die Klasse <a name="ixa102712"><a href="index_j.html#ixb101779"><font color=#000080><tt>JScrollPane</tt></font></a></a>
wurde in den vorigen Abschnitten bereits mehrfach verwendet. In Verbindung
mit den Klassen <a href="index_j.html#ixb101918"><font color=#000080><tt>JTextArea</tt></font></a>
und <a href="index_j.html#ixb101777"><font color=#000080><tt>JList</tt></font></a>
bestand ihre Aufgabe darin, Dialogelemente, die zu groß für
den zur Verfügung stehenden Platz waren, mit Hilfe eines verschiebbaren
Fensters ausschnittsweise sichtbar zu machen. Dabei war es ausreichend,
das betreffende Dialogelement an den Konstruktor von <a href="index_j.html#ixb101779"><font color=#000080><tt>JScrollPane</tt></font></a>
zu übergeben und anstelle des Dialogelements selbst die <a href="index_j.html#ixb101779"><font color=#000080><tt>JScrollPane</tt></font></a>-Instanz
an den Container zu übergeben.
<p>
<a href="index_j.html#ixb101779"><font color=#000080><tt>JScrollPane</tt></font></a>
besitzt aber noch weitere Fähigkeiten, die hier kurz vorgestellt
werden sollen. Zunächst wollen wir uns ihre wichtigsten Konstruktoren
ansehen:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public JScrollPane(Component view)
public JScrollPane(Component view, int vsbPolicy, int hsbPolicy)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/javax/swing/JScrollPane.html" onClick="this.href=getApiDoc('javax.swing.JScrollPane')"><font color="#660066" size=-1>javax.swing.JScrollPane</font></a></td>
</tr>
</table>
<p>
Die Argumente <font color="#000077"><tt>vsbPolicy</tt></font> und
<font color="#000077"><tt>hsbPolicy</tt></font> geben an, wann ein
horizontaler bzw. vertikaler Schieberegler eingeblendet wird. Hier
können folgende Werte angegeben werden: <a name="tableid038001"></a>
<p>
<table cols=2 border width=66%>
<tr>
<td valign=top align=left width=33%><b>Konstante</b></td>
<td valign=top align=left width=66%><b>Bedeutung</b></td></tr>
<tr>
<td valign=top align=left><a name="ixa102713"><a href="index_v.html#ixb102001"><font color=#000080><tt>VERTICAL_SCROLLBAR_NEVER</tt></font></a></a></td>
<td valign=top align=left>Der vertikale Schieberegler wird nie angezeigt.</td></tr>
<tr>
<td valign=top align=left><a name="ixa102714"><a href="index_v.html#ixb102002"><font color=#000080><tt>VERTICAL_SCROLLBAR_ALWAYS</tt></font></a></a></td>
<td valign=top align=left>Der vertikale Schieberegler wird immer angezeigt.</td></tr>
<tr>
<td valign=top align=left><a name="ixa102715"><a href="index_v.html#ixb102003"><font color=#000080><tt>VERTICAL_SCROLLBAR_AS_NEEDED</tt></font></a></a></td>
<td valign=top align=left>Der vertikale Schieberegler wird nur angezeigt,
wenn er tatsächlich benötigt wird.</td></tr>
<tr>
<td valign=top align=left><a name="ixa102716"><a href="index_h.html#ixb102004"><font color=#000080><tt>HORIZONTAL_SCROLLBAR_NEVER</tt></font></a></a></td>
<td valign=top align=left>Der horizontale Schieberegler wird nie angezeigt.</td></tr>
<tr>
<td valign=top align=left><a name="ixa102717"><a href="index_h.html#ixb102005"><font color=#000080><tt>HORIZONTAL_SCROLLBAR_ALWAYS</tt></font></a></a></td>
<td valign=top align=left>Der horizontale Schieberegler wird immer
angezeigt.</td></tr>
<tr>
<td valign=top align=left><a name="ixa102718"><a href="index_h.html#ixb102006"><font color=#000080><tt>HORIZONTAL_SCROLLBAR_AS_NEEDED</tt></font></a></a></td>
<td valign=top align=left>Der horizontale Schieberegler wird nur angezeigt,
wenn er tatsächlich benötigt wird.</td></tr>
</table>
<p><i>
Tabelle 38.1: Anzeige der Schieberegler bei JScrollPane</i></p>
<p>
Wenn die Argumente <font color="#000077"><tt>vsbPolicy</tt></font>
und <font color="#000077"><tt>hsbPolicy</tt></font> nicht angegeben
werden, blendet <a href="index_j.html#ixb101779"><font color=#000080><tt>JScrollPane</tt></font></a>
die Schieberegler nur dann ein, wenn sie wirklich benötigt werden
(wenn also das Dialogelement in der jeweiligen Ausdehnung größer
als der verfügbare Platz ist).
<p>
Die beiden wichtigsten zusätzlichen Fähigkeiten von <a href="index_j.html#ixb101779"><font color=#000080><tt>JScrollPane</tt></font></a>
bestehen darin, Spalten- und Zeilenheader anzeigen und die Eckelemente
mit beliebigen Komponenten belegen zu können (siehe <a href="k100244.html#anatomiejscrollpane">Abbildung 38.1</a>):
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public void setColumnHeaderView(Component view)
public void setRowHeaderView(Component view)
public void setCorner(String key, Component corner)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/javax/swing/JScrollPane.html" onClick="this.href=getApiDoc('javax.swing.JScrollPane')"><font color="#660066" size=-1>javax.swing.JScrollPane</font></a></td>
</tr>
</table>
<p>
Mit <a name="ixa102719"><a href="index_s.html#ixb102007"><font color=#000080><tt>setColumnHeaderView</tt></font></a></a>
kann eine Komponente für den Spaltenkopf angegeben werden. Sie
wird über dem eigentlichen Dialogelement angezeigt und bei horizontalen
Bewegungen zusammen mit diesem verschoben. Bei vertikalen Schieberbewegungen
bleibt sie dagegen an ihrem Platz. Analog dazu kann mit <a name="ixa102720"><a href="index_s.html#ixb102008"><font color=#000080><tt>setRowHeaderView</tt></font></a></a>
ein Zeilenkopf angegeben werden, der links neben der eigentlichen
Komponente platziert wird. Er wird bei vertikalen Bewegungen verschoben
und behält bei horizontalen Bewegungen seinen Platz bei.
<p>
Mit <a name="ixa102721"><a href="index_s.html#ixb102009"><font color=#000080><tt>setCorner</tt></font></a></a>
kann in einer beliebigen der vier ungenutzten Ecken einer <a href="index_j.html#ixb101779"><font color=#000080><tt>JScrollPane</tt></font></a>
ein Dialogelement platziert werden. Der Parameter <font color="#000077"><tt>key</tt></font>
gibt dabei an, welche Ecke belegt werden soll. Als Argument kann eine
der Konstanten <a name="ixa102722"><a href="index_l.html#ixb102010"><font color=#000080><tt>LOWER_LEFT_CORNER</tt></font></a></a>,
<a name="ixa102723"><a href="index_l.html#ixb102011"><font color=#000080><tt>LOWER_RIGHT_CORNER </tt></font></a></a>,
<a name="ixa102724"><a href="index_u.html#ixb102012"><font color=#000080><tt>UPPER_LEFT_CORNER</tt></font></a></a>
oder <a name="ixa102725"><a href="index_u.html#ixb102013"><font color=#000080><tt>UPPER_RIGHT_CORNER</tt></font></a></a>
der Klasse <a href="index_j.html#ixb101779"><font color=#000080><tt>JScrollPane</tt></font></a>
angegeben werden.
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100%>
<tr>
<td width=1 align=left valign=top bgcolor="#000077"><img src="trp1_1.gif"></td>
<td><img src="trp1_1.gif" width=2></td>
<td valign=top width=1000>
<p>
Zu beachten ist allerdings, dass die Eckflächen unter Umständen
gar nicht zur Verfügung stehen. Die beiden Ecken auf der linken
Seite sind beispielsweise nur dann vorhanden, wenn ein Zeilenkopf
eingeblendet wurde. Die rechte obere ist nur vorhanden, wenn ein vertikaler
Schieberegler eingeblendet wurde, und die rechte untere erfordert
sogar die Anwesenheit beider Schieberegler. Auch kann die Anwendung
praktisch keinen Einfluss auf die Größe der Ecken nehmen.
Diese wird ausschließlich durch die Ausdehnung der Schieberegler
und des Zeilenkopfes bestimmt. Summa sumarum ist die Möglichkeit,
die Ecken belegen zu können, eine nur in Ausnahmefällen
nützliche Eigenschaft.</td>
<td><img src="trp1_1.gif" width=2></td>
<td valign=top>
<table border=0 cellspacing=0 cellpadding=1 width=100% bgcolor="#000077">
<tr>
<td><font color="#FFFFFF"> Hinweis </font></td>
</tr>
</table>
</td>
<td width=1 align=left valign=top bgcolor="#000077"><img src="trp1_1.gif"></td>
</tr>
</table>
<p>
<a name="anatomiejscrollpane"></a>
<img src="images/ScrollPaneAnato.gif">
<p>
<p><i>
Abbildung 38.1: Die Anatomie einer JScrollPane</i></p>
<p>
Das folgende Beispiel zeigt ein Programm, in dem eine <a href="index_j.html#ixb101779"><font color=#000080><tt>JScrollPane</tt></font></a>
ein zu großes <a href="index_j.html#ixb101767"><font color=#000080><tt>JPanel</tt></font></a>
mit hundert Checkboxen aufnimmt. In den beiden rechten Ecken wird
jeweils ein <a href="index_j.html#ixb101769"><font color=#000080><tt>JLabel</tt></font></a>
platziert, und als Spaltenkopf wird eine Instanz der Klasse <font color="#000077"><tt>ColumnHeader</tt></font>
verwendet:
<a name="listingid038001"></a>
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#DDDDDD">
<tr>
<td valign=top>
<font color="#000055">
<pre>
<font color="#555555">001 </font><font color="#00AA00">/* Listing3801.java */</font>
<font color="#555555">002 </font>
<font color="#555555">003 </font><font color="#0000AA">import</font> java.awt.*;
<font color="#555555">004 </font><font color="#0000AA">import</font> java.awt.event.*;
<font color="#555555">005 </font><font color="#0000AA">import</font> javax.swing.*;
<font color="#555555">006 </font>
<font color="#555555">007 </font><font color="#0000AA">public</font> <font color="#0000AA">class</font> Listing3801
<font color="#555555">008 </font><font color="#0000AA">extends</font> JFrame
<font color="#555555">009 </font>{
<font color="#555555">010 </font> <font color="#0000AA">public</font> Listing3801()
<font color="#555555">011 </font> {
<font color="#555555">012 </font> <font color="#006699">super</font>(<font color="#0000FF">"JScrollPane"</font>);
<font color="#555555">013 </font> addWindowListener(<font color="#0000AA">new</font> WindowClosingAdapter(<font color="#006699">true</font>));
<font color="#555555">014 </font> <font color="#00AA00">//Dialogpanel erzeugen</font>
<font color="#555555">015 </font> JPanel panel = <font color="#0000AA">new</font> JPanel();
<font color="#555555">016 </font> panel.setLayout(<font color="#0000AA">new</font> GridLayout(10, 10));
<font color="#555555">017 </font> <font color="#0000AA">for</font> (<font color="#006699">int</font> i = 1; i <= 100; ++i) {
<font color="#555555">018 </font> panel.add(<font color="#0000AA">new</font> JCheckBox(<font color="#0000FF">"Frage "</font> + i));
<font color="#555555">019 </font> }
<font color="#555555">020 </font> <font color="#00AA00">//JScrollPane erzeugen</font>
<font color="#555555">021 </font> JScrollPane scroll = <font color="#0000AA">new</font> JScrollPane(panel);
<font color="#555555">022 </font> scroll.setCorner(
<font color="#555555">023 </font> JScrollPane.UPPER_RIGHT_CORNER,
<font color="#555555">024 </font> <font color="#0000AA">new</font> JLabel(<font color="#0000FF">"1"</font>, JLabel.CENTER)
<font color="#555555">025 </font> );
<font color="#555555">026 </font> scroll.setCorner(
<font color="#555555">027 </font> JScrollPane.LOWER_RIGHT_CORNER,
<font color="#555555">028 </font> <font color="#0000AA">new</font> JLabel(<font color="#0000FF">"2"</font>, JLabel.CENTER)
<font color="#555555">029 </font> );
<font color="#555555">030 </font> scroll.setColumnHeaderView(<font color="#0000AA">new</font> ColumnHeader(panel, 10));
<font color="#555555">031 </font> <font color="#00AA00">//JScrollPane zur ContentPane hinzufügen</font>
<font color="#555555">032 </font> getContentPane().add(scroll, BorderLayout.CENTER);
<font color="#555555">033 </font> }
<font color="#555555">034 </font>
<font color="#555555">035 </font> <font color="#0000AA">public</font> <font color="#0000AA">static</font> <font color="#006699">void</font> main(String[] args)
<font color="#555555">036 </font> {
<font color="#555555">037 </font> Listing3801 frame = <font color="#0000AA">new</font> Listing3801();
<font color="#555555">038 </font> frame.setLocation(100, 100);
<font color="#555555">039 </font> frame.setSize(300, 150);
<font color="#555555">040 </font> frame.setVisible(<font color="#006699">true</font>);
<font color="#555555">041 </font> }
<font color="#555555">042 </font>}
<font color="#555555">043 </font>
<font color="#555555">044 </font><font color="#0000AA">class</font> ColumnHeader
<font color="#555555">045 </font><font color="#0000AA">extends</font> JComponent
<font color="#555555">046 </font>{
<font color="#555555">047 </font> JComponent component;
<font color="#555555">048 </font> <font color="#006699">int</font> columns;
<font color="#555555">049 </font>
<font color="#555555">050 </font> <font color="#0000AA">public</font> ColumnHeader(JComponent component, <font color="#006699">int</font> columns)
<font color="#555555">051 </font> {
<font color="#555555">052 </font> <font color="#006699">this</font>.component = component;
<font color="#555555">053 </font> <font color="#006699">this</font>.columns = columns;
<font color="#555555">054 </font> }
<font color="#555555">055 </font>
<font color="#555555">056 </font> <font color="#0000AA">public</font> <font color="#006699">void</font> paintComponent(Graphics g)
<font color="#555555">057 </font> {
<font color="#555555">058 </font> <font color="#006699">int</font> width = component.getSize().width;
<font color="#555555">059 </font> <font color="#006699">int</font> height = getSize().height;
<font color="#555555">060 </font> <font color="#006699">int</font> colwid = width / columns;
<font color="#555555">061 </font> <font color="#0000AA">for</font> (<font color="#006699">int</font> i = 0; i < columns; ++i) {
<font color="#555555">062 </font> g.setColor(i % 2 == 0 ? Color.yellow : Color.gray);
<font color="#555555">063 </font> g.fillRect(i * colwid, 0, colwid, height);
<font color="#555555">064 </font> }
<font color="#555555">065 </font> g.setColor(Color.black);
<font color="#555555">066 </font> g.drawLine(0, height - 1, width, height - 1);
<font color="#555555">067 </font> }
<font color="#555555">068 </font>
<font color="#555555">069 </font> <font color="#0000AA">public</font> Dimension getPreferredSize()
<font color="#555555">070 </font> {
<font color="#555555">071 </font> <font color="#0000AA">return</font> <font color="#0000AA">new</font> Dimension(component.getSize().width, 20);
<font color="#555555">072 </font> }
<font color="#555555">073 </font>}</pre>
</font>
</td>
<td valign=top align=right>
<a href="../examples/Listing3801.java"><font color="#000055" size=-1>Listing3801.java</font></a></td>
</tr>
</table>
<i>
Listing 38.1: Die Klasse JScrollPane</i></p>
<p>
Die Klasse <font color="#000077"><tt>ColumnHeader</tt></font> ist
aus <a href="index_j.html#ixb101768"><font color=#000080><tt>JComponent</tt></font></a>
abgeleitet und wird als Spaltenkopf für die <a href="index_j.html#ixb101767"><font color=#000080><tt>JPanel</tt></font></a>-Komponente
verwendet. Deren Spalten sind in diesem Sonderfall alle gleich breit.
Das Panel selbst und die Spaltenzahl werden an den Konstruktor übergeben,
und mit Hilfe dieser Angaben werden die nebeneinanderliegenden Spalten
als abwechselnd grau und gelb gefärbte Rechtecke angezeigt. Zusätzlich
wird eine schwarze Linie als untere Begrenzung des Spaltenkopfes gezeichnet.
Durch Überlagern von <a href="index_g.html#ixb101706"><font color=#000080><tt>getPreferredSize</tt></font></a>
teilt <font color="#000077"><tt>ColumnHeader</tt></font> der <a href="index_j.html#ixb101779"><font color=#000080><tt>JScrollPane</tt></font></a>
seine Größe mit. Die Breite entspricht dabei der Breite
der scrollbaren Komponente, die Höhe ist fest auf zwanzig Pixel
eingestellt.
<p>
Die Ausgabe des Programms ist:
<p>
<a name="imageid038002"></a>
<img src="images/JScrollPane1.gif">
<p>
<p><i>
Abbildung 38.2: Die Klasse JScrollPane</i></p>
<!-- Section -->
<a name="sectlevel3id038001002"></a>
<h3>38.1.2 JSplitPane </h3>
<p>
<a name="ixa102726"><a href="index_j.html#ixb102014"><font color=#000080><tt>JSplitPane</tt></font></a></a>
ist ein Panel, mit dem zwei Komponenten neben- oder übereinander
platziert werden können. Die Komponenten werden dabei durch einen
sichtbaren Separator voneinander getrennt. Der Anwender kann den Separator
verschieben und so den Platz, der beiden Komponenten zur Verfügung
steht, variieren. Ein <a href="index_j.html#ixb102014"><font color=#000080><tt>JSplitPane</tt></font></a>
ist beispielsweise nützlich, wenn Komponenten dargestellt werden
sollen, deren Breite oder Höhe von den darin enthaltenen Daten
abhängig ist. Das Programm braucht dann den benötigten Platz
nur grob vorzugeben, und der Anwender kann durch Verschieben des Separators
zur Laufzeit festlegen, wieviel Platz er jeder Komponente zur Verfügung
stellen will.
<p>
Die Konstruktoren von <a href="index_j.html#ixb102014"><font color=#000080><tt>JSplitPane</tt></font></a>
sind:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public JSplitPane(int orientation)
public JSplitPane(
int orientation,
boolean continuousLayout
)
public JSplitPane(
int orientation,
Component leftComponent,
Component rightComponent
)
public JSplitPane(
int orientation,
boolean continuousLayout,
Component leftComponent,
Component rightComponent
)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/javax/swing/JSplitPane.html" onClick="this.href=getApiDoc('javax.swing.JSplitPane')"><font color="#660066" size=-1>javax.swing.JSplitPane</font></a></td>
</tr>
</table>
<p>
Der Parameter <font color="#000077"><tt>orientation</tt></font> gibt
an, wie die Elemente zueinander angeordnet werden sollen. Hat er den
Wert <a name="ixa102727"><a href="index_h.html#ixb102015"><font color=#000080><tt>HORIZONTAL_SPLIT</tt></font></a></a>,
werden sie nebeneinander, bei <a name="ixa102728"><a href="index_v.html#ixb102016"><font color=#000080><tt>VERTICAL_SPLIT</tt></font></a></a>
übereinander angeordnet. Hat <font color="#000077"><tt>continuousLayout</tt></font>
den Wert <a href="index_t.html#ixb100233"><font color=#000080><tt>true</tt></font></a>,
so wird schon beim Verschieben des Separators der Bildschirminhalt
aktualisiert. Andernfalls erfolgt das erst nach Ende des Verschiebevorgangs.
In den Parametern <font color="#000077"><tt>leftComponent</tt></font>
und <font color="#000077"><tt>rightComponent</tt></font> werden die
beiden einzubettenden Komponenten übergeben. Alle Eigenschaften
können auch nach der Instanzierung verändert bzw. abgefragt
werden:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public void setOrientation(int orientation)
public void setContinuousLayout(boolean continuousLayout)
public void setLeftComponent(Component comp)
public void setRightComponent(Component comp)
public void setTopComponent(Component comp)
public void setBottomComponent(Component comp)
public int getOrientation()
public boolean isContinuousLayout()
public Component getLeftComponent()
public Component getTopComponent()
public Component getRightComponent()
public Component getBottomComponent()
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/javax/swing/JSplitPane.html" onClick="this.href=getApiDoc('javax.swing.JSplitPane')"><font color="#660066" size=-1>javax.swing.JSplitPane</font></a></td>
</tr>
</table>
<p>
Die Größe der beiden Komponenten richtet sich nach ihren
minimalen und gewünschten Abmessungen. <a href="index_j.html#ixb102014"><font color=#000080><tt>JSplitPane</tt></font></a>
ermittelt diese Werte durch Aufruf von <a href="index_g.html#ixb101706"><font color=#000080><tt>getPreferredSize</tt></font></a>
und <a href="index_g.html#ixb101715"><font color=#000080><tt>getMinimumSize</tt></font></a>
auf den Komponentenobjekten. Es gilt:
<ul>
<li>Bei der initialen Darstellung der Komponenten wird zunächst
geprüft, ob beide in ihrer <i>gewünschten</i> Größe
angezeigt werden können (es wird also <a href="index_g.html#ixb101706"><font color=#000080><tt>getPreferredSize</tt></font></a>
aufgerufen). Ist das der Fall, wird die linke (obere) Komponente in
der gewünschten Größe angezeigt, und die rechte (untere)
erhält den verbleibenden Platz.
<li>Ist das nicht der Fall, wird die linke (untere) Komponente in
ihrer minimalen Größe angezeigt, und die rechte erhält
den verbleibenden Platz.
<li>Reicht der Platz nicht einmal aus, um beide Komponenten in ihrer
minimalen Ausdehnung anzuzeigen, ist das Verhalten undefiniert. Typischerweise
steht der Separator danach komplett auf einer Seite, und es ist nur
noch eine der beiden Komponenten sichtbar.
<li>Sind die Komponenten auf dem Bildschirm sichtbar, kann der Separator
soweit in jede Richtung verschoben werden, bis die minimale Größe
der jeweiligen Komponente erreicht ist.
</ul>
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100%>
<tr>
<td width=1 align=left valign=top bgcolor="#0099CC"><img src="trp1_1.gif"></td>
<td><img src="trp1_1.gif" width=1></td>
<td width=1 align=left valign=top bgcolor="#0099CC"><img src="trp1_1.gif"></td>
<td><img src="trp1_1.gif" width=2></td>
<td valign=top width=1000>
<p>
Manche Komponenten liefern beim Aufruf von <a href="index_g.html#ixb101715"><font color=#000080><tt>getMinimumSize</tt></font></a>
die Größe, die sie beim ersten Sichtbarwerden auf dem Bildschirm
hatten. In diesem Fall ist der Separator überhaupt nicht veränderbar,
denn jede Verschiebung würde die minimale Größe einer
der beiden Komponenten unterschreiten. Falls ein solches Problem auftritt,
kann Abhilfe geschaffen werden, indem durch Aufruf von <a name="ixa102729"><a href="index_s.html#ixb101889"><font color=#000080><tt>setMinimumSize</tt></font></a></a>
die minimale Größe der Komponenten vermindert wird.</td>
<td><img src="trp1_1.gif" width=2></td>
<td valign=top>
<table border=0 cellspacing=0 cellpadding=1 width=100% bgcolor="#0099CC">
<tr>
<td><font color="#FFFFFF"> Tipp </font></td>
</tr>
</table>
</td>
<td width=1 align=left valign=top bgcolor="#0099CC"><img src="trp1_1.gif"></td>
</tr>
</table>
<p>
Eine interessante Methode zur Modifikation des Separators ist <a name="ixa102730"><a href="index_s.html#ixb102017"><font color=#000080><tt>setOneTouchExpandable</tt></font></a></a>:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public void setOneTouchExpandable(boolean newValue)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/javax/swing/JSplitPane.html" onClick="this.href=getApiDoc('javax.swing.JSplitPane')"><font color="#660066" size=-1>javax.swing.JSplitPane</font></a></td>
</tr>
</table>
<p>
Wird sie mit <a href="index_t.html#ixb100233"><font color=#000080><tt>true</tt></font></a>
als Argument aufgerufen, erhält der Separator zwei kleine Pfeile,
die jeweils auf eine der beiden Komponenten zeigen. Wird einer von
ihnen angeklickt, so wird der Separator komplett auf die angezeigte
Seite verschoben. Die auf dieser Seite liegende Komponente wird verdeckt
und die andere erhält den vollen zur Verfügung stehenden
Platz (die von <a href="index_g.html#ixb101715"><font color=#000080><tt>getMinimumSize</tt></font></a>
definierten Grenzen werden dabei ignoriert). Ein weiterer Klick auf
den Separator gibt der verdeckten Komponente wieder ihre Minimalgröße.
<p>
Das folgende Programm zeigt einen <a href="index_j.html#ixb100511"><font color=#000080><tt>JFrame</tt></font></a>
mit einem horizontal geteilten <a href="index_j.html#ixb102014"><font color=#000080><tt>JSplitPane</tt></font></a>.
Als Komponenten werden zwei Instanzen der weiter unten definierten
Klasse <font color="#000077"><tt>GridComponent</tt></font> verwendet,
die ein Gitternetz anzeigt, dessen Maschengröße proportional
zur Ausdehnung der Komponente ist:
<a name="listingid038002"></a>
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#DDDDDD">
<tr>
<td valign=top>
<font color="#000055">
<pre>
<font color="#555555">001 </font><font color="#00AA00">/* Listing3802.java */</font>
<font color="#555555">002 </font>
<font color="#555555">003 </font><font color="#0000AA">import</font> java.awt.*;
<font color="#555555">004 </font><font color="#0000AA">import</font> java.awt.event.*;
<font color="#555555">005 </font><font color="#0000AA">import</font> javax.swing.*;
<font color="#555555">006 </font>
<font color="#555555">007 </font><font color="#0000AA">public</font> <font color="#0000AA">class</font> Listing3802
<font color="#555555">008 </font><font color="#0000AA">extends</font> JFrame
<font color="#555555">009 </font>{
<font color="#555555">010 </font> <font color="#0000AA">public</font> Listing3802()
<font color="#555555">011 </font> {
<font color="#555555">012 </font> <font color="#006699">super</font>(<font color="#0000FF">"JSplitPane"</font>);
<font color="#555555">013 </font> addWindowListener(<font color="#0000AA">new</font> WindowClosingAdapter(<font color="#006699">true</font>));
<font color="#555555">014 </font> <font color="#00AA00">//Linkes Element erzeugen</font>
<font color="#555555">015 </font> GridComponent grid1 = <font color="#0000AA">new</font> GridComponent();
<font color="#555555">016 </font> grid1.setMinimumSize(<font color="#0000AA">new</font> Dimension(50, 100));
<font color="#555555">017 </font> grid1.setPreferredSize(<font color="#0000AA">new</font> Dimension(180, 100));
<font color="#555555">018 </font> <font color="#00AA00">//Rechtes Element erzeugen</font>
<font color="#555555">019 </font> GridComponent grid2 = <font color="#0000AA">new</font> GridComponent();
<font color="#555555">020 </font> grid2.setMinimumSize(<font color="#0000AA">new</font> Dimension(100, 100));
<font color="#555555">021 </font> grid2.setPreferredSize(<font color="#0000AA">new</font> Dimension(80, 100));
<font color="#555555">022 </font> <font color="#00AA00">//JSplitPane erzeugen</font>
<font color="#555555">023 </font> JSplitPane sp = <font color="#0000AA">new</font> JSplitPane(JSplitPane.HORIZONTAL_SPLIT);
<font color="#555555">024 </font> sp.setLeftComponent(grid1);
<font color="#555555">025 </font> sp.setRightComponent(grid2);
<font color="#555555">026 </font> sp.setOneTouchExpandable(<font color="#006699">true</font>);
<font color="#555555">027 </font> sp.setContinuousLayout(<font color="#006699">true</font>);
<font color="#555555">028 </font> getContentPane().add(sp, BorderLayout.CENTER);
<font color="#555555">029 </font> }
<font color="#555555">030 </font>
<font color="#555555">031 </font> <font color="#0000AA">public</font> <font color="#0000AA">static</font> <font color="#006699">void</font> main(String[] args)
<font color="#555555">032 </font> {
<font color="#555555">033 </font> Listing3802 frame = <font color="#0000AA">new</font> Listing3802();
<font color="#555555">034 </font> frame.setLocation(100, 100);
<font color="#555555">035 </font> frame.setSize(300, 200);
<font color="#555555">036 </font> frame.setVisible(<font color="#006699">true</font>);
<font color="#555555">037 </font> }
<font color="#555555">038 </font>}
<font color="#555555">039 </font>
<font color="#555555">040 </font><font color="#0000AA">class</font> GridComponent
<font color="#555555">041 </font><font color="#0000AA">extends</font> JComponent
<font color="#555555">042 </font>{
<font color="#555555">043 </font> <font color="#0000AA">public</font> <font color="#006699">void</font> paintComponent(Graphics g)
<font color="#555555">044 </font> {
<font color="#555555">045 </font> g.setColor(Color.gray);
<font color="#555555">046 </font> <font color="#006699">int</font> width = getSize().width;
<font color="#555555">047 </font> <font color="#006699">int</font> height = getSize().height;
<font color="#555555">048 </font> <font color="#0000AA">for</font> (<font color="#006699">int</font> i = 0; i < 10; ++i) {
<font color="#555555">049 </font> g.drawLine(i * width / 10, 0, i * width / 10, height);
<font color="#555555">050 </font> }
<font color="#555555">051 </font> <font color="#0000AA">for</font> (<font color="#006699">int</font> i = 0; i < 10; ++i) {
<font color="#555555">052 </font> g.drawLine(0, i * height / 10, width, i * height / 10);
<font color="#555555">053 </font> }
<font color="#555555">054 </font> g.setColor(Color.black);
<font color="#555555">055 </font> g.drawString(<font color="#0000FF">""</font> + width, 5, 15);
<font color="#555555">056 </font> }
<font color="#555555">057 </font>}</pre>
</font>
</td>
<td valign=top align=right>
<a href="../examples/Listing3802.java"><font color="#000055" size=-1>Listing3802.java</font></a></td>
</tr>
</table>
<i>
Listing 38.2: Die Klasse JSplitPane</i></p>
<p>
Die Ausgabe des Programms ist:
<p>
<a name="imageid038003"></a>
<img src="images/JSplitPane1.gif">
<p>
<p><i>
Abbildung 38.3: Die Klasse JSplitPane</i></p>
<!-- Section -->
<a name="sectlevel3id038001003"></a>
<h3>38.1.3 JTabbedPane </h3>
<p>
Als letztes der speziellen Panels wollen wir uns die Klasse <a name="ixa102731"><a href="index_j.html#ixb102018"><font color=#000080><tt>JTabbedPane</tt></font></a></a>
ansehen. Mit ihr ist es möglich, Dialoge zu erstellen, die eine
Reihe von Registerkarten enthalten. Das sind Unterdialoge, die über
ein am Rand befindliches Register einzeln ausgewählt werden können.
Derartige Registerkarten werden beispielsweise in Konfigurationsdialogen
verwendet, wenn die zu bearbeitenden Optionen nicht alle auf eine
Seite passen.
<p>
<a href="index_j.html#ixb102018"><font color=#000080><tt>JTabbedPane</tt></font></a>
stellt zwei Konstruktoren zur Verfügung:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public JTabbedPane()
public JTabbedPane(int tabPlacement)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/javax/swing/JTabbedPane.html" onClick="this.href=getApiDoc('javax.swing.JTabbedPane')"><font color="#660066" size=-1>javax.swing.JTabbedPane</font></a></td>
</tr>
</table>
<p>
Der erste von beiden erzeugt ein <a href="index_j.html#ixb102018"><font color=#000080><tt>JTabbedPane</tt></font></a>
mit oben liegenden Registern. Beim zweiten kann explizit angegeben
werden, auf welcher Seite die Register angeordnet werden sollen. Hier
können die Konstanten <a href="index_t.html#ixb101853"><font color=#000080><tt>TOP</tt></font></a>,
<a href="index_b.html#ixb101848"><font color=#000080><tt>BOTTOM</tt></font></a>,
<a href="index_l.html#ixb101614"><font color=#000080><tt>LEFT</tt></font></a>
oder <a href="index_r.html#ixb101615"><font color=#000080><tt>RIGHT</tt></font></a>
aus dem Interface <a href="index_s.html#ixb101847"><font color=#000080><tt>SwingConstants</tt></font></a>
übergeben werden. Üblich ist es, die Register links oder
oben anzuordnen. Mit den Methoden <a name="ixa102732"><a href="index_g.html#ixb102019"><font color=#000080><tt>getTabPlacement</tt></font></a></a>
und <a name="ixa102733"><a href="index_s.html#ixb102020"><font color=#000080><tt>setTabPlacement</tt></font></a></a>
kann auch nachträglich auf die Anordnung zugegriffen werden.
<p>
Nach der Instanzierung ist der Registerdialog zunächst leer.
Um Registerkarten hinzuzufügen, kann eine der Methoden <a name="ixa102734"><a href="index_a.html#ixb102021"><font color=#000080><tt>addTab</tt></font></a></a>
oder <a name="ixa102735"><a href="index_i.html#ixb102022"><font color=#000080><tt>insertTab</tt></font></a></a>
aufgerufen werden:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public void addTab(
String title,
Icon icon,
Component component,
String tip
)
public void insertTab(
String title,
Icon icon,
Component component,
String tip,
int index
)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/javax/swing/JTabbedPane.html" onClick="this.href=getApiDoc('javax.swing.JTabbedPane')"><font color="#660066" size=-1>javax.swing.JTabbedPane</font></a></td>
</tr>
</table>
<p>
Der Parameter <font color="#000077"><tt>title</tt></font> gibt die
Beschriftung des Registereintrags an. Mit <font color="#000077"><tt>icon</tt></font>
kann zusätzlich ein Icon und mit <font color="#000077"><tt>tip</tt></font>
ein Tooltiptext hinzugefügt werden. Der Parameter <font color="#000077"><tt>component</tt></font>
gibt das darzustellende Dialogelement an. Meist wird hier eine Containerklasse
übergeben (z.B. ein <a href="index_j.html#ixb101767"><font color=#000080><tt>JPanel</tt></font></a>),
die den entsprechenden Unterdialog enthält. Die Parameter <font color="#000077"><tt>icon</tt></font>
und <font color="#000077"><tt>tip</tt></font> sind optional, d.h.
es gibt die beiden Methoden auch ohne sie. <a href="index_a.html#ixb102021"><font color=#000080><tt>addTab</tt></font></a>
fügt die Registerkarte am Ende ein, bei <a href="index_i.html#ixb102022"><font color=#000080><tt>insertTab</tt></font></a>
kann die Einfügeposition mit dem Parameter <font color="#000077"><tt>index</tt></font>
selbst angegeben werden.
<p>
Bereits definierte Registerkarten können auch wieder entfernt
werden:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public void removeTabAt(int index)
public void removeAll()
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/javax/swing/JTabbedPane.html" onClick="this.href=getApiDoc('javax.swing.JTabbedPane')"><font color="#660066" size=-1>javax.swing.JTabbedPane</font></a></td>
</tr>
</table>
<p>
<a name="ixa102736"><a href="index_r.html#ixb102023"><font color=#000080><tt>removeTabAt</tt></font></a></a>
entfernt die Karte mit dem angegebenen Index, <a name="ixa102737"><a href="index_r.html#ixb100731"><font color=#000080><tt>removeAll</tt></font></a></a>
entfernt alle Karten.
<p>
Mit <a name="ixa102738"><a href="index_g.html#ixb102024"><font color=#000080><tt>getTabCount</tt></font></a></a>
kann die Anzahl der Registerkarten ermittelt werden, und mit <a name="ixa102739"><a href="index_g.html#ixb102025"><font color=#000080><tt>getComponentAt</tt></font></a></a>
kann die Komponente einer beliebigen Registerkarte ermittelt werden.
Mit <a name="ixa102740"><a href="index_s.html#ixb102026"><font color=#000080><tt>setComponentAt</tt></font></a></a>
kann der Inhalt einer Registerkarte sogar nachträglich ausgetauscht
werden:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public int getTabCount()
public Component getComponentAt(int index)
public void setComponentAt(int index, Component component)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/javax/swing/JTabbedPane.html" onClick="this.href=getApiDoc('javax.swing.JTabbedPane')"><font color="#660066" size=-1>javax.swing.JTabbedPane</font></a></td>
</tr>
</table>
<p>
In einem Registerdialog ist immer genau eine der Karten selektiert.
Mit <a name="ixa102741"><a href="index_g.html#ixb101675"><font color=#000080><tt>getSelectedIndex</tt></font></a></a>
kann deren Index ermittelt werden, mit <a name="ixa102742"><a href="index_g.html#ixb102027"><font color=#000080><tt>getSelectedComponent</tt></font></a></a>
sogar direkt auf ihren Inhalt zugegriffen werden. Die Methode <a name="ixa102743"><a href="index_s.html#ixb101960"><font color=#000080><tt>setSelectedIndex</tt></font></a></a>
erlaubt es, programmgesteuert eine beliebige Registerkarte auszuwählen:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public int getSelectedIndex()
public Component getSelectedComponent()
public void setSelectedIndex(int index)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/javax/swing/JTabbedPane.html" onClick="this.href=getApiDoc('javax.swing.JTabbedPane')"><font color="#660066" size=-1>javax.swing.JTabbedPane</font></a></td>
</tr>
</table>
<p>
Registerkarten besitzen eine Reihe von Eigenschaften, die einzeln
verändert werden können. Die wichtigste von ihnen ist die
Möglichkeit, sie zu aktivieren oder zu deaktivieren. Nur aktivierte
Karten können ausgewählt werden, deaktivierte dagegen nicht.
Der Zugriff auf den Aktivierungsstatus erfolgt mit den Methoden <a name="ixa102744"><a href="index_s.html#ixb102028"><font color=#000080><tt>setEnabledAt</tt></font></a></a>
und <a name="ixa102745"><a href="index_i.html#ixb102029"><font color=#000080><tt>isEnabledAt</tt></font></a></a>:
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#EEFFCC">
<tr>
<td valign=top width=100%>
<font color="#660066">
<pre>
public boolean isEnabledAt(int index)
public void setEnabledAt(int index, boolean enabled)
</pre>
</font>
</td>
<td valign=top>
<a href="../jdkdocs/api/javax/swing/JTabbedPane.html" onClick="this.href=getApiDoc('javax.swing.JTabbedPane')"><font color="#660066" size=-1>javax.swing.JTabbedPane</font></a></td>
</tr>
</table>
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100%>
<tr>
<td width=1 align=left valign=top bgcolor="#0099CC"><img src="trp1_1.gif"></td>
<td><img src="trp1_1.gif" width=1></td>
<td width=1 align=left valign=top bgcolor="#0099CC"><img src="trp1_1.gif"></td>
<td><img src="trp1_1.gif" width=2></td>
<td valign=top width=1000>
<p>
Bei jeder Änderung der Selektion versendet ein <a href="index_j.html#ixb102018"><font color=#000080><tt>JTabbedPane</tt></font></a>
ein <a name="ixa102746"><a href="index_c.html#ixb101992"><font color=#000080><tt>ChangeEvent</tt></font></a></a>
an registrierte <a name="ixa102747"><a href="index_c.html#ixb101993"><font color=#000080><tt>ChangeListener</tt></font></a></a>.
Auf diese Weise ist es möglich, Programmcode zu schreiben, der
beim Anwählen oder Verlassen einzelner Registerkarten ausgeführt
wird. Eine der Anwendungen hierfür besteht darin, die Dialoge
auf den Registerkarten erst dann zu erzeugen, wenn sie wirklich gebraucht
werden. Dazu wird an alle Registerkarten zunächst ein leeres
Panel übergeben und erst in der Methode <a href="index_s.html#ixb101996"><font color=#000080><tt>stateChanged</tt></font></a>
durch den eigentlichen Dialog ersetzt. Auf diese Weise spart das Programm
beim Initialisieren des Registerdialogs Rechenzeit und Speicher, was
sich vor allem bei komplexen Dialogen positiv bemerkbar machen könnte.</td>
<td><img src="trp1_1.gif" width=2></td>
<td valign=top>
<table border=0 cellspacing=0 cellpadding=1 width=100% bgcolor="#0099CC">
<tr>
<td><font color="#FFFFFF"> Tipp </font></td>
</tr>
</table>
</td>
<td width=1 align=left valign=top bgcolor="#0099CC"><img src="trp1_1.gif"></td>
</tr>
</table>
<p>
Das folgende Programm zeigt ein einfaches Beispiel eines Registerdialogs.
Es erstellt ein <a href="index_j.html#ixb102018"><font color=#000080><tt>JTabbedPane</tt></font></a>
mit fünf Registerkarten, die jeweils ein <a href="index_j.html#ixb101767"><font color=#000080><tt>JPanel</tt></font></a>
mit einem Label und einem Button enthalten. Das Label zeigt den Namen
der Karte an, der Button dient dazu, die jeweils nächste Karte
auszuwählen. Dessen Aktivität ist in der Klasse <font color="#000077"><tt>NextTabActionListener</tt></font>
gekapselt. Als Besonderheit wird nach jedem Seitenwechsel <a name="ixa102748"><a href="index_r.html#ixb102030"><font color=#000080><tt>requestDefaultFocus</tt></font></a></a>
auf der neuen Seite aufgerufen, um automatisch dem ersten Dialogelement
den Fokus zu geben.
<a name="listingid038003"></a>
<p>
<table border=0 cellspacing=0 cellpadding=0 width=100% bgcolor="#DDDDDD">
<tr>
<td valign=top>
<font color="#000055">
<pre>
<font color="#555555">001 </font><font color="#00AA00">/* Listing3803.java */</font>
<font color="#555555">002 </font>
<font color="#555555">003 </font><font color="#0000AA">import</font> java.awt.*;
<font color="#555555">004 </font><font color="#0000AA">import</font> java.awt.event.*;
<font color="#555555">005 </font><font color="#0000AA">import</font> javax.swing.*;
<font color="#555555">006 </font>
<font color="#555555">007 </font><font color="#0000AA">public</font> <font color="#0000AA">class</font> Listing3803
<font color="#555555">008 </font><font color="#0000AA">extends</font> JFrame
<font color="#555555">009 </font>{
<font color="#555555">010 </font> JTabbedPane tp;
<font color="#555555">011 </font>
<font color="#555555">012 </font> <font color="#0000AA">public</font> Listing3803()
<font color="#555555">013 </font> {
<font color="#555555">014 </font> <font color="#006699">super</font>(<font color="#0000FF">"JTabbedPane"</font>);
<font color="#555555">015 </font> addWindowListener(<font color="#0000AA">new</font> WindowClosingAdapter(<font color="#006699">true</font>));
<font color="#555555">016 </font> tp = <font color="#0000AA">new</font> JTabbedPane();
<font color="#555555">017 </font> <font color="#0000AA">for</font> (<font color="#006699">int</font> i = 0; i < 5; ++i) {
<font color="#555555">018 </font> JPanel panel = <font color="#0000AA">new</font> JPanel();
<font color="#555555">019 </font> panel.add(<font color="#0000AA">new</font> JLabel(<font color="#0000FF">"Karte "</font> + i));
<font color="#555555">020 </font> JButton next = <font color="#0000AA">new</font> JButton(<font color="#0000FF">"Weiter"</font>);
<font color="#555555">021 </font> next.addActionListener(<font color="#0000AA">new</font> NextTabActionListener());
<font color="#555555">022 </font> panel.add(next);
<font color="#555555">023 </font> tp.addTab(<font color="#0000FF">"Tab"</font> + i, panel);
<font color="#555555">024 </font> }
<font color="#555555">025 </font> getContentPane().add(tp, BorderLayout.CENTER);
<font color="#555555">026 </font> }
<font color="#555555">027 </font>
<font color="#555555">028 </font> <font color="#0000AA">class</font> NextTabActionListener
<font color="#555555">029 </font> <font color="#0000AA">implements</font> ActionListener
<font color="#555555">030 </font> {
<font color="#555555">031 </font> <font color="#0000AA">public</font> <font color="#006699">void</font> actionPerformed(ActionEvent event)
<font color="#555555">032 </font> {
<font color="#555555">033 </font> <font color="#006699">int</font> tab = tp.getSelectedIndex();
<font color="#555555">034 </font> tab = (tab >= tp.getTabCount() - 1 ? 0 : tab + 1);
<font color="#555555">035 </font> tp.setSelectedIndex(tab);
<font color="#555555">036 </font> ((JPanel)tp.getSelectedComponent()).requestDefaultFocus();
<font color="#555555">037 </font> }
<font color="#555555">038 </font> }
<font color="#555555">039 </font>
<font color="#555555">040 </font> <font color="#0000AA">public</font> <font color="#0000AA">static</font> <font color="#006699">void</font> main(String[] args)
<font color="#555555">041 </font> {
<font color="#555555">042 </font> Listing3803 frame = <font color="#0000AA">new</font> Listing3803();
<font color="#555555">043 </font> frame.setLocation(100, 100);
<font color="#555555">044 </font> frame.setSize(300, 200);
<font color="#555555">045 </font> frame.setVisible(<font color="#006699">true</font>);
<font color="#555555">046 </font> }
<font color="#555555">047 </font>}</pre>
</font>
</td>
<td valign=top align=right>
<a href="../examples/Listing3803.java"><font color="#000055" size=-1>Listing3803.java</font></a></td>
</tr>
</table>
<i>
Listing 38.3: Die Klasse JTabbedPane</i></p>
<p>
Die Ausgabe des Programms ist:
<p>
<a name="imageid038004"></a>
<img src="images/JTabbedPane1.gif">
<p>
<p><i>
Abbildung 38.4: Die Klasse JTabbedPane</i></p>
<hr>
<table border=0 cellpadding=0 cellspacing=1 width="100%">
<tr bgcolor="#EEFFCC">
<td width="7%" align=center bgcolor="#DDCC99"><a href="cover.html"> Titel </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100003.html"> Inhalt </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="search.html"> Suchen </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="index.html"> Index </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="../jdkdocs/index.html" onClick="this.href=getDocIndex()"> DOC </a>
<td align="right">Handbuch der Java-Programmierung, 5. Auflage, Addison
Wesley, Version 5.0.1
<tr bgcolor="#EEFFCC">
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100243.html"> << </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100243.html"> < </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100245.html"> > </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="k100248.html"> >> </a>
<td width="7%" align=center bgcolor="#DDCC99"><a href="../jdkdocs/api/index.html" onClick="this.href=getApiIndex()"> API </a>
<td align="right">© 1998, 2007 Guido Krüger & Thomas
Stark, <a href="http://www.javabuch.de">http://www.javabuch.de</a>
</table>
<a name="endofbody"></a>
</body>
</html>
|
