Index: api/doc/changes/apichanges.xml =================================================================== RCS file: /cvs/openide/api/doc/changes/apichanges.xml,v retrieving revision 1.172 diff -u -r1.172 apichanges.xml --- api/doc/changes/apichanges.xml 25 Nov 2003 10:55:03 -0000 1.172 +++ api/doc/changes/apichanges.xml 5 Dec 2003 19:00:56 -0000 @@ -113,6 +113,49 @@ + + Removal of org.openide.explorer.propertysheet.InplaceEditor.handleInitialInputEvent + + + + + + 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. + + + + + + + + Property panel rewrite, addition of set/getProperty methods and new constructors, deprecation of getPropertyEditor + + + + + + 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. + + + + + Added method findTopComponent(String tcID) to WindowManager Index: api/doc/org/openide/explorer/doc-files/api.html =================================================================== RCS file: /cvs/openide/api/doc/org/openide/explorer/doc-files/api.html,v retrieving revision 1.41 diff -u -r1.41 api.html --- api/doc/org/openide/explorer/doc-files/api.html 2 Dec 2003 22:58:25 -0000 1.41 +++ api/doc/org/openide/explorer/doc-files/api.html 5 Dec 2003 19:00:57 -0000 @@ -841,10 +841,56 @@ java.lang.Boolean useful especially when passing value Boolean.FALSE - in this case disable the possibility of editing the the value as text - but allows getAsText to return non null + but allows getAsText to return non null. Also used by passing + Boolean.TRUE to indicate that a combo-box editor should allow + the user to type their own text into the combo box. + + property sheet + suppressCustomEditor + java.lang.Boolean + indicates that the property sheet/property panel should not + display the custom editor button even if the property editor + supports one. + + + + + property sheet + postSetAction + javax.swing.Action + An action that should be run if, and only if, the user updates + the value of the property (or reconfirms the existing value by + an explicit gesture, such as pressing enter in the property + sheet with an editor opened. This is useful for code which + should, for example, scroll the editor to a specific position + when the user sets a value, but must differentiate between the + user setting the value and the value of the property being + set programmatically. + + + + custom property editor display + title + java.lang.String + title of the custom property dialog, must be passed to the + component itself (e.g. panel.putClientProperty("title", "New custom title.");) + + + + + custom property editor display + title + java.lang.String + title of the custom property dialog, must be passed to the + component itself (e.g. panel.putClientProperty("title", "New custom title.");) + + + + + property sheet longerDisplayName java.lang.String title for the property sheet, must be passed to the Index: arch/arch-openide-propertysheet.xml =================================================================== RCS file: /cvs/openide/arch/arch-openide-propertysheet.xml,v retrieving revision 1.15 diff -u -r1.15 arch-openide-propertysheet.xml --- arch/arch-openide-propertysheet.xml 1 Nov 2003 16:53:46 -0000 1.15 +++ arch/arch-openide-propertysheet.xml 5 Dec 2003 19:00:58 -0000 @@ -329,8 +329,8 @@
  • netbeans.ps.noCustomButtons-When true, hide the custom editor button that appears in the property sheet unless the cell is in edit mode.
    • -
  • netbeans.ps.forceRadioBoolean-Use a radio button editor instead - of a checkbox for boolean values
    • +
  • netbeans.ps.useCheckbox-Use a checkbox editor instead + of the default radio button editor for boolean values
  • netbeans.ps.checkboxCaption-If false, no caption will be provided alongside checkboxes in the boolean editor
    • @@ -344,11 +344,6 @@ display property names and values at some aesthetic expense; it is useful on laptops with small screens -
  • netbeans.ps.combolog-Enable diagnostic logging of resizings of - the combo box editor popup, an attempt to diagnose some (ultimately - unreproducable) problems with combo boxes on a pre-release build of KDE - on Linux
    • -
  • netbeans.ps.combohack-Forces the combo box editor to use a heavyweight popup window, used to solve the above window manager problem in which the created heavyweight popup dimensions differ from those of the @@ -384,9 +379,29 @@
  • PropSheet.setBackground-Background color for expandable property sets
    • +
  • PropSheet.selectionBackground-Background color for selected + properties in the property sheet, overriding the default table selection + color if present. Used to fulfil HIE color requirements on various + platforms.
    • + +
  • PropSheet.selectionForeground-Foreground color for selected + properties in the property sheet, overriding the default table selection + color if present. Used to fulfil HIE color requirements on various + platforms.
    • +
  • PropSheet.selectedSetBackground-Background color for expandable property sets when selected in the UI
    • + +
  • PropSheet.selectedSetForeground-Foreground color for expandable + property sets when selected in the UI
    • +
  • PropSheet.gridColor-Color for the grid of the property sheet + table
    • + +
  • PropSheet.disabledForeground-Foreground color for disabled + properties. May or may not be used, depending on the look and feel's + implementation.
    • +
  • netbeans.ps.iconmargin-Integer spacing that should be used to left of the expansion handle for property sets.
    • @@ -395,22 +410,26 @@ the font and/or the expansion handle icon, whichever is taller, the first time the property sheet is painted -

    Additionally, the property sheeet uses the Java Preferences API to store some -trivial state information based on the users actions. These are stored in the -Preferences context returned by -Preferences.userNodeForPackage(PropertySheet.class).

    + +Additionally, client properties may be used to affect behavior of PropertyPanel, +a component for displaying individual properties. They are as follows:
      -
    • showDescriptionArea-Boolean, determining whether the description - area should be shown by default
      • - -
    • closedSetNames-A comma-delimited string containing the names - of property sets which the user has explicitly closed, and which presumably - they would like to see closed in the future on nodes that have similarly - named property sets
      • - -
    • sortOrder-Integer matching one of the constants described in - org.openide.explorer.propertysheet.PropertySheet to define - sort orders
      • +
    • flat-Boolean. Use a borderless UI suitable for use as a table renderer/editor. + Also affects the behavior of combo boxes, enabling them to open on first click or focus, + as appropriate for combo boxes displayed in a table. This property is obsoleted by + PropertyPanel.PREF_TABLEUI which performs the same function when set as part of the + PropertyPanel preferences bitmask, but is supported for backward compatibility
      • +
    • suppressCustomEditor-Boolean. suppresses the presence of the custom editor button + even if the property editor supports a custom editor.
      • +
    • radioButtonMax-Integer n. Instructs the PropertyPanel to use radio buttons + instead of a combo box for properties whose property editor supports tags but supplies + less than n tags.
      • +
    • useLabels-Boolean. Instructs the PropertyPanel to use the property's + display name as the caption for checkboxes, and as the title of a TitledBorder in the + case of radiobuttons (this latter usage only applies if radioButtonMax is also used). + The use of labels is important for checkboxes, as it is the natural way to display + the meaning of a checkbox in a panel, and the label of a checkbox is what checkboxes + use to indicate they have keyboard focus.
    @@ -471,6 +490,11 @@ --> Reflection is used to invoke JavaHelp if present, when the user invokes help. +Refelection is used to try to attach action listeners to the component supplied +by legacy (deprecated) EnhancedPropertyEditor implementations to supply their +own inline editor component. Reflection is used by the deprecated +DefaultPropertyModel to attempt to locate getter and setter methods on a +random bean. @@ -660,7 +684,7 @@ --> The property sheet is designed to perform minimal memory consumption -as it paints, by reusing renderers, etc., but by and large it is +as it paints, by reusing renderers, etc., and by and large it is quite efficient.
    There may be some overhead to selecting a large @@ -733,8 +757,7 @@ --> -No. It does use the Java Preferences API to store a handful of trivial -settings such as a list of closed set names and the last sort mode. +No.