Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Mail Systems
Eclipse Documentation

How To Guides
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Problem Solutions
Privacy Policy




Eclipse Plug-in Developer Guide
Previous Page Home Next Page

Eclipse Platform
Release 3.5

Package org.eclipse.debug.ui.console

Provides a set of interfaces and classes for rendering and annotating text in the debug console.


Interface Summary
IConsole A console that displays output and writes input to a process.
IConsoleColorProvider Provides coloring for a console document.
IConsoleHyperlink Deprecated. replaced by org.eclipse.ui.console.IHyperlink
IConsoleLineTracker Notified of lines appended to the console.
IConsoleLineTrackerExtension An extension to the console line tracker interface that console line trackers may implement to be notified when output from the console is complete.

Class Summary
ConsoleColorProvider Default console color provider for a process.
FileLink A hyperlink that opens a file in a text editor and selects a range of text.

Package org.eclipse.debug.ui.console Description

Provides a set of interfaces and classes for rendering and annotating text in the debug console.

Package Specification

This package provides a set interfaces and classses for coloring streams of text, parsing output, and creating hyperlinks in the debug console.

Coloring Console Output

A process may have standard input, output, and error streams associated with, as defined by org.eclipse.debug.core.model.IProcess and org.eclipse.debug.core.model.IStreamsProxy. When a process is registered with the debug plug-in, a document is created to display the output of that process, and to provide input to the process via the keyboard. A console document is displayed in the Console View. By default, the output, error, and input streams are rendered in colors specified by user preferences.

A client can specialize coloring for a process's streams by defining an IConsoleColorProvider extension (using the org.eclipse.debug.ui.consoleColorProviders extension point). A console color provider is defined for a type of process. A process type is defined by the creator of a process, and is specified on an IProcess via the ATTR_PROCESS_TYPE attribute. When a process is registered with the debug plug-in, a console color provider associated with the process type is instantiated, and connected to the process (IProcess) and a console (IConsole). The console color provider then connects its streams to the console (IConsole), via the console methods connect(IStreamsProxy) and connect(IStreamMonitor, String). The color provider will then be consulted to provide a color when the console needs to render output from a stream.

Parsing Console Output

A client can be notified of output appended to a process's console document, by defining an IConsoleLineTracker extension (using the org.eclipse.debug.ui.consoleLineTrackers extension point). A console line tracker is defined for a type of process. When a process is registered with the debug plug-in, a console document is created for that process, and output is appended to that document. As output is written to the document, each console line tracker extension defined for that process type is notified of output, line by line. This support is most commonly used to annotate output with hyperlinks.

Eclipse Platform
Release 3.5

Guidelines for using Eclipse APIs.

Copyright (c) Eclipse contributors and others 2000, 2008. All rights reserved.

  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire