방법: 사용자 지정 모델링 도구 상자 항목 정의

아티클
06/10/2015

자주 사용하는 패턴에 따라 요소 또는 요소 그룹을 쉽게 만들 수 있도록 Visual Studio Ultimate의 모델링 다이어그램 도구 상자에 새 도구를 추가할 수 있습니다. 이러한 도구 상자 항목을 다른 Visual Studio Ultimate 사용자에게 배포할 수도 있습니다.

사용자 지정 도구 다이어그램에서 하나 이상의 새 요소를 만듭니다. 사용자 지정 연결 도구를 만들 수 없습니다.

예를 들어, 다음과 같은 요소를 만들 수 있는 사용자 지정 도구를 만들 수 있습니다.

.NET 프로필에 링크된 패키지 및 .NET 스테레오타입을 포함하는 클래스
관찰자 패턴을 나타내기 위해 연결에 의해 링크된 클래스 한 쌍

이 방법을 사용하여 요소 도구를 만들 수 있습니다. 즉, 도구 상자에서 다이어그램으로 끌어 오는 도구를 만들 수 있습니다. 연결선 도구는 만들 수 없습니다.

사용자 지정 모델링 도구 정의

사용자 지정 모델링 도구를 정의하려면

요소 또는 요소 그룹을 포함하는 UML 다이어그램을 만듭니다.
- 이러한 요소는 요소 간의 관계를 가질 수도 있고 포트, 특성, 작업 또는 핀과 같은 보조 요소를 가질 수도 있습니다.
새 도구에 지정할 이름을 사용 하 여 다이어그램을 저장 합니다. 에 파일 메뉴 사용 저장...As.
Windows 탐색기를 사용하여 두 다이어그램 파일을 다음 폴더 또는 하위 폴더에 복사합니다.

YourDocuments**\Visual Studio 2012\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 파일로 패키지할 수 있습니다. 자세한 내용은 Deploying Visual Studio Extensions를 참조하십시오.

일반적으로 VSIX 프로젝트 템플릿을 사용하여 Visual Studio Extension을 빌드합니다. 이렇게 하려면 Visual Studio SDK가 설치되어 있어야 합니다.

Visual Studio Extension에 도구 상자 항목을 추가하려면

하나 이상의 사용자 지정 도구를 만들고 테스트합니다.
이 도구를 참조하는 .tbxinfo 파일을 만듭니다.
기존 Visual Studio Extension 프로젝트를 엽니다.

-또는-

새 Visual Studio Extension 프로젝트를 정의합니다.
1. 파일 메뉴에서 새로 만들기, 프로젝트를 선택합니다.
2. 에 새 프로젝트 대화 상자에서 설치 된 템플릿, 선택 C#, 확장성, VSIX 프로젝트.
프로젝트에 도구 상자 정의를 추가합니다. .tbxinfo 파일, 다이어그램 파일, 비트맵 파일 및 리소스 파일을 포함하고 이러한 파일이 VSIX에 포함되도록 합니다.
- 솔루션 탐색기에서 VSIX 프로젝트를 바로 가기 메뉴에서 선택 추가, 기존 항목. 대화 상자가 나타나면 형식의 개체: 모든 파일을 설정합니다. 파일을 찾아 모두 선택 하 고 다음 선택 추가.
  
  참고
  
  이 프로젝트에서는 모델 편집기에서 다이어그램 파일을 열 수 없습니다.
방금 추가한 모든 파일에 대해 다음 속성을 설정합니다. 솔루션 탐색기에서 모든 파일을 선택하여 해당 속성을 동시에 설정할 수 있습니다. 이때 프로젝트에 포함된 다른 파일의 속성은 변경하지 않도록 주의합니다.

출력 디렉터리로 복사 = 항상 복사

빌드 작업 = 내용

Include in VSIX = true
source.extension.vsixmanifest를 엽니다. 확장 매니페스트 편집기에서 파일이 열립니다.
아래 메타 데이터, 사용자 지정 도구에 대 한 설명을 추가 합니다.

아래 자산, 선택 New 다음 필드 대화 상자에서 다음과 같이 설정:
- 형식 = 사용자 지정 확장 형식
- 형식 = Microsoft.VisualStudio.ArchitectureTools.CustomToolboxItems
  
  참고
  
  이 드롭다운 목록에서 옵션 중 하나 아닙니다.사용자가 키보드를 사용 하 여 입력 해야 합니다.
- 소스 = 파일 시스템에 파일을.
- 경로 = 사용자 .tbxinfo 예를 들어 파일MyTools.tbxinfo
프로젝트를 빌드합니다.
확장이 제대로 작동 하는지 확인 하려면, F5 키를 누릅니다. Visual Studio 실험적 인스턴스에서 시작합니다.

실험적 인스턴스를 만들거나 관련 형식의 UML 다이어그램을 엽니다. 새 도구 도구 상자에 나타나고 요소가 올바르게 만들어집니다 확인 하십시오.
배포에 대 한 VSIX 파일을 가져오려면: Windows 탐색기에서 폴더 열기 .\bin\Debug 또는 .\bin\Release 찾을 수 있는 .vsix 파일. 이 파일은 Visual Studio Extension 파일입니다. 이 파일을 컴퓨터에 설치하거나 다른 Visual Studio 사용자에게 보낼 수 있습니다.

Visual Studio Extension에서 사용자 지정 도구를 설치하려면

열려 있는 .vsix 파일을 Windows 탐색기 또는 Visual Studio.
선택 설치 에 표시 되는 대화 상자입니다.
확장을 제거하거나 일시적으로 사용할 수 없게 하려면 도구 메뉴에서 확장 관리자를 엽니다.

지역화

확장이 다른 컴퓨터에 설치되어 있는 경우 도구 이름 및 도구 설명이 대상 컴퓨터의 언어로 표시되도록 할 수 있습니다.

도구의 버전을 둘 이상의 언어로 제공하려면

사용자 지정 도구를 하나 이상 포함하는 Visual Studio Extension 프로젝트를 만듭니다.

.tbxinfo 파일에서 리소스 파일 메서드를 사용하여 도구의 displayName, 도구 상자 tabName 및 도구 설명을 정의합니다. 그런 다음 이러한 문자열이 정의되어 있는 리소스 파일을 만들어 어셈블리로 컴파일하고 tbxinfo 파일에서 참조합니다.
다른 언어의 문자열로 리소스 파일을 포함하는 추가 어셈블리를 만듭니다.
해당 언어의 문화권 코드를 이름으로 사용하는 폴더에 각 추가 어셈블리를 넣습니다. 예를 들어 프랑스어 버전의 어셈블리는 fr 폴더에 넣습니다.
이때 fr-CA와 같은 특정 문화권이 아니라 일반적으로 두 자로 된 중립 문화권 코드를 사용해야 합니다. 문화권 코드에 대한 자세한 내용은 전체 문화권 코드 목록을 제공하는 CultureInfo.GetCultures method 페이지를 참조하십시오.
Visual Studio Extension을 빌드하고 배포합니다.
다른 컴퓨터에 확장이 설치되어 있으면 해당 사용자의 로컬 문화권에 맞는 리소스 파일 버전이 자동으로 로드됩니다. 사용자의 문화권에 맞는 버전을 제공하지 않은 경우에는 기본 리소스가 사용됩니다.

이 방법을 사용하여 프로토타입 다이어그램의 다른 버전을 설치할 수는 없습니다. 요소 및 연결선의 이름은 모든 설치에서 동일합니다.

기타 도구 상자 작업

일반적으로 Visual Studio, 도구 이름 바꾸기, 다른 도구 상자 탭으로 이동 하 여 삭제 하면 도구 상자를 개인 설정할 수 있습니다. 그러나이 항목에서 설명 하는 절차를 사용 하 여 만든 사용자 지정 모델링 도구에 대 한 이러한 변경 내용은 유지 되지 않습니다. Visual Studio를 다시 시작하면 사용자 지정 도구는 원래 정의된 이름 및 도구 상자 위치에 다시 나타납니다.

또한 도구 상자 다시 설정 명령을 수행하면 사용자 지정 도구가 없어집니다. 그러나 Visual Studio를 다시 시작하면 다시 나타납니다.