Eclipse Platform
Release 3.1

org.eclipse.ui.console
Interface IConsoleManager


public interface IConsoleManager

The console manager manages registered consoles.

Clients are not intended to implement this interface.

Since:
3.0

Method Summary
 void addConsoleListener(IConsoleListener listener)
          Registers the given listener for console notifications.
 void addConsoles(IConsole[] consoles)
          Adds the given consoles to the console manager.
 IPatternMatchListener[] createPatternMatchListeners(IConsole console)
          Creates and returns a collection of new pattern match listeners enabled for the given console.
 IConsole[] getConsoles()
          Returns a collection of consoles registered with the console manager.
 void refresh(IConsole console)
          Requests a redraw of any visible console page containing the specified console.
 void removeConsoleListener(IConsoleListener listener)
          Deregisters the given listener for console notifications.
 void removeConsoles(IConsole[] consoles)
          Removes the given consoles from the console manager.
 void showConsoleView(IConsole console)
          Opens the console view and displays given the console.
 void warnOfContentChange(IConsole console)
          Warns that the content of the given console has changed in all console views.
 

Method Detail

addConsoleListener

public void addConsoleListener(IConsoleListener listener)
Registers the given listener for console notifications. Has no effect if an identical listener is already registered.

Parameters:
listener - listener to register

removeConsoleListener

public void removeConsoleListener(IConsoleListener listener)
Deregisters the given listener for console notifications. Has no effect if an identical listener is not already registered.

Parameters:
listener - listener to deregister

addConsoles

public void addConsoles(IConsole[] consoles)
Adds the given consoles to the console manager. Has no effect for equivalent consoles already registered. The consoles will be added to any existing console views.

Parameters:
consoles - consoles to add

removeConsoles

public void removeConsoles(IConsole[] consoles)
Removes the given consoles from the console manager. If the consoles are being displayed in any console views, the associated pages will be removed and disposed.

Parameters:
consoles - consoles to remove

getConsoles

public IConsole[] getConsoles()
Returns a collection of consoles registered with the console manager.

Returns:
a collection of consoles registered with the console manager

showConsoleView

public void showConsoleView(IConsole console)
Opens the console view and displays given the console. If the view is already open, it is brought to the front unless the view is pinned on a console other than the given console. Has no effect if the given console is not currently registered.

Parameters:
console - console to display

warnOfContentChange

public void warnOfContentChange(IConsole console)
Warns that the content of the given console has changed in all console views. Has no effect if the given console is not currently registered.

Parameters:
console - the console that has changed

createPatternMatchListeners

public IPatternMatchListener[] createPatternMatchListeners(IConsole console)
Creates and returns a collection of new pattern match listeners enabled for the given console. The pattern match listeners are new instances, intended to be used in a new console. No methods on the participants have been called. Clients are responsible for connecting to and disconnecting from the pattern match listeners.

Console pattern match listeners are contributed via the org.eclipse.ui.console.consolePatternMatchListeners extension point.

Parameters:
console - the console for which pattern match listeners are requested
Returns:
a collection of new pattern match listeners
Since:
3.1
See Also:
IPatternMatchListener

refresh

public void refresh(IConsole console)
Requests a redraw of any visible console page containing the specified console.

Parameters:
console - the console to be refreshed
Since:
3.1

Eclipse Platform
Release 3.1

Guidelines for using Eclipse APIs.

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