指令

識別碼: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>

 在 UI 中,指令通常是按種類來組織,這使得它們更加容易管理。這個元素用來定義這些種類。指令可以將它們自己新增至最多一個種類中。如果有多個元素存在且具有相同 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。查詢和設定範圍的公開 API,以及登錄動作以處理特定指令的公用 API 可在 org.eclipse.ui.IKeyBindingService 中找到。

Copyright (c) 2000, 2003 IBM Corporation and others.
All rights reserved. 這個程式和伴隨的素材可以根據伴隨這個分送,而且可在 http://www.eclipse.org/legal/cpl-v10.html 中取得的 Common Public License v1.0 的條款來使用