Selection View

From Developer Documents
Revision as of 18:32, 17 September 2011 by Antti Villberg (talk | contribs)
Jump to navigation Jump to search

The Selection View is a standard Simantics view, which shows tabbed configuration views about the current workbench selection.

Basic implementation

Selection view displays content for the workbench selection, which is produced by the active workbench part. The main implementation of the Selection View is also contributed by the active workbench part.

The implementation class is org.simantics.browsing.ui.swt.IPropertyPage (needs refactoring).

The standard implementation is org.simantics.views.swt.StandardPropertyPage (needs refactoring).

Selection processing

StandardPropertyPage uses org.simantics.browsing.ui.SelectionProcessor for computing an ordered set of tabs from the given workbench selection. The tabs are implementations of org.simantics.browsing.ui.swt.ComparableTabContributor.

A modelled implementation of the SelectionProcessor interface is org.simantics.views.swt.StandardSelectionProcessor.

StandardSelectionProcessor seeks all instances of http://www.simantics.org/Views-1.0/TabContribution and adapts them to org.simantics.views.swt.TabContribution.

StandardSelectionProcessor seeks all instances of http://www.simantics.org/Views-1.0/SelectionTransformation (which are also L0X.Function) and applies them to obtain a set of inputs, which is then feed to all TabContributions.

Tab implementation

The standard way of implementing a tab is a Simantics Modelled View. Generic modelled selection view tabs include

StandardProperties (http://www.simantics.org/Modeling-1.0/StandardProperties)

  • StandardProperties is an Explorer view which expects a single Variable as input.
  • The view has the columns 'Property', 'Value' and 'Unit'
  • Children are obtained using variable.browseProperties such that the property contains a property named 'StandardProperty'
  • Labels are obtained using the properties 'PredicateLabel', 'HasLabel', 'DisplayUnit'
  • Modifier uses 'HasInputValidator' for getting the validator
  • Modifier writes into property 'HasLabel'
  • Categories?
  • Required, Default?