모양 또는 데코레이터 클릭 가로채기

아티클
06/19/2023

다음 절차에서는 도형 또는 아이콘 데코레이터의 클릭을 가로채는 방법을 보여 줍니다. 클릭, 두 번 클릭, 끌기 및 기타 제스처를 가로채고 요소가 응답하게 할 수 있습니다.

도형 클릭 가로채기

Dsl 프로젝트의 생성된 코드 파일과는 다른 코드 파일에서, 도형 클래스에 대한 partial 클래스 정의를 작성합니다. OnDoubleClick() 또는 이름이 On...으로 시작하는 다른 메서드를 재정의합니다. 예시:

public partial class MyShape // change
{
  public override void OnDoubleClick(DiagramPointEventArgs e)
  {
    base.OnDoubleClick(e);
    System.Windows.Forms.MessageBox.Show("Click");
    e.Handled = true;
  }
}

참고 항목

이벤트를 포함된 도형이나 다이어그램으로 전달하지 않는 이상, e.Handled를 true로 설정합니다.

데코레이터 클릭 가로채기

이미지 데코레이터는 OnDoubleClick 메서드가 있는 ImageField 클래스의 인스턴스에서 수행됩니다. ImageField 하위 클래스를 작성하면 클릭을 가로챌 수 있습니다. 필드는 InitializeShapeFields 메서드에서 설정됩니다. 따라서 일반 ImageField 대신 하위 클래스를 인스턴스화하려면 해당 메서드를 변경해야 합니다. InitializeShapeFields 메서드는 도형 클래스의 생성된 코드에 있습니다. Generates Double Derived 속성을 다음 절차의 설명에 따라 설정하면 도형 클래스를 재정의할 수 있습니다.

InitializeShapeFields는 인스턴스 메서드이지만 각 클래스별로 한 번만 호출됩니다. 따라서 다이어그램의 도형별로 인스턴스 하나가 아닌, 각 클래스의 필드별로 단 하나의 ClickableImageField 인스턴스만 존재합니다. 사용자가 인스턴스를 두 번 클릭하면 예제의 코드에서처럼 적중된 인스턴스를 식별해야 합니다.

아이콘 데코레이터 클릭을 가로채려면 다음 단계를 따릅니다.

DSL 솔루션을 열거나 만듭니다.
아이콘 데코레이터가 있는 도형을 선택하거나 만들고 도메인 클래스에 매핑합니다.

GeneratedCode 폴더에 있는 파일과는 다른 코드 파일에서 ImageField의 새 하위 클래스를 만듭니다.

using Microsoft.VisualStudio.Modeling;
using Microsoft.VisualStudio.Modeling.Design;
using Microsoft.VisualStudio.Modeling.Diagrams;
using System.Collections.Generic;
using System.Linq;

namespace Fabrikam.MyDsl { // Change to your namespace
internal class ClickableImageField : ImageField
{
  // You can also override OnClick and so on.
  public override void OnDoubleClick(DiagramPointEventArgs e)
  {
    base.OnDoubleClick(e);
    // Work out which instance was hit.
    MyShape shapeHit = e.HitDiagramItem.Shape as MyShape;
    if (shapeHit != null)
    {
      MyDomainClass element =
          shapeHit.ModelElement as MyDomainClass;
      System.Windows.Forms.MessageBox.Show(
         "Double click on shape for " + element.Name);
      // If we do not set Handled, the event will
      // be passed to the containing shape:
      e.Handled = true;
    }
  }

   public ClickableImageField(string fieldName)
     : base(fieldName)
   { }
}

이벤트를 포함된 도형으로 전달하고 싶지 않다면 Handled를 true로 설정해야 합니다.

다음 partial 클래스 정의를 추가하여 도형 클래스의 InitializeShapeFields 메서드를 재정의합니다.

public partial class MyShape // change
{
 protected override void InitializeShapeFields
      (IList<ShapeField> shapeFields)
 {
  base.InitializeShapeFields(shapeFields);
  // You can see the above method in MyShapeBase
  // in the generated Shapes.cs
  // It has already added fields for the Icons.
  // So you will have to retrieve them and replace with your own.
  ShapeField unwantedField = shapeFields.First
      (field => field.Name == "IconDecorator1");
  shapeFields.Remove(unwantedField);

  // Now replicate the generated code from the base class
  // in Shape.cs, but with your own image constructor.
  ImageField field2 = new ClickableImageField("IconDecorator1");
  field2.DefaultImage = ImageHelper.GetImage(
    MyDslDomainModel.SingletonResourceManager
    .GetObject("MyShapeIconDecorator1DefaultImage"));
      shapeFields.Add(field2);
}

솔루션을 빌드하고 실행합니다.
도형의 인스턴스에 있는 아이콘을 두 번 클릭합니다. 테스트 메시지가 표시됩니다.

CompartmentShape 목록에서 클릭 및 끌기 가로채기

다음 샘플에서는 사용자가 구획 도형의 항목을 끌어 순서를 변경할 수 있습니다.

클래스 다이어그램 솔루션 템플릿을 사용하여 새 DSL 솔루션을 만듭니다.

구획 도형을 포함하는 자체 솔루션을 사용할 수도 있습니다. 이 코드에서는 도형이 나타내는 모델 요소와 구획 목록 항목에 표시되는 요소 간에 포함 관계가 있다고 가정합니다.
구획 도형의 Generates Double Derived 속성을 설정합니다.
Dsl 프로젝트의 파일에 이 코드를 추가합니다.
자체 DSL에 맞게 이 코드의 도메인 클래스와 도형 이름을 조정합니다.

코드는 다음과 같이 작동합니다. 이 예제에서 ClassShape는 구획 도형의 이름입니다.

마우스 이벤트 처리기 세트는 생성과 동시에 각 구획 인스턴스에 연결됩니다.
이 ClassShape.MouseDown 이벤트는 현재 항목을 저장합니다.
마우스가 현재 항목 밖으로 이동하면 MouseAction 인스턴스가 생성됩니다. 이 인스턴스는 마우스가 해제될 때까지 커서를 설정하고 마우스를 캡처합니다.

항목 텍스트 선택 같은 다른 마우스 동작을 방해하지 않도록, MouseAction은 마우스가 원래 항목을 떠난 후에 생성됩니다.

MouseAction을 만드는 다른 방법은 MouseUp을 수신 대기하는 것입니다. 그러나 사용자가 구획 밖으로 마우스를 끌어 놓으면 이 방법이 제대로 작동하지 않게 됩니다. MouseAction은 마우스를 놓은 위치에 관계없이 적절한 작업을 수행할 수 있습니다.
마우스를 놓으면 MouseAction.MouseUp은 모델 요소 간의 링크 순서를 다시 정렬합니다.
역할 순서를 변경하면 표시를 업데이트하는 규칙이 실행됩니다. 이 동작은 이미 정의되어 있으며 추가 코드가 필요 없습니다.

샘플 코드는 다음과 같습니다.

using Microsoft.VisualStudio.Modeling;
using Microsoft.VisualStudio.Modeling.Design;
using Microsoft.VisualStudio.Modeling.Diagrams;
using System.Collections.Generic;
using System.Linq;

// This sample allows users to re-order items in a compartment shape by dragging.

// This example is built on the "Class Diagrams" solution template of VMSDK (DSL Tools).
// You will need to change the following domain class names to your own:
// ClassShape = a compartment shape
// ClassModelElement = the domain class displayed using a ClassShape
// This code assumes that the embedding relationships
// displayed in the compartments don't use inheritance
// (don't have base or derived domain relationships).

namespace Company.CompartmentDrag
{
 /// <summary>
 /// Manage the mouse while dragging a compartment item.
 /// </summary>
 public class CompartmentDragMouseAction : MouseAction
 {
  private ModelElement sourceChild;
  private ClassShape sourceShape;
  private RectangleD sourceCompartmentBounds;

  public CompartmentDragMouseAction(ModelElement sourceChildElement, ClassShape sourceParentShape, RectangleD bounds)
   : base (sourceParentShape.Diagram)
  {
   sourceChild = sourceChildElement;
   sourceShape = sourceParentShape;
   sourceCompartmentBounds = bounds; // For cursor.
  }

  /// <summary>
  /// Call back to the source shape to drop the dragged item.
  /// </summary>
  /// <param name="e"></param>
  protected override void OnMouseUp(DiagramMouseEventArgs e)
  {
   base.OnMouseUp(e);
   sourceShape.DoMouseUp(sourceChild, e);
   this.Cancel(e.DiagramClientView);
   e.Handled = true;
  }

  /// <summary>
  /// Ideally, this shouldn't happen. This action should only be active
  /// while the mouse is still pressed. However, it can happen if you
  /// move the mouse rapidly out of the source shape, let go, and then
  /// click somewhere else in the source shape.
  /// </summary>
  /// <param name="e"></param>
  protected override void OnMouseDown(DiagramMouseEventArgs e)
  {
   base.OnMouseDown(e);
   this.Cancel(e.DiagramClientView);
   e.Handled = false;
  }

  /// <summary>
  /// Display an appropriate cursor while the drag is in progress:
  /// Up-down arrow if we are inside the original compartment.
  /// No entry if we are elsewhere.
  /// </summary>
  /// <param name="currentCursor"></param>
  /// <param name="diagramClientView"></param>
  /// <param name="mousePosition"></param>
  /// <returns></returns>
  public override System.Windows.Forms.Cursor GetCursor(System.Windows.Forms.Cursor currentCursor, DiagramClientView diagramClientView, PointD mousePosition)
  {
   // If the cursor is inside the original compartment, show up-down cursor.
   return sourceCompartmentBounds.Contains(mousePosition)
    ? System.Windows.Forms.Cursors.SizeNS // Up-down arrow.
    : System.Windows.Forms.Cursors.No;
  }
 }

 /// <summary>
 /// Override some methods of the compartment shape.
 /// *** GenerateDoubleDerived must be set for this shape in DslDefinition.dsl. ****
 /// </summary>
 public partial class ClassShape
 {
  /// <summary>
  /// Model element that is being dragged.
  /// </summary>
  private static ClassModelElement dragStartElement = null;
  /// <summary>
  /// Absolute bounds of the compartment, used to set the cursor.
  /// </summary>
  private static RectangleD compartmentBounds;

  /// <summary>
  /// Attach mouse listeners to the compartments for the shape.
  /// This is called once per compartment shape.
  /// The base method creates the compartments for this shape.
  /// </summary>
  public override void EnsureCompartments()
  {
   base.EnsureCompartments();
   foreach (Compartment compartment in this.NestedChildShapes.OfType<Compartment>())
   {
    compartment.MouseDown += new DiagramMouseEventHandler(compartment_MouseDown);
    compartment.MouseUp += new DiagramMouseEventHandler(compartment_MouseUp);
    compartment.MouseMove += new DiagramMouseEventHandler(compartment_MouseMove);
   }
  }

  /// <summary>
  /// Remember which item the mouse was dragged from.
  /// We don't create an Action immediately, as this would inhibit the
  /// inline text editing feature. Instead, we just remember the details
  /// and will create an Action when/if the mouse moves off this list item.
  /// </summary>
  /// <param name="sender"></param>
  /// <param name="e"></param>
  void compartment_MouseDown(object sender, DiagramMouseEventArgs e)
  {
   dragStartElement = e.HitDiagramItem.RepresentedElements
     .OfType<ClassModelElement>().FirstOrDefault();
   compartmentBounds = e.HitDiagramItem.Shape.AbsoluteBoundingBox;
  }

  /// <summary>
  /// When the mouse moves away from the initial list item,
  /// but still inside the compartment, create an Action
  /// to supervise the cursor and handle subsequent mouse events.
  /// Transfer the details of the initial mouse position to the Action.
  /// </summary>
  /// <param name="sender"></param>
  /// <param name="e"></param>
  void compartment_MouseMove(object sender, DiagramMouseEventArgs e)
  {
   if (dragStartElement != null)
   {
    if (dragStartElement != e.HitDiagramItem.RepresentedElements.OfType<ClassModelElement>().FirstOrDefault())
    {
     e.DiagramClientView.ActiveMouseAction = new CompartmentDragMouseAction(dragStartElement, this, compartmentBounds);
     dragStartElement = null;
    }
   }
  }

  /// <summary>
  /// User has released the mouse button.
  /// </summary>
  /// <param name="sender"></param>
  /// <param name="e"></param>
  void compartment_MouseUp(object sender, DiagramMouseEventArgs e)
  {
   dragStartElement = null;
  }

  /// <summary>
  /// Forget the source item if mouse up occurs outside the
  /// compartment.
  /// </summary>
  /// <param name="e"></param>
  public override void OnMouseUp(DiagramMouseEventArgs e)
  {
   base.OnMouseUp(e);
   dragStartElement = null;
  }

  /// <summary>
  /// Called by the Action when the user releases the mouse.
  /// If we are still on the same compartment but in a different list item,
  /// move the starting item to the position of the current one.
  /// </summary>
  /// <param name="dragFrom"></param>
  /// <param name="e"></param>
  public void DoMouseUp(ModelElement dragFrom, DiagramMouseEventArgs e)
  {
   // Original or "from" item:
   ClassModelElement dragFromElement = dragFrom as ClassModelElement;
   // Current or "to" item:
   ClassModelElement dragToElement = e.HitDiagramItem.RepresentedElements.OfType<ClassModelElement>().FirstOrDefault();
   if (dragFromElement != null && dragToElement != null)
   {
    // Find the common parent model element, and the relationship links:
    ElementLink parentToLink = GetEmbeddingLink(dragToElement);
    ElementLink parentFromLink = GetEmbeddingLink(dragFromElement);
    if (parentToLink != parentFromLink && parentFromLink != null && parentToLink != null)
    {
     // Get the static relationship and role (= end of relationship):
     DomainRelationshipInfo relationshipFrom = parentFromLink.GetDomainRelationship();
     DomainRoleInfo parentFromRole = relationshipFrom.DomainRoles[0];
     // Get the node in which the element is embedded, usually the element displayed in the shape:
     ModelElement parentFrom = parentFromLink.LinkedElements[0];

     // Same again for the target:
     DomainRelationshipInfo relationshipTo = parentToLink.GetDomainRelationship();
     DomainRoleInfo parentToRole = relationshipTo.DomainRoles[0];
     ModelElement parentTo = parentToLink.LinkedElements[0];

     // Mouse went down and up in same parent and same compartment:
     if (parentTo == parentFrom && relationshipTo == relationshipFrom)
     {
      // Find index of target position:
      int newIndex = 0;
      var elementLinks = parentToRole.GetElementLinks(parentTo);
      foreach (ElementLink link in elementLinks)
      {
       if (link == parentToLink) { break; }
       newIndex++;
      }

      if (newIndex < elementLinks.Count)
      {
       using (Transaction t = parentFrom.Store.TransactionManager.BeginTransaction("Move list item"))
       {
        parentFromLink.MoveToIndex(parentFromRole, newIndex);
        t.Commit();
       }
      }
     }
    }
   }
  }

  /// <summary>
  /// Get the embedding link to this element.
  /// Assumes there is no inheritance between embedding relationships.
  /// (If there is, you need to make sure you've got the relationship
  /// that is represented in the shape compartment.)
  /// </summary>
  /// <param name="child"></param>
  /// <returns></returns>
  ElementLink GetEmbeddingLink(ClassModelElement child)
  {
   foreach (DomainRoleInfo role in child.GetDomainClass().AllEmbeddedByDomainRoles)
   {
    foreach (ElementLink link in role.OppositeDomainRole.GetElementLinks(child))
    {
     // Just the assume the first embedding link is the only one.
     // Not a valid assumption if one relationship is derived from another.
     return link;
    }
   }
   return null;
  }
 }
}

다음을 통해 공유

모양 또는 데코레이터 클릭 가로채기

도형 클릭 가로채기

데코레이터 클릭 가로채기

CompartmentShape 목록에서 클릭 및 끌기 가로채기

피드백

추가 리소스

다음을 통해 공유

모양 또는 데코레이터 클릭 가로채기

도형 클릭 가로채기

데코레이터 클릭 가로채기

CompartmentShape 목록에서 클릭 및 끌기 가로채기

관련 콘텐츠

피드백

추가 리소스