加速器集

org.eclipse.ui.acceleratorSets

2.0 版

警告:這個延伸點已停用。
請不要使用這個延伸點,將在本產品的未來版本中移除它。 請改用 org.eclipse.ui.commands 延伸點。

這個延伸點用來登錄加速器集延伸。加速器集如其名,就是加速器的集合。加速器是一或多個加速鍵序列和工作台動作之間的關聯。加速鍵序列可能是長度 1 或大於 1。

加速器集與加速器配置一起登錄(請參閱「加速器配置」延伸點), 並適用於加速器範圍(請參閱「加速器範圍」延伸點)。

<!ELEMENT extension (acceleratorSet*)>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT acceleratorSet (accelerator+)>

<!ATTLIST acceleratorSet

configurationId CDATA #REQUIRED

scopeId         CDATA #REQUIRED>

@deprecated 請改用 "org.eclipse.ui.bindings" 延伸點。使用 key 元素。



<!ELEMENT accelerator EMPTY>

<!ATTLIST accelerator

id       CDATA #IMPLIED

key      CDATA #REQUIRED

locale   CDATA #IMPLIED

platform CDATA #IMPLIED>

@deprecated 請改用 "org.eclipse.ui.bindings" 延伸點。使用 key 元素。



下列是加速器集延伸的範例:

   

<extension point=

"org.eclipse.ui.acceleratorSets"

>

<acceleratorSet configurationId=

"org.eclipse.ui.exampleAcceleratorConfiguration"

scopeId=

"org.eclipse.ui.globalScope"

>

<accelerator id=

"org.eclipse.ui.ExampleActionA"

key=

"CTRL+R CTRL+A"

>

</accelerator>

<accelerator id=

"org.eclipse.ui.ExampleActionB"

key=

"CTRL+R CTRL+B"

>

</accelerator>

<accelerator id=

"org.eclipse.ui.ExampleActionC"

key=

"CTRL+R CTRL+C || CTRL+SHIFT+DELETE"

>

</accelerator>

</acceleratorSet>

</extension>

可有多個加速器指定給加速器集中的同一動作,但只使用一個。

如果已指定語言環境和 / 或平台,加速器最好符合現在所使用的平台和語言環境。 現行語言環境由 API Locale.getDefault() 所判斷,而平台由 API SWT.getPlatform() 所決定。如果已指定平台和/或語言環境,而它並不符合現行的語言環境和/或平台,即捨棄這個加速器。 如果加速器 A 只定義語言環境而 B 只定義平台,會使用 B。 如果加速器 A 定義 ja 為它的語言環境而 B 定義 ja_JP,因現行語言環境為 ja_JP,所以會使用 B。

如果是兩個定義於不同外掛程式中之加速器集的加速器,將依據外掛程式選取加速器。 如果外掛程式 A 依據 B,則使用定義於 B 中的加速器。 如果 A 和 B 彼此不相依,將依外掛程式 ID 的字母排序。

如果兩個加速器定義於不同範圍中,將使用定義於現行範圍中的加速器。 如果加速器未定義於現行範圍或它的母項之一,即捨棄這個加速器。 如果加速器定義於母項和子項範圍中,則使用子項範圍。

工作台提供加速器集給 Default 和 Emacs 加速器配置。