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
|
<?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="commandImages" name="Command Images"/>
</appInfo>
<documentation>
<p>
The images extension point provides a way of linking different types of images and icons to a particular command. These images can be used, as appropriate, wherever the command appears in the user interface. To accommodate some boundary cases (e.g., tool bar drop-down items), it is possible to group the images for a particular commands into "styles". These styles can then be specifically requested when a command is to be displayed.
</p>
<p>
Commands placed in menus using the <a href="org_eclipse_ui_menus.html">org.eclipse.ui.menus</a> extension point will use the default image if available, and commands placed in a toolbar will use the <code>toolbar</code> style images if available, followed by the default images.
</p>
</documentation>
</annotation>
<element name="extension">
<annotation>
<appInfo>
<meta.element />
</appInfo>
</annotation>
<complexType>
<sequence>
<element ref="image" minOccurs="0" maxOccurs="unbounded"/>
</sequence>
<attribute name="point" type="string" use="required">
<annotation>
<documentation>
</documentation>
</annotation>
</attribute>
<attribute name="id" type="string">
<annotation>
<documentation>
</documentation>
</annotation>
</attribute>
<attribute name="name" type="string">
<annotation>
<documentation>
</documentation>
<appInfo>
<meta.attribute translatable="true"/>
</appInfo>
</annotation>
</attribute>
</complexType>
</element>
<element name="image">
<annotation>
<appInfo>
<meta.element labelAttribute="commandId"/>
</appInfo>
<documentation>
The images to associate with a particular command.
</documentation>
</annotation>
<complexType>
<attribute name="commandId" type="string" use="required">
<annotation>
<documentation>
The identifier of the command with which the images should be associated.
</documentation>
<appInfo>
<meta.attribute kind="identifier" basedOn="org.eclipse.ui.commands/command/@id"/>
</appInfo>
</annotation>
</attribute>
<attribute name="icon" type="string" use="required">
<annotation>
<documentation>
The path to the icon which should be used in the default case, or the <code>ISharedImages</code> constant. This will appear when the icon is enabled and mouse is not hovering over it. It will also be used in any situation where such a more specific icon is not available.
</documentation>
<appInfo>
<meta.attribute kind="resource"/>
</appInfo>
</annotation>
</attribute>
<attribute name="disabledIcon" type="string">
<annotation>
<documentation>
The icon to display when the command is disabled.
</documentation>
<appInfo>
<meta.attribute kind="resource"/>
</appInfo>
</annotation>
</attribute>
<attribute name="hoverIcon" type="string">
<annotation>
<documentation>
The icon to display when the user is hovering over the command.
</documentation>
<appInfo>
<meta.attribute kind="resource"/>
</appInfo>
</annotation>
</attribute>
<attribute name="style" type="string">
<annotation>
<documentation>
The particular scenario in which this block of icons apply. For example, it may be desirable to have different icons when the command is displayed as a toolbar drop-down item. Currently the org.eclipse.ui.menus extension will use the default style (no style) for menu icons and the <code>toolbar</code> style for toolbar contributions. If no <code>toolbar</code> entry is available for that command, it uses the default style.
</documentation>
</annotation>
</attribute>
</complexType>
</element>
<annotation>
<appInfo>
<meta.section type="since"/>
</appInfo>
<documentation>
3.2
</documentation>
</annotation>
<annotation>
<appInfo>
<meta.section type="examples"/>
</appInfo>
<documentation>
<pre>
<extension
point="org.eclipse.ui.commandImages">
<image
commandId="org.eclipse.example.ProfileLast"
hoverIcon="icons/full/etool16/profile.png"
disabledIcon="icons/full/dtool16/profile.png"
icon="icons/full/etool16/profile.png" />
<image
commandId="org.eclipse.example.ProfileLast"
hoverIcon="icons/full/etool16/history.png"
disabledIcon="icons/full/dtool16/history.png"
icon="icons/full/etool16/history.png"
style="toolbar" />
</extension>
</pre>
</documentation>
</annotation>
<annotation>
<appInfo>
<meta.section type="apiInfo"/>
</appInfo>
<documentation>
<p>
Within the workbench, it is possible to get images for commands using the <code>org.eclipse.ui.commands.ICommandImageService</code> interface. This interface can be retrieved from supporting workbench objects, such as <code>IWorkbench</code> itself, the <code>IWorkbenchWindow</code>, or the <code>IWorkbenchPartSite</code>. To retrieve the service, you would make a call like <code>workbench.getService(ICommandImageService.class)</code>.
</p>
</documentation>
</annotation>
<annotation>
<appInfo>
<meta.section type="copyright"/>
</appInfo>
<documentation>
Copyright (c) 2005,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>
|
