Source

main-silver / openide.explorer / apichanges.xml

  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
<?xml version="1.0" encoding="UTF-8"?>
<!--
The contents of this file are subject to the terms of the Common Development
and Distribution License (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.html
or http://www.netbeans.org/cddl.txt.

When distributing Covered Code, include this CDDL Header Notice in each file
and include the License file at http://www.netbeans.org/cddl.txt.
If applicable, add the following below the CDDL Header, with the fields
enclosed by brackets [] replaced by your own identifying information:
"Portions Copyrighted [year] [name of copyright owner]"

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.
--><!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="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 &lt; 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@/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>