ダイアグラムへの背景イメージの設定

2025-06-12

Visual Studio Visualization and Modeling SDK では、カスタムコードを使用して生成されるデザイナーの背景イメージを設定できます。

背景画像を設定する

生成されるデザイナーの背景イメージを設定するには

図の背景として使用するイメージファイルを、現在のプロジェクトの Dsl\Resources ディレクトリにコピーします。
ソリューションエクスプローラーで Dsl\Resources フォルダーを右クリックし、[追加] をポイントしてから [既存の項目] をクリックします。
[既存項目の追加] ダイアログボックスで Dsl\Resources フォルダーを参照します。
[ファイルの種類] ボックスの一覧で、[イメージファイル] をクリックします。
ディレクトリにコピーしたイメージファイルをクリックしてから、[追加] をクリックします。
Dsl を右クリックし、[プロパティ] をクリックして Dsl プロジェクトのプロパティを開きます。
[リソース] タブで、[このプロジェクトには既定のリソースファイルが含まれていません。ファイルを作成するには、ここをクリックしてください。] をクリックします。
ソリューションエクスプローラーからリソースウィンドウに画像をドラッグして、イメージファイルをリソースファイルに追加します。
［ファイル］メニューを開き、プロジェクトのプロパティを保存するオプションをクリックします。
ファイル Dsl\Properties\Resources.resx が存在しており、その下に Resources.Designer.cs ファイルがあることを確認します。
Resources.Designer.cs がない場合は、ソリューションエクスプローラーで Resources.resx ファイルをクリックします。
[プロパティ] ウィンドウで、 Custom Tool プロパティを ResXFileCodeGeneratorに設定します。
ソリューションエクスプローラーで Dsl プロジェクトを右クリックし、[追加] をポイントして [新しいフォルダー] をクリックします。
フォルダーに Custom という名前を指定します。
Custom フォルダーを右クリックし、[追加] をポイントしてから [新しい項目] をクリックします。
[新しい項目の追加] ダイアログボックスの [テンプレート] ボックスの一覧で、[コードファイル] をクリックします。
[名前] ボックスに「BackgroundImage.cs」と入力して、[追加] をクリックします。

次のコードを BackgroundImage.cs ファイルにコピーし、名前空間、図クラス名、およびイメージファイルリソース名を調整します。

"MyDiagramClass" を、Dsl\GeneratedCode\Diagrams.cs で定義されている図の部分クラスの名前に置き換えます。 Dsl\GeneratedCode\Diagrams.cs ファイルから正しい名前空間を取得することもできます。

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();
    }
  }
}

プログラムコードを使用したモデルのカスタマイズの詳細については、「プログラムコードでのモデルのナビゲーションと更新」を参照してください。

Note

テキストテンプレート変換コンポーネントは、Visual Studio 拡張機能の開発ワークロードの一部として自動的にインストールされます。また、 [SDK、ライブラリ、およびフレームワーク] カテゴリの下にある Visual Studio インストーラーの [個別のコンポーネント] タブからインストールすることもできます。 [個別のコンポーネント] タブから Modeling SDK コンポーネントをインストールします。

次の方法で共有

ダイアグラムへの背景イメージの設定

背景画像を設定する

生成されるデザイナーの背景イメージを設定するには

関連するコンテンツ

フィードバック

その他のリソース