Поделиться через

Задание фонового изображения схемы

В пакете SDK для визуализации и моделирования Visual Studio можно задать фоновое изображение для созданного конструктора с помощью пользовательского кода.

Настройка фонового изображения

Установка фонового изображения для сгенерированного конструктора

  1. Скопируйте файл изображения, который будет использоваться в качестве фона схемы, в каталог Dsl\Resources текущего проекта.

  2. В Обозреватель решений щелкните правой кнопкой мыши папку Dsl\Resources, наведите указатель мыши на добавление и выберите пункт "Существующий элемент".

  3. В диалоговом окне "Добавление существующего элемента" перейдите в папку Dsl\Resources.

  4. В списке "Файлы типов " щелкните "Файлы изображений".

  5. Щелкните файл изображения, скопированный в каталог, и нажмите кнопку "Добавить".

  6. Щелкните правой кнопкой мыши Dsl и щелкните "Свойства ", чтобы открыть свойства проекта Dsl.

  7. На вкладке "Ресурсы" щелкните этот проект не содержит файл ресурсов по умолчанию. Щелкните здесь, чтобы создать его.

  8. Добавьте файл изображения в файл ресурса, перетащив рисунок из Обозреватель решений в окно ресурсов.

  9. Откройте меню "Файл" и выберите параметр для сохранения свойств проекта.

  10. Убедитесь, что файл Dsl\Properties\Resources.resx существует и под ним есть файл Resources.Designer.cs.

  11. Если resources.Designer.cs отсутствует, щелкните файл Resources.resx в Обозреватель решений.

  12. В окне Свойства присвойте свойству Custom Tool значение ResXFileCodeGenerator.

  13. В Обозреватель решений щелкните правой кнопкой мыши проект Dsl, наведите указатель мыши на добавление и нажмите кнопку "Создать папку".

  14. Назовите папку Custom.

  15. Щелкните правой кнопкой мыши папку "Пользовательская", наведите указатель на "Добавить" и выберите пункт "Создать элемент".

  16. В диалоговом окне "Добавление нового элемента" в списке "Шаблоны" щелкните "Файл кода".

  17. В поле "Имя" введите BackgroundImage.csи нажмите кнопку "Добавить".

  18. Скопируйте указанный ниже код в файл 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();
    }
  }
}

    Дополнительные сведения о настройке модели с помощью кода программы см. в статье Навигация и обновление модели в коде программы.

Связанный контент

Примечание.

Компонент Text Template Transformation (Преобразование текстовых шаблонов) автоматически устанавливается как часть рабочей нагрузки разработки расширений Visual Studio. Его также можно установить на вкладке Отдельные компоненты Visual Studio Installer в категории Пакеты SDK, библиотеки и платформы. Установите компонент Пакет SDK для моделирования со вкладки Отдельные компоненты.