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
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

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

  




 

 


Eclipse Platform
Release 3.5

org.eclipse.jface.text.presentation
Interface IPresentationReconciler

All Known Implementing Classes:
PresentationReconciler

public interface IPresentationReconciler

An IPresentationReconciler defines and maintains the representation of a text viewer's document in the presence of changes applied to the document. An IPresentationReconciler is a ITextViewer add-on.

The presentation reconciler keeps track of changes applied to the text viewer. It sends each change to presentation damagers which are registered for the content types of the regions in which the change occurred. The presentation reconciler passes the computed damage to presentation repairer which construct text presentations. When applied to the presentation reconciler's text viewer, those text presentations bring the document's presentation in sync with the document's content and thus repair the damage. A presentation damager is expected to return damage which is a valid input for a presentation repairer registered for the same content type as the damager.

A presentation reconciler should always be configured with a pair of damager/repairer strategies. I.e. for each damager there should be a corresponding repairer.

The interface may be implemented by clients. Clients may use PresentationReconciler as the standard implementation of this interface.

In order to provided backward compatibility for clients of IPresentationReconciler, extension interfaces are used to provide a means of evolution. The following extension interface exists:

See Also:
IPresentationReconcilerExtension, ITextViewer, IPresentationDamager, IPresentationRepairer, TextPresentation

Method Summary
  IPresentationDamager getDamager ( String contentType)
          Returns the presentation damager registered with this presentation reconciler for the specified content type.
  IPresentationRepairer getRepairer ( String contentType)
          Returns the presentation repairer registered with this presentation reconciler for the specified content type.
 void install ( ITextViewer viewer)
          Installs this presentation reconciler on the given text viewer.
 void uninstall ()
          Removes the reconciler from the text viewer it has previously been installed on.
 

Method Detail

install

void install(
ITextViewer viewer)
Installs this presentation reconciler on the given text viewer. After this method has been finished, the reconciler is operational. I.e., it works without requesting further client actions until uninstall is called.

The install and uninstall methods must be called in sequence; i.e. repeatedly calling install without calling uninstall may throw an exception.

Parameters:
viewer - the viewer on which this presentation reconciler is installed

uninstall

void uninstall()
Removes the reconciler from the text viewer it has previously been installed on.


getDamager

IPresentationDamager getDamager(
String contentType)
Returns the presentation damager registered with this presentation reconciler for the specified content type.

Parameters:
contentType - the content type for which to determine the damager
Returns:
the presentation damager registered for the given content type, or null if there is no damager

getRepairer

IPresentationRepairer getRepairer(
String contentType)
Returns the presentation repairer registered with this presentation reconciler for the specified content type.

Parameters:
contentType - the content type for which to determine the repairer
Returns:
the presentation repairer registered for the given content type, or null if there is no repairer

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