DSL 코드 이해

ConnectionBuilders.cs

연결 작성기 관계를 만드는 클래스입니다.이 코드 숨김 연결 도구입니다.이 파일 한 쌍의 각 연결 도구에 대 한 클래스를 포함합니다.자신의 이름을 도메인 관계 및 연결 도구 이름에서 파생 된: 관계작성기, 및 ConnectorToolConnectAction.

(컴포넌트 솔루션 예제에서 연결 작성기 중 하나가 ConnectionBuilder 호출 됩니다, 그리고 도메인 관계 명명 된 연결 때문에 만든 것입니다.)

관계 생성 됩니다 있는 관계Builder.Connect() 메서드.원본 및 대상 모델 요소에 적합 하 고 다음 관계를 인스턴스화합니다 기본 버전을 확인 합니다.예를 들면 다음과 같습니다.

CommentReferencesSubject(sourceAccepted, targetAccepted);

각 작성기 클래스의 노드에서 생성 되는 연결 작성기 DSL 탐색기에서 섹션.하나 Connect 메서드는 도메인 클래스 중 하나 이상의 쌍 간의 관계를 만들 수 있습니다.각 쌍은 링크 연결 DSL 탐색기에서 작성기 노드 아래에서 찾을 수 있습니다 지시문으로 정의 됩니다.

예를 들어, 각 관계 DSL이 샘플에는 세 가지 종류의 하나의 연결 작성기 연결 링크 지시문을 추가할 수 있습니다.이 사용자 단일 연결 도구를 제공 합니다.사용자가 선택한 원본 및 대상 요소 유형의 인스턴스화할 관계 유형을 따라 달라 집니다.연결 링크 지시문을 추가 하려면 작성기 DSL 탐색기에서를 마우스 오른쪽 단추로 클릭 합니다.

특정 유형의 도메인 관계를 만들 때 실행 되는 사용자 지정 코드를 작성 하려면 연결할 적절 한 링크 지시문 작성기 노드 아래의 노드를 선택 합니다.속성 창에서 설정 사용자 지정 연결을 사용 하 여.솔루션을 다시 빌드해야 하 고 결과 오류를 수정 하는 코드를 제공 합니다.

사용자가이 연결 도구를 사용할 때마다 실행 되는 사용자 지정 코드를 작성 하려면 설정의 입니다 사용자 지정 연결 작성기의 속성입니다.특정 조합이 원본 여부 원본 요소 허용 및 대상 허용 됩니다, 그리고 및 연결 될 때 어떤 업데이트가 모델에 등록 해야 여부를 결정 하는 코드를 제공할 수 있습니다.예를 들어 다이어그램에서 루프 만들 수 없습니다만 하면 연결이 가능 합니다.대신 단일 관계 링크, 더 복잡 한 패턴을 위하여 여러 가지 요소 소스와 대상 사이 인스턴스화할 수 있습니다.

Diagram.cs

다이어그램을 정의 하는 클래스를 포함 합니다.파생 된 Diagram.

색 및 다른 스타일 피쳐 변수 런타임에 DSL 정의 다이어그램에서 클래스를 마우스 오른쪽 단추로 클릭 한 지점에 추가 노출.

또한이 파일을 포함의 FixupDiagram 모델에 새 요소를 추가할 때 응답 하는 규칙입니다.규칙이 새 도형을 추가 하 고 모델 요소에 있는 셰이프를 연결 합니다.

DomainClasses.cs

도메인 모델 루트 클래스와 추상 클래스를 포함 하 여 정의 하는 클래스를 구현 합니다.파생 된 ModelElement.

각 도메인 클래스에 있습니다.

• 속성 정 및 각 도메인 속성에 대 한 중첩 된 처리기 클래스입니다.OnValueChanging() 및 Onvaluechanged()를 재정의할 수 있습니다.자세한 내용은 도메인 속성 값 변경 처리기를 참조하십시오.

  DSL, 예제에서는 Comment 클래스를 포함 하는 속성 Text 및 처리기 클래스 TextPropertyHandler.

• 이 도메인 클래스에 참여 하는 관계에 대 한 접근자 속성입니다.(역할 속성에 대 한 중첩된 클래스가 없습니다입니다.)

  DSL, 예제에서는 Comment 클래스에는 포함 관계를 통해 해당 모 피쳐 모델에 액세스 하는 접근자가 ComponentModelHasComments.

• 생성자가 있습니다.이 재정의 하려면 설정 사용자 정의 생성자가 도메인 클래스에 있습니다.

• 요소 그룹 프로토타입 (EGP) 처리기 메서드를 사용 합니다.이러한 필요한 사용자 수 있습니다 경우입니다 병합 (추가)이이 클래스의 인스턴스를 다른 요소입니다.일반적으로 사용자가이 요소 도구 또는 다른 셰이프를 끌어 또는 붙여 넣어 하지 않습니다.

  구성 요소를 복사 하는 DSL, 포트 입력 또는 출력 포트를 병합할 수 있습니다.또한 구성 요소와 주석이 모델에 병합할 수 있습니다.

  EGP 처리기 메서드는 Component 클래스에서 포트를 있지만 않는 의견을 받아들이도록 구성 요소가 있습니다.EGP 처리기 루트 모델 클래스에서 주석 및 구성 요소를 있지만 않은 포트를 사용할 수 있습니다.

DomainModelResx.resx

이 문자열의 설명 등을 도메인 클래스와 속성, 속성 이름, 레이블 도구 상자, 표준 오류 메시지 및 사용자에 게 표시 될 수 있습니다 다른 문자열을 포함 합니다.도구 아이콘 및 이미지 모양에 대 한 이미지가 들어 있습니다.

이 파일은 빌드된 어셈블리에 연결 된, 이러한 리소스에는 기본값을 제공 합니다.리소스의 지역화 된 버전을 포함 하는 위성 어셈블리를 만들어 해당 DSL를 지역화할 수 있습니다.DSL의 지역화 된 리소스와 일치 하는 culture에 설치 되어 있는 경우 해당 버전이 사용 됩니다.자세한 내용은 도메인별 언어 솔루션 배포를 참조하십시오.

HelpKeywordHelper.cs

F1 키를 누를 때 사용 되는 함수를 제공 합니다.

PropertiesGrid.cs

만 도메인 등록 정보에는 사용자 지정 형식 설명자를 첨부 한 경우이 파일에는 코드가 들어 있습니다.자세한 내용은 속성 창 사용자 지정를 참조하십시오.

Serializer.cs

각 도메인 클래스, 관계, 도형, 연결선, 다이어그램 및 모델에 대 한 serializer 클래스입니다.

이러한 클래스의 기능 중 많은 DSL 탐색기의 설정으로 제어할 수 있습니다 Xml Serialization 동작.

ToolboxHelper.cs

도구 상자의 구성 요소 그룹 프로토타입을 요소 도구를 설치 하 여 설정 합니다.사용자가 도구를 실행할 때 이러한 프로토타입에 복사 대상 요소와 병합 됩니다.

재정의할 수 CreateElementPrototype() 그룹의 몇 가지 개체를 만드는 도구 상자 항목을 정의 합니다.예를 들어, 하위 구성 요소에 있는 개체를 나타내는 항목을 정의할 수 있습니다.실험적인 인스턴스를 재설정 코드를 변경한 후 Visual Studio 도구 상자 캐시를 지울 수 있습니다.

Constants.cs

Guid가 있습니다.

DocView.cs

YourDslDocView 다이어그램에서 표시 되는 창으로 관리 합니다.예를 들어, 다이어그램 windows 폼을 포함할 수 있습니다.

사용자 정의 컨트롤 파일을 DslPackage 프로젝트에 추가 합니다.다이어그램에 표시 될 수 있습니다 패널을 추가 합니다.단추 및 기타 컨트롤을 추가 합니다.폼의 코드 보기에서 조정 하 여 DSL에 다음 코드를 추가 합니다.

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Data;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using Microsoft.VisualStudio.Modeling;
using Microsoft.VisualStudio.Modeling.Shell;
namespace Company.EmbedInForm
{
  public partial class UserControl1 : UserControl
  {
    public UserControl1()
    {
      InitializeComponent();
    }
    
    private DiagramDocView docView;
    public UserControl1(DiagramDocView docView, Control content)
      : this()
    {
      this.docView = docView;
      panel1.Controls.Add(content);
    }
    private void button1_Click(object sender, EventArgs e)
    {
      ExampleModel modelRoot = this.docView.CurrentDiagram.ModelElement as ExampleModel;
      foreach (ExampleElement element in modelRoot.Elements)
      {
       listBox1.Items.Add(element.Name);
      }
    }
  }
  internal partial class EmbedInFormDocView
  {
    private ContainerControl container;
    /// <summary>
    /// Return a User Control instead of the DSL window. 
    /// The user control will contain the DSL window.
    /// </summary>
    public override System.Windows.Forms.IWin32Window Window
    {
      get
      {
        if (container == null)
        {
          // Put the normal DSL Window inside our control
          container = new UserControl1(this, (Control)base.Window);
        }
        return container;
      }
    }
  }
}

GeneratedVSCT.vsct

표준 메뉴 명령을 다이어그램 상황에 맞는 메뉴와 같은 메뉴를 정하고 편집 메뉴를 합니다.명령에 대 한 코드에서 CommandSet.cs입니다.위치를 변경 하거나 표준 명령을 수정할 수 및 직접 명령을 추가할 수 있습니다.자세한 내용은 사용자 명령 및 작업 작성를 참조하십시오.

ModelExplorerToolWindow.cs

모델 탐색기에 표시 되는 창을 정의 합니다.탐색기에서 항목의 선택을 처리합니다.

Source.extension.vsixmanifest

이 파일을 사용자 정의 하려면 편집 하 여 .tt 파일.

주의

.Tt 아이콘 또는 이미지 등의 리소스를 포함 하려면 파일을 편집 하는 경우 리소스에 포함 되어 있는지 확인 하십시오 VSIX 빌드에서.솔루션 탐색기에서 파일을 선택 하 고을 VSIX에 포함 속성이 True.

DSL은 Visual Studio 통합 확장 (VSIX에) 패키지를 만드는 방법이 파일을 제어 합니다.자세한 내용은 도메인별 언어 솔루션 배포를 참조하십시오.