mirrors/cdt
1
0
Fork 0
mirror of https://github.com/eclipse-cdt/cdt synced 2025-07-27 02:45:32 +02:00
Code Issues Wiki Activity

Further clarification (javadoc)

Browse source
This commit is contained in:
John Cortell 2009-10-06 01:32:19 +00:00
parent aefccd7002
commit 8aa547ee60
1 changed files with 13 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

24
dsf/org.eclipse.cdt.dsf.ui/src/org/eclipse/cdt/dsf/ui/viewmodel/IRootVMNode.java
View file

@ -36,25 +36,27 @@ public interface IRootVMNode extends IVMNode{
public boolean isDeltaEvent(Object rootObject, Object event); public boolean isDeltaEvent(Object rootObject, Object event);
/** /**
* The VM proxy calls this to produce the starting point for a delta. It is * The VM proxy calls this to produce the starting point for a delta, which
* a variant of * can be a single delta node or a chain of them. It is a variant of
* {@link IVMNode#buildDelta(Object, ViewModelDelta, org.eclipse.cdt.dsf.concurrent.RequestMonitor)} * {@link IVMNode#buildDelta(Object, ViewModelDelta, org.eclipse.cdt.dsf.concurrent.RequestMonitor)}
* that does not require a parent delta object since we will return the root * that does not require a parent delta object since we will return the root
* portion of the delta's tree. That does not necessarily mean, though, that * section of the final delta's tree. The root model element in our
* the root model element in our associated viewer is of our type (IVMNode). * associated viewer is not necessarily of our type (IVMNode). A VMProvider
* A VMProvider may be representing only a lower subset of the content in * may be representing only a lower sub-tree of the content in the viewer
* the viewer (the other content may be coming from other VM Providers * (the other content may be coming from other VM Providers and/or sources
* and/or sources outside DSF altogether). In that case, this method should * outside DSF altogether). In that case, this method should create a chain
* return a chain of delta nodes that reflect the path to the VMProvider's * of delta nodes that reflect the path to the VMProvider's root element,
* root element, since deltas sent to the viewer must take into account the * since deltas sent to the viewer must take into account the entire model.
* entire model. * However, the specific delta node returned should be the one associated
* with [rootObject]--i.e., the last node in the chain.
* *
* @param rootObject * @param rootObject
* the root model element being represented by our VMProvider * the root model element being represented by our VMProvider
* @param event * @param event
* event being processed * event being processed
* @param rm * @param rm
* result notification, contains the root of the delta. * result notification, contains the delta for [rootObject], with
* parents if [rootObject] is not the root node of the viewer.
*/ */
public void createRootDelta(Object rootObject, Object event, DataRequestMonitor<VMDelta> rm); public void createRootDelta(Object rootObject, Object event, DataRequestMonitor<VMDelta> rm);
} }