Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Platform UI/Multi-instance Properties View"
(→Use cases {{bug|248103#c12}}) |
(→Ideas/Use cases/Requirements for multi-instance Properties View (PV) {{bug|248103}}:: Add use cases.) |
||
| Line 1: | Line 1: | ||
| − | = | + | = Brainstorming {{bug|248103}}: = |
* Pin PV to current selection (stop following selection) | * Pin PV to current selection (stop following selection) | ||
| Line 15: | Line 15: | ||
* Open the properties view from the context menu of the current selection (show in) (Object id might be used for secondary view id). | * Open the properties view from the context menu of the current selection (show in) (Object id might be used for secondary view id). | ||
* When a second view is opened from the original view, what should happen? Should the original stop following selection or should the second one? | * When a second view is opened from the original view, what should happen? Should the original stop following selection or should the second one? | ||
| + | |||
| + | = Use cases = | ||
| + | *pinning selection | ||
| + | :Allowing a user to pin the view to a given selection provides the user with the capability of see the properties of the given selection while providing them with the freedom to select alternate items. The current 'Properties' view implementation "always" follows the current workbench's selection and prevents the user from multitasking. | ||
| + | *multiple instances | ||
| + | :By letting the user spawn multiple instances of the 'Properties' view, they are now able to compare the properties of N+1 items. This is different from the Compare framework's textual compare as the information provided in the 'Properties' view is defined by the selection's adapted <code>IPropertySource</code> and is often not the textual content of the selection, if the selection even has textual content. | ||
| + | *secondary instances hidden upon workbench shutdown | ||
| + | :Any secondary instances of the 'Properties' view are hidden upon workbench shutdown. Note that other views provided by the SDK currently stay '''up'''. | ||
| + | *spawning instances via the 'Show In' context menu | ||
| + | :Users can use the 'Show In' context menu as they are currently familiar with to display the current selection in a 'Properties' view. A new view will be constructed if all current views are set to be pinned or there are no 'Properties' view in the current perspective. | ||
| + | *constructing new instances from the 'Properties' view itself | ||
| + | :A user can also create new instances of the 'Properties' view from an existing one. The existing one will be pinned to the contents it is currently displaying and the new instance will be set to follow the workbench's selection. | ||
= Existing behaviour = | = Existing behaviour = | ||
Revision as of 11:47, 8 December 2008
Contents
Brainstorming bug 248103:
- Pin PV to current selection (stop following selection)
- Inherit parents settings (For PV org.eclipse.ui.part.WorkbenchPart.getPartProperties() might be an option)
- Inherit parents input (requires API to get the Input from the parent)
- Setting parents state/input requires additional API whereas freezing (pinning) the parent and opening a "fresh" PV wouldn't require any additional API
- The console view for example gets the parents content in org.eclipse.ui.internal.console.ConsoleView.consolesAdded(IConsole[])
- New one has focus?
- Open the new view either on the same stack or else where? (If the user wants to compare two objects, a stacked view doesn't fit)
- Back and forward buttons to navigate between the property view instances
- Multiple PV instances are still restorable?
- Only restore the master property view (the first one)?
- Only restore property view instances which are pinned?
- Restore all property views
- Open the properties view from the context menu of the current selection (show in) (Object id might be used for secondary view id).
- When a second view is opened from the original view, what should happen? Should the original stop following selection or should the second one?
Use cases
- pinning selection
- Allowing a user to pin the view to a given selection provides the user with the capability of see the properties of the given selection while providing them with the freedom to select alternate items. The current 'Properties' view implementation "always" follows the current workbench's selection and prevents the user from multitasking.
- multiple instances
- By letting the user spawn multiple instances of the 'Properties' view, they are now able to compare the properties of N+1 items. This is different from the Compare framework's textual compare as the information provided in the 'Properties' view is defined by the selection's adapted
IPropertySourceand is often not the textual content of the selection, if the selection even has textual content.
- secondary instances hidden upon workbench shutdown
- Any secondary instances of the 'Properties' view are hidden upon workbench shutdown. Note that other views provided by the SDK currently stay up.
- spawning instances via the 'Show In' context menu
- Users can use the 'Show In' context menu as they are currently familiar with to display the current selection in a 'Properties' view. A new view will be constructed if all current views are set to be pinned or there are no 'Properties' view in the current perspective.
- constructing new instances from the 'Properties' view itself
- A user can also create new instances of the 'Properties' view from an existing one. The existing one will be pinned to the contents it is currently displaying and the new instance will be set to follow the workbench's selection.
Existing behaviour
| View | Open secondary instance by | Inherit parent's content | Inherit parent's settings | Same "input" opens new view | Name new instance |
|---|---|---|---|---|---|
Search |
Pin parent and rerun search | no | no | ? | no |
History |
Pin and call Team > Show History on a different resource | no | yes | ? | no |
Memory |
"New" button View toolbar | ? | yes | ? | no |
Bookmarks |
"New ... View" from View menubar | yes¹ | no | n/a | yes |
Markers |
"New ... View" from View menubar | yes¹ | no | n/a | yes |
Problems |
"New ... View" from View menubar | yes¹ | no | n/a | yes |
Tasks |
"New ... View" from View menubar | yes¹ | no | n/a | yes |
Console |
Can be opened explicitly | yes | ? | ? | ? |
¹ Content comes from workspace
Use cases bug 248103#c12
Compare properties of two or more resources in the workbench Prakash's Blog