편집기 항목 템플릿을 사용 하 여 확장 만들기Create an extension with an editor item template

Visual Studio SDK에 포함 된 항목 템플릿을 사용 하 여 편집기에 분류자, 장식 및 여백을 추가 하는 기본 편집기 확장을 만들 수 있습니다.You can use item templates that are included in the Visual Studio SDK to create basic editor extensions that add classifiers, adornments, and margins to the editor. 편집기 항목 템플릿은 Visual c # 또는 Visual Basic VSIX 프로젝트에 사용할 수 있습니다.The editor item templates are available for Visual C# or Visual Basic VSIX projects.

사전 요구 사항Prerequisites

Visual Studio 2015 부터는 다운로드 센터에서 Visual Studio SDK를 설치 하지 않습니다.Starting in Visual Studio 2015, you do not install the Visual Studio SDK from the download center. Visual Studio 설치 프로그램에서 선택적 기능으로 포함 됩니다.It is included as an optional feature in Visual Studio setup. VS SDK는 나중에 설치할 수도 있습니다.You can also install the VS SDK later on. 자세한 내용은 Visual STUDIO SDK 설치를 참조 하세요.For more information, see Install the Visual Studio SDK.

분류자 확장 만들기Create a classifier extension

편집기 분류자 항목 템플릿은 텍스트 파일에서 적절 한 텍스트 (이 경우 모든 항목)를 색으로 구분 하는 편집기 분류자를 만듭니다.The Editor Classifier item template creates an editor classifier that colors the appropriate text (in this case, everything) in any text file.

  1. 새 프로젝트 대화 상자에서 Visual c # 또는 Visual Basic 을 확장 한 다음 확장성 을 클릭 합니다.In the New Project dialog box, expand Visual C# or Visual Basic and then click Extensibility. 템플릿 창에서 VSIX 프로젝트 를 선택 합니다.In the Templates pane, select VSIX Project. 이름 상자에서 TestClassifier을 입력합니다.In the Name box, type TestClassifier. 확인 을 클릭합니다.Click OK.

  2. 솔루션 탐색기 에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭 하 고 > 새 항목 추가를 선택 합니다.In the Solution Explorer, right-click the project node and select Add > New Item. Visual c # 확장성 노드로 이동 하 여 편집기 분류자 를 선택 합니다.Go to the Visual C# Extensibility node and select Editor Classifier. 기본 파일 이름 (EditorClassifier1)을 그대로 둡니다.Leave the default file name (EditorClassifier1.cs).

  3. 다음과 같이 4 개의 코드 파일이 있습니다.There are four code files, as follows:

    • EditorClassifier1 에는 클래스가 포함 되어 있습니다. EditorClassifier1EditorClassifier1.cs contains the EditorClassifier1 class.

    • EditorClassifier1ClassificationDefinition 에는 클래스가 포함 되어 있습니다. EditorClassifier1ClassificationDefinitionEditorClassifier1ClassificationDefinition.cs contains the EditorClassifier1ClassificationDefinition class.

    • EditorClassifier1Format 에는 클래스가 포함 되어 있습니다. EditorClassifier1FormatEditorClassifier1Format.cs contains the EditorClassifier1Format class.

    • EditorClassifier1Provider 에는 클래스가 포함 되어 있습니다. EditorClassifier1ProviderEditorClassifier1Provider.cs contains the EditorClassifier1Provider class.

  4. 프로젝트를 빌드하고 디버깅을 시작합니다.Build the project and start debugging. Visual Studio의 실험적 인스턴스가 나타납니다.The experimental instance of Visual Studio appears.

    텍스트 파일을 열면 모든 텍스트에 자주색 배경의 밑줄이 표시 됩니다.If you open a text file, all the text is underlined against a violet background.

텍스트 상대 장식 확장 만들기Create a text-relative adornment extension

편집기 텍스트 장식 템플릿은 빨간색 윤곽선과 파란색 배경이 있는 상자를 사용 하 여 텍스트 문자 ' a '의 모든 인스턴스를 데코레이팅하는 텍스트 관련 장식을 만듭니다.The Editor Text Adornment template creates a text-relative adornment that decorates all instances of the text character 'a' by using a box that has a red outline and a blue background. 상자는 이동 하거나 다시 포맷 하는 경우에도 항상 ' a ' 문자를 중첩 하므로 텍스트를 기준으로 합니다.It is text-relative because the box always overlays the 'a' characters, even when they are moved or reformatted.

  1. 새 프로젝트 대화 상자에서 Visual c # 또는 Visual Basic 을 확장 한 다음 확장성 을 클릭 합니다.In the New Project dialog box, expand Visual C# or Visual Basic and then click Extensibility. 템플릿 창에서 VSIX 프로젝트 를 선택 합니다.In the Templates pane, select VSIX Project. 이름 상자에서 TestAdornment을 입력합니다.In the Name box, type TestAdornment. 확인 을 클릭합니다.Click OK.

  2. 솔루션 탐색기 에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭 하 고 > 새 항목 추가를 선택 합니다.In the Solution Explorer, right-click the project node and select Add > New Item. Visual c # 확장성 노드로 이동 하 여 편집기 텍스트 장식 을 선택 합니다.Go to the Visual C# Extensibility node and select Editor Text Adornment. 기본 파일 이름을 그대로 둡니다 (TextAdornment1/vb).Leave the default file name (TextAdornment1.cs/vb).

  3. 다음과 같은 두 가지 코드 파일이 있습니다.There are two code files, as follows:

    • TextAdornment1 에는 클래스가 포함 되어 있습니다. TextAdornment1TextAdornment1.cs contains the TextAdornment1 class.

    • TextAdornment1TextViewCreationListener 에는 클래스가 포함 되어 있습니다. TextAdornment1TextViewCreationListenerTextAdornment1TextViewCreationListener.cs contains the TextAdornment1TextViewCreationListener class.

  4. 프로젝트를 빌드하고 디버깅을 시작합니다.Build the project and start debugging. 실험적 인스턴스가 나타납니다.The experimental instance appears. 텍스트 파일을 여는 경우 텍스트의 모든 ' a ' 문자는 파란색 배경에 빨강으로 표시 됩니다.If you open a text file, all the 'a' characters in the text are outlined in red against a blue background.

뷰포트 관련 장식 확장 만들기Create a viewport-relative adornment extension

편집기 뷰포트 장식 템플릿은 뷰포트 오른쪽 위 모퉁이에 빨간색 윤곽선이 있는 자주색 상자를 추가 하는 뷰포트 관련 장식을 만듭니다.The Editor Viewport Adornment template creates a viewport-relative adornment that adds a violet box that has a red outline to the top-right corner of the viewport.

참고

뷰포트 는 현재 표시 되는 텍스트 뷰의 영역입니다.The viewport is the area of the text view that is currently displayed.

편집기 뷰포트 장식 템플릿을 사용 하 여 뷰포트 장식 확장을 만들려면To create a viewport adornment extension by using the Editor Viewport Adornment template

  1. 새 프로젝트 대화 상자에서 Visual c # 또는 Visual Basic 을 확장 한 다음 확장성 을 클릭 합니다.In the New Project dialog box, expand Visual C# or Visual Basic and then click Extensibility. 템플릿 창에서 VSIX 프로젝트 를 선택 합니다.In the Templates pane, select VSIX Project. 이름 상자에서 ViewportAdornment을 입력합니다.In the Name box, type ViewportAdornment. 확인 을 클릭합니다.Click OK.

  2. 솔루션 탐색기 에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭 하 고 > 새 항목 추가를 선택 합니다.In the Solution Explorer, right-click the project node and select Add > New Item. Visual c # 확장성 노드로 이동 하 여 편집기 뷰포트 장식 을 선택 합니다.Go to the Visual C# Extensibility node and select Editor Viewport Adornment. 기본 파일 이름을 그대로 둡니다 (ViewportAdornment1/vb).Leave the default file name (ViewportAdornment1.cs/vb).

  3. 다음과 같은 두 가지 코드 파일이 있습니다.There are two code files, as follows:

    • ViewportAdornment1 에는 클래스가 포함 되어 있습니다. ViewportAdornment1ViewportAdornment1.cs contains the ViewportAdornment1 class.

    • ViewportAdornment1TextViewCreationListener 에는 클래스가 포함 되어 있습니다. ViewportAdornment1TextViewCreationListenerViewportAdornment1TextViewCreationListener.cs contains the ViewportAdornment1TextViewCreationListener class

  4. 프로젝트를 빌드하고 디버깅을 시작합니다.Build the project and start debugging. 실험적 인스턴스가 나타납니다.The experimental instance appears. 새 텍스트 파일을 만드는 경우 뷰포트의 오른쪽 위에 빨간색 윤곽선이 있는 자주색 상자가 표시 됩니다.If you create a new text file, a violet box that has a red outline is displayed in the top-right corner of the viewport.

여백 확장 만들기Create a margin extension

편집기 여백 템플릿은 *Hello 세계! 라는 단어와 함께 표시 되는 녹색 여백을 만듭니다.The Editor Margin template creates a green margin that appears together with the words *Hello world! 가로 스크롤 막대 아래에 있습니다.below the horizontal scroll bar.

편집기 여백 템플릿을 사용 하 여 여백 확장을 만들려면To create a margin extension by using the Editor Margin template

  1. 새 프로젝트 대화 상자에서 Visual c # 또는 Visual Basic 을 확장 한 다음 확장성 을 클릭 합니다.In the New Project dialog box, expand Visual C# or Visual Basic and then click Extensibility. 템플릿 창에서 VSIX 프로젝트 를 선택 합니다.In the Templates pane, select VSIX Project. 이름 상자에서 MarginExtension을 입력합니다.In the Name box, type MarginExtension. 확인 을 클릭합니다.Click OK.

  2. 솔루션 탐색기 에서 프로젝트 노드를 마우스 오른쪽 단추로 클릭 하 고 > 새 항목 추가를 선택 합니다.In the Solution Explorer, right-click the project node and select Add > New Item. Visual c # 확장성 노드로 이동 하 고 편집기 여백 을 선택 합니다.Go to the Visual C# Extensibility node and select Editor Margin. 기본 파일 이름을 그대로 둡니다 (EditorMargin1/vb).Leave the default file name (EditorMargin1.cs/vb).

  3. 다음과 같은 두 가지 코드 파일이 있습니다.There are two code files, as follows:

    • EditorMargin1 에는 클래스가 포함 되어 있습니다. EditorMargin1EditorMargin1.cs contains the EditorMargin1 class.

    • EditorMargin1Factory 에는 클래스가 포함 되어 있습니다. EditorMargin1FactoryEditorMargin1Factory.cs contains the EditorMargin1Factory class.

  4. 이 프로젝트를 빌드하고 디버깅을 시작 합니다.Build this project and start debugging. 실험적 인스턴스가 나타납니다.The experimental instance appears. 텍스트 파일을 열면 Hello EditorMargin1 라는 단어가 있는 녹색 여백이 가로 스크롤 막대 아래에 표시 됩니다.If you open a text file, a green margin that has the words Hello EditorMargin1 is displayed below the horizontal scroll bar.

참조See also