Eclipse Platform
Release 3.2

org.eclipse.ui.navigator
Interface INavigatorViewerDescriptor


public interface INavigatorViewerDescriptor

Provides a basic metadata about the abstract viewer for a particular content service.

This interface is not intended to be implemented by clients.

Since:
3.2

Field Summary
static String PROP_HIDE_AVAILABLE_CUSTOMIZATIONS_DIALOG
          "org.eclipse.ui.navigator.hideAvailableCustomizationsDialog" (boolean): True indicates the entire "Available Customizations" dialog should not be available for the user (defaults to false).
static String PROP_HIDE_AVAILABLE_EXT_TAB
          "org.eclipse.ui.navigator.hideAvailableExtensionsTab" (boolean): True indicates the "Available Extensions" tab in the "Available Customizations" dialog should not be available for the user (defaults to false).
static String PROP_HIDE_COLLAPSE_ALL_ACTION
          "org.eclipse.ui.navigator.hideCollapseAllAction" (boolean): True indicates the "Collapse All" button should not be available for the user (defaults to false).
static String PROP_HIDE_LINK_WITH_EDITOR_ACTION
          "org.eclipse.ui.navigator.hideLinkWithEditorAction" (boolean): True indicates the "Link With Editor" action should not be available for the user (defaults to false).
 
Method Summary
 boolean allowsPlatformContributionsToContextMenu()
          Returns true by default.
 boolean getBooleanConfigProperty(String aPropertyName)
           
 MenuInsertionPoint[] getCustomInsertionPoints()
          Custom insertion points are declared through a nested 'popupMenu' element in the org.eclipse.ui.navigator.viewer extension point.
 String getPopupMenuId()
          The default value of the popup menu id is the viewer id.
 String getStringConfigProperty(String aPropertyName)
           
 String getViewerId()
          Returns the id of the viewer targeted by this extension.
 boolean hasOverriddenRootExtensions()
          Returns true if there exists at least one matching viewerContentBinding which declares isRoot as true.
 boolean isRootExtension(String aContentExtensionId)
          Returns true if the content extension of the given id matches a viewerContentBinding extension that declares isRoot as true.
 boolean isVisibleActionExtension(String anActionExtensionId)
          Returns true if the action extension of the given id is 'visible'.
 boolean isVisibleContentExtension(String aContentExtensionId)
          Returns true if the content extension of the given id is 'visible'.
 

Field Detail

PROP_HIDE_AVAILABLE_EXT_TAB

public static final String PROP_HIDE_AVAILABLE_EXT_TAB
"org.eclipse.ui.navigator.hideAvailableExtensionsTab" (boolean): True indicates the "Available Extensions" tab in the "Available Customizations" dialog should not be available for the user (defaults to false).

See Also:
Constant Field Values

PROP_HIDE_AVAILABLE_CUSTOMIZATIONS_DIALOG

public static final String PROP_HIDE_AVAILABLE_CUSTOMIZATIONS_DIALOG
"org.eclipse.ui.navigator.hideAvailableCustomizationsDialog" (boolean): True indicates the entire "Available Customizations" dialog should not be available for the user (defaults to false).

See Also:
Constant Field Values

PROP_HIDE_COLLAPSE_ALL_ACTION

public static final String PROP_HIDE_COLLAPSE_ALL_ACTION
"org.eclipse.ui.navigator.hideCollapseAllAction" (boolean): True indicates the "Collapse All" button should not be available for the user (defaults to false).

See Also:
Constant Field Values

PROP_HIDE_LINK_WITH_EDITOR_ACTION

public static final String PROP_HIDE_LINK_WITH_EDITOR_ACTION
"org.eclipse.ui.navigator.hideLinkWithEditorAction" (boolean): True indicates the "Link With Editor" action should not be available for the user (defaults to false).

See Also:
Constant Field Values
Method Detail

getViewerId

public String getViewerId()
Returns the id of the viewer targeted by this extension.

Returns:
the id of the viewer targeted by this extension.

getPopupMenuId

public String getPopupMenuId()
The default value of the popup menu id is the viewer id. Clients may override this value using a navigatorConfiguration extension.

Returns:
The id of the context menu of the viewer.

isVisibleContentExtension

public boolean isVisibleContentExtension(String aContentExtensionId)
Returns true if the content extension of the given id is 'visible'. A content extension is 'visible' if it matches a viewerContentBinding for the given viewer id.

Parameters:
aContentExtensionId - The id to query
Returns:
True if the content extension matches a viewerContentBinding for the viewer id of this descriptor.

isVisibleActionExtension

public boolean isVisibleActionExtension(String anActionExtensionId)
Returns true if the action extension of the given id is 'visible'. An action extension is 'visible' if it matches a viewerActionBinding for the given viewer id.

Parameters:
anActionExtensionId - The id to query
Returns:
True if the action extension matches a viewerActionBinding for the viewer id of this descriptor.

isRootExtension

public boolean isRootExtension(String aContentExtensionId)
Returns true if the content extension of the given id matches a viewerContentBinding extension that declares isRoot as true.

Parameters:
aContentExtensionId - The id to query
Returns:
True if the content extension matches a viewerContentBinding which declares 'isRoot' as true for the viewer id of this descriptor.

hasOverriddenRootExtensions

public boolean hasOverriddenRootExtensions()
Returns true if there exists at least one matching viewerContentBinding which declares isRoot as true. This behavior will override the default enablement for the viewer root.

Returns:
True if there exists a matching viewerContentBinding which declares isRoot as true.

allowsPlatformContributionsToContextMenu

public boolean allowsPlatformContributionsToContextMenu()
Returns true by default. A true value indicates that object and view contributions should be supported by the popup menu of any viewer described by this viewer descriptor. The value may be overridden from the <popupMenu /> child element of the <viewer /> element in the org.eclipse.ui.navigator.viewer extension point.

Returns:
True if object/view contributions should be allowed or False otherwise.

getCustomInsertionPoints

public MenuInsertionPoint[] getCustomInsertionPoints()
Custom insertion points are declared through a nested 'popupMenu' element in the org.eclipse.ui.navigator.viewer extension point. Each insertion point represents either a Separator or GroupMarker in the context menu of the viewer.

Returns:
The set of custom insertion points, if any. A null list indicates the default set (as defined by NavigatorActionService) should be used. An empty list indicates there are no declarative insertion points.

getStringConfigProperty

public String getStringConfigProperty(String aPropertyName)
Parameters:
aPropertyName - A property name corresponding to a configuration option from org.eclipse.ui.navigator.viewer
Returns:
The unmodified string value returned from the extension (null is a possible return value).

getBooleanConfigProperty

public boolean getBooleanConfigProperty(String aPropertyName)
Parameters:
aPropertyName - A property name corresponding to a configuration option from org.eclipse.ui.navigator.viewer
Returns:
The boolean value returned from the extension (null is a possible return value).

Eclipse Platform
Release 3.2

Guidelines for using Eclipse APIs.

Copyright (c) IBM Corp. and others 2000, 2006. All rights reserved.