Org.simantics.browsing.ui - Revision history

Tuukka Lehtonen: /* Resource selection example */

2011-02-04T13:51:04Z

Resource selection example

← Older revision		Revision as of 13:51, 4 February 2011
Line 73:		Line 73:

	=== Resource selection example ===		=== Resource selection example ===

	<source lang="Java">		<source lang="Java">
	ISelectionProvider provider = (ISelectionProvider) explorer.getAdapter(ISelectionProvider.class);		ISelectionProvider provider = (ISelectionProvider) explorer.getAdapter(ISelectionProvider.class);
	if (provider != null) {		if (provider != null) {
	ISelection selection = provider.getSelection();		ISelection selection = provider.getSelection();

			// For single-selection browsers or assuming a single-selection on a multi-select browser
	Resource object = ISelectionUtils.getSinglePossibleKey(selection, SelectionHints.KEY_MAIN, Resource.class);		Resource object = ISelectionUtils.getSinglePossibleKey(selection, SelectionHints.KEY_MAIN, Resource.class);

			// For multi-selections
			List<Resource> objects = ISelectionUtils.getPossibleKeys(selection, SelectionHints.KEY_MAIN, Resource.class);
	}		}
	</source>		</source>

Tuukka Lehtonen: /* Basic Query hierarchy */

2010-10-30T20:30:39Z

Basic Query hierarchy

← Older revision		Revision as of 20:30, 30 October 2010
Line 61:		Line 61:

	=== Basic Query hierarchy ===		=== Basic Query hierarchy ===

			WARNING: IMAGE IS OUT OF DATE

	[[Image:Graph-explorer-queries.png\|center\|thumb\|700px\|alt=Visual query order representation\|Visual representation of the order in which the basic graph explorer query processors work to produce and render the explored content on the screen.]]		[[Image:Graph-explorer-queries.png\|center\|thumb\|700px\|alt=Visual query order representation\|Visual representation of the order in which the basic graph explorer query processors work to produce and render the explored content on the screen.]]

Tuukka Lehtonen: /* Basic Query hierarchy */

2010-10-30T20:28:26Z

Basic Query hierarchy

← Older revision		Revision as of 20:28, 30 October 2010
Line 62:		Line 62:
	=== Basic Query hierarchy ===		=== Basic Query hierarchy ===

	[[Image:Graph-explorer-queries.png\|thumb\|700px\|alt=Visual query order representation\|Visual representation of the order in which the basic graph explorer query processors work to produce and render the explored content on the screen.]]		[[Image:Graph-explorer-queries.png\|center\|thumb\|700px\|alt=Visual query order representation\|Visual representation of the order in which the basic graph explorer query processors work to produce and render the explored content on the screen.]]

	== Selection handling ==		== Selection handling ==

Tuukka Lehtonen: /* Basic Query hierarchy */

2010-10-30T20:28:00Z

Basic Query hierarchy

← Older revision		Revision as of 20:28, 30 October 2010
Line 62:		Line 62:
	=== Basic Query hierarchy ===		=== Basic Query hierarchy ===

	[[Image:~~800px-~~Graph-explorer-queries.png\|~~800px~~\|alt=Visual query order representation\|Visual representation of the order in which the basic graph explorer query processors work to produce and render the explored content on the screen.]]		[[Image:Graph-explorer-queries.png\|thumb\|700px\|alt=Visual query order representation\|Visual representation of the order in which the basic graph explorer query processors work to produce and render the explored content on the screen.]]

	== Selection handling ==		== Selection handling ==

Tuukka Lehtonen: /* Basic Usage */

2010-10-30T20:24:36Z

Basic Usage

← Older revision		Revision as of 20:24, 30 October 2010
Line 60:		Line 60:
	Internally a GraphExplorer implementation shall also bind certain top-level queries to actual UI elements. If such queries with bound UI elements are updated, the UI elements shall be updated also. For example in the case of a tree this implies updating the label or image of the tree node.		Internally a GraphExplorer implementation shall also bind certain top-level queries to actual UI elements. If such queries with bound UI elements are updated, the UI elements shall be updated also. For example in the case of a tree this implies updating the label or image of the tree node.

	=== ~~Visualization of~~ Basic Query hierarchy ===		=== Basic Query hierarchy ===

	[[Image:800px-Graph-explorer-queries.png\|800px\|alt=Visual query order representation\|Visual representation of the order in which the basic graph explorer query processors work to produce and render the explored content on the screen.]]		[[Image:800px-Graph-explorer-queries.png\|800px\|alt=Visual query order representation\|Visual representation of the order in which the basic graph explorer query processors work to produce and render the explored content on the screen.]]

Tuukka Lehtonen: /* Basic Usage */

2010-10-06T12:45:32Z

Basic Usage

← Older revision		Revision as of 12:45, 6 October 2010
Line 29:		Line 29:
	# Initialize data sources (<code>DataSourceProvider</code>) for the graph explorer (<code>GraphExplorer.setDataSource(DataSourceProvider)</code>)		# Initialize data sources (<code>DataSourceProvider</code>) for the graph explorer (<code>GraphExplorer.setDataSource(DataSourceProvider)</code>)
	#* For example, the graph database is one possible data source.		#* For example, the graph database is one possible data source.
	~~# Initialize suitable query processors for your purposes (<code>GraphExplorer.setProcessor(NodeQueryProcessor)</code>, <code>GraphExplorer.setPrimitiveProcessor(PrimitiveQueryProcessor)</code>)~~		# Initialize an [[svn:foundation/browsing/trunk/org.simantics.browsing.ui.common/src/org/simantics/browsing/ui/common/EvaluatorData.java\|EvaluatorData]] for your explorer. Preferably use [[svn:foundation/browsing/trunk/org.simantics.browsing.ui.graph.impl/src/org/simantics/browsing/ui/graph/impl/Evaluators.java\|Evaluators.load(...)]] to do this.
	# Initialize an [[svn:foundation/browsing/trunk/org.simantics.browsing.ui.common/src/org/simantics/browsing/ui/common/EvaluatorData.java\|EvaluatorData]] for your explorer. Preferably use [[svn:foundation/browsing/trunk/org.simantics.browsing.ui.graph.impl/src/org/simantics/browsing/ui/graph/impl/Evaluators.java\|~~EvaluatorData~~ Evaluators.load(~~RequestProcessor, Set<String>, ResourceManager~~)]] to do this.		# Initialize all needed query processors for your purposes with the previously loaded EvaluatorData as an argument (<code>GraphExplorer.setProcessor(NodeQueryProcessor)</code>, <code>GraphExplorer.setPrimitiveProcessor(PrimitiveQueryProcessor)</code>)
	# Set root input (<code>GraphExplorer.setRoot(Object)</code>)		# Set root input (<code>GraphExplorer.setRoot(Object)</code>)

Tuukka Lehtonen: /* Basic Usage */

2010-10-06T12:35:14Z

Basic Usage

← Older revision		Revision as of 12:35, 6 October 2010
Line 30:		Line 30:
	#* For example, the graph database is one possible data source.		#* For example, the graph database is one possible data source.
	# Initialize suitable query processors for your purposes (<code>GraphExplorer.setProcessor(NodeQueryProcessor)</code>, <code>GraphExplorer.setPrimitiveProcessor(PrimitiveQueryProcessor)</code>)		# Initialize suitable query processors for your purposes (<code>GraphExplorer.setProcessor(NodeQueryProcessor)</code>, <code>GraphExplorer.setPrimitiveProcessor(PrimitiveQueryProcessor)</code>)
			# Initialize an [[svn:foundation/browsing/trunk/org.simantics.browsing.ui.common/src/org/simantics/browsing/ui/common/EvaluatorData.java\|EvaluatorData]] for your explorer. Preferably use [[svn:foundation/browsing/trunk/org.simantics.browsing.ui.graph.impl/src/org/simantics/browsing/ui/graph/impl/Evaluators.java\|EvaluatorData Evaluators.load(RequestProcessor, Set<String>, ResourceManager)]] to do this.
	# Set root input (<code>GraphExplorer.setRoot(Object)</code>)		# Set root input (<code>GraphExplorer.setRoot(Object)</code>)

Tuukka Lehtonen: /* Concepts */

2010-10-06T12:19:00Z

Concepts

← Older revision		Revision as of 12:19, 6 October 2010
Line 3:		Line 3:
	== Concepts ==		== Concepts ==
	; Query Key		; Query Key
	: An object that identifies the query to be performed. Query keys are capable of identifying the query processor to be used for actually performing the query. See the [[svn:foundation/trunk/org.simantics.browsing.ui/src/org/simantics/browsing/ui/~~INodeContext~~.java\|base class for all keys]]:		: An object that identifies the query to be performed. Query keys are capable of identifying the query processor to be used for actually performing the query. See the [[svn:foundation/browsing/trunk/org.simantics.browsing.ui/src/org/simantics/browsing/ui/NodeContext.java\|base class for all keys]]:
	<blockquote>		<blockquote>
	<pre>		<pre>

Toni Kalajainen at 10:11, 29 September 2010

2010-09-29T10:11:00Z

← Older revision		Revision as of 10:11, 29 September 2010
Line 25:		Line 25:

	== Basic Usage ==		== Basic Usage ==

	~~'''TODO:''' explain better~~

	# Use <code>org.simantics.browsing.ui.GraphExplorerFactory</code> to construct new instances of the SWT-based GraphExplorer control.		# Use <code>org.simantics.browsing.ui.GraphExplorerFactory</code> to construct new instances of the SWT-based GraphExplorer control.
	# Setup layouts for the GraphExplorer control as you normally would in SWT		# Setup layouts for the GraphExplorer control as you normally would in SWT
Line 36:		Line 33:

	=== Query System ===		=== Query System ===

	The explorer content production process is based solely on ''queries''. Abstractly speaking, a query is just a request for an answer to a question.		The explorer content production process is based solely on ''queries''. Abstractly speaking, a query is just a request for an answer to a question.
	Each potentially visible element in a GraphExplorer will have its own ''node context'' (see [[svn:foundation/browsing/trunk/org.simantics.browsing.ui/src/org/simantics/browsing/ui/NodeContext.java\|NodeContext]]). Queries are always performed on a single node context.		Each potentially visible element in a GraphExplorer will have its own ''node context'' (see [[svn:foundation/browsing/trunk/org.simantics.browsing.ui/src/org/simantics/browsing/ui/NodeContext.java\|NodeContext]]). Queries are always performed on a single node context.

Toni Kalajainen at 10:10, 29 September 2010

2010-09-29T10:10:27Z

← Older revision		Revision as of 10:10, 29 September 2010
Line 65:		Line 65:
	=== Visualization of Basic Query hierarchy ===		=== Visualization of Basic Query hierarchy ===

	[[Image:~~graph~~-explorer-queries.png\|800px\|alt=Visual query order representation\|Visual representation of the order in which the basic graph explorer query processors work to produce and render the explored content on the screen.]]		[[Image:800px-Graph-explorer-queries.png\|800px\|alt=Visual query order representation\|Visual representation of the order in which the basic graph explorer query processors work to produce and render the explored content on the screen.]]

	== Selection handling ==		== Selection handling ==