BlueBerry
A modular, cross-platform, C++ application framework
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines
berry::ISelectionService Struct Reference

#include <berryISelectionService.h>

+ Inheritance diagram for berry::ISelectionService:

List of all members.

Classes

struct  SelectionEvents

Public Member Functions

virtual ~ISelectionService ()
virtual void AddSelectionListener (ISelectionListener::Pointer listener)=0
virtual void AddSelectionListener (const std::string &partId, ISelectionListener::Pointer listener)=0
virtual void AddPostSelectionListener (ISelectionListener::Pointer listener)=0
virtual void AddPostSelectionListener (const std::string &partId, ISelectionListener::Pointer listener)=0
virtual ISelection::ConstPointer GetSelection () const =0
virtual ISelection::ConstPointer GetSelection (const std::string &partId)=0
virtual void RemoveSelectionListener (ISelectionListener::Pointer listener)=0
virtual void RemoveSelectionListener (const std::string &partId, ISelectionListener::Pointer listener)=0
virtual void RemovePostSelectionListener (ISelectionListener::Pointer listener)=0
virtual void RemovePostSelectionListener (const std::string &partId, ISelectionListener::Pointer listener)=0

Detailed Description

A selection service tracks the selection within an object.

A listener that wants to be notified when the selection becomes null must implement the INullSelectionListener interface.

This interface is not intended to be implemented by clients.

See also:
org.blueberry.ui.ISelectionListener
org.blueberry.ui.INullSelectionListener

Definition at line 45 of file berryISelectionService.h.


Constructor & Destructor Documentation


Member Function Documentation

Adds the given post selection listener.It is equivalent to selection changed if the selection was triggered by the mouse but it has a delay if the selection is triggered by the keyboard arrows. Has no effect if an identical listener is already registered.

Note: Works only for StructuredViewer(s).

Parameters:
listenera selection listener

Implemented in berry::WorkbenchPage, and berry::AbstractSelectionService.

virtual void berry::ISelectionService::AddPostSelectionListener ( const std::string &  partId,
ISelectionListener::Pointer  listener 
) [pure virtual]

Adds a part-specific selection listener which is notified when selection changes in the part with the given id. This is independent of part activation - the part need not be active for notification to be sent.

When the part is created, the listener is passed the part's initial selection. When the part is disposed, the listener is passed a null selection, but only if the listener implements INullSelectionListener.

Note: This will not correctly track editor parts as each editor does not have a unique partId.

Parameters:
partIdthe id of the part to track
listenera selection listener
Since:
2.0

Implemented in berry::WorkbenchPage, and berry::AbstractSelectionService.

Adds the given selection listener. Has no effect if an identical listener is already registered.

Parameters:
listenera selection listener

Implemented in berry::WorkbenchPage, and berry::AbstractSelectionService.

virtual void berry::ISelectionService::AddSelectionListener ( const std::string &  partId,
ISelectionListener::Pointer  listener 
) [pure virtual]

Adds a part-specific selection listener which is notified when selection changes in the part with the given id. This is independent of part activation - the part need not be active for notification to be sent.

When the part is created, the listener is passed the part's initial selection. When the part is disposed, the listener is passed a null selection, but only if the listener implements INullSelectionListener.

Note: This will not correctly track editor parts as each editor does not have a unique partId.

Parameters:
partIdthe id of the part to track
listenera selection listener
Since:
2.0

Implemented in berry::WorkbenchPage, and berry::AbstractSelectionService.

Returns the current selection in the active part. If the selection in the active part is undefined (the active part has no selection provider) the result will be null.

Returns:
the current selection, or null if undefined

Implemented in berry::WorkbenchPage, and berry::AbstractSelectionService.

virtual ISelection::ConstPointer berry::ISelectionService::GetSelection ( const std::string &  partId) [pure virtual]

Returns the current selection in the part with the given id. If the part is not open, or if the selection in the active part is undefined (the active part has no selection provider) the result will be null.

Parameters:
partIdthe id of the part
Returns:
the current selection, or null if undefined
Since:
2.0

Implemented in berry::WorkbenchPage, and berry::AbstractSelectionService.

Removes the given post selection listener. Has no effect if an identical listener is not registered.

Parameters:
listenera selection listener

Implemented in berry::WorkbenchPage, and berry::AbstractSelectionService.

virtual void berry::ISelectionService::RemovePostSelectionListener ( const std::string &  partId,
ISelectionListener::Pointer  listener 
) [pure virtual]

Removes the given part-specific post selection listener. Has no effect if an identical listener is not registered for the given part id.

Parameters:
partIdthe id of the part to track
listenera selection listener
Since:
2.0

Implemented in berry::WorkbenchPage, and berry::AbstractSelectionService.

Removes the given selection listener. Has no effect if an identical listener is not registered.

Parameters:
listenera selection listener

Implemented in berry::WorkbenchPage, and berry::AbstractSelectionService.

virtual void berry::ISelectionService::RemoveSelectionListener ( const std::string &  partId,
ISelectionListener::Pointer  listener 
) [pure virtual]

Removes the given part-specific selection listener. Has no effect if an identical listener is not registered for the given part id.

Parameters:
partIdthe id of the part to track
listenera selection listener
Since:
2.0

Implemented in berry::WorkbenchPage, and berry::AbstractSelectionService.


The documentation for this struct was generated from the following files: