Context View Bindings

Identifier:

org.eclipse.debug.ui.contextViewBindings

Since:

3.0

Description:

This extension point provides a mechanism for associating a view with a context identifier. When a context is activated by the Debug view, views associated with it (and also views associated with any parent contexts) are opened, closed, or activated. Contributors have the option to override the automatic open and close behavior.

Configuration Markup:

<!ELEMENT extension (contextViewBinding* , perspective*)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

point - a fully qualified identifier of the target extension point
id - an optional identifier of the extension instance
name - an optional name of the extension instance

<!ELEMENT contextViewBinding EMPTY>

<!ATTLIST contextViewBinding

contextId IDREF #REQUIRED

viewId IDREF #REQUIRED

autoOpen (true | false)

autoClose (true | false) >

contextId - Specifies the context identifier that this binding is for.
viewId - Specifies the identifier of the view which should be associated with the specified context. When the specified context is enabled, this view will be automatically brought to the front. When elements are selected in the Debug view, contexts associated with those elements (as specified by extensions of the debugModelContextBindings extension point) are automatically enabled. Note that this only occurs in perspectives which are specified by the perspective elements, or for which the user has requested "automatic view management" via the preferences.
autoOpen - Specifies whether the view should be automatically opened when the given context is enabled. If unspecified, the value of this attribute is true. If this attribute is specified false, the view will not be automatically opened, but it will still be brought to the front if it is open when the given context is enabled. Clients are intended to specify false to avoid cluttering the perspective with views that are used infrequently.
autoClose - Clients are not intended to specify this attribute except in rare cases. Specifies whether the view should be automatically closed when the given context is disabled (this occurs when all debug targets that contained the specified context have terminated). When unspecified, the value of this attribute is true. This attribute should only be specified false in the unlikely case that a debugging view must remain open even when the user is not debugging.

<!ELEMENT perspective EMPTY>

<!ATTLIST perspective

perspectiveId IDREF #IMPLIED>

Specifies a perspective in which the view management will be enabled (since 3.5).

perspectiveId - Identifier of the perspective in which to enable view management.

Examples:

The following is an example of a context view binding contribution:


<extension
      point="org.eclipse.debug.ui.contextViewBindings">
   <contextViewBinding
         contextId="com.example.mydebugger.debugging"
         viewId="com.example.view"
         autoOpen="true"
         autoClose="false">
   </contextViewBinding>
</extension>

In the above example, when a context with the specified identifier is activated by the Debug view, the given view will be automatically opened. When a context which is bound to a different debug model is activated that isn't associated with the view, the view will not be automatically closed.

API Information:

Since 3.5 , the perspective element can be used to spectify a perspectives in which to enable view management. A product or the user override this setting, by specifying the org.eclipse.debug.ui.manage_view_perspectives preference with a comma-delimited set of perspective IDs.

Copyright (c) 2003, 2005 IBM Corporation and others.
This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-v20.html/ SPDX-License-Identifier: EPL-2.0