命令

标识:org.eclipse.ui.commands

起始发行版:

2.1

描述:

org.eclipse.ui.commands 扩展点用来通过使用 commandcategory 元素声明命令和命令类别。通过此扩展点,您还可以使用 keyBinding 元素将键序列指定给命令。键序列是根据键配置和作用域(它们也是在此处通过使用 keyConfigurationscope 元素声明的)绑定至命令的。

配置标记:

   <!ELEMENT extension (activeKeyConfiguration , category , command , keyBinding , keyConfiguration , scope)>

   <!ATTLIST extension
     id    CDATA #IMPLIED
     name  CDATA #IMPLIED
     point CDATA #REQUIRED
   >

   <!ELEMENT activeKeyConfiguration EMPTY>

  此元素用来定义 Eclipse 的初始活动键配置。如果存在多个这样的元素,则仅最后声明的那个元素(以读取插件注册表的次序)才被认为是有效的。

   <!ATTLIST activeKeyConfiguration
     value CDATA #IMPLIED
   >

   <!ELEMENT category EMPTY>

在用户界面中,命令通常是按类别组织的,以便更易于管理它们。此元素用来定义这些类别。命令可以将它们自己添加到最多一个类别。如果存在具有相同 id 属性的多个这样的元素,则仅最后声明的那个元素(以读取插件注册表的次序)才被认为是有效的。

   <!ATTLIST category
     description CDATA #IMPLIED
     id          CDATA #REQUIRED
     name        CDATA #REQUIRED
   >

   <!ELEMENT command EMPTY>

此元素用来定义命令。命令表示来自用户的可由操作处理的请求,它与其它命令相比在语义上应是唯一的。如果已定义具有相同含义的命令,则不要定义它。如果存在具有相同 id 属性的多个这样的元素,则仅最后声明的那个元素(以读取插件注册表的次序)才被认为是有效的。参见扩展点 org.eclipse.ui.actionSetsorg.eclipse.ui.editorActions 以了解操作如何与命令连接。

   <!ATTLIST command
     category    CDATA #IMPLIED
     description CDATA #IMPLIED
     icon        CDATA #IMPLIED
     id          CDATA #REQUIRED
     name        CDATA #REQUIRED
   >

   <!ELEMENT keyBinding EMPTY>

此元素允许用户将键序列指定给命令。

   <!ATTLIST keyBinding
     configuration CDATA #REQUIRED
     command       CDATA #IMPLIED
     locale        CDATA #IMPLIED
     platform      CDATA #IMPLIED
     scope         CDATA #REQUIRED
     string        CDATA #REQUIRED
   >

   <!ELEMENT keyConfiguration EMPTY>

此元素用来定义键配置。如果存在具有相同 id 属性的多个这样的元素,则仅最后声明的那个元素(以读取插件注册表的次序)才被认为是有效的。

   <!ATTLIST keyConfiguration
     description CDATA #IMPLIED
     id          CDATA #REQUIRED
     name        CDATA #REQUIRED
     parent      CDATA #IMPLIED
   >

   <!ELEMENT scope EMPTY>

此元素用来定义作用域。如果存在具有相同 id 属性的多个这样的元素,则仅最后声明的那个元素(以读取插件注册表的次序)才被认为是有效的。

   <!ATTLIST scope
     description CDATA #IMPLIED
     id          CDATA #REQUIRED
     name        CDATA #REQUIRED
     parent      CDATA #IMPLIED
   >
示例:

org.eclipse.ui 插件中的 plugin.xml 文件高度使用了 org.eclipse.ui.commands 扩展点。

API 信息:

这是用于声明命令、类别、键绑定、键配置或除此扩展点之外的作用域的非公用 API。可以在 org.eclipse.ui.IKeyBindingService 中找到用于查询和设置作用域以及注册处理特定命令的操作的公用 API。

Copyright (c) 2000, 2003 IBM Corporation and others.
All rights reserved. 该程序及附带提供的资料是基于“一般公共许可证”(Common Public License) v1.0 的条款提供的,本发行版中提供了该许可证条款,并且也可 在以下位置处找到该条款:http://www.eclipse.org/legal/cpl-v10.html