org.eclipse.contribution.visualiser.interfaces
Interface IContentProvider

All Known Implementing Classes:
JDTContentProvider, SimpleContentProvider

public interface IContentProvider

The implementation of this interface is responsible for returning information about the bars that appear in the VSisualiser view. The related implementation of IMarkupProvider provides the information about the colored stripes on the bars. A simple implementation is provided in SimpleContentProvider - this contains basic implementations of some of the common features of a content provider In particular, it manages groups/members automatically. Important: The lists returned from the various get methods should either be lists of classes implementing IGroup or classes implementing IMember. Simple implementations of IGroup and IMember are SimpleGroup and SimpleMember.


Method Summary
 void activate()
          Called when this provider is selected.
 void deactivate()
          Called when this provider is currently active and another provider is selected.
 java.util.List getAllGroups()
          Return a list of all groups that the provider knows about.
 java.util.List getAllMembers()
          Return a list of all members in all groups the provider knows about.
 java.util.List getAllMembers(IGroup group)
          Return a list of all members in a group.
 org.eclipse.jface.resource.ImageDescriptor getGroupViewIcon()
          Called when switching to this content provider to get the icon used in the Visualiser view for Group view.
 org.eclipse.jface.resource.ImageDescriptor getMemberViewIcon()
          Called when switching to this content provider to get the icon used in the Visualiser view for Member view.
 void initialise()
          Called on Visualiser startup, to get the provider ready.
 boolean processMouseclick(IMember member, boolean markupWasClicked, int buttonClicked)
          Called when the user clicks on a member in the Visualiser - the information passed is - The full name of the member, e.g.
 

Method Detail

getAllGroups

public java.util.List getAllGroups()
Return a list of all groups that the provider knows about.

Returns:
List of IGroups

getAllMembers

public java.util.List getAllMembers(IGroup group)
Return a list of all members in a group.

Returns:
List of IMembers

getAllMembers

public java.util.List getAllMembers()
Return a list of all members in all groups the provider knows about.


initialise

public void initialise()
Called on Visualiser startup, to get the provider ready.


processMouseclick

public boolean processMouseclick(IMember member,
                                 boolean markupWasClicked,
                                 int buttonClicked)
Called when the user clicks on a member in the Visualiser - the information passed is - The full name of the member, e.g. "ABC.B" - Whether the click was actually on a colored area (stripe) in the member - The buttons pressed (1 is LH button, 3 is RH button) The return value is whether the VSisualiser should take its normal action on this click. The normal action is that on a left hand mouse click, the visualiser subselects the clicked member (if in the group view, it swaps to a member view of the members in that group). If the right hand mouse button is clicked, it returns to the previous visualisation. Remember: The markup provider is called with a similar method 'processMouseClick()' if the boolean markupWasClicked is true. This call to the markup provider will occur regardless of whether true or false is returned here.


getMemberViewIcon

public org.eclipse.jface.resource.ImageDescriptor getMemberViewIcon()
Called when switching to this content provider to get the icon used in the Visualiser view for Member view. If null is returned default icons are used.

Returns:
image to be used as member view icon

getGroupViewIcon

public org.eclipse.jface.resource.ImageDescriptor getGroupViewIcon()
Called when switching to this content provider to get the icon used in the Visualiser view for Group view. If null is returned default icons are used.

Returns:
image to be used as group view icon, or null if default is required

activate

public void activate()
Called when this provider is selected.


deactivate

public void deactivate()
Called when this provider is currently active and another provider is selected.