Eclipse Platform
Release 3.0

org.eclipse.ui.presentations
Interface IStackPresentationSite


public interface IStackPresentationSite

Represents the main interface between a StackPresentation and the workbench. Not intended to be implemented by clients.

Since:
3.0

Field Summary
static int STATE_MAXIMIZED
           
static int STATE_MINIMIZED
           
static int STATE_RESTORED
           
 
Method Summary
 void addSystemActions(IMenuManager menuManager)
          Adds system actions to the given menu manager.
 void close(IPresentablePart[] toClose)
          Closes the given set of parts.
 void dragStart(IPresentablePart beingDragged, Point initialPosition, boolean keyboard)
          Begins dragging the given part
 void dragStart(Point initialPosition, boolean keyboard)
          Begins dragging the entire stack of parts
 IPresentablePart getSelectedPart()
          Returns the currently selected part or null if the stack is empty
 int getState()
          Returns the current state of the site (one of the STATE_* constants)
 boolean isCloseable(IPresentablePart toClose)
          Returns true iff this site will allow the given part to be closed
 boolean isPartMoveable(IPresentablePart toMove)
          Returns true iff the given part can be dragged.
 boolean isStackMoveable()
          Returns true iff this entire stack can be dragged
 void selectPart(IPresentablePart toSelect)
          Makes the given part active
 void setState(int newState)
          Sets the state of the container.
 boolean supportsState(int state)
          Returns true iff the site supports the given state
 

Field Detail

STATE_MINIMIZED

public static final int STATE_MINIMIZED
See Also:
Constant Field Values

STATE_MAXIMIZED

public static final int STATE_MAXIMIZED
See Also:
Constant Field Values

STATE_RESTORED

public static final int STATE_RESTORED
See Also:
Constant Field Values
Method Detail

setState

public void setState(int newState)
Sets the state of the container. Called by the presentation when the user causes the the container to be minimized, maximized, etc.

Parameters:
newState - one of the STATE_* constants

getState

public int getState()
Returns the current state of the site (one of the STATE_* constants)

Returns:
the current state of the site (one of the STATE_* constants)

supportsState

public boolean supportsState(int state)
Returns true iff the site supports the given state

Parameters:
state - one of the STATE_* constants, above
Returns:
true iff the site supports the given state

dragStart

public void dragStart(IPresentablePart beingDragged,
                      Point initialPosition,
                      boolean keyboard)
Begins dragging the given part

Parameters:
beingDragged - the part to drag (not null)
initialPosition - the mouse position at the time of the initial mousedown (display coordinates, not null)
keyboard - true iff the drag was initiated via mouse dragging, and false if the drag may be using the keyboard

close

public void close(IPresentablePart[] toClose)
Closes the given set of parts.

Parameters:
toClose - the set of parts to close (Not null. All of the entries must be non-null)

dragStart

public void dragStart(Point initialPosition,
                      boolean keyboard)
Begins dragging the entire stack of parts

Parameters:
initialPosition - the mouse position at the time of the initial mousedown (display coordinates, not null)
keyboard - true iff the drag was initiated via mouse dragging, and false if the drag may be using the keyboard

isCloseable

public boolean isCloseable(IPresentablePart toClose)
Returns true iff this site will allow the given part to be closed

Parameters:
toClose - part to test (not null)
Returns:
true iff the part may be closed

isPartMoveable

public boolean isPartMoveable(IPresentablePart toMove)
Returns true iff the given part can be dragged. If this returns false, the given part should not trigger a drag.

Parameters:
toMove - part to test (not null)
Returns:
true iff this part is a valid drag source

isStackMoveable

public boolean isStackMoveable()
Returns true iff this entire stack can be dragged

Returns:
tre iff the stack can be dragged

selectPart

public void selectPart(IPresentablePart toSelect)
Makes the given part active

Parameters:
toSelect -

getSelectedPart

public IPresentablePart getSelectedPart()
Returns the currently selected part or null if the stack is empty

Returns:
the currently selected part or null if the stack is empty

addSystemActions

public void addSystemActions(IMenuManager menuManager)
Adds system actions to the given menu manager. The site may make use of the following group ids: The presentation can control the insertion position by creating these group IDs where appropriate.

Parameters:
menuManager - the menu manager to populate

Eclipse Platform
Release 3.0

Guidelines for using Eclipse APIs.

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