방법: 사용자 지정 모델링 도구 상자 항목 정의
자주 사용하는 패턴에 따라 요소 또는 요소 그룹을 쉽게 만들 수 있도록 Visual Studio Ultimate의 모델링 다이어그램 도구 상자에 새 도구를 추가할 수 있습니다. 이러한 도구 상자 항목을 다른 Visual Studio Ultimate 사용자에게 배포할 수도 있습니다.
예를 들어 다음과 같은 요소를 만들기 위해 사용자 지정 도구를 추가할 수 있습니다.
.NET 프로필에 링크된 패키지 및 .NET 스테레오타입을 포함하는 클래스
관찰자 패턴을 나타내기 위해 연결에 의해 링크된 클래스 한 쌍
이 방법을 사용하여 요소 도구를 만들 수 있습니다. 즉, 도구 상자에서 다이어그램으로 끌어 오는 도구를 만들 수 있습니다. 연결선 도구는 만들 수 없습니다.
사용자 지정 모델링 도구 정의
사용자 지정 모델링 도구를 정의하려면
요소 또는 요소 그룹을 포함하는 UML 다이어그램을 만듭니다.
이러한 요소는 요소 간의 관계를 가질 수도 있고 포트, 특성, 작업 또는 핀과 같은 보조 요소를 가질 수도 있습니다.
솔루션 탐색기에서 다이어그램 이름을 새 도구에 지정할 이름으로 변경합니다.
다이어그램을 저장합니다.
Windows 탐색기를 사용하여 두 다이어그램 파일을 다음 폴더 또는 하위 폴더에 복사합니다.
YourDocuments**\Visual Studio 2010\Architecture Tools\Custom Toolbox Items**
이 폴더가 없으면 새로 만듭니다. Architecture Tools 폴더와 Custom Toolbox Items 폴더를 모두 만들어야 할 수 있습니다.
하나는 이름이 "…diagram"으로 끝나고 다른 하나는 이름이 "…diagram.layout"으로 끝나는 두 다이어그램 파일을 모두 복사합니다.
사용자 지정 도구를 원하는 수만큼 만들 수 있으며 각 도구에 하나의 다이어그램을 사용합니다.
(선택 사항) 사용자 지정 도구의 속성을 정의하는 방법에 설명된 대로 .tbxinfo 파일을 만들어 같은 디렉터리에 추가합니다. 이렇게 하면 도구 상자 아이콘, 도구 설명 등을 정의할 수 있습니다.
- 단일 .tbxinfo 파일을 사용하여 여러 도구를 정의할 수 있습니다. 이 파일은 하위 폴더의 다이어그램 파일을 참조할 수 있습니다.
Visual Studio를 다시 시작합니다. 해당 형식의 다이어그램에 대해 도구 상자에 추가 도구가 나타납니다.
사용자 지정 도구의 복제 기능
사용자 지정 도구는 다음과 같이 소스 다이어그램에서 대부분의 기능을 복제합니다.
이름. 도구 상자에서 항목이 만들어지면 같은 네임스페이스에서 이름이 중복되지 않도록 하기 위해 필요한 경우 이름의 끝에 번호가 추가됩니다.
색, 크기, 모양
스테레오타입 및 패키지 프로필
속성 값(예: 추상)
링크된 작업 항목
복합성 및 기타 관계 속성
모양의 상대 위치
다음 기능은 사용자 지정 도구에서 유지되지 않습니다.
단순 도형. 단순 도형은 모델 요소와 관련이 없는 도형으로, 일부 종류의 다이어그램에서 그릴 수 있습니다.
연결선 라우팅. 연결선을 수동으로 라우트하면 도구를 사용할 때 라우팅이 유지되지 않습니다. 포트와 같이 일부 중첩된 모양의 위치는 소유자에 상대적인 위치로 유지되지 않습니다.
사용자 지정 도구의 속성을 정의하는 방법
도구 상자 정보 파일(.tbxinfo)을 사용하면 도구 상자 이름, 아이콘, 도구 설명, 탭, 하나 이상의 사용자 지정 도구에 대한 도움말 키워드 등을 지정할 수 있습니다. 이 파일에는 MyTools.tbxinfo와 같은 임의의 이름을 지정합니다.
일반적으로 이 파일은 다음과 같은 형식으로 되어 있습니다.
<?xml version="1.0" encoding="utf-8" ?>
<customToolboxItems xmlns="https://schemas.microsoft.com/visualstudio/2010/ArchitectureTools/CustomToolboxItems">
<customToolboxItem fileName="MyObserverTool.classdiagram">
<displayName>
<value>Observer Pattern</value>
</displayName>
<tabName>
<value>UML Class Diagram</value>
</tabName>
<image><bmp fileName="ObserverPatternIcon.bmp"/></image>
<f1Keyword>
<value>ObserverPatternHelp</value>
</f1Keyword>
<tooltip>
<value>Create a pair of classes</value>
</tooltip>
</customToolboxItem>
</customToolboxItems>
각 항목의 값은 다음과 같이 될 수 있습니다.
- 이 예제와 같이 도구 상자 아이콘의 경우 <bmp fileName="…"/>이고 다른 항목의 경우 <value>string</value>입니다.
-또는-
<resource fileName="Resources.dll"
baseName="Observer.resources" id="Observer.tabname" />
이 경우에는 문자열 값을 리소스로 컴파일한 컴파일된 어셈블리를 제공합니다.
정의할 각 도구 상자 항목에 대해 <customToolboxItem> 노드를 추가합니다.
.tbxinfo 파일의 노드는 다음과 같습니다. 각 노드에 대한 기본값이 있습니다.
노드 이름 |
정의 |
|---|---|
displayName |
도구 상자 항목의 이름 |
tabName |
항목이 나타나는 도구 상자 탭. 이 다이어그램 형식에 대한 일반 탭의 이름 또는 별도의 이름을 지정할 수 있습니다. |
image |
비트맵 파일(.bmp)의 위치. 이 파일은 높이와 너비가 각각 16이고 색상 수는 24비트여야 합니다. |
f1Keyword |
도움말 항목을 찾는 키워드 |
tooltip |
이 도구에 대한 도구 설명 |
Visual Studio에서 비트맵 파일을 편집하고 속성 창에서 높이와 너비를 16으로 설정할 수 있습니다.
참고
다이어그램 파일만 사용하여 실험한 후 .tbxinfo 파일을 사용하기 시작하면 도구 상자에 이전 버전과 새 버전의 도구 상자 항목이 둘 다 포함되어 있음을 알 수 있습니다. .tbxinfo 파일에 다이어그램 파일 이름을 잘못 입력한 경우에도 이렇게 될 수 있습니다. 이 경우에는 도구 상자 항목을 마우스 오른쪽 단추로 클릭하고 도구 상자 다시 설정을 클릭합니다. 그러면 사용자 지정 도구 상자 항목이 없어집니다. 이제 Visual Studio를 다시 시작하면 올바른 사용자 지정 항목이 나타납니다.
Visual Studio Extension에서 도구 상자 항목을 배포하는 방법
도구 상자 항목을 VSIX(Visual Studio Extension)에 패키지하여 다른 Visual Studio 사용자에게 배포할 수 있습니다. 명령, 프로필 및 기타 확장을 같은 VSIX 파일에 패키지할 수 있습니다. 자세한 내용은 Visual Studio Extension 배포를 참조하십시오.
일반적으로 VSIX 프로젝트 템플릿을 사용하여 Visual Studio Extension을 빌드합니다. 이렇게 하려면 Visual Studio SDK가 설치되어 있어야 합니다.
Visual Studio Extension에 도구 상자 항목을 추가하려면
하나 이상의 사용자 지정 도구를 만들고 테스트합니다.
이 도구를 참조하는 .tbxinfo 파일을 만듭니다.
기존 Visual Studio Extension 프로젝트를 엽니다.
-또는-
새 Visual Studio Extension 프로젝트를 정의합니다.
파일 메뉴에서 새로 만들기를 가리킨 다음 프로젝트를 클릭합니다.
새 프로젝트 대화 상자의 설치된 템플릿에서 **Visual C#**을 확장하고 확장성, VSIX 프로젝트를 차례로 클릭합니다. 그런 다음 프로젝트 이름을 설정하고 확인을 클릭합니다.
프로젝트에 도구 상자 정의를 추가합니다. .tbxinfo 파일, 다이어그램 파일, 비트맵 파일 및 리소스 파일을 포함하고 이러한 파일이 VSIX에 포함되도록 합니다.
솔루션 탐색기에서 프로젝트를 마우스 오른쪽 단추로 클릭하고 추가를 가리킨 다음, 기존 항목을 클릭합니다. 대화 상자가 나타나면 형식의 개체: 모든 파일을 설정합니다. 그런 다음 파일을 찾아 모두 선택하고 추가를 클릭합니다.
참고
이 프로젝트에서는 모델 편집기에서 다이어그램 파일을 열 수 없습니다.
방금 추가한 모든 파일에 대해 다음 속성을 설정합니다. 솔루션 탐색기에서 모든 파일을 선택하여 해당 속성을 동시에 설정할 수 있습니다. 이때 프로젝트에 포함된 다른 파일의 속성은 변경하지 않도록 주의합니다.
출력 디렉터리로 복사 = 항상 복사
빌드 작업 = 내용
Include in VSIX = true
source.extension.vsixmanifest를 엽니다. 확장 매니페스트 편집기에서 파일이 열립니다.
콘텐츠 아래에 사용자 지정 도구를 설명하는 행을 추가합니다. 콘텐츠 추가를 클릭하고 이 대화 상자의 필드를 다음과 같이 설정합니다.
콘텐츠 형식 = 사용자 지정 확장 형식
형식 = Microsoft.VisualStudio.ArchitectureTools.CustomToolboxItems
경로 = 프로젝트 내의 파일. .tbxinfo 파일(예: MyTools.tbxinfo)을 선택합니다.
제품 이름 및 원하는 경우 다른 필드를 설정할 수 있습니다.
프로젝트를 빌드합니다.
Windows 탐색기에서 .\bin\Debug 또는 .\bin\Release 폴더를 열어 .vsix 파일을 찾습니다. 이 파일은 Visual Studio Extension 파일입니다. 이 파일을 컴퓨터에 설치하거나 다른 Visual Studio 사용자에게 보낼 수 있습니다.
Visual Studio Extension에서 사용자 지정 도구를 설치하려면
Windows 탐색기에서 .vsix 파일을 두 번 클릭하거나 Visual Studio에서 이 파일을 엽니다.
대화 상자가 나타나면 설치를 클릭합니다.
확장을 제거하거나 일시적으로 사용할 수 없게 하려면 도구 메뉴에서 확장 관리자를 엽니다.
지역화
확장이 다른 컴퓨터에 설치되어 있는 경우 도구 이름 및 도구 설명이 대상 컴퓨터의 언어로 표시되도록 할 수 있습니다.
도구의 버전을 둘 이상의 언어로 제공하려면
사용자 지정 도구를 하나 이상 포함하는 Visual Studio Extension 프로젝트를 만듭니다.
.tbxinfo 파일에서 리소스 파일 메서드를 사용하여 도구의 displayName, 도구 상자 tabName 및 도구 설명을 정의합니다. 그런 다음 이러한 문자열이 정의되어 있는 리소스 파일을 만들어 어셈블리로 컴파일하고 tbxinfo 파일에서 참조합니다.
다른 언어의 문자열로 리소스 파일을 포함하는 추가 어셈블리를 만듭니다.
해당 언어의 문화권 코드를 이름으로 사용하는 폴더에 각 추가 어셈블리를 넣습니다. 예를 들어 프랑스어 버전의 어셈블리는 fr 폴더에 넣습니다.
이때 fr-CA와 같은 특정 문화권이 아니라 일반적으로 두 자로 된 중립 문화권 코드를 사용해야 합니다. 문화권 코드에 대한 자세한 내용은 전체 문화권 코드 목록을 제공하는 CultureInfo.GetCultures method 페이지를 참조하십시오.
Visual Studio Extension을 빌드하고 배포합니다.
다른 컴퓨터에 확장이 설치되어 있으면 해당 사용자의 로컬 문화권에 맞는 리소스 파일 버전이 자동으로 로드됩니다. 사용자의 문화권에 맞는 버전을 제공하지 않은 경우에는 기본 리소스가 사용됩니다.
이 방법을 사용하여 프로토타입 다이어그램의 다른 버전을 설치할 수는 없습니다. 요소 및 연결선의 이름은 모든 설치에서 동일합니다.
기타 도구 상자 작업
일반적으로 Visual Studio에서는 도구 이름 바꾸기, 도구를 다른 도구 상자 탭으로 이동, 도구 삭제 등의 작업을 수행하여 도구 상자를 개인 설정할 수 있습니다. 그러나 이러한 변경 내용은 이 항목에서 설명하는 절차를 통해 만든 사용자 지정 모델링 도구에 대해서는 유지되지 않습니다. Visual Studio를 다시 시작하면 사용자 지정 도구는 원래 정의된 이름 및 도구 상자 위치에 다시 나타납니다.
또한 도구 상자 다시 설정 명령을 수행하면 사용자 지정 도구가 없어집니다. 그러나 Visual Studio를 다시 시작하면 다시 나타납니다.