AbstractProtected_Protected_Protected_Protected_Protected_Protected_Protected_Protected_Родительская ячейка. Может быть только одна. Наличие его означает, что элемент в группе
Protected_ProtectedcalculatedДочерние ячейки. Если массив не пуст, значит ячейка является группой
Название курсора, который задан в cursorCollection, который будет показываться при наведении на фигуру. Если пустая строка, будет показан станадартный, указанный в cursorName, если задан, standardCursor нужно выставить 'none'
Смещение кастомного курсора
Предназначен для расширения атрибутами
Применяется при драге с привязкой. Сначала изменяется это значение, и если выполняется условие привязки - меняется положение ячейки
Масштаб чертежа
Параметры элемента.
Значения нельзя мутировать. Для изменения значения используйте switchParam
Для получения значения getParamValue
Если имя параметра совпадает с именем поля элемента, то параметр будет автоматически обновляться из поля элемента. Если такое поведение нежелательно, то полностью переопределяйте updateParamValues
Для избежания конфликтов между именами можно использовать префикс для имени параметра, например "PAR_".
Если есть вероятность того, что параметр меняется извне, например контролом, и значение берется не из внутреннего поля элемента или его нужно вычислить, обновление параметра нужно прописать в updateParamValues
protected override updateParamValues(): void {
super.updateParamValues()
this.updateParamVal("angle", round(this.angle, true, 2))
}
Уникальный идентификатор
Фигура с таким флагом будет редактироваться в TextEditor
Имя библиотеки, которая породила этот элемент.
ProtectedmagnetИмя. Отображается пользователю
Точки привязки, задаются как доли от ширины и высоты
Сцена, которой принадлежит
Стандартный курсор, который будет показываться при наведении на фигуру. Если задан cursorName, то нужно выставить в 'none'
ReadonlysupportedДля любых данных пользователя
Возвращает библиотеку, которая породила этот элемент. Для этого у элемента должен быть задан libName, элемент должен быть в сцене и подключен сервис Stencil
AbstractcontainsПопадает ли точка в фигуру.
Если accurately = false то будет найдено пересечение с повернутым bbox
AbstractdrawOptionalwithCellSizes: booleanAbstractgetProtectedgetФункция для расчета привязки к центру элемента. в глобальных координатах Может быть переопределена
Optional_options: Record<string, boolean>Добавляет кастомные параметры
Добавлять параметры так же можно через dynamicParams и описывать поведение в onParamChange
Получает текущее значение параметра
ProtectedgetРезультат используется в calculatedSnaps для расчета абсолютных точек привязки.
По умолчанию возвращает Null. Можно переопределить и выдавать кастомные точки привязки, заданные в локальных координатах элемента
Точки привязки также могут быть заданы через relativeSnapPoints
Возвращает посчитанные точки для привязок в абсолютных координатах
AbstractisЗаписывает this.dynamicParams.paramData в this._paramData, обогащая переданные в dynamicParams paramData методом onChange, который вызывает:
onChange: (val: string | number | boolean) => {
this.updateParamVal(customParam.name, val)
this.onParamChange(customParam.name, val)
this.update()
}
AbstractmoveOptional_update: booleanAbstractonВызывается в моммент изменения параметра методом onChange() перед this.update(). Предназначен для переопределения в наследнике
AbstractonAbstractonOptional_options: RenderOptionsМеняет значение параметра, вызывая его метод onChange()
При добавлении нового поля если хотите, чтобы оно сохранялось, нужно добавить его в GRAPHIC_ELEMENT_SAVE_FIELDS
AbstractupdateProtectedupdateProtectedupdateВспомогательный метод, обновляет значение в параметрах dynamicParams и _paramData
ProtectedupdateЕсли в параметрах используется поле из самого объекта, то его нужно обновить в параметрах, так как оно могло измениться другим способом, например контролами. Пример:
protected override updateParamValues(): void {
this.updateParamVal("widthMM", this.widthMM)
})
}
Если имя параметра совпадает с именем поля объекта, то можно не переопределять, он обновит автоматически, или если переопределяете, то вызывайте super.updateParamValues()
Базовый класс, от которого все наследуются.
Стабильный ID типа для сериализации (
classNameв JSON) и ключа вelementsLib—static readonly typeName. Не зависит от минификации. Объявляйте на каждом конкретном cell-классе; наGraphicElementзначение не задаётся. При наследовании обязательно переопределите — иначе assertCellTypeName выбросит ошибку. См. ../../guide/typeName и сериализация cell-классов.md.