2.1
org.eclipse.ui.commands
확장점은 command
및 category
요소를 사용하여
명령 및 명령 카테고리를 선언하는 데 사용됩니다. 명령은 어떤 의미론적 동작의 추상적 표시이지만, 실제 구현은 아닙니다. 이는 서로 다른 개발자들이 개별 부분에 대해 특정 작동을 제공할 수 있게 합니다. 예를 들어 편집기에 하나의 구현을 갖고 탐색기 위지트(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
를 지정하십시오.
ID
속성).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.actionSets
및 org.eclipse.ui.editorActions 확장점을 참조하십시오.
activeWhen
조건을 지정하지 않는
다른 핸들러 정의와 충돌합니다. IExecutableExtension
을 작성 중인 경우 defaultHandler
요소를 대신 사용할 수 있습니다. <!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
요소를 사용하십시오.
java.util.Locale
에 선언된 형식에 따라 지정됩니다.platform
속성의 가능한 값은 org.eclipse.swt.SWT.getPlatform()
에서 리턴된
가능한 값 세트입니다.key
요소에서 schemeId
속성을 사용하십시오. 명령에 지정할 키 순서입니다. 키 순서는 하나 이상의 키 스트로크로 구성되며, 여기서 키 스트로크는 키보드의 키로 구성되고, 선택적으로 Ctrl, Alt, Shift 및 명령과 같은 하나 이상의 수정자와 함께 선택됩니다. 키 스트로크는 공백으로 분리되며, 수정자는 '+' 문자로 분리됩니다.
수정자 키는 또한 플랫폼에 무관한 방법으로 표현될 수 있습니다. 예를 들어 MacOS X에서 "명령"이 거의 항상 "Ctrl" 대신 사용됩니다. 따라서 "Ctrl" 또는 "명령" 중 하나에 적절하게 맵핑되는 "M1"을 제공합니다. 비슷하게 "M2"는 "Shift", "M3"는 "Alt" 및 "M4"는 "Ctrl"입니다(MacOS X). 추가 플랫폼이 추가되는 경우 좋은 플랫폼 기본값에 맵핑되는 이러한 별명을 계수할 수 있습니다.
이 문자열의 구문은 org.eclipse.ui.internal.keys
에 정의됩니다. 간략하게 모든 대문자가 문체적으로 바람직하지만 문자열은
대소문자를 구분하지 않습니다. 키가 문자인 경우 단순히 문자를 추가하십시오. 키가 특수 키(즉 비 ASCII)인 경우, ARROW_DOWN, ARROW_LEFT, ARROW_RIGHT, ARROW_UP, BREAK, CAPS_LOCK, END, F1, F2, F3, F4, F5, F6, F7, F8, F9, F10, F11, F12, F13, F14, F15, HOME, INSERT, NUM_LOCK, NUMPAD_0, NUMPAD_1, NUMPAD_2, NUMPAD_3, NUMPAD_4, NUMPAD_5, NUMPAD_6, NUMPAD_7, NUMPAD_8, NUMPAD_9, NUMPAD_ADD, NUMPAD_DECIMAL, NUMPAD_DIVIDE, NUMPAD_ENTER, NUMPAD_EQUAL, NUMPAD_MULTIPLY, NUMPAD_SUBTRACT, PAGE_UP, PAGE_DOWN, PAUSE, PRINT_SCREEN 또는 SCROLL_LOCK
중 하나를 사용하십시오. 키가 인쇄할 수 없는 ASCII 키인 경우 BS, CR, DEL, ESC, FF, LF, NUL, SPACE, TAB 또는 VT 중 하나를
사용하십시오. 기본 키보드 Enter/Return 키는 CR입니다.
<!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 같이 취급되어야 합니다.
org.eclipse.core.commands.IParameterValues
를
구현해야 합니다. 이 클래스가 지정되지 않으면 더욱 상세한 values
요소를 지정해야 합니다.
org.eclipse.core.runtime.IExecutableExtension
을 참조하십시오. <!ATTLIST values
class CDATA #REQUIRED>
commandParameter
의 values
속성의 더욱 상세한 버전입니다.
org.eclipse.core.commands.IParameterValues
를
구현해야 합니다. 이 클래스가 지정되지 않으면 더욱 상세한 values
요소를 지정해야 합니다.
org.eclipse.core.runtime.IExecutableExtension
을 참조하십시오. <!ELEMENT parameter EMPTY>
<!ATTLIST parameter
name CDATA #REQUIRED
value CDATA #REQUIRED>
매개변수에 대한 가능한 값입니다.
IExecutableExtension
으로 전달할 매개변수 이름입니다. IExecutableExtension
으로 전달할 매개변수의 값입니다. <!ELEMENT defaultHandler (parameter)>
<!ATTLIST defaultHandler
class CDATA #REQUIRED>
이 명령에 대한 기본 핸들러입니다. 활성 상태인 다른 핸들러가 없는 경우 이 핸들러가 활성이 됩니다. 이 핸들러는 activeWhen
조건을 지정하지 않는
다른 핸들러 정의와 충돌합니다. IExecutableExtension
을 작성 중이 아니면 대신 defaultHandler
속성을 사용할 수 있습니다.
org.eclipse.core.commands.IHandler
를 구현하는 클래스입니다.
org.eclipse.ui
플러그인의 plugin.xml
파일은
org.eclipse.ui.commands
확장점을 다양하게 사용합니다.
이 정보는 이 확장점 이외의 명령, 카테고리, 키 바인딩, 키 구성 또는 컨텍스트 등을 선언하기 위한
공용 API가 아닙니다. 특정 명령을 처리하는 조치를 등록할 뿐만 아니라 컨텍스트를 조회하고
설정하기 위한 공용 API는 org.eclipse.ui.IKeyBindingService
에서 찾을 수 있습니다.
Copyright (c) 2000, 2005 IBM Corporation and others.
All rights reserved. 본 프로그램 및 본 프로그램에 동봉되는 자료는 본 배포물에 동봉되는 Eclipse Public License v1.0의 조항에 따라 사용해야 하며
웹 사이트(http://www.eclipse.org/legal/epl-v10.html)에서도 관련 사항을 참조할 수 있습니다.