XML 명령 테이블(.vsct) 파일 디자인
XML 명령 테이블(.vsct) 파일은 VSPackage에 대한 명령 항목의 레이아웃과 모양을 설명합니다. 명령 항목에는 단추, 콤보 상자, 메뉴, 도구 모음 및 명령 항목 그룹이 포함됩니다. 이 문서에서는 XML 명령 테이블 파일, 명령 항목 및 메뉴에 미치는 영향 및 파일을 만드는 방법에 대해 설명합니다.
명령, 메뉴, 그룹 및 .vsct 파일
.vsct 파일은 명령, 메뉴 및 명령 그룹을 중심으로 구성됩니다. .vsct 파일의 XML 태그는 이러한 각 항목을 명령 단추, 명령 배치 및 비트맵과 같은 다른 관련 항목과 함께 나타냅니다.
Visual Studio 패키지 템플릿을 실행하여 새 VSPackage를 만들 때 템플릿은 선택 항목에 따라 메뉴 명령, 도구 창 또는 사용자 지정 편집기에 필요한 요소를 사용하여 .vsct 파일을 생성합니다. 이 .vsct 파일은 특정 VSPackage의 요구 사항을 충족하도록 수정할 수 있습니다. .vsct 파일을 수정하는 방법에 대한 예제는 메뉴 및 명령 확장을 참조하세요.
빈 .vsct 파일을 새로 만들려면 방법: .vsct 파일 만들기를 참조하세요. 만든 후에는 XML 요소, 특성 및 값을 파일에 추가하여 명령 항목 레이아웃을 설명합니다. 자세한 XML 스키마는 VSCT XML 스키마 참조를 참조하세요.
.ctc 파일과 .vsct 파일 간 차이
.vsct 파일의 XML 태그는 현재 사용되지 않는 .ctc 파일 형식의 태그와 의미는 동일하지만 구현은 약간 다릅니다.
새 <extern> 태그는 Visual Studio 도구 모음에 대한 파일과 같이 컴파일할 다른 .h 파일을 참조하는 위치입니다.
.vsct 파일은 .ctc 파일과 마찬가지로 /include 문을 지원하지만 새 <import> 요소도 지원합니다. 차이점은 /include는 모든 정보를 가져오는 반면, <import>는 이름만 가져온다는 것입니다.
.ctc 파일에는 전처리기 지시문을 정의하는 헤더 파일이 필요하지만 .vsct 파일에는 필요하지 않습니다. 대신, .vsct 파일 맨 아래의 <Symbol> 요소에 있는 기호 테이블에 지시문을 배치합니다.
.vsct 파일에는 <주석> 태그가 있어 노트 또는 그림과 같은 원하는 정보를 포함할 수 있습니다.
값은 항목에 특성으로 저장됩니다.
명령 플래그는 개별적으로 저장하거나 배치할 수 있습니다. 그러나 IntelliSense는 배치된 명령 플래그에서 작동하지 않습니다. 명령 플래그에 대한 자세한 내용은 CommandFlag 요소를 참조하세요.
분할 드롭다운, 콤보 등 여러 유형을 지정할 수 있습니다.
GUID는 유효성을 검사하지 않습니다.
각 UI 요소에는 함께 표시되는 텍스트를 나타내는 문자열이 있습니다.
부모는 선택 사항입니다. 생략하면 알 수 없는 그룹 값이 사용됩니다.
Icon 인수는 선택 사항입니다.
Bitmap 섹션: 이 섹션은 이제 컴파일 시간에 vsct.exe 컴파일러에서 끌어올 Href를 통해 파일 이름을 지정할 수 있다는 점을 제외하면 .ctc 파일과 동일합니다.
ResID: 이전 비트맵 리소스 ID를 사용할 수 있으며 .ctc 파일에서와 동일하게 작동합니다.
HRef: 비트맵 리소스의 파일 이름을 지정할 수 있는 새 메서드입니다. 이 메서드는 모든 항목이 사용된다고 가정하므로 Used 섹션을 생략할 수 있습니다. 컴파일러는 먼저 파일에 대한 로컬 리소스를 검색한 다음 모든 순 공유 및 /I 스위치로 정의된 모든 리소스를 검색합니다.
키 바인딩: 더 이상 에뮬레이터를 지정할 필요가 없습니다. 에뮬레이터를 지정하면 컴파일러는 편집기와 에뮬레이터가 동일하다고 가정합니다.
키코드: 키코드는 삭제되었습니다. 새 형식은 Key1,Mod1,Key2,Mod2입니다. 문자, 16진수 또는 VK 상수를 지정할 수 있습니다.
새 컴파일러 vsct.exe는 .ctc 파일과 .vsct 파일을 모두 컴파일합니다. 그러나 이전의 ctc.exe 컴파일러는 .vsct 파일을 인식하거나 컴파일하지 않습니다.
vsct.exe 컴파일러를 사용하여 기존 .cto 파일을 .vsct 파일로 변환할 수 있습니다. 자세한 내용은 방법: 기존 .cto 파일에서 .vsct 파일 만들기를 참조하세요.
.vsct 파일 요소
명령 테이블에는 다음과 같은 계층 구조 및 요소가 있습니다.
CommandTable 요소: VSPackage와 연결된 모든 명령, 메뉴 그룹 및 메뉴를 나타냅니다.
Extern 요소: .vsct 파일과 병합하려는 외부 .h 파일을 참조합니다.
Include 요소: .vsct 파일과 함께 컴파일하려는 추가 헤더(.h) 파일을 참조합니다. .vsct 파일은 IDE 또는 다른 VSPackage에서 제공하는 명령, 메뉴 그룹 및 메뉴를 정의하는 상수가 포함된 .h 파일을 포함할 수 있습니다.
Commands 요소: 실행할 수 있는 모든 개별 명령을 나타냅니다. 각 명령에는 다음과 같은 4개의 자식 요소가 있습니다.
Menus 요소: VSPackage의 모든 메뉴 및 도구 모음을 나타냅니다. 메뉴는 명령 그룹의 컨테이너입니다.
Groups 요소: VSPackage의 모든 그룹을 나타냅니다. 그룹은 개별 명령의 컬렉션입니다.
Buttons 요소: VSPackage의 모든 명령 단추 및 메뉴 항목을 나타냅니다. 단추는 명령과 연결될 수 있는 시각적 컨트롤입니다.
Bitmaps 요소: VSPackage의 모든 단추에 대한 모든 비트맵을 나타냅니다. 비트맵은 컨텍스트에 따라 명령 단추 옆이나 명령 단추에 표시되는 그림입니다.
CommandPlacements 요소: VSPackage의 메뉴에서 개별 명령이 배치되어야 하는 추가 위치를 나타냅니다.
VisibilityConstraints 요소: 명령을 항상 표시할지 아니면 특정 대화 상자 또는 창이 표시되는 경우와 같은 특정 컨텍스트에서만 표시할지를 지정합니다. 이 요소에 대한 값이 있는 메뉴 및 명령은 지정된 컨텍스트가 활성 상태인 경우에만 표시됩니다. 기본 동작은 명령을 항상 표시하는 것입니다.
KeyBindings 요소: 명령에 대한 모든 키 바인딩을 지정합니다. 즉, Ctrl+S와 같이 명령을 실행하기 위해 눌러야 하는 하나 이상의 키 조합입니다.
UsedCommands 요소: 지정된 명령이 다른 코드에 의해 구현되지만 현재 VSPackage가 활성 상태일 때 명령 구현을 제공한다는 것을 Visual Studio 환경에 알립니다.
Symbols 요소: 패키지의 모든 명령에 대한 기호 이름 및 GUID ID를 포함합니다.
.vsct 파일 디자인 지침
.vsct 파일을 성공적으로 디자인하려면 다음 지침을 따르세요.
명령은 그룹에만 배치할 수 있고, 그룹은 메뉴에만 배치할 수 있고, 메뉴는 그룹에만 배치할 수 있습니다. 메뉴만 실제로 IDE에 표시되고 그룹 및 명령은 표시되지 않습니다.
하위 메뉴는 메뉴에 직접 할당할 수 없고 그룹에 할당해야 합니다. 그런 다음 그룹을 메뉴에 할당합니다.
명령, 하위 메뉴 및 그룹을 해당 정의 지시문의 부모 필드를 사용하여 하나의 부모/자식 관리 그룹 또는 메뉴에 할당할 수 있습니다.
지시문의 부모 필드를 통해서만 명령 테이블을 구성하는 데는 상당한 제한이 있습니다. 개체를 정의하는 지시문은 부모 인수를 하나만 사용할 수 있습니다.
명령, 그룹 또는 하위 메뉴 다시 사용하려면 새 지시문을 사용하여 자체
GUID:ID쌍으로 개체의 새 인스턴스를 만들어야 합니다.각
GUID:ID쌍은 고유해야 합니다. 예를 들어 메뉴, 도구 모음 또는 바로 가기 메뉴에 배치된 명령을 다시 사용하는 것은 IOleCommandTarget 인터페이스에서 처리됩니다.또한 명령 및 하위 메뉴를 여러 그룹에 할당할 수 있으며 Commands 요소를 사용하여 그룹을 여러 메뉴에 할당할 수 있습니다.
.vsct 파일 참고 사항
.vsct 파일을 컴파일하고 네이티브 위성 DLL에 배치한 후 해당 파일을 변경하는 경우 devenv.exe /setup /nosetupvstemplates를 실행해야 합니다. 이렇게 하면 실험적 레지스트리에 지정된 VSPackage 리소스를 다시 읽고 Visual Studio를 설명하는 내부 데이터베이스를 다시 빌드해야 합니다.
개발하는 동안 여러 VSPackage 프로젝트를 만들고 실험적 레지스트리 하이브에 등록할 수 있으므로 이로 인해 IDE에서 혼란을 야기할 수 있습니다. 이 문제를 해결하려면 실험적 하이브를 기본 설정으로 초기화하여 등록된 모든 VSPackage 및 IDE에 대한 변경 내용을 제거할 수 있습니다. 실험적 하이브를 초기화하려면 Visual Studio SDK와 함께 제공되는 CreateExpInstance.exe 도구를 사용합니다. 이 파일의 위치는 다음과 같습니다.
%PROGRAMFILES(x86)%\Visual Studio\<version> SDK\VisualStudioIntegration\Tools\Bin\CreateExpInstance.exe
CreateExpInstance /Reset 명령을 사용하여 도구를 실행합니다. 이 도구는 일반적으로 Visual Studio와 함께 설치되지 않는 등록된 모든 VSPackage를 실험적 하이브에서 제거한다는 점을 기억하세요.