Skip navigation links

Introduction

This document lists changes made to the MultiView 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.core.multiview > 1.20

Changes by affected class

org.netbeans.core.spi.multiview.text.MultiViewEditorElement

org.netbeans.core.spi.multiview.MultiViewElement

org.netbeans.core.spi.multiview.MultiViewFactory

org.netbeans.core.api.multiview.MultiViewHandler

org.netbeans.core.api.multiview.MultiViews

org.netbeans.core.spi.multiview.SourceViewMarker


Details of all changes by API and date


MultiView API

Add/Remove MultiView elements to an existing MultiView TopComponent at runtime.

Dec 5 '13; API spec. version: 1.38; affected top-level classes: MultiViewHandler; made by: saubrecht; issues: #239088
It is possible to add/remove multiview elements at runtime.

Tab switching action in popup

Jul 18 '11; API spec. version: 1.25; made by: jtulach; issues: #199545
Toolbar can be hidden completely. To compensate that new tab switching action is available in popup of multi view components by default.

MultiViews.create for MIME type

Jun 1 '11; API spec. version: 1.24; affected top-level classes: MultiViews; made by: jtulach; issues: #196810
New factory methods to create multiview components for a given mime type.

MultiView SPI

Validate icons

Dec 9 '11; API spec. version: 1.28; affected top-level classes: MultiViewElement; made by: jtulach; issues: #204174
The processor for MultiViewElement.Registration now checks validity of provided iconBase (not on JDK6 due to bug in javac). Also the attribute was made optional.
Compatibility: A code specifying icon that does not exist may no longer compile.
Binary-compatible

@MultiViewElement.Registration

Jun 1 '11; API spec. version: 1.24; affected top-level classes: MultiViewElement; made by: jtulach; issues: #196810
Declarative way to register MultiViewElement via Registration annotation.

Added marker interface SourceViewMarker to identify elements with sourcecode.

Sep 14 '07; API spec. version: 1.10; affected top-level classes: SourceViewMarker; made by: mkleint; issues: #68912
Adding a marker interface for MultiViewDescription instances that allows to identify them as containing source code. The associated MultiViewElement's visual representation is assumed to implement CloneableEditorSupport.Pane interface.

Added factory methods to create multiview component

May 4 '04; API spec. version: 1.1; affected top-level classes: MultiViewFactory; made by: mkleint; issues: #42646
Additional factory methods to MultiViewFactory added: createCloneableMultiView() The existing createMultiView() is now guaranteed not to return CloneableTopComponent instance. Please note that editors can only be embedded in cloneanle multiview component.

MultiView Text SPI

MultiViewEditorElement

Jun 1 '11; API spec. version: 1.24; affected top-level classes: MultiViewEditorElement; made by: jtulach; issues: #196810
Common support class for integrating multi view and text infrastructure.

Uncategorized changes

MultiView TopComponent spliting

Apr 17 '13; API spec. version: 1.35; made by: theofanis; issues: #228448
Should a MultiViewElement allow spliting? Some applications may need that, some don't. There is a branding API to control such behavior now.