명령

org.eclipse.ui.commands

2.1

org.eclipse.ui.commands 확장점은 commandcategory 요소를 사용하여 명령 및 명령 카테고리를 선언하는 데 사용됩니다. 명령은 어떤 의미론적 동작의 추상적 표시이지만, 실제 구현은 아닙니다. 이는 서로 다른 개발자들이 개별 부분에 대해 특정 작동을 제공할 수 있게 합니다. 예를 들어 편집기에 하나의 구현을 갖고 탐색기 위지트(widget)에 다른 구현을 갖는 "paste" 명령이 있을 수 있습니다. 이러한 구현을 핸들러라고 부릅니다.

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

<!ATTLIST extension

id    CDATA #IMPLIED

name  CDATA #IMPLIED

point CDATA #REQUIRED>


<!ELEMENT activeKeyConfiguration EMPTY>

<!ATTLIST activeKeyConfiguration

value              CDATA #IMPLIED

keyConfigurationId CDATA #IMPLIED>

이 요소는 Eclipse용 초기 활성 키 구성을 정의하는 데 사용됩니다. 이들 요소가 둘 이상이 존재하는 경우 마지막 선언된 요소(플러그인 레지스트리를 읽는 순서에서)가 유효한 것으로 간주됩니다.

이 요소는 환경 설정으로 대체되었습니다. 응용프로그램이 기본 키 구성을 변경해야 하는 경우 plugin_customization.ini 파일에 org.eclipse.ui/KEY_CONFIGURATION_ID=your.default.key.configuration.id를 지정하십시오.



<!ELEMENT category EMPTY>

<!ATTLIST category

description CDATA #IMPLIED

id          CDATA #REQUIRED

name         CDATA #REQUIRED>

UI에서 명령은 종종 더 잘 관리할 수 있도록 카테고리에서 구성됩니다. 이 요소는 카테고리를 정의하는 데 사용됩니다. 명령은 하나의 카테고리에만 추가될 수 있습니다. 이 요소들 중 하나 이상의 요소가 동일한 ID 속성을 사용하여 존재하는 경우 마지막 선언된 요소(플러그인 레지스트리 읽기 순으로)만 올바른 것으로 간주됩니다.



<!ELEMENT command (commandParameter | defaultHandler?)>

<!ATTLIST command

category       CDATA #IMPLIED

description    CDATA #IMPLIED

id             CDATA #REQUIRED

name           CDATA #REQUIRED

categoryId     CDATA #IMPLIED

defaultHandler CDATA #IMPLIED>

이 요소는 명령을 정의하는 데 사용됩니다. 명령은 조치가 처리할 수 있는 사용자의 요청을 표현하고 다른 명령들 가운데 의미상 고유해야 합니다. 이미 같은 의미로 정의된 명령이 있다면 명령을 정의하지 마십시오. 하나 이상의 요소가 같은 ID 속성을 사용하여 존재하는 경우 마지막 선언된 요소(플러그인 레지스트리 읽기 순으로)만 올바른 것으로 간주됩니다. 조치가 명령에 연결되는 방법을 이해하려면 org.eclipse.ui.actionSetsorg.eclipse.ui.editorActions 확장점을 참조하십시오.



<!ELEMENT keyBinding EMPTY>

<!ATTLIST keyBinding

configuration      CDATA #IMPLIED

command            CDATA #IMPLIED

locale             CDATA #IMPLIED

platform           CDATA #IMPLIED

contextId          CDATA #IMPLIED

string             CDATA #IMPLIED

scope              CDATA #IMPLIED

keyConfigurationId CDATA #IMPLIED

commandId          CDATA #IMPLIED

keySequence        CDATA #IMPLIED>

이 요소를 사용하면 명령에 키 순서를 지정할 수 있습니다. 대신 "org.eclipse.ui.bindings" 확장점에서 key 요소를 사용하십시오.



<!ELEMENT keyConfiguration EMPTY>

<!ATTLIST keyConfiguration

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED

parent      CDATA #IMPLIED

parentId    CDATA #IMPLIED>

이 요소는 키 구성을 정의하는 데 사용됩니다. 하나 이상의 요소가 같은 ID 속성을 사용하여 존재하는 경우 마지막 선언된 요소(플러그인 레지스트리 읽기 순으로)만 올바른 것으로 간주됩니다. 대신 "org.eclipse.ui.bindings" 확장점을 사용하십시오.



<!ELEMENT context EMPTY>

<!ATTLIST context

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED

parent      CDATA #IMPLIED

parentId    CDATA #IMPLIED>

이 요소는 컨텍스트를 정의하는 데 사용됩니다. 하나 이상의 요소가 같은 ID 속성을 사용하여 존재하는 경우 마지막 선언된 요소(플러그인 레지스트리 읽기 순으로)만 올바른 것으로 간주됩니다. 대신 org.eclipse.ui.contexts 확장점을 사용하십시오.



<!ELEMENT scope EMPTY>

<!ATTLIST scope

description CDATA #IMPLIED

id          CDATA #REQUIRED

name        CDATA #REQUIRED

parent      CDATA #IMPLIED>

이 요소는 범위를 정의하는 데 사용됩니다. 하나 이상의 요소가 같은 ID 속성을 사용하여 존재하는 경우 마지막 선언된 요소(플러그인 레지스트리 읽기 순으로)만 올바른 것으로 간주됩니다. deprecated 대신 "org.eclipse.ui.contexts" 확장점을 사용하십시오.



<!ELEMENT commandParameter (values)>

<!ATTLIST commandParameter

id       CDATA #REQUIRED

name     CDATA #REQUIRED

values   CDATA #IMPLIED

optional (true | false) "true">

명령이 이해해야 하는 매개변수를 정의합니다. 매개변수는 실행 시간에 핸들러에 추가 정보를 제공하는 방법입니다. 예를 들어 "show view" 명령은 보기를 매개변수로 사용할 수 있습니다. 핸들러가 이러한 매개변수를 이해할 수 있어야 하므로, API 같이 취급되어야 합니다.



<!ELEMENT values (parameter)>

<!ATTLIST values

class CDATA #REQUIRED>

commandParametervalues 속성의 더욱 상세한 버전입니다.



<!ELEMENT parameter EMPTY>

<!ATTLIST parameter

name  CDATA #REQUIRED

value CDATA #REQUIRED>

매개변수에 대한 가능한 값입니다.



<!ELEMENT defaultHandler (parameter)>

<!ATTLIST defaultHandler

class CDATA #REQUIRED>

이 명령에 대한 기본 핸들러입니다. 활성 상태인 다른 핸들러가 없는 경우 이 핸들러가 활성이 됩니다. 이 핸들러는 activeWhen 조건을 지정하지 않는 다른 핸들러 정의와 충돌합니다. IExecutableExtension을 작성 중이 아니면 대신 defaultHandler 속성을 사용할 수 있습니다.



org.eclipse.ui 플러그인의 plugin.xml 파일은 org.eclipse.ui.commands 확장점을 다양하게 사용합니다.

이 정보는 이 확장점 이외의 명령, 카테고리, 키 바인딩, 키 구성 또는 컨텍스트 등을 선언하기 위한 공용 API가 아닙니다. 특정 명령을 처리하는 조치를 등록할 뿐만 아니라 컨텍스트를 조회하고 설정하기 위한 공용 API는 org.eclipse.ui.IKeyBindingService에서 찾을 수 있습니다.