站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > NetBeans API Javadoc (Current Development Version)

Change History for the Progress API - NetBeans API Javadoc (Current Development Version)

Overview

Introduction

This document lists changes made to the Palette API/SPI.

Index of APIs

Incompatible changes by date

Fuller descriptions of all changes can be found below (follow links).

Not all deprecations are listed here, assuming that the deprecated APIs continue to essentially work. For a full deprecation list, please consult the Javadoc.

All changes by date

Changes by version

These API specification versions may be used to indicate that a module requires a certain API feature in order to function. For example, if you see here a feature you need which is labelled 1.20, your manifest should contain in its main attributes the line: 

OpenIDE-Module-Module-Dependencies: org.netbeans.spi.palette > 1.20

Changes by affected class

org.netbeans.spi.palette.PaletteActions

Details of all changes by API and date

Palette API

Allow associating palette content with document mime type.

Feb 27 '07; API spec. version: 1.10; made by: saubrecht; issues: #90213

The previous version of palette API mandated that editor TopComponent had to insert a PaletteController instance into its Lookup if it wants to associate the palette with it. Now it is possible to associate the palette also with an existing editor without the need to change its implementation, e.g. to add code snippets palette to java source editor.

If the mime type of active editor window has an associated instance of PaletteController in the XML layer system then palette window opens and displays the specified palette contents. The PaletteController from TopComponent's Lookup takes precedens over the PaletteController found from mime type lookup in the XML layer (if any) for backwards compatibility.

The new API is fully backwards compatible and there are no implications for existing palette providers.

Allow display name and tooltip to be defined directly in item's XML

Jan 30 '07; API spec. version: 1.8; made by: saubrecht; issues: #90212

Now it's possible to specify item's display name and tooltip directly in item's XML definition (instead of providing bundle name and keys). It's needed for items created at runtime, for example code snippets highlighted in the editor and dropped to the palette.

Palette providers need to be notified when the palette content is being refreshed.

Jan 27 '07; API spec. version: 1.9; affected top-level classes: PaletteActions; made by: saubrecht; issues: #88400

Now it's possible to provide an action that will be invoked as part of palette's 'refresh' logic.

Added helpId attribute

Oct 16 '06; API spec. version: 1.7; made by: saubrecht; issues: #77387

Now it's possible to add helpId attribute to palette's root, categories and items that will be used to create appropriate HelpCtx. The attribute can be specified in XML layer as a folder (palette's root and categories) or file attribute (palette items) or it can be provided directly by appropriate Nodes.

When F1 key is pressed in palette's window then first the selected item is asked for HelpCtx id. If no item is selected or it does not provide specific help id then selected category is checked for help id. If the category does not provide any help id either then palette's root is asked for help id. If the root does not define any then the default help id CommonPalette will be used.

The Common Palette API has been stabilized.

Jun 6 '06; API spec. version: 1.6; made by: saubrecht; issues: #77387

To indicate that this is now considered a stable API, the major release version was incremented to 1 from 0.

Added support for default drag and drop operations

Sep 13 '05; API spec. version: 1.4; made by: saubrecht
The abstract class DragAndDropHandler now provides default implementation for all drag and drop operations. The only method that needs to be overridden is void customize( ExTransferable t, Lookup item ) to provide custom data flavors for items dragged from the palette to editor.
There are also new methods (and their default implementations) in this class that handle reordering of categories and reordering of items (i.e. drag and drop operations withing the palette window).

Palette client support released

Aug 10 '05; API spec. version: 1.3; made by: lkotouc
The first release of the Palette client support. It involves namely DTD describing item definition file format and some implementation addons regarding definition file parsing and custom implementation class loading. The palette item implementor can either directly provide the item body or her own item class implementing org.openide.text.ActiveEditorDrop interface. Lookup that holds object(s) representing the selected item then associates custom item class instance with the org.openide.text.ActiveEditorDrop.class key and the body with java.lang.String key.

Added a new optional attribute that can specify the width of items in the palette.

Aug 9 '05; API spec. version: 1.2; made by: saubrecht
There's a new attribute "itemWidth" that can be set for palette's root node (or for palette's root folder in the layer). This attribute defines the width in pixels for all items in the palette thus forcing the same number of columns for all categories. If the attribute is omitted or its value is "-1" then the item widths will be calculated dynamically. The attribute is read-only.

Removing unnecessary exceptions from PaletteFactory

Aug 8 '05; API spec. version: 1.1; made by: saubrecht
Removed IOException from the signature of methods in PaletteFactory that accept Node as an argument.

Initial version released

Jul 21 '05; API spec. version: 1.0; made by: saubrecht
The first initial release of the Palette API.

Built on May 28 2007.  |  Portions Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.