1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420
|
<?xml version='1.0' encoding='UTF-8'?>
<!-- Schema file written by PDE -->
<schema targetNamespace="org.eclipse.ui" xmlns="http://www.w3.org/2001/XMLSchema">
<annotation>
<appInfo>
<meta.schema plugin="org.eclipse.ui" id="perspectiveExtensions" name="Perspective Extensions"/>
</appInfo>
<documentation>
This extension point is used to extend perspectives
registered by other plug-ins. A perspective defines
the initial contents of the window action bars
(menu and toolbar) and the initial set of views
and their layout within a workbench page.
Other plug-ins may contribute actions or views to
the perspective which appear when the perspective
is selected. Optional additions by other plug-ins
are appended to the initial definition.
</documentation>
</annotation>
<element name="extension">
<annotation>
<appInfo>
<meta.element />
</appInfo>
</annotation>
<complexType>
<sequence>
<element ref="perspectiveExtension" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
<attribute name="point" type="string" use="required">
<annotation>
<documentation>
a fully qualified identifier of the target extension point
</documentation>
</annotation>
</attribute>
<attribute name="id" type="string">
<annotation>
<documentation>
an optional identifier of the extension instance
</documentation>
</annotation>
</attribute>
<attribute name="name" type="string">
<annotation>
<documentation>
an optional name of the extension instance
</documentation>
<appInfo>
<meta.attribute translatable="true"/>
</appInfo>
</annotation>
</attribute>
</complexType>
</element>
<element name="perspectiveExtension">
<annotation>
<appInfo>
<meta.element labelAttribute="targetID"/>
</appInfo>
</annotation>
<complexType>
<choice minOccurs="0" maxOccurs="unbounded">
<element ref="actionSet"/>
<element ref="viewShortcut"/>
<element ref="perspectiveShortcut"/>
<element ref="newWizardShortcut"/>
<element ref="view"/>
<element ref="showInPart"/>
<element ref="hiddenMenuItem"/>
<element ref="hiddenToolBarItem"/>
<element ref="editorOnboardingCommand" minOccurs="0" maxOccurs="5"/>
</choice>
<attribute name="targetID" use="required">
<annotation>
<documentation>
the unique identifier of the perspective (as specified in the registry) into which the contribution is made. If the value is set to "*" the extension is applied to all perspectives.
</documentation>
<appInfo>
<meta.attribute kind="identifier" basedOn="org.eclipse.ui.perspectives/perspective/@id"/>
</appInfo>
</annotation>
<simpleType>
<restriction base="string">
<enumeration value="*">
</enumeration>
</restriction>
</simpleType>
</attribute>
<attribute name="editorOnboardingText" type="string">
<annotation>
<documentation>
The text is shown in the editor area in case no editor is open.
</documentation>
<appInfo>
<meta.attribute translatable="true"/>
</appInfo>
</annotation>
</attribute>
<attribute name="editorOnboardingImage" type="string">
<annotation>
<documentation>
The image is shown in the editor area in case no editor is open.
The image shall be grey and not colored and shall have a size of 250 x 250 px.
Plus a second image for high resolution with a size of 500 x 500 px and a name like [image_name]@2x.[image_type].
</documentation>
<appInfo>
<meta.attribute kind="resource"/>
</appInfo>
</annotation>
</attribute>
</complexType>
</element>
<element name="actionSet">
<complexType>
<attribute name="id" type="string" use="required">
<annotation>
<documentation>
the unique identifier of the action set which will be added to the perspective.
</documentation>
<appInfo>
<meta.attribute kind="identifier" basedOn="org.eclipse.ui.actionSets/actionSet/@id"/>
</appInfo>
</annotation>
</attribute>
</complexType>
</element>
<element name="viewShortcut">
<complexType>
<attribute name="id" type="string" use="required">
<annotation>
<documentation>
the unique identifier of the view which will be added to the perspective's "Show View" submenu of the "Window" menu.
</documentation>
<appInfo>
<meta.attribute kind="identifier" basedOn="org.eclipse.ui.views/view/@id,org.eclipse.ui.views/e4view/@id"/>
</appInfo>
</annotation>
</attribute>
</complexType>
</element>
<element name="perspectiveShortcut">
<complexType>
<attribute name="id" type="string" use="required">
<annotation>
<documentation>
the unique identifier of the perspective which will be added to the perspective's "Open Perspective" submenu of the "Window" menu.
</documentation>
<appInfo>
<meta.attribute kind="identifier" basedOn="org.eclipse.ui.perspectives/perspective/@id"/>
</appInfo>
</annotation>
</attribute>
</complexType>
</element>
<element name="newWizardShortcut">
<complexType>
<attribute name="id" type="string" use="required">
<annotation>
<documentation>
the unique identifier of the new wizard which will be added to the perspective's "New" submenu of the "File" menu.
</documentation>
<appInfo>
<meta.attribute kind="identifier" basedOn="org.eclipse.ui.newWizards/wizard/@id"/>
</appInfo>
</annotation>
</attribute>
</complexType>
</element>
<element name="showInPart">
<complexType>
<attribute name="id" type="string">
<annotation>
<documentation>
the unique identifier of the view which will be added to the perspective's "Show In..." prompter in the Navigate menu.
</documentation>
<appInfo>
<meta.attribute kind="identifier" basedOn="org.eclipse.ui.views/view/@id,org.eclipse.ui.views/e4view/@id"/>
</appInfo>
</annotation>
</attribute>
</complexType>
</element>
<element name="view">
<complexType>
<attribute name="id" type="string" use="required">
<annotation>
<documentation>
the unique identifier of the view which will be added to the perspective layout.
</documentation>
<appInfo>
<meta.attribute kind="identifier" basedOn="org.eclipse.ui.views/view/@id,org.eclipse.ui.views/e4view/@id"/>
</appInfo>
</annotation>
</attribute>
<attribute name="relative">
<annotation>
<documentation>
the unique identifier of a view which already exists in the perspective. This will be used as a reference point for placement of the view. The relationship between these two views is defined by <samp>relationship</samp>. Ignored if relationship is "fast".
</documentation>
<appInfo>
<meta.attribute kind="identifier" basedOn="org.eclipse.ui.views/view/@id,org.eclipse.ui.views/e4view/@id"/>
</appInfo>
</annotation>
<simpleType>
<restriction base="string">
<enumeration value="org.eclipse.ui.editorss">
</enumeration>
</restriction>
</simpleType>
</attribute>
<attribute name="relationship" use="required">
<annotation>
<documentation>
specifies the relationship between <samp>id</samp> and
<samp>relative</samp>.
The following values are supported:
<ul>
<b>fast</b> - <b>Deprecated</b> - the view extension will be created as a fast view.
<br><b>stack</b> - the view extension will be stacked with the relative
view in a folder.
<br><b>left, right, top, bottom</b> - the view extension will be placed
beside the relative view. In this case a <samp>ratio</samp> must also
be defined.</ul>
</documentation>
</annotation>
<simpleType>
<restriction base="string">
<enumeration value="stack">
</enumeration>
<enumeration value="left">
</enumeration>
<enumeration value="right">
</enumeration>
<enumeration value="top">
</enumeration>
<enumeration value="bottom">
</enumeration>
<enumeration value="fast">
</enumeration>
</restriction>
</simpleType>
</attribute>
<attribute name="ratio" type="string">
<annotation>
<documentation>
the percentage of area within the relative view which will be donated to the view extension. If the view extension is a fast view, the ratio is the percentage of the workbench the fast view will cover when active. This must be defined as a floating point value and lie between 0.05 and 0.95.
</documentation>
</annotation>
</attribute>
<attribute name="visible" type="boolean">
<annotation>
<documentation>
whether the view is initially visible when the perspective is opened. This attribute should have a value of "true" or "false" if used.
If this attribute is not used, the view will be initially visible by default.
</documentation>
</annotation>
</attribute>
<attribute name="closeable" type="boolean">
<annotation>
<documentation>
whether the view is closeable in the target perspective. This attribute should have a value of "true" or "false" if used. If this attribute is not used, the view will be closeable, unless the perspective itself is marked as fixed.
</documentation>
</annotation>
</attribute>
<attribute name="moveable" type="boolean">
<annotation>
<documentation>
whether the view is moveable. A non-moveable view cannot be moved either within the same folder, or moved between folders in the perspective. This attribute should have a value of "true" or "false" if used.
If this attribute is not used, the view will be moveable, unless the perspective itself is marked as fixed.
</documentation>
</annotation>
</attribute>
<attribute name="standalone" type="boolean">
<annotation>
<documentation>
whether the view is a standalone view. A standalone view cannot be docked together with others in the same folder. This attribute should have a value of "true" or "false" if used. This attribute is ignored if the relationship attribute is "fast" or "stacked". If this attribute is not used, the view will be a regular view, not a standalone view (default is "false").
</documentation>
</annotation>
</attribute>
<attribute name="showTitle" type="boolean">
<annotation>
<documentation>
whether the view's title is shown. This attribute should have a value of "true" or "false" if used. This attribute only applies to standalone views. If this attribute is not used, the view's title will be shown (default is "true").
</documentation>
</annotation>
</attribute>
<attribute name="minimized" type="boolean" use="default" value="false">
<annotation>
<documentation>
If the perspective extension will result in a new view stack being created (i.e. the 'relationship' attribute is one of left, right, top or bottom) this field determines the new stack's initial display state.
</documentation>
</annotation>
</attribute>
</complexType>
</element>
<element name="hiddenMenuItem">
<complexType>
<attribute name="id" type="string" use="required">
<annotation>
<documentation>
The unique identifier of the Command which is to be removed from the menu.
<strong>WARNING:</strong> This is considered to be a 'Product level' extension and should not be used in consumable plugins without great care.
</documentation>
</annotation>
</attribute>
</complexType>
</element>
<element name="hiddenToolBarItem">
<complexType>
<attribute name="id" type="string" use="required">
<annotation>
<documentation>
The unique identifier of the Command which is to be removed from thetoolbar.
<strong>WARNING:</strong> This is considered to be a 'Product level' extension and should not be used in consumable plugins without great care.
</documentation>
</annotation>
</attribute>
</complexType>
</element>
<element name="editorOnboardingCommand">
<annotation>
<documentation>
The commands are shown including key binding in the editor area in case no editor is open.
Up to five commands can be added.
</documentation>
</annotation>
<complexType>
<attribute name="id" type="string" use="required">
<annotation>
<documentation>
The unique identifier of the command which will be shown in case no editor is open.
</documentation>
<appInfo>
<meta.attribute kind="identifier" basedOn="org.eclipse.ui.commands/command/@id"/>
</appInfo>
</annotation>
</attribute>
</complexType>
</element>
<annotation>
<appInfo>
<meta.section type="examples"/>
</appInfo>
<documentation>
The following is an example of a perspective extension (note the subelements and the way attributes are used):
<p>
<pre>
<extension point="org.eclipse.ui.perspectiveExtensions">
<perspectiveExtension
targetID="org.eclipse.ui.resourcePerspective">
<actionSet id="org.eclipse.jdt.ui.JavaActionSet"/>
<viewShortcut id="org.eclipse.jdt.ui.PackageExplorer"/>
<newWizardShortcut id="org.eclipse.jdt.ui.wizards.NewProjectCreationWizard"/>
<perspectiveShortcut id="org.eclipse.jdt.ui.JavaPerspective"/>
<view id="org.eclipse.jdt.ui.PackageExplorer"
relative="org.eclipse.ui.views.ResourceNavigator"
relationship="stack"/>
<view id="org.eclipse.jdt.ui.TypeHierarchy"
relative="org.eclipse.ui.views.ResourceNavigator"
relationship="left"
ratio="0.50"/>
</perspectiveExtension>
</extension>
</pre>
</p>
<p>
In the example above, an action set, view shortcut,
new wizard shortcut, and perspective shortcut are
contributed to the initial contents of the
Resource Perspective. In addition, the
Package Explorer view is stacked on the
Resource Navigator and the Type Hierarchy View is
added beside the Resource Navigator.
</p>
</documentation>
</annotation>
<annotation>
<appInfo>
<meta.section type="apiInfo"/>
</appInfo>
<documentation>
The items defined within the perspective extension are contributed to the initial contents of the target perspective. Following this, the user may remove any contribution or add others to a perspective from within the workbench user interface.
</documentation>
</annotation>
<annotation>
<appInfo>
<meta.section type="copyright"/>
</appInfo>
<documentation>
Copyright (c) 2002, 2007 IBM Corporation and others.<br>
This program and the accompanying materials are made
available under the terms of the Eclipse Public License 2.0 which accompanies
this distribution, and is available at <a
href="https://www.eclipse.org/legal/epl-2.0">https://www.eclipse.org/legal/epl-v20.html</a>/
SPDX-License-Identifier: EPL-2.0
</documentation>
</annotation>
</schema>
|