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

ImageField - класс

  • Статья

Упрощенный объект, представляющий часть формы, которая может оформители или фон образа отображения.

Иерархия наследования

System.Object
  Microsoft.VisualStudio.Modeling.Diagrams.ShapeField
    Microsoft.VisualStudio.Modeling.Diagrams.ImageField

Пространство имен:  Microsoft.VisualStudio.Modeling.Diagrams
Сборка:  Microsoft.VisualStudio.Modeling.Sdk.Diagrams.11.0 (в Microsoft.VisualStudio.Modeling.Sdk.Diagrams.11.0.dll)

Синтаксис

'Декларация
Public Class ImageField _
    Inherits ShapeField

public class ImageField : ShapeField

Тип ImageField предоставляет следующие члены.

Конструкторы

  Имя Описание
Открытый метод ImageField(String) Инициализирует новый экземпляр класса ImageField.
Открытый метод ImageField(String, Image) Инициализирует новый экземпляр класса ImageField.

В начало страницы

Свойства

  Имя Описание
Открытое свойство AnchoringBehavior Описывает, как содержимое поля должно располагаться и размер самого относительно родительского ShapeElement. (Унаследовано от ShapeField.)
Открытое свойство DefaultAccessibleDescription Возвращает или задает описание. доступное по умолчанию (Унаследовано от ShapeField.)
Открытое свойство DefaultAccessibleName Возвращает или задает имя по умолчанию поля формы для объекта со специальными возможностями. (Унаследовано от ShapeField.)
Открытое свойство DefaultAccessibleState Получает состояние по умолчанию поля формы для объекта со специальными возможностями. (Унаследовано от ShapeField.)
Открытое свойство DefaultBackgroundBrushId Возвращает или задает идентификатор по умолчанию кисти для закрашивания фона поля формы. (Унаследовано от ShapeField.)
Открытое свойство DefaultFocusable Получает поле формы и проверяет ли оно может получать фокус или присваивает полю формы возможность получить фокус. (Унаследовано от ShapeField.)
Открытое свойство DefaultImage Возвращает или задает используемый по умолчанию образ, связанный с этим ImageField.По умолчанию образ может быть настраивается путем переопределения метода GetDisplayImage.
Открытое свойство DefaultInactiveSelectedBackgroundBrushId Возвращает или задает идентификатор по умолчанию кисти фона для поля формы. (Унаследовано от ShapeField.)
Открытое свойство DefaultPenId Возвращает или задает идентификатор по умолчанию пера, используемый для поля формы. (Унаследовано от ShapeField.)
Открытое свойство DefaultReflectParentFocusedState Получает поле формы дочернего элемента и проверяет, должен ли он получать фокус, если его родительская фигура получает фокус или задает возможность отразить состояние фокуса для своей родительской формы. (Унаследовано от ShapeField.)
Открытое свойство DefaultReflectParentSelectedState Получает поле формы дочернего элемента и проверяет, должна ли она быть выбрана, если выбрана родительская фигура или задает его возможности отражения состояния выделения своей родительской формы. (Унаследовано от ShapeField.)
Открытое свойство DefaultSelectable Получает поле формы и проверяет, может ли быть выбран по умолчанию или задает состояние по умолчанию выделения поля формы. (Унаследовано от ShapeField.)
Открытое свойство DefaultSelectedBackgroundBrushId Возвращает или задает идентификатор по умолчанию кисти фона для поля формы. (Унаследовано от ShapeField.)
Открытое свойство DefaultUnscaled Возвращает или задает значение, которое указывает, должен ли изображение быть вычерченными границ (немасштабированное) относительно этих полей или изображения - должны быть в соответствии с границами.
Открытое свойство DefaultVisibility Получает поле формы и проверяет, отображается ли он по умолчанию или устанавливается по умолчанию видимость поля формы. (Унаследовано от ShapeField.)
Открытое свойство Name Возвращает имя поля формы. (Унаследовано от ShapeField.)

В начало страницы

Методы

  Имя Описание
Открытый метод AccessibleDoDefaultAction Выполняет действие по умолчанию для объекта со специальными возможностями. (Унаследовано от ShapeField.)
Открытый метод AllowInPlaceEditorAutoSize Включает редактор на месте для автоматического определения размеров в поле формы. (Унаследовано от ShapeField.)
Открытый метод AssociateValueWith(Store, AssociatedPropertyInfo) Связывает поле фигуры со свойством домена, присвоенное элементу фигуры. (Унаследовано от ShapeField.)
Открытый метод AssociateValueWith(Store, Guid) Связывает поле фигуры со свойством домена, присвоенное элементу фигуры. (Унаследовано от ShapeField.)
Открытый метод AssociateValueWith(Store, Guid, AssociatedPropertyInfo) Связывает поле фигуры со свойством домена, присвоенное элементу фигуры. (Унаследовано от ShapeField.)
Открытый метод AssociateVisibilityWith(Store, AssociatedPropertyInfo) Связывает видимость поля формы с свойством домена, присвоенное элементу фигуры. (Унаследовано от ShapeField.)
Открытый метод AssociateVisibilityWith(Store, Guid) Связывает видимость поля формы с свойством домена, присвоенное элементу фигуры. (Унаследовано от ShapeField.)
Открытый метод AssociateVisibilityWith(Store, Guid, AssociatedPropertyInfo) Связывает видимость поля формы с свойством домена, присвоенное элементу фигуры. (Унаследовано от ShapeField.)
Открытый метод CanEditValue Получает поле формы и проверяет, является ли его можно изменить. (Унаследовано от ShapeField.)
Открытый метод CommitPendingEdit Фиксирует отложенную правка. (Унаследовано от ShapeField.)
Открытый метод DoHitTest Выполняет проверку нажатия в указанной точке в схеме, чтобы определить, находится ли точка в диапазоне поля формы. (Унаследовано от ShapeField.)
Открытый метод DoKeyboardNavigation Переход в поле формы с помощью клавиатуры. (Унаследовано от ShapeField.)
Открытый метод DoPaint Прорисовывает содержимое ShapeField. (Переопределяет ShapeField.DoPaint(DiagramPaintEventArgs, ShapeElement).)
Открытый метод EditValue(ShapeElement, DiagramClientView) Открывается редактор на месте для поля формы. (Унаследовано от ShapeField.)
Открытый метод EditValue(ShapeElement, DiagramClientView, PointD) Открывается редактор на месте для поля формы. (Унаследовано от ShapeField.)
Открытый метод Equals Определяет, равен ли заданный объект текущему объекту. (Унаследовано от Object.)
Защищенный метод Finalize Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет утилизирован в процессе сборки мусора. (Унаследовано от Object.)
Открытый метод FindFirstChild Ищет первое поле формы дочерних элементов в родительском поле формы. (Унаследовано от ShapeField.)
Открытый метод FindLastChild Находит последнее поле формы дочерних элементов в родительском поле формы. (Унаследовано от ShapeField.)
Открытый метод FindNextChild Находит следующее поле формы дочерних элементов в родительском поле формы. (Унаследовано от ShapeField.)
Открытый метод FindNextInChildSubFields Находит следующее поле формы дочернего элемента в последовательности переходов. (Унаследовано от ShapeField.)
Открытый метод FindPreviousChild Находит предыдущее поле формы дочерних элементов в родительском поле формы. (Унаследовано от ShapeField.)
Открытый метод FindPreviousInChildSubFields Находит предыдущее поле формы дочернего элемента в последовательности переходов. (Унаследовано от ShapeField.)
Открытый метод Focused Получает поле формы и проверяет, имеет ли он фокус. (Унаследовано от ShapeField.)
Открытый метод GetAccessibilityObject Возвращает объект со специальными возможностями, присвоенный полю формы. (Унаследовано от ShapeField.)
Открытый метод GetAccessibleChild Возвращает объект специальных возможностей для поля формы дочернего элемента. (Унаследовано от ShapeField.)
Открытый метод GetAccessibleChildCount Возвращает количество объектов со специальными возможностями, присвоенные родительский полю формы и его полям формы дочернего элемента. (Унаследовано от ShapeField.)
Открытый метод GetAccessibleDefaultActionDescription Возвращает назначение по умолчанию поля формы для объекта со специальными возможностями. (Унаследовано от ShapeField.)
Открытый метод GetAccessibleDescription Возвращает доступное описание отображенного по умолчанию для поля. (Переопределяет ShapeField.GetAccessibleDescription(ShapeElement).)
Открытый метод GetAccessibleHelp Возвращает Справку поля формы для объекта со специальными возможностями. (Унаследовано от ShapeField.)
Открытый метод GetAccessibleHelpTopicFileName Возвращает тему справки для объекта со специальными возможностями. (Унаследовано от ShapeField.)
Открытый метод GetAccessibleHelpTopicId Возвращает идентификатор, присвоенный разделе Справки для объекта со специальными возможностями. (Унаследовано от ShapeField.)
Открытый метод GetAccessibleName Возвращает доступное по умолчанию имя поля, отображенного. (Переопределяет ShapeField.GetAccessibleName(ShapeElement).)
Открытый метод GetAccessibleRole Извлекает доступная роль данного ShapeField. (Переопределяет ShapeField.GetAccessibleRole(ShapeElement).)
Открытый метод GetAccessibleState Получает состояние поля формы для объекта со специальными возможностями. (Унаследовано от ShapeField.)
Открытый метод GetAccessibleValue Возвращает значение поля формы для объекта со специальными возможностями. (Унаследовано от ShapeField.)
Открытый метод GetActiveInPlaceEditor Возвращает редактор на месте, активен. (Унаследовано от ShapeField.)
Открытый метод GetBackgroundBrush Возвращает кисть, которая рисует фон для элемента фигуры, к которому присвоено данное поле формы. (Унаследовано от ShapeField.)
Открытый метод GetBackgroundBrushId Получает идентификатор кисти, которая рисует фон для элемента фигуры, к которому присвоено данное поле формы. (Унаследовано от ShapeField.)
Открытый метод GetBounds Получает границы для поля формы. (Унаследовано от ShapeField.)
Открытый метод GetCursor Получает указатель, который появляется, когда мышь указывает на поле формы. (Унаследовано от ShapeField.)
Открытый метод GetDisplayImage Возвращает изображение отображаться этим полем.
Открытый метод GetFocusable Получает поле формы и проверяет ли оно может получать фокус. (Унаследовано от ShapeField.)
Открытый метод GetHashCode Играет роль хэш-функции для определенного типа. (Унаследовано от Object.)
Открытый метод GetInPlaceEditorBounds Получает границы для редактора на месте. (Унаследовано от ShapeField.)
Открытый метод GetMaximumInPlaceEditorSize Получает максимальные границы для встроенного редактора. (Унаследовано от ShapeField.)
Открытый метод GetMinimumInPlaceEditorSize Возвращает минимальный размер границы для редактора на месте. (Унаследовано от ShapeField.)
Открытый метод GetMinimumSize Возвращает минимальный размер ImageField. (Переопределяет ShapeField.GetMinimumSize(ShapeElement).)
Открытый метод GetPen Получает перо, которая рисует элемент фигуры, к которому присвоено поле формы. (Унаследовано от ShapeField.)
Открытый метод GetPenId Получает идентификатор пера, которая рисует элемент фигуры, к которому присвоено поле формы. (Унаследовано от ShapeField.)
Открытый метод GetPotentialMouseAction Возвращает действие, когда пользователь щелкает мышью активировать далее конкретный точку на диаграмме. (Унаследовано от ShapeField.)
Открытый метод GetSelectable Получает поле формы и проверяет ли оно может быть выбран. (Унаследовано от ShapeField.)
Открытый метод GetType Возвращает объект Type для текущего экземпляра. (Унаследовано от Object.)
Открытый метод GetUnscaled Возвращает, должен ли изображение быть вычерченно (немасштабированное).
Открытый метод GetValue Возвращает значение поля формы. (Унаследовано от ShapeField.)
Открытый метод GetValueDomainPropertyInfo Возвращает свойство домена, присвоенное значение в поле формы. (Унаследовано от ShapeField.)
Открытый метод GetVisible Получает поле формы и проверяет, отображается ли он. (Унаследовано от ShapeField.)
Открытый метод HasFocusedAppearance Получает поле формы и проверяет, должен ли оно показаться, что имевший фокус. (Унаследовано от ShapeField.)
Открытый метод HasPendingEdit Получает поле формы и проверяет, является ли его встроенного редактора и изменение активен ожидается. (Унаследовано от ShapeField.)
Открытый метод HasSelectedAppearance Получает поле формы и проверяет, является ли он установлен. (Унаследовано от ShapeField.)
Открытый метод IsNavigationKey(Char) Возвращает ключ, который пользователь отжал и проверяет, является ли его можно использовать для перехода между полями фигуры. (Унаследовано от ShapeField.)
Открытый метод IsNavigationKey(Keys) Возвращает ключи, которые пользователь отжал и проверяет, является ли они могут быть использованы для перехода между полями фигуры. (Унаследовано от ShapeField.)
Защищенный метод MemberwiseClone Создает неполную копию текущего объекта Object. (Унаследовано от Object.)
Открытый метод NavigateAscend Перемещает фокус к предыдущему полю формы в последовательности переходов для выбранных фигур. (Унаследовано от ShapeField.)
Открытый метод NavigateDescend Перемещает фокус к следующему полю формы в последовательности переходов для выбранных фигур. (Унаследовано от ShapeField.)
Открытый метод NavigateToFirst Перемещает фокус к первому полю формы в последовательности переходов для выбранных фигур. (Унаследовано от ShapeField.)
Открытый метод NavigateToLast Передает фокус последней полю формы в последовательности переходов для выбранных фигур. (Унаследовано от ShapeField.)
Открытый метод NavigateToNext Перемещает фокус к следующему полю формы в последовательности переходов для выбранных фигур. (Унаследовано от ShapeField.)
Открытый метод NavigateToPrevious Перемещает фокус к предыдущему полю формы в последовательности переходов для выбранных фигур. (Унаследовано от ShapeField.)
Защищенный метод OnBeginEdit Alerts, прослушиватели, если редактирование на месте началось (Унаследовано от ShapeField.)
Открытый метод OnClick Alerts, прослушиватели, когда пользователь нажимает поле формы. (Унаследовано от ShapeField.)
Открытый метод OnDoubleClick Alerts, прослушиватели, когда пользователь дважды щелкнул поле формы. (Унаследовано от ShapeField.)
Защищенный метод OnEndEdit Alerts, прослушиватели, если редактирование на месте завершен. (Унаследовано от ShapeField.)
Открытый метод OnKeyDown Alerts, прослушиватели, когда пользователь удерживал ключом, указывающим на поле формы. (Унаследовано от ShapeField.)
Открытый метод OnKeyPress Alerts, прослушиватели, когда пользователь отжимал ключом, указывающим на поле формы. (Унаследовано от ShapeField.)
Открытый метод OnKeyUp Alerts, прослушиватели, когда пользователь освобождал ключом, указывающим на поле формы. (Унаследовано от ShapeField.)
Открытый метод OnMouseDown Alerts, прослушиватели при удерживании пользователем при наведении курсора мыши на поле формы. (Унаследовано от ShapeField.)
Открытый метод OnMouseMove Alerts, прослушиватели, когда указатель мыши над полем формы было перемещено. (Унаследовано от ShapeField.)
Открытый метод OnMouseUp Alerts, прослушиватели, когда пользователь освобождал кнопка мыши находится над полем формы. (Унаследовано от ShapeField.)
Открытый метод OnMouseWheel Alerts, прослушиватели, когда мышь была вращано по полю формы. (Унаследовано от ShapeField.)
Открытый метод Selected Получает поле формы и проверяет, установлен ли он. (Унаследовано от ShapeField.)
Открытый метод SetSelectionRange Устанавливает выделение диапазона полей формы дочернего элемента. (Унаследовано от ShapeField.)
Открытый метод SetValue Присвоить указанное значение в поле формы. (Унаследовано от ShapeField.)
Открытый метод SetVisible Задает видимость поля формы. (Унаследовано от ShapeField.)
Открытый метод ToString Возвращает строку, представляющую текущий объект. (Унаследовано от Object.)

В начало страницы

Заметки

При указании оформителя образа в фигуре, и при указании форма образа область, в которой отображается форма управляемые ImageField.Примеры инициализации ImageFields и другого ShapeFields проверьте Dsl \ GeneratedCode \ Shapes.cs в решении DSL.

ImageField объект, который управляет область в пределах формы, например пробел присвоенная к оформителю.ImageField один экземпляр совместно используется много форм того же класса формы.ImageField отдельный экземпляр не сохраняет изображение для каждой из фигур: вместо GetDisplayImage(ShapeElement) метод принимает форму в качестве параметра и может найти зависимую ячейку образа на текущем состоянии фигур и его элемента модели.

Если требуется особый расширения функциональности, как образ переменной, можно создать собственный класс, производный от ImageField.

Создание подкласса ImageField

  1. Установка Создает производный тип double свойство родительского класса формы в своем определении DSL.

  2. Переопределите InitializeShapeFields метод класса формы.

    • Создайте новый файл кода в проекте DSL и запишите определение разделяемого класса для класса формы.Переопределите определение метода в ней.

  3. Выполните код InitializeShapeFields в DSL \ GeneratedCode \ Shapes.cs.

    В методе переопределения, вызовите базовый метод, а затем создайте экземпляр собственного класса отображенного поля.Используйте это для замены обычной отображенное в поле shapeFields список.

Примеры

В этом примере зависимую ячейку изменения значка на состояние элемента модели фигуры.

Предупреждающее замечаниеВнимание

В этом примере показано, как сделать динамического оформителя образа.Однако если необходимо только переключаться между одним или двумя образом в зависимости от состояния моделей переменной, оно более просты создать несколько оформителей образа находит их в той же позиции в фигуре, а затем задать фильтр видимости в значения зависят от конкретной модели переменной.Задать фильтр, выберите сопоставление фигуры в определении DSL, чтобы открыть окно сведений DSL, и щелкните вкладку оформителей.

Чтобы выполнить этот пример, создайте новое решение DSL с помощью минимального шаблон языка.Добавьте логическое свойство домена AlternateState к классу ExampleElement доменному.Добавьте оформитель значка к классу ExampleShape и присвойте его образ в файл растрового изображения.Нажать Преобразовать все шаблоны.Добавьте новый файл кода в проекте DSL и вставьте следующий код.

Чтобы проверить код, нажмите клавишу F5 и в решении отладки, откройте схему.Состояние по умолчанию значков должен присутствовать.Выберите форма и в окне свойств измените значение AlternateState свойство.Значок должен располагаться после этого вращанным до 90 градусов, в этой форме.

using Microsoft.VisualStudio.Modeling;
using Microsoft.VisualStudio.Modeling.Diagrams;
...
partial class ExampleShape
{
    /// <summary>
    /// Compose a list of the fields in this shape.
    /// Called once for each shape class.
    /// </summary>
    /// <param name="shapeFields"></param>
    protected override void InitializeShapeFields(IList<ShapeField> shapeFields)
    {
      // Fields set up according to DSL Definition:
      base.InitializeShapeFields(shapeFields);

      // Replace the image field:
      ShapeField oldField = ShapeElement.FindShapeField(shapeFields, "IconDecorator");
      shapeFields.Remove(oldField);
      // Must keep the same name:
      MyImageField newField = new MyImageField(oldField.Name);
      shapeFields.Add(newField);
      newField.DefaultImage = (oldField as ImageField).DefaultImage.Clone() as System.Drawing.Image;
    }
  }


  public class MyImageField : ImageField
  {
    public MyImageField(string tag) : base(tag) { }

    /// <summary>
    /// Get the image for this field in the given shape.
    /// </summary>
    public override System.Drawing.Image GetDisplayImage(ShapeElement parentShape)
    {
      ExampleElement element = parentShape.ModelElement as ExampleElement;
      if (element.AlternateState == true)
        return AlternateImage;
      else
        return base.GetDisplayImage(parentShape);
    }

    private System.Drawing.Image alternateImage;
    public System.Drawing.Image AlternateImage
    {
      get
      {
        if (alternateImage == null)
        {
          // Alternate image is a copy of the default, rotated by 90 degrees:
          alternateImage = this.DefaultImage.Clone() as System.Drawing.Image;
          alternateImage.RotateFlip(System.Drawing.RotateFlipType.Rotate90FlipNone);
        }
        return alternateImage;
      }
    }
  }
}

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасность членов экземпляров не гарантируется.

См. также

Ссылки

Microsoft.VisualStudio.Modeling.Diagrams - пространство имен

TextField

ShapeField

InitializeShapeFields