Class LinkedModeModel
LinkedPositionGroup
s. Once installed, the model
propagates any changes to a position to all its siblings in the same position
group.
Setting up a model consists of first adding
LinkedPositionGroup
s to it, and then installing the
model by either calling forceInstall()
or
tryInstall()
. After installing the model, it becomes
sealed and no more groups may be added.
If a document change occurs that would modify more than one position
group or that would invalidate the disjointness requirement of the positions,
the model is torn down and all positions are deleted. The same happens
upon calling exit(int)
.
Nesting
A LinkedModeModel
may be nested into another model. This
happens when installing a model the positions of which all fit into a
single position in a parent model that has previously been installed on
the same document(s).
Clients may instantiate instances of this class.
- Since:
- 3.0
- Restriction:
- This class is not intended to be subclassed by clients.
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
addGroup
(LinkedPositionGroup group) Adds a position group to thisLinkedModeModel
.void
addLinkingListener
(ILinkedModeListener listener) Addslistener
to the set of listeners that are informed upon state changes.boolean
anyPositionContains
(int offset) Returns whether an offset is contained by any position in this model.static void
closeAllModels
(IDocument document) Cancels any linked mode model on the specified document.void
exit
(int flags) Causes this model to exit.findPosition
(LinkedPosition toFind) Finds the position in this model that is closest aftertoFind
.void
Installs this model, which includes registering as document listener on all involved documents and storing global information about this model.getGroupForPosition
(Position position) Returns the linked position group that containsposition
, ornull
ifposition
is not contained in any group within this model.static LinkedModeModel
Returns the model currently active ondocument
atoffset
, ornull
if there is none.Returns the positions in this model that have a tab stop, in the order they were added.static boolean
hasInstalledModel
(IDocument document) Checks whether there is already a model installed ondocument
.static boolean
hasInstalledModel
(IDocument[] documents) Checks whether there is already a linked mode model installed on any of thedocuments
.boolean
isNested()
Returns whether this model is nested.void
removeLinkingListener
(ILinkedModeListener listener) Removeslistener
from the set of listeners that are informed upon state changes.void
stopForwarding
(int flags) Causes this model to stop forwarding updates.boolean
Installs this model, which includes registering as document listener on all involved documents and storing global information about this model.
-
Constructor Details
-
LinkedModeModel
public LinkedModeModel()Creates a new model.- Since:
- 3.1
-
-
Method Details
-
hasInstalledModel
Checks whether there is already a model installed ondocument
.- Parameters:
document
- theIDocument
of interest- Returns:
true
if there is an existing model,false
otherwise
-
hasInstalledModel
Checks whether there is already a linked mode model installed on any of thedocuments
.- Parameters:
documents
- theIDocument
s of interest- Returns:
true
if there is an existing model,false
otherwise
-
closeAllModels
Cancels any linked mode model on the specified document. If there is no model, nothing happens.- Parameters:
document
- the document whoseLinkedModeModel
should be canceled
-
getModel
Returns the model currently active ondocument
atoffset
, ornull
if there is none.- Parameters:
document
- the document for which the caller asks for a modeloffset
- the offset intodocument
, as there may be several models on a document- Returns:
- the model currently active on
document
, ornull
-
exit
public void exit(int flags) Causes this model to exit. Called either if an illegal document change is detected, or by the UI.- Parameters:
flags
- the exit flags as defined inILinkedModeListener
-
stopForwarding
public void stopForwarding(int flags) Causes this model to stop forwarding updates. The positions are not unregistered however, which will only happen whenexit
is called, or after the next document change.- Parameters:
flags
- the exit flags as defined inILinkedModeListener
- Since:
- 3.1
-
addGroup
Adds a position group to thisLinkedModeModel
. This method may not be called if the model has been installed. Also, if a UI has been set up for this model, it may not pick up groups added afterwards.If the positions in
group
conflict with any other group in this model, aBadLocationException
is thrown. Also, if this model is nested inside another one, all positions in all groups of the child model have to reside within a single position in the parent model, otherwise aBadLocationException
is thrown.If
group
already exists, nothing happens.- Parameters:
group
- the group to be added to this model- Throws:
BadLocationException
- if the group conflicts with the other groups in this model or violates the nesting requirements.IllegalStateException
- if the method is called when the model is already sealed
-
forceInstall
Installs this model, which includes registering as document listener on all involved documents and storing global information about this model. Any conflicting model already present will be closed.If an exception is thrown, the installation failed and the model is unusable.
- Throws:
BadLocationException
- if some of the positions of this model were not valid positions on their respective documents
-
tryInstall
Installs this model, which includes registering as document listener on all involved documents and storing global information about this model. If there is another model installed on the document(s) targeted by the receiver that conflicts with it, installation may fail.The return value states whether installation was successful; if not, the model is not installed and will not work.
- Returns:
true
if installation was successful,false
otherwise- Throws:
BadLocationException
- if some of the positions of this model were not valid positions on their respective documents
-
isNested
public boolean isNested()Returns whether this model is nested.This method is part of the private protocol between
LinkedModeUI
andLinkedModeModel
.- Returns:
true
if this model is nested,false
otherwise
-
getTabStopSequence
Returns the positions in this model that have a tab stop, in the order they were added.This method is part of the private protocol between
LinkedModeUI
andLinkedModeModel
.- Returns:
- the positions in this model that have a tab stop, in the order they were added
-
addLinkingListener
Addslistener
to the set of listeners that are informed upon state changes.- Parameters:
listener
- the new listener
-
removeLinkingListener
Removeslistener
from the set of listeners that are informed upon state changes.- Parameters:
listener
- the new listener
-
findPosition
Finds the position in this model that is closest aftertoFind
.toFind
needs not be a position in this model and serves merely as an offset.This method part of the private protocol between
LinkedModeUI
andLinkedModeModel
.- Parameters:
toFind
- the position to search from- Returns:
- the closest position in the same document as
toFind
after the offset oftoFind
, ornull
-
anyPositionContains
public boolean anyPositionContains(int offset) Returns whether an offset is contained by any position in this model.- Parameters:
offset
- the offset to check- Returns:
true
ifoffset
is included by any position (seeLinkedPosition.includes(int)
) in this model,false
otherwise
-
getGroupForPosition
Returns the linked position group that containsposition
, ornull
ifposition
is not contained in any group within this model. Group containment is tested by callinggroup.contains(position)
for everygroup
in this model.This method part of the private protocol between
LinkedModeUI
andLinkedModeModel
.- Parameters:
position
- the position the group of which is requested- Returns:
- the first group in this model for which
group.contains(position)
returnstrue
, ornull
if no group containsposition
-