Festlegen eines Hintergrundbilds für ein Diagramm

Artikel
05/19/2015

Im Visualisierungs- und Modellierungs-SDK von Visual Studio können Sie das Hintergrundbild für einen generierten Designer mithilfe von benutzerdefiniertem Code festlegen.

Festlegen des Hintergrundbildes

So legen Sie ein Hintergrundbild für einen generierten Designer fest

Kopieren Sie die Bilddatei, die Sie als Diagrammhintergrund verwenden möchten, in das Verzeichnis "Dsl\Resources" des aktuellen Projekts.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Ordner "Dsl\Resources", zeigen Sie auf Hinzufügen, und klicken Sie anschließend auf Vorhandenes Element.
Navigieren Sie im Dialogfeld Vorhandenes Element hinzufügen zum Ordner "Dsl\Resources".
Klicken Sie in der Dropdownliste Dateityp auf Bilddateien.
Klicken Sie auf die Bilddatei, die Sie in das Verzeichnis kopiert haben, und klicken Sie dann auf Hinzufügen.
Klicken Sie mit der rechten Maustaste auf "Dsl", und klicken Sie auf Eigenschaften, um die Eigenschaften des Projekts "Dsl" zu öffnen.
Klicken Sie auf der Registerkarte Ressourcen auf Dieses Projekt enthält keine Standardressourcendatei. Klicken Sie hier, um eine zu erstellen.
Fügen Sie die Bilddatei der Ressourcendatei hinzu, indem Sie das Bild aus dem Projektmappen-Explorer in das Ressourcenfenster ziehen.
Öffnen Sie das Menü "Datei", und klicken Sie auf die Option zum Speichern der Projekteigenschaften.
Prüfen Sie, ob die Datei "Dsl\Properties\Resources.resx" vorhanden ist und die Datei "Resources.Designer.cs" enthält.
Wenn "Resources.Designer.cs" fehlt, klicken Sie im Projektmappen-Explorer auf die Datei "Resources.resx".
Legen Sie im Fenster Eigenschaften für die Custom Tool-Eigenschaft den Wert ResXFileCodeGenerator fest.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt "Dsl", zeigen Sie auf Hinzufügen, und klicken Sie dann auf Neuer Ordner.
Geben Sie dem Ordner den Namen "Custom".
Klicken Sie mit der rechten Maustaste auf den Ordner "Custom", zeigen Sie auf Hinzufügen, und klicken Sie auf Neues Element.
Klicken Sie im Dialogfeld Neues Element hinzufügen im Feld Vorlagen auf Codedatei.
Geben Sie Feld Name den Dateinamen BackgroundImage.cs ein, und klicken Sie auf Hinzufügen.

Kopieren Sie den folgenden Code in die Datei "BackgroundImage.cs", und passen Sie den Namespace, den Diagrammklassennamen und den Bilddatei-Ressourcennamen an.

Ersetzen Sie "MyDiagramClass" durch den Namen der partiellen Diagrammklasse, die in "Dsl\GeneratedCode\Diagrams.cs" definiert ist. Den richtigen Namespace können Sie auch aus der Datei "Dsl\GeneratedCode\Diagrams.cs" abrufen.

using System;
using Microsoft.VisualStudio.Modeling.Diagrams;

// Fix the namespace:
namespace Fabrikam.MyLanguage
{
  // Fix the Diagram Class name - get it from GeneratedCode\Diagram.cs

  public partial class Language29Diagram
  {
    protected override void InitializeInstanceResources()
    {
      // Fix the Resources namespace and the Image resource name:
      ImageField backgroundField = new ImageField("background",
          Fabrikam.MyLanguage.Properties.Resources.MyPicture);

      backgroundField.DefaultFocusable = false;
      backgroundField.DefaultSelectable = false;
      backgroundField.DefaultVisibility = true;
      backgroundField.DefaultUnscaled = false;

      shapeFields.Add(backgroundField);

      backgroundField.AnchoringBehavior
        .SetTopAnchor(AnchoringBehavior.Edge.Top, 0.01);
      backgroundField.AnchoringBehavior
        .SetLeftAnchor(AnchoringBehavior.Edge.Left, 0.01);
      backgroundField.AnchoringBehavior
        .SetRightAnchor(AnchoringBehavior.Edge.Right, 0.01);
      backgroundField.AnchoringBehavior
        .SetBottomAnchor(AnchoringBehavior.Edge.Bottom, 0.01);

      base.InitializeInstanceResources();
    }
  }
}

Weitere Informationen zum Anpassen des Modells mit Programmcode finden Sie unter Navigating and Updating a Model in Program Code.

Siehe auch

Konzepte

Definieren von Formen und Konnektoren

Customizing Text and Image Fields

Navigating and Updating a Model in Program Code

Weitere Ressourcen

Writing Code to Customise a Domain-Specific Language

Freigeben über