|
78
|
1 /*******************************************************************************
|
|
|
2 * Copyright (c) 2006, 2007 IBM Corporation and others.
|
|
|
3 * All rights reserved. This program and the accompanying materials
|
|
|
4 * are made available under the terms of the Eclipse Public License v1.0
|
|
|
5 * which accompanies this distribution, and is available at
|
|
|
6 * http://www.eclipse.org/legal/epl-v10.html
|
|
|
7 *
|
|
|
8 * Contributors:
|
|
|
9 * IBM Corporation - initial API and implementation
|
|
|
10 *******************************************************************************/
|
|
|
11
|
|
|
12 module org.eclipse.core.internal.databinding.observable.tree.IOrderedTreeProvider;
|
|
|
13
|
|
|
14 import java.lang.all;
|
|
|
15
|
|
|
16 import org.eclipse.core.databinding.observable.Realm;
|
|
|
17 import org.eclipse.core.databinding.observable.list.IObservableList;
|
|
|
18
|
|
|
19 /**
|
|
|
20 * Objects that implement this interface are capable of describing a tree by
|
|
|
21 * returning the list of children of any given element in the tree.
|
|
|
22 *
|
|
|
23 * @since 3.3
|
|
|
24 */
|
|
|
25 public interface IOrderedTreeProvider {
|
|
|
26 /**
|
|
|
27 * Returns the children of the given element, or null if the element is a
|
|
|
28 * leaf node. The caller of this method is expected to dispose the result
|
|
|
29 * list when it is no longer needed.
|
|
|
30 *
|
|
|
31 * @param element
|
|
|
32 * the tree path of the element to query
|
|
|
33 * @return the children of the given element, or null if the element is a
|
|
|
34 * leaf node
|
|
|
35 */
|
|
|
36 IObservableList createChildList(TreePath element);
|
|
|
37
|
|
|
38 /**
|
|
|
39 * @return the realm shared by all child lists
|
|
|
40 */
|
|
|
41 Realm getRealm();
|
|
|
42 }
|
