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
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
|
<?xml version="1.0" encoding="UTF-8"?>
<!--
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
Copyright 1997-2010 Oracle and/or its affiliates. All rights reserved.
Oracle and Java are registered trademarks of Oracle and/or its affiliates.
Other names may be trademarks of their respective owners.
The contents of this file are subject to the terms of either the GNU
General Public License Version 2 only ("GPL") or the Common
Development and Distribution License("CDDL") (collectively, the
"License"). You may not use this file except in compliance with the
License. You can obtain a copy of the License at
http://www.netbeans.org/cddl-gplv2.html
or nbbuild/licenses/CDDL-GPL-2-CP. See the License for the
specific language governing permissions and limitations under the
License. When distributing the software, include this License Header
Notice in each file and include the License file at
nbbuild/licenses/CDDL-GPL-2-CP. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the GPL Version 2 section of the License file that
accompanied this code. If applicable, add the following below the
License Header, with the fields enclosed by brackets [] replaced by
your own identifying information:
"Portions Copyrighted [year] [name of copyright owner]"
Contributor(s):
The Original Software is NetBeans. The Initial Developer of the Original
Software is Sun Microsystems, Inc. Portions Copyright 1997-2006 Sun
Microsystems, Inc. All Rights Reserved.
If you wish your version of this file to be governed by only the CDDL
or only the GPL Version 2, indicate your decision by adding
"[Contributor] elects to include this software in this distribution
under the [CDDL or GPL Version 2] license." If you do not indicate a
single choice of license, a recipient has the option to distribute
your version of this file under either the CDDL, the GPL Version 2 or
to extend the choice of license to its licensees as provided above.
However, if you add GPL Version 2 code and therefore, elected the GPL
Version 2 license, then the option applies only if the new code is
made subject to such option by the copyright holder.
-->
<!DOCTYPE apichanges PUBLIC "-//NetBeans//DTD API changes list 1.0//EN" "../nbbuild/javadoctools/apichanges.dtd">
<apichanges>
<apidefs>
<apidef name="explorer">Explorer API</apidef>
</apidefs>
<changes>
<change id="HideIcons">
<api name="explorer"/>
<summary>Hide node icons in OutlineView and TreeView.</summary>
<version major="6" minor="59"/>
<date day="20" month="10" year="2014"/>
<author login="mentlicher"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="yes"/>
<description>
It is possible not to show icons in OutlineView and in TreeView and it's descendants.
Methods OutlineView.setShowNodeIcons(boolean)/isShowNodeIcons()
and NodeRenderer.setShowIcons(boolean)/isShowIcons()
are added for this purpose.
</description>
<class package="org.openide.explorer.view" name="OutlineView"/>
<class package="org.openide.explorer.view" name="NodeRenderer"/>
<issue number="247556"/>
</change>
<change id="NoAutoComplete">
<api name="explorer"/>
<summary>Turn auto-complete in combo box editor off.</summary>
<version major="6" minor="55"/>
<date day="11" month="11" year="2013"/>
<author login="saubrecht"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="yes"/>
<description>
Now it's possible to turn off the default autocomplete for in-line
combo box editors by using "canAutoComplete" attribute to Boolean.FALSE on appropriate FeatureDescriptor.
</description>
<issue number="238038"/>
</change>
<change id="PropertySheetExtensions">
<api name="explorer"/>
<summary>PropertySheet extensions</summary>
<version major="6" minor="47"/>
<date day="6" month="9" year="2012"/>
<author login="saubrecht"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="yes"/>
<description>
PropertySheet class has new methods which allow subclasses to provide custom
popup menu, check expansion state, expand/collapse property categories,
retrieve the selected property.
</description>
<class package="org.openide.explorer.propertysheet" name="PropertySheet"/>
<issue number="217624"/>
</change>
<change id="OutlineView_setPropertyColumnAttribute">
<api name="explorer"/>
<summary>setPropertyColumnAttribute() method added to OutlineView</summary>
<version major="6" minor="44"/>
<date day="4" month="4" year="2012"/>
<author login="mentlicher"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="yes"/>
<description>
In order to conveniently set attributes to column properties,
setPropertyColumnAttribute() method is added to OutlineView.
After OutlineView.setProperties() method was deprecated, the preferred
way how to add columns is via addPropertyColumn()/setPropertyColumns().
But then there's no Node.Property to set additional attributes on.
This is why setPropertyColumnAttribute() method is introduced.
</description>
<class package="org.openide.explorer.view" name="OutlineView"/>
<issue number="208713"/>
</change>
<change id="OutlineView_with_quicksearch">
<api name="explorer"/>
<summary>QuickSearch attached to OutlineView</summary>
<version major="6" minor="43"/>
<date day="8" month="3" year="2012"/>
<author login="mentlicher"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="yes"/>
<description>
Added <a href="@TOP@/org/openide/explorer/view/OutlineView.html#isQuickSearchAllowed()">OutlineView.isQuickSearchAllowed()</a>,
<a href="@TOP@/org/openide/explorer/view/OutlineView.html#setQuickSearchAllowed(boolean)">OutlineView.setQuickSearchAllowed()</a>
and <a href="@TOP@/org/openide/explorer/view/OutlineView.html#setQuickSearchTableFilter(org.openide.explorer.view.QuickSearchTableFilter, boolean)">OutlineView.setQuickSearchTableFilter()</a>
methods to control quick search functionality on OutlineView.
Interface <a href="@TOP@/org/openide/explorer/view/QuickSearchTableFilter.html">QuickSearchTableFilter</a>
introduced to provide custom table cell data for quick search.
</description>
<class package="org.openide.explorer.view" name="OutlineView"/>
<class package="org.openide.explorer.view" name="QuickSearchTableFilter"/>
<issue number="110686"/>
</change>
<change id="PropertyEnv.create">
<api name="explorer"/>
<summary>API method for creating a PropertyEnv instance</summary>
<version major="6" minor="39"/>
<date day="31" month="8" year="2011"/>
<author login="tpavek"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="yes"/>
<description>
Added <a href="@TOP@/org/openide/explorer/propertysheet/PropertyEnv.html#create(java.beans.FeatureDescriptor,%20java.lang.Object...)">PropertyEnv.create</a>
method for creating an instance of PropertyEnv for given property and beans (nodes).
To be used when there is a need to initialize an ExPropertyEditor instance independently from
PropertySheet or PropertyPanel infrastructure (e.g. before the property appears in UI).
</description>
<class package="org.openide.explorer.propertysheet" name="PropertyEnv"/>
<issue number="201223"/>
</change>
<change id="slowRename">
<api name="explorer"/>
<summary>In-place rename can be processed on background</summary>
<version major="6" minor="38"/>
<date day="30" month="6" year="2011"/>
<author login="jtulach"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="yes"/>
<description>
By providing <a href="@TOP@/architecture-summary.html#property-slowRename">slowRename</a>
property, nodes can request in-place rename to be finished on background.
</description>
<class package="org.openide.explorer.view" name="TreeView"/>
<class package="org.openide.explorer.view" name="TreeTableView"/>
<class package="org.openide.explorer.view" name="OutlineView"/>
<issue number="190736"/>
</change>
<change id="BaseTable.setQuickSearchAllowed">
<api name="explorer"/>
<summary>Allows one to disable quick search in property sheets, either globally or per-instance.</summary>
<version major="6" minor="37"/>
<date day="10" month="6" year="2011"/>
<author login="tomwheeler"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="yes"/>
<description>
Added methods <code>setQuickSearchAllowed(boolean)</code> and <code>isQuickSearchAllowed()</code>
to BaseTable to control and query whether the quick search feature is enabled. Since the BaseTable
instance of a PropertySheet is private, <code>setQuickSearchAllowed(boolean)</code> and
<code>isQuickSearchAllowed()</code> delegate methods were also added to PropertySheet. This allows
a developer control on a per-instance basis, though it is also possible to disable property sheet
quick search globally by setting the <code>ps.quickSearch.disabled.global</code> system property
to <code>true</code>.
</description>
<class package="org.openide.explorer.propertysheet" name="BaseTable" link="no" />
<class package="org.openide.explorer.propertysheet" name="PropertySheet"/>
<issue number="199349"/>
</change>
<change id="TreeView.quickSearchAllowed">
<api name="explorer"/>
<summary>It's possible to define whether the quick search is enabled or disabled in TreeView.</summary>
<version major="6" minor="33"/>
<date day="16" month="11" year="2010"/>
<author login="theanuradha"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="yes"/>
<description>
Methods <code>setQuickSearchAllowed()</code> and <code>isQuickSearchAllowed()</code>
added to TreeView to control quick search enable or disable.
</description>
<class package="org.openide.explorer.view" name="TreeView"/>
<issue number="181452"/>
</change>
<change id="OutlineView.defaultActionAllowed">
<api name="explorer"/>
<summary>It's possible to define whether the default action is allowed or not in OutlineView.</summary>
<version major="6" minor="32"/>
<date day="4" month="10" year="2010"/>
<author login="mentlicher"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="yes"/>
<description>
Methods <code>setDefaultActionAllowed()</code> and <code>isDefaultActionAllowed()</code>
added to OutlineView to control invocation of the default action.
</description>
<class package="org.openide.explorer.view" name="OutlineView"/>
<issue number="190258"/>
</change>
<change id="OutlineView.setTreeHorizontalScrollBarPolicy">
<api name="explorer"/>
<summary>OutlineView can provide horizontal scroll bar in the tree column.</summary>
<version major="6" minor="30"/>
<date day="7" month="7" year="2010"/>
<author login="mentlicher"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="yes"/>
<description>
In order to be able to provide horizontal scroll bar in the tree column,
two methods are added: <code>getTreeHorizontalScrollBarPolicy()</code>
and <code>setTreeHorizontalScrollBarPolicy()</code>.
</description>
<class package="org.openide.explorer.view" name="OutlineView"/>
<issue number="188130"/>
</change>
<change id="ListView.setShowParentNode">
<api name="explorer"/>
<summary>ListView can now display ".." item</summary>
<version major="6" minor="28"/>
<date day="24" month="4" year="2010"/>
<author login="jtulach"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="yes"/>
<description>
To simplify navigation "up" in the <code>ListView</code> one
can turn on <a href="@TOP@/org/openide/explorer/view/ListView.html#setShowParentNode(boolean)">showParentNode</a>
property.
</description>
<class package="org.openide.explorer.view" name="ListView"/>
<issue number="35954"/>
</change>
<change id="OutlineView.setPropertyColumns">
<api name="explorer"/>
<summary><code>OutlineView.setPropertyColumns</code>,
<code>OutlineView.addPropertyColumn</code> and
<code>OutlineView.removePropertyColumn</code> added.
</summary>
<version major="6" minor="25"/>
<date day="11" month="1" year="2010"/>
<author login="tboudreau"/>
<compatibility binary="compatible" source="compatible" deprecation="yes" deletion="no" addition="yes"/>
<description>
Added methods to manipulate the displayed columns of an OutlineView
without needing to create prototype property objects, both making
it simpler to use, and avoiding the common problem of properties
not appearing because the prototype property does not use the
exact type required.
<p/>
Deprecated <code>OutlineView.setProperties()</code>, as this was
only needed for ease of replacement of TreeTableView.
</description>
<class package="org.openide.explorer.view" name="OutlineView"/>
<issue number="179397"/>
</change>
<change id="OutlineView.setTreeSortable">
<api name="explorer"/>
<summary><code>OutlineView.setTreeSortable</code> added.</summary>
<version major="6" minor="24"/>
<date day="21" month="12" year="2009"/>
<author login="mentlicher"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="yes"/>
<description>Added method to set or unset the tree column as sortable.</description>
<class package="org.openide.explorer.view" name="OutlineView"/>
<issue number="178613"/>
</change>
<change id="TreeView.setAutoWaitCursor">
<api name="explorer"/>
<summary><code>TreeView.setAutoWaitCursor</code> added.</summary>
<version major="6" minor="21"/>
<date day="19" month="10" year="2009"/>
<author login="t_h"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="yes"/>
<description>Added method to control automatic setting of wait cursor when node is expanded.</description>
<class package="org.openide.explorer.view" name="TreeView"/>
<issue number="169353"/>
</change>
<change id="CheckNodes">
<api name="explorer"/>
<summary>Support for check-boxes displayed next to node icons.</summary>
<version major="6" minor="18"/>
<date day="8" month="3" year="2009"/>
<author login="mentlicher"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="yes"/>
<description>Nodes can have check-boxes rendered next to their icons or display names.
</description>
<class package="org.openide.explorer.view" name="CheckableNode"/>
<issue number="159546"/>
</change>
<change id="SetSelectedNodes">
<api name="explorer"/>
<summary>setSelectedNodes() does partial selection instead of throwing IllegalArgumentException when
some of newly selected nodes are not under root context.</summary>
<version major="6" minor="16"/>
<date day="16" month="9" year="2008"/>
<author login="t_h"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="no"/>
<description>Nodes can be removed outside of AWT thread while e.g. view can
try to select them. This generated IllegalArgumentException during checking if
such a node is under root context. Now
<a href="@TOP@/org/openide/explorer/ExplorerManager.html#setSelectedNodes(org.openide.nodes.Node[])"><code>setSelectedNodes()</code></a>.
does partial selection
of valid nodes instead of throwing IllegalArgumentException.
</description>
<class package="org.openide.explorer" name="ExplorerManager"/>
<issue number="145376"/>
</change>
<change id="OutlineView">
<api name="explorer"/>
<summary>Added OutlineView component which is a replacement for buggy TreeTableView.</summary>
<version major="6" minor="15"/>
<date day="29" month="5" year="2008"/>
<author login="saubrecht"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no" addition="yes"/>
<description>Added new OutlineView component which is a table with expandable
tree-like part and which replaces the current buggy TreeTableView.
</description>
<class package="org.openide.explorer.view" name="OutlineView"/>
<issue number="33281"/>
</change>
<change id="ColumnDisplayNameWithMnemonicTTV">
<api name="explorer"/>
<summary>Added support for property ColumnDisplayNameWithMnemonicTTV.</summary>
<version major="6" minor="12"/>
<date day="2" month="11" year="2007"/>
<author login="saubrecht"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no"/>
<description>Added support for property ColumnDisplayNameWithMnemonicTTV. This
property may be used to specify column names with mnemonic char using '&' char.
Such display name will be used in 'Change Visible Columns' dialog window.
</description>
<class package="org.openide.explorer.view" name="NodeTableModel"/>
<issue number="113642"/>
</change>
<change id="setUseSubstringInQuickSearch">
<api name="explorer"/>
<summary>Added method TreeView.setUseSubstringInQuickSearch(boolean).</summary>
<version major="6" minor="11"/>
<date day="11" month="7" year="2007"/>
<author login="dstrupl"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no"/>
<description>Added method setUseSubstringInQuickSearch(boolean). This
method allows using substring search for the typed in text in the quick
search feature instead of the (default) prefix search.
</description>
<class package="org.openide.explorer.view" name="TreeView"/>
<issue number="108729"/>
</change>
<change id="extendedDelete">
<api name="explorer"/>
<summary>Added an interface and a registration slot
for explorer delete action interceptors.</summary>
<version major="6" minor="10"/>
<date day="15" month="6" year="2007"/>
<author login="pnejedly"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no"/>
<description>Added an interface ExtendedDelete that can be registered to
handle deletion of selected nodes instead of the default implementation.
</description>
<class package="org.openide.explorer" name="ExtendedDelete"/>
<issue number="76722"/>
</change>
<change id="descriptionAreaAndPopupConfig">
<api name="explorer"/>
<summary>Added setters to show/hide the description area and
enable/disable the popup menu</summary>
<version major="6" minor="9"/>
<date day="1" month="6" year="2007"/>
<author login="tboudreau"/>
<compatibility binary="compatible" source="compatible" deprecation="no" deletion="no"/>
<description>Added setters for the visibility of the description area
and availability of the popup menu to PropertySheet
</description>
<class package="org.openide.explorer.propertysheet" name="PropertySheet"/>
<issue number="100170"/>
</change>
<change id="deleted-PropertySheetSettings">
<api name="explorer"/>
<summary>PropertySheetSettings was deleted</summary>
<version major="6" minor="8"/>
<date day="9" month="11" year="2006"/>
<author login="rmatous"/>
<compatibility binary="compatible" source="incompatible" deprecation="no" deletion="yes"/>
<description>PropertySheetSettings was deleted from org.openide.explorer.
To ensure binary compatibility there was added dependency transformation that ensures
that for all modules that depend on org.openide.explorer with spec.version < 6.8 is added additional dependency
on org.openide.options with spec.version 6.6 during runtime.
</description>
<class package="org.openide.explorer.propertysheet" name="PropertySheetSettings" link="no"/>
<issue number="88769"/>
</change>
<change id="ExternalDragAndDrop.explorer">
<api name="explorer"/>
<summary>When an external object(s) is dragged over the Explorer, the drag
events are passed to Nodes under the cursor.</summary>
<version major="6" minor="7"/>
<date day="30" month="5" year="2006"/>
<author login="saubrecht"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description> <p>When an external object (e.g. file(s)) is dragged over the
Explorer, the drag events passed to Nodes under the cursor. It means
that the appropriate Node is asked whether the dragged object(s) can
be dropped to it. The drag support classes will also provide appropriate
visual drag feedback - change cursor shape and/or draw drop line indicator.
</p>
<p>When the object is dropped then the Node under the cursor will be
asked to provide supported <code>PasteType</code>s that will handle
the drop.</p>
</description>
<package name="org.openide.explorer.view" />
<issue number="35228"/>
</change>
<change id="dnd.convertor.drag">
<api name="explorer"/>
<summary>
Dragging uses
Node.drag
and
ExClipboard.convert
</summary>
<version major="6" minor="3"/>
<date day="29" month="4" year="2005"/>
<author login="jtulach"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description>
When doing drag and drop of nodes from explorer
to another place in explorer the
<a href="@org-openide-nodes@/org/openide/nodes/Node.html">
Node.drag</a> method is called when doing copy
and in both cases of copy or move the
<a href="@org-openide-util-ui@/org/openide/util/datatransfer/ExClipboard.html">
ExClipboard.convert
</a> method is called for Transferable containing
all the nodes, so one can wrap the whole transfer with
pre and post operations.
</description>
<package name="org.openide.explorer.view" />
<issue number="57972"/>
</change>
<change id="NodeTableModel.ColumnMnemonicCharTTV">
<api name="explorer"/>
<summary>Added a new <code>ColumnMnemonicCharTTV</code> property to <code>NodeTableModel</code>
</summary>
<version major="5" minor="9"/>
<date day="30" month="3" year="2005"/>
<author login="saubrecht"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description>
The new property allows you to specify a mnemonic character for display names
of <code>TreeTableView</code> columns.
</description>
<class package="org.openide.explorer.view" name="NodeTableModel"/>
<issue number="56781"/>
</change>
<change id="item-separator-attribute-for-StringArrayPropertyEditor">
<api name="explorer"/>
<summary>One can specify separator for property editor for <code>String[]</code> </summary>
<version major="5" minor="7"/>
<date day="18" month="3" year="2005"/>
<author login="jtulach"/>
<compatibility addition="yes" binary="compatible" semantic="compatible" source="compatible" deprecation="no" deletion="no" modification="no"/>
<description>
One can specify an item separator for properties using string array editor. For example
following code:
<pre xml:space="preserve">
Node.Property np = new Node.Property (String[].class, ...);
np.setValue ("item.separator", "-");
</pre>
separates items returned from <code>getAsText</code> and parsed by <code>setAsText</code>
by <q>-</q>. List of supported parameters can be found
<a href="@TOP@/org/openide/explorer/doc-files/propertyViewCustomization.html#core_editors_custom_parameters" shape="rect">here</a>.
</description>
<class package="org.openide.explorer.propertysheet" name="PropertyPanel"/>
<issue number="56257"/>
</change>
<change id="ExplorerActions.DeleteActionPerfomer">
<api name="explorer"/>
<summary>Nodes in explorer can supress default confirmation dialog during delete operation</summary>
<version major="5" minor="6"/>
<date day="11" month="3" year="2005"/>
<author login="rkubacki"/>
<compatibility modification="yes" semantic="compatible" binary="compatible" source="compatible" deprecation="no" addition="no" deletion="no"/>
<description>
Nodes that need to supress default confirmation dialog shown during delete action
can do this if they return <code>Boolean.TRUE</code> from <code>Node.getValue(String)</code>
for attribute customDelete.
</description>
<issue number="56256"/>
</change>
<change id="TreeView.dragActive">
<api name="explorer"/>
<summary>Fixed <code>TreeView.drag/dropActive</code> switcher</summary>
<version major="4" minor="45"/>
<date day="25" month="8" year="2004"/>
<author login="jrechtacek"/>
<compatibility modification="yes" semantic="compatible" binary="compatible" source="compatible" deprecation="no" addition="no" deletion="no"/>
<description>
The methods <code>TreeView.setDragSource(boolean)</code> and <code>TreeView.setDropTarget</code>
can set drag/dropActive on/off. The drag source and drop target are enabled by default.
Before the views were forced to be drag/drop active no matter what state was set.
</description>
<class package="org.openide.explorer.view" name="TreeView"/>
<issue number="47672"/>
</change>
<change>
<api name="explorer"/>
<summary>Added ExplorerUtils.getHelpCtx</summary>
<version major="4" minor="40"/>
<date day="14" month="6" year="2004"/>
<author login="pnejedly"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description>
Add the utility method for computing the help id for a set
of nodes with a fallback to provided default id.
</description>
<class package="org.openide.explorer" name="ExplorerUtils"/>
<issue number="37543"/>
</change>
<change>
<api name="explorer"/>
<summary>Deprecation of NodeRenderer.sharedInstance()</summary>
<version major="4" minor="36"/>
<date day="1" month="6" year="2004"/>
<author login="tboudreau"/>
<compatibility deprecation="yes" binary="compatible" source="compatible" semantic="compatible" addition="no" deletion="no" modification="no"/>
<description>
NodeRenderer.sharedInstance() is now deprecated. Components which
wish to render nodes should create their own private instance of
NodeRenderer, to avoid one view's painting interfering with another's.
</description>
<class package="org.openide.explorer.view" name="NodeRenderer"/>
<issue number="43148"/>
</change>
<change id="delete-InplaceEditor.handleInitialInputEvent">
<api name="explorer"/>
<summary>Removal of org.openide.explorer.propertysheet.InplaceEditor.handleInitialInputEvent</summary>
<version major="4" minor="17"/>
<date day="9" month="12" year="2003"/>
<author login="tboudreau"/>
<compatibility deletion="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" addition="no" modification="no"/>
<description>
This method was introduced post-3.5, and has proven unnecessary, as the
event may effectively be dispatched to the component using dispatchEvent().
It will instead be the responsibility of the component to determine if
it has just been added to a container and should handle the event in some
special way because of that.
</description>
<class package="org.openide.explorer.propertysheet" name="InplaceEditor"/>
<issue number="37626"/>
</change>
<change id="PropertyPanel-rewrite">
<api name="explorer"/>
<summary>Property panel rewrite, addition of set/getProperty methods and new constructors, deprecation of getPropertyEditor</summary>
<version major="4" minor="17"/>
<date day="9" month="12" year="2003"/>
<author login="tboudreau"/>
<compatibility deprecation="yes" addition="yes" modification="yes" binary="compatible" source="compatible" semantic="compatible" deletion="no"/>
<description>
As part of the rewrite of the internals of PropertyPanel to use the new
property sheet's infrastructure, users of PropertyPanel are encouraged
to use Node.Property rather than PropertyModel objects to drive their
PropertyPanel instances. To that end, methods and constructors have been
added in order to support using Node.Property objects. The method
getPropertyEditor() has been deprecated, and the property change
PROP_PROPERTY_EDITOR will no longer be fired. As documented, in the case
of custom editors, its function has not changed, but for inline uses,
there is no particular use for holding a reference to the property editor
instance, so for inline uses it is no longer guaranteed to return the
same property editor instance as previously - this is now the sole
responsibility of the Property object. As this method was primarily used
by the old property sheet, this is a low-impact change.
</description>
<class package="org.openide.explorer.propertysheet" name="PropertyPanel"/>
<issue number="31896"/>
</change>
<change id="ExplorerManager-action-factories">
<api name="explorer"/>
<summary>Copy, Cut, Paste and Delete Action Factory</summary>
<version major="4" minor="14"/>
<date day="21" month="11" year="2003"/>
<author login="jtulach"/>
<compatibility addition="yes" deprecation="yes" binary="compatible" source="compatible" semantic="compatible" deletion="no" modification="no"/>
<description>
As part of the work on separation of openide.jar into smaller parts
the existing <code>ExplorerActions</code> class and <code>ExplorerPanel</code>
are being deprecated and replaced by new factory methods in
<code>ExplorerUtils</code> class. Use them to create actions
handling copy, cut, paste and delete on given ExplorerManager.
</description>
<class link="no" package="org.openide.explorer" name="ExplorerActions"/>
<class link="no" package="org.openide.explorer" name="ExplorerPanel"/>
<class package="org.openide.explorer" name="ExplorerUtils"/>
<issue number="34758"/>
</change>
<change id="boolean.editor.hints">
<api name="explorer"/>
<summary>
Additional hints for boolean, Boolean properties
</summary>
<version major="4" minor="3"/>
<date day="4" month="4" year="2003"/>
<author login="tboudreau"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description>
Properties of type boolean or Boolean can now
supply the following hint to the property editor:
stringValues - a String[2] which will be used
to replace the standard "true" or
"false" displayed in the editor.
</description>
<issue number="32619"/>
</change>
<change id="integer.editor.hints">
<api name="explorer"/>
<summary>
Additional hints for int,Integer properties
</summary>
<version major="4" minor="3"/>
<date day="4" month="4" year="2003"/>
<author login="tboudreau"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description>
Properties representing instances of int or Integer can
now supply the following hints to their property editors:
stringKeys, intValues, codeValues. The String[] keys will be
displayed in a drop down in the propertysheet; the
int[] values are used when a key of the corresponding
index is selected; the optional codeValues String[]
can be used to supply custom text to getJavaInitializationString()
for code generation.
This replaces the functionality of the now deprecated
ChoicePropertyEditor.
</description>
<issue number="20736"/>
<issue number="5278"/>
<issue number="31879"/>
</change>
<change id="string.editor.hints">
<api name="explorer"/>
<summary>
Additional hints for String properties
</summary>
<version major="4" minor="2"/>
<date day="26" month="3" year="2003"/>
<author login="tboudreau"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description>
Properties representing String instances can now supply
the following additional hints: oneline, suppressCustomEditor
and instructions. These affect the behavior of the custom
editor if invoked. If these hints are not supplied, behavior
will be the same as it always was.
</description>
<issue number="29294"/>
</change>
<change>
<api name="explorer"/>
<summary>MenuView.MenuItem implements HelpCtx.Provider</summary>
<version major="3" minor="38"/>
<date day="13" month="2" year="2003"/>
<author login="pnejedly"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description>
The HelpCtx of the underlying node is now exported through
HelpCtx.Provider interface. For the API users, HelpCtx.findHelp
keeps working the same way.
</description>
<class package="org.openide.explorer.view" name="MenuView"/>
</change>
<change>
<api name="explorer"/>
<summary>PropertyPanel.getState, PropertyEnv.add/removePropertyChanageListener</summary>
<version major="2" minor="20"/>
<date day="27" month="5" year="2002"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description>Define interface that would allow to tell customizer that it should check
user changed values and that it should commit values. PropertyPanel controls/obtains
the value of the PropertyEnv.getState of the current property editor.
Thus adding method PropertyPanel.getState () and firing property
changes appropriatelly.
Added public methods
<code>PropertyPanel.getState()</code>,
<code>PropertyEnv.addPropertyChangeListener(PropertyChangeListener)</code> and
<code>PropertyEnv.removePropertyChangeListener(PropertyChangeListener)</code>.
Added public static field
<code>PropertyPanel.PROP_STATE</code>.
</description>
<class package="org.openide.explorer.propertysheet" name="PropertyPanel"/>
<class package="org.openide.explorer.propertysheet" name="PropertyEnv"/>
<issue number="23369"/>
</change>
<change>
<api name="explorer"/>
<summary>Add set/getSelectionMode in TreeView</summary>
<version major="2" minor="15"/>
<date day="24" month="4" year="2002"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description>
Added public methods
<code>TreeView.setSelectionMode(int)</code> and
<code>TreeView.getSelectioMode()</code>.
</description>
<class package="org.openide.explorer.view" name="TreeView"/>
</change>
<change>
<api name="explorer"/>
<summary>Add generic help support to property editors</summary>
<version major="2" minor="7"/>
<date day="6" month="3" year="2002"/>
<author login="akemr"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description> New property PROPERTY_HELP_ID added to improve generic help
support to property editors.
</description>
<class package="org.openide.explorer.propertysheet" name="ExPropertyEditor"/>
<issue number="19294"/>
</change>
<change>
<api name="explorer"/>
<summary>Constructor DefaultPropertyModel (bean, propertyDescriptor) added</summary>
<version major="2" minor="4"/>
<date day="20" month="2" year="2002"/>
<author login="jtulach"/>
<compatibility addition="yes" modification="no" deprecation="no" binary="compatible" source="compatible" semantic="compatible" deletion="no"/>
<description>
<p>
New constructor to make DefaultPropertyModel more easily usable with PropertyDescriptor created by hand
and not obtained from BeanInfo.
</p>
</description>
<class package="org.openide.explorer.propertysheet" name="DefaultPropertyModel"/>
<issue number="20601"/>
</change>
<change>
<api name="explorer"/>
<summary>The whole <code>org.openide.explorer.propertysheet.editors</code> package is deprecated</summary>
<compatibility deprecation="yes" binary="compatible" source="compatible" semantic="compatible" addition="no" deletion="no" modification="no"/>
<description>
<p>
The entire
<code>org.openide.explorer.propertysheet.editors</code>
package is generally deprecated
and no longer included in Javadoc.
</p>
<p>
As of 3.14, this package is again included in the Javadoc, though only
only a few interfaces remain, and of these several are in fact
deprecated, and the rest will probably be deprecated at some point.
</p>
</description>
<package name="org.openide.explorer.propertysheet.editors"/>
</change>
<change>
<api name="explorer"/>
<summary>New property changesImmediate in <code>PropertyPanel</code>
</summary>
<date day="22" month="8" year="2001"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no">
Added two public methods to class PropertyPanel: <code>public boolean
isChangeImmediate();</code> and <code>public void
setChangeImmediate(boolean b);</code>
</compatibility>
<description>
The added property allows to control whether the changes fired from
property editor are immediately propagated to the value of the property
(more precisely to the property model).
</description>
<class package="org.openide.explorer.propertysheet" name="PropertyPanel"/>
</change>
<change>
<api name="explorer"/>
<summary><code>PropertyEnv</code> can control validation state</summary>
<date day="9" month="7" year="2001"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description>
New constants and methods added to the class <code>PropertyEnv</code>:
<pre xml:space="preserve">public static final String PROP_STATE;
public static final Object STATE_VALID;
public static final Object STATE_NEEDS_VALIDATION;
public static final Object STATE_INVALID;
public void setState (Object state);
public Object getState ();
public void addVetoableChangeListener(VetoableChangeListener l);
public void removeVetoableChangeListener(VetoableChangeListener l);</pre>
<br/>
The added methods allow to modify the state of the "environment" from
a property editor. They also allow listening on such changes and
veto the change if needed.
The API documentation for the class <code>PropertyEnv</code> should
provide information on what they do.
</description>
<class package="org.openide.explorer.propertysheet" name="PropertyEnv"/>
</change>
<change>
<api name="explorer"/>
<summary>Moved validity check into <code>ExPropertyEditor</code>
</summary>
<date day="30" month="10" year="2000"/>
<compatibility addition="yes" deletion="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" modification="no">
Deletion from newly added <code>PropertyEnv</code> only.
</compatibility>
<description>
Minor change to the new class <code>PropertyEnv</code>: removed methods
<code>set</code>/<code>isValid</code> from <code>PropertyEnv</code> and
introduced new constant <code>PROP_VALUE_VALID</code> in the
<code>ExPropertyEditor</code>.
</description>
<class package="org.openide.explorer.propertysheet" name="PropertyEnv"/>
<class package="org.openide.explorer.propertysheet" name="ExPropertyEditor"/>
</change>
<change>
<api name="explorer"/>
<summary><code>ExPropertyEditor</code> added and used</summary>
<date day="25" month="10" year="2000"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description>
New interface <code>ExPropertyEditor</code> added to the package <code>org.openide.explorer.propertysheet</code>.
It extends <code>PropertyEditor</code> allowing to pass information to the
property editor by passing an instance of <code>PropertyEnv</code> class - this
class was also added. To be able to pass the required information
the <code>PropertyModel</code> interface was also extended to <code>ExPropertyModel</code>.
<code>DefaultPropertyModel</code> was modified to implement the new interface
<code>ExPropertyModel</code> (instead of <code>PropertyModel</code>).
</description>
<class package="org.openide.explorer.propertysheet" name="ExPropertyEditor"/>
<class package="org.openide.explorer.propertysheet" name="DefaultPropertyModel"/>
<class package="org.openide.explorer.propertysheet" name="PropertyEnv"/>
<class package="org.openide.explorer.propertysheet" name="ExPropertyModel"/>
</change>
<change>
<api name="explorer"/>
<summary>Property editor for <code>File</code> accepts hint <code>baseDir</code>
</summary>
<date day="25" month="9" year="2001"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description>
The property editor for <code>java.io.File</code> may now be given the
property hint <code>baseDir</code> specifying a directory from which
relative filenames edited by the editor may be resolved.
</description>
</change>
<change>
<api name="explorer"/>
<summary>Property editor for <code>DataObject</code> accepts hint <code>rootNode</code>
</summary>
<version major="1" minor="41"/>
<date day="19" month="10" year="2001"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description>
The property editor for <code>org.openide.loaders.DataObject</code> may now be given the
property hint <code>rootNode</code> specifying a root node of displyed nodes hierarchy.
If omited filesystems repository root node is used instead.
</description>
</change>
<change id="PropertyDialogManager-removed">
<api name="explorer"/>
<summary><code>PropertyDialogManager</code> removed</summary>
<date day="31" month="5" year="2000"/>
<compatibility deletion="yes" source="incompatible" binary="compatible" semantic="compatible" deprecation="no" addition="no" modification="no">
First broken, later restored binary compatibility in trunk and
<code>boston</code>. Code referring to this class can generally be easily
rewritten to simply embed the supplied component in a dialog and show that
dialog.
</compatibility>
<description>
Made inaccessible. No one should have been using this class outside its
package to begin with, it was public by accident.
</description>
<class link="no" package="org.openide.explorer.propertysheet" name="PropertyDialogManager"/>
</change>
<change id="SetDefaultValueAction-removed">
<api name="explorer"/>
<summary><code>SetDefaultValueAction</code> removed</summary>
<date day="30" month="11" year="2000"/>
<author login="jglick"/>
<compatibility deletion="yes" source="incompatible" binary="compatible" semantic="compatible" deprecation="no" addition="no" modification="no"/>
<description>
Made inaccessible. No reason for it to have been public.
</description>
<class link="no" package="org.openide.explorer.propertysheet" name="SetDefaultValueAction"/>
</change>
<change>
<api name="explorer"/>
<summary><code>BeanTreeView.selectionChanged</code> made protected, not public</summary>
<date day="6" month="11" year="2000"/>
<compatibility modification="yes" source="incompatible" binary="compatible" semantic="compatible" deprecation="no" addition="no" deletion="no"/>
<description>
Method <code>selectionChanged</code> made protected, not public, to match
the access mode of the method it was implementing in
<code>TreeView</code>. Code calling it as public is erroneous.
</description>
<class package="org.openide.explorer.view" name="BeanTreeView"/>
</change>
<change>
<api name="explorer"/>
<summary>Deserialization of explorer managers and panels may throw <code>SafeException</code>
</summary>
<date day="9" month="3" year="2000"/>
<author login="jglick"/>
<compatibility modification="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" addition="no" deletion="no"/>
<description>
<code>readExternal</code> of <code>ExplorerPanel</code> or deserialization
of <code>ExplorerManager</code> may throw <code>SafeException</code> to
indicate a failure in the loading of the manager's handles, but the stream
is OK.
</description>
<class link="no" package="org.openide.explorer" name="ExplorerPanel"/>
<class package="org.openide.explorer" name="ExplorerManager"/>
</change>
<change>
<api name="explorer"/>
<summary><code>MenuView.Acceptor</code> deprecated and not used</summary>
<date day="5" month="9" year="2000"/>
<compatibility deprecation="yes" binary="incompatible" source="incompatible" semantic="compatible" addition="no" deletion="no" modification="no">
Subclasses accessing the <code>action</code> field will be broken.
</compatibility>
<description>
Interface <code>MenuView.Acceptor</code> is now deprecated. It is
recommended to use <code>nodes.NodeAcceptor</code> over
<code>MenuView.Acceptor</code>, which will be probably removed entirely in
future. The protected field <code>action</code> in both
<code>MenuView.Menu</code> and <code>MenuView.MenuItem</code> has changed
type to be <code>NodeAcceptor</code>.
</description>
<class package="org.openide.explorer.view" name="MenuView"/>
</change>
<change>
<api name="explorer"/>
<summary>Set explored context while selecting nodes</summary>
<date day="13" month="9" year="2000"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description>
New method <code>setExploredContext</code> added with a second parameter
giving nodes which are to be selected.
</description>
<class package="org.openide.explorer" name="ExplorerManager"/>
</change>
<change>
<api name="explorer"/>
<summary>Set explored context while selecting nodes (and throw an exception)</summary>
<date day="20" month="2" year="2001"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description>
New method <code>public final void setExploredContextAndSelection(Node
value, Node[] selection) throws PropertyVetoException</code> added to the
class <code>ExplorerManager</code>. It is replacement for the
<code>setExploredContext</code> method which should throw the exception.
</description>
<class package="org.openide.explorer" name="ExplorerManager"/>
</change>
<change>
<api name="explorer"/>
<summary>Table explorer views added</summary>
<version major="1" minor="7"/>
<date day="7" month="5" year="2001"/>
<compatibility addition="yes" binary="compatible" source="compatible" semantic="compatible" deprecation="no" deletion="no" modification="no"/>
<description>
New explorer views permit viewing of a list of tree of nodes with
properties displayed in tabular form.
</description>
<class package="org.openide.explorer.view" name="NodeTableModel"/>
<class package="org.openide.explorer.view" name="TreeTableView"/>
<class package="org.openide.explorer.view" name="ListTableView"/>
</change>
</changes>
<htmlcontents>
<head>
<title>Change History for the Explorer API</title>
<link rel="stylesheet" href="prose.css" type="text/css"/>
</head>
<body>
<p class="overviewlink">
<a href="overview-summary.html">Overview</a>
</p>
<h1>Introduction</h1>
<h2>What do the Dates Mean?</h2>
<p>The supplied dates indicate when the API change was made, on the CVS
trunk. From this you can generally tell whether the change should be
present in a given build or not; for trunk builds, simply whether it
was made before or after the change; for builds on a stabilization
branch, whether the branch was made before or after the given date. In
some cases corresponding API changes have been made both in the trunk
and in an in-progress stabilization branch, if they were needed for a
bug fix; this ought to be marked in this list.</p>
<ul>
<li>The <code>release41</code> branch was made on Apr 03 '05 for use in the NetBeans 4.1 release.
Specification versions: 6.0 begins after this point.</li>
<li>The <code>release40</code> branch was made on Nov 01 '04 for use in the NetBeans 4.0 release.
Specification versions: 5.0 begins after this point.</li>
</ul>
<hr/>
<standard-changelists module-code-name="org.openide.explorer"/>
<hr/>
<p>@FOOTER@</p>
</body>
</htmlcontents>
</apichanges>
|
