Свойства атрибутов#

Раздел находится в разработке.

Перечислены все задокументированные свойства Global1, часть из которых не работает в ApplicationServer.

Основные свойства#

Свойства, непосредственно влияющие на отображение атрибута выборки.

UrlLinkInExternalAttribute#
Title

Ссылка хранится во внешнем поле

Доступен при использовании редакторов:

Определяет, хранится ли ссылка в атрибуте или во внешнем поле.

Значение по умолчанию: 0.

Возможные значения:

  • 0 — в атрибуте, ассоциированном с редактором хранится значение ссылки. По-умолчанию, в редакторе отображается значение ссылки. Отображаемое значение можно изменить с помощью UrlCaptionValueAttribute;

  • 1 — в атрибуте ассоциированном с редактором хранится отображаемое значение. Значение ссылки хранится в атрибуте UrlLinkValueAttribute. Если атрибут со ссылкой отсутствует, будет возбуждено исключение.

See also

UrlCaptionValueAttribute#
Title

Атрибут, содержащий текст отображаемый вместо гиперссылки

Доступен при использовании редакторов:

Системное имя атрибута, содержащего текст который должен отображаться вместо ссылки.

See also

UrlLinkValueAttribute#
Title

Атрибут, содержащий гиперссылку

Доступен при использовании редакторов:

Системное имя атрибута, содержащего ссылку

See also

CellMerging#
Title

Вертикальное объединение ячеек

Объединение ячеек одного атрибута с одинаковыми значениями.

See also

CellMergingAttr#
Title

Атрибут вертикального объединения ячеек

Дополнительный атрибут, значения которого будут учитываться при расчёте объединения ячеек. То есть, ячейки будут объединены при совпадении значений как самого атрибута, для которого задана настройка, так и дополнительного. Значение данного свойства перекрывает значение свойства CellMergingAttr.

See also

REF.NotUseRefReg#
Title

Не заполнять регистр ссылочности

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

Свойства редактора атрибута#

ADD.DisplayFormat#
Title

Формат отображения значений числовых атрибутов.

Доступен при использовании редакторов:

Свойство определяет формат представления числовых атрибутов в виде строки.

See also

ShowHint#
Title

Показывать всплывающую подсказку.

Доступно в следующих фреймах:

  • TbtkLookUpCardFrame.

Показывать всплывающую подсказку для редактора атрибута. Текст всплывающей подсказки берется из свойства AttrDesc. Если AttrDesc пуст, используется отображаемое название атрибута.

See also

  • Документация Global1 ShowHint

AttrDesc#
Title

Описание атрибута.

Доступно в следующих фреймах:

  • TbtkLookUpCardFrame.

Определяет текст всплывающей подсказки при наведении курсора мыши на текст поля ввода.

See also

  • Документация Global1 AttrDesc

ADD.InputMaskKind#
Title

Тип маски ввода

Доступен при использовании редакторов:

Тип маски ввода, задаваемой настройкой ADD.INPUTMASK

Возможные значения:

See also

ADD.INPUTMASK#
Title

Маска ввода

Доступен при использовании редакторов:

Шаблон ввода значения в редактор

See also

Note

Если не задан формат отображения области итогов, а маска ввода имеет тип “Стандартная”, то эта маска ввода будет применена для форматирования значения в области итогов.

DropDownCount#
Title

Количество выпадающих строк

Доступен при использовании редакторов:

  • etImageCollection

  • etCombo

  • etLookUp

Количество отображаемых строк выпадающего списка.

See also

LookUpLazyLoad#
Title

Отложенная загрузка

Доступен при использовании редакторов:

  • etLookUp

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

See also

CanEdit#
Title

temp

Доступен при использовании редакторов:

  • etEditButton

  • etButtonsEdit

Если включено, появляется возможность редактировать значение атрибута через поле ввода, а не только через кнопку.

See also

  • Документация Global1 CanEdit

ResetButtonVisible#
Title

Отображать кнопку сброса значения

Доступен при использовании редакторов:

  • etTimePick

  • etLookUp

  • etEditButton

  • etColorPick

Управляет видимостью кнопки сброса значения.

See also

ADD.AutoRunSetter#
Title

Автозапуск сеттера

Доступен при использовании редакторов:

Сеттер атрибута будет автоматически срабатывать после прекращения редактрирования поля через указанный в свойстве ADD.AutoRunSetterInterval интервал времени.

See also

WantTabs#
Title

Клавиша Tab создает отступ в тексте

Доступен при использовании редакторов:

  • etMemo

Управляет реакцией редактора на нажатие клавиши TAB. False - произойдёт перевод фокуса ввода, True - произойдёт ввод симвода табуляции.

See also

  • Документация Global1 WantTabs

EDITORTYPE#
Title

Тип редактора

Свойство определяет тип редактора, который будет отображаться при редатрировании ячейки списка/дерева, или отображаться в карточке.

See also

ReadOnly#
Title

Только чтение

Определят доступность редактирования для атрибута.

See also

  • Документация Global1 ReadOnly

HideSeconds#
Title

Скрыть секунды

Доступен при использовании редакторов:

  • etTimePick

  • etDateTimePick

Скрывает секунды.

See also

DecimalNumbers#
Title

Количество знаков после запятой

Доступен при использовании редакторов:

  • etCurrency

Определяет количество знаков после запятой.

See also

ImageCollectionName#
Title

Имя коллекции изображений

Доступен при использовании редакторов:

  • etImageCollection

Указывается системное имя коллекции, которая будет отображаться в редакторе.

See also

DEFAULTVALUE#
Title

Значение по умолчанию

Значение по умолчанию атрибута класса. Подставляется при вставке нового объекта. Тип данных вводимого значения должен совпадать с типом данных атрибута с учетом автоматического преобразования из строки в тип данных атрибута.

See also

EditButtons#
Title

Список кнопок

Доступен при использовании редакторов:

  • etButtonsEdit

  • etTagLookUp

Список кнопок, которые будут отображаться в редакторе.

See also

BeforeEditLock#
Title

Не выполнять BeforeEdit перед началом редактирования

Позволяет отключить вызов операции BeforeEdit при редактировании данного атрибута.

See also

ImageListName#
Title

Коллекция изображений

Доступен при использовании редакторов:

  • etIcon

Указывает на коллекцию изображений, используемую при оботображении иконки в столбце списка или дерева.

See also

ADD.AutoRunSetterInterval#
Title

Интервал автозапуска сеттера

Доступен при использовании редакторов:

Задает интервал срабатывания сеттера после прекращения редактрирования поля в милисекундах (по умолчанию 1000 мс.). Свойсто имеет смысл, если включено ADD.AutoRunSetter.

See also

UnlimDeclNumbersInput#
Title

Ввод неограниченного количества знаков после запятой

Доступен при использовании редакторов:

  • etCurrency

При включении становится возможможным ввод более 2 символов после запятой.

See also

EditorTypeAttribute#
Title

Атрибут, отвечающий за тип редактора

Содержит имя поля выборки, содержащего информацию о типе редактора ячейки.

See also

ValueChecked#
Title

Значение Checked чекбокса

Доступен при использовании редакторов:

  • etCheck

Позволяет задать значение, которое будет подставляться в поле при установке “галочки” в редакторе.

See also

ValueUnChecked#
Title

Значение UnChecked чекбокса

Доступен при использовании редакторов:

  • etCheck

Позволяет задать значение, которое будет подставляться в поле при снятии “галочки” в редакторе.

See also

WordWrap#
Title

Переносить слова на другую строку

Доступен при использовании редакторов:

  • etMemo

Управляет режимом отображения длинных строк. Если установлено True - слова строки, не влезающие в строку, будут переноситься на следующую строку.

See also

  • Документация Global1 WordWrap

SEL.GroupEditAvailable#
Title

Доступно групповое редактирование

Позволяет при помощи операции раздела «Дополнительно» выполнять групповое редактирование данного атрибута.

See also

ImageSource#
Title

Источник изображения

Доступен при использовании редакторов:

  • etIcon

Возможные значения:

  • Коллекция изображений - изображение задается номером в используемой коллекции

  • Поле атрибута выборки - изображение загружается как blob.

See also

ImageStretch#
Title

Вписать сохраняя пропорции

Доступен при использовании редакторов:

  • etIcon

Если включено - изображение отображается в оригинальном масштабе, иначе вписывается, сохраняя пропорции размерам ячейки.

See also

ScrollOnMouseBtn#
Title

Прокручивать мышью значения

Доступен при использовании редакторов:

  • etLookUp

Отвечает за синхронизацию выбранного значения и сфокусированного значения выпадающего списка. Если выключено - значение активного редактора не изменяется при прокрутке колеса мыши.

See also

AutoDateTimeSupplement#
Title

Автоматическое дополнение даты-время по начальному вводу

Доступен при использовании редакторов:

  • etDate

  • etDateTime

Автоматически дополняет дату текущим днем, месяцем и годом. Для даты-времени если время не указано, а дата указано полностью или частично, используется время указанное в свойстве AutoDateTimeSupplementBehavior. Если время указано частично, то оно дополняется нолями.

See also

SEL.GroupEditAvailableDirect#
Title

Доступен при прямом изменении в групповом редактировании

При включении появится возможность редактирования через режим прямого изменения.

See also

AutoDateTimeSupplementBehavior#
Title

Время для автодополнения

Доступен при использовании редакторов:

  • etDateTime

Определяет какое время будет использоваться при автодополнении в качестве времени по умолчанию. Возможные значения:

  • acbCurrentTime - используется текущее системное время

  • acbCustomTime - используется время, указанное в свойстве AutoDateTimeSupplementCustomTime.

See also

AutoDateTimeSupplementCustomTime#
Title

Пользовательское время для автодополнения

Доступен при использовании редакторов:

  • etDateTime

Время для автодополнения по умолчанию для свойства AutoDateTimeSupplement

See also

SEL.GroupEditClientSet#
Title

Вызвать клиентский сеттер в групповом редактировании

При включении, при изменении атрибута через групповое редактирование будет вызван клиентский сеттер.

See also

Размер, положение и стиль#

Свойства, управляющие размером поля вывода атрибута, его надписью, стилем раскраски, положением на форме и другими настройками визуализации.

ADD.SUMMARYFORMAT#
Title

Формат отображения итогов.

Свойство определяет формат представления итогов в виде строки.

See also

ADD.GROUPSUMMARYFORMAT#
Title

Формат отображения промежуточных итогов.

Свойство определяет формат представления промежуточных итогов в виде строки.

See also

TagLookup.AttrTagStyle#
Title

Атрибут управления стилем раскраски значения.

Свойство определяет атрибут, в котором хранится стиль раскраски тегов.

See also

TagLookup.AttrTagStyle.Hover#
Title

Атрибут управления стилем раскраски значения (наведена мышь).

Свойство определяет атрибут, в котором хранится стиль раскраски тегов при наведйнном курсоре мыши.

See also

Дополнительные свойства#

Свойства, управляющие сортировкой, фильтрацией и администрированием атрибута выборки.

Строка формата#

В строке формата могут использоваться следующие обозначения:

`0` - любая цифра, если цифры нету отображается “0”
`#` - любая цифра, если цифры нету ничего не отображается
`.` - разделитель целой и дробной частей вещественного числа
`,` - разделитель групп разрядов. Позиция и количество введенных символов никак не влияет на результат форматирования
`E+`, `E-`, `e+`, `e` - используются для экспоненциального представления
`’xx’/”xx”` символы заключенные в одиночные или двойные кавычки выводятся как есть, и не влияют на форматирование
`;` - разделитель для форматов нуля, положительных и отрицательных чисел

Примеры значений формата:

“#0.###” - будет использоваться общий формат для нуля, положительных и отрицательных чисел.
“#0.###;(#0.###)” - будет использоваться разный формат для положительных и отрицательных чисел. Отрицательные числа будут выводиться в скобках. Для нуля будет использоваться формат положительных чисел.
“#0.###;;’Ноль’” - будет использоваться общий формат для положительных и отрицательных чисел, вместо нуля будет выводится слово “Ноль”.

Особенности вывода чисел с плавающей точкой#

При указании формата который приводит к формированию числа содержащего больше 15-16 цифр, хвост формата будет обрезан. Это делается чтобы избежать “появления лишних знаков” в числах с плавающей точкой. Если бы формат не обрезался то выводилось бы число близкое к оригинальному, но всё же не равное ему. Такое происходило бы из-за особенностей работы с типами данных которыми представлены числа с плавающей точкой.

Синтетический пример демонстрирующий проблему:

В качестве формата используется строка #0.############## (с 14-ю знаками после запятой).

Значение

Строковое представление с необрезанным форматом

Строковое представление с обрезанным форматом

1.111

1,111

1,111

11.11

11,11

11,11

111.1

111,09999999999999

111,1

Если бы формат не обрезался то для значения 111.1 число изменилось бы и в конце числа появились бы “лишние знаки” (как во второй колонке). Это произошло бы из-за того что 3 знака перед запятой и 14 после сумарно дают 17 знаков на число. Но так как при конвертации числа к строке формат обрезается до 12 знаков (чтобы сумарно количество знаков до запятой и после не превышало 15), тип не расширяется, значение числа не изменяется, и в строку не попадают лишние знаки (как в третьей колонке).

Маска ввода#

Стандартная маска ввода#

Строка маски ввода состоит из трех частей, разделенных символом ;.

Первая часть маски является шаблоном ввода, отображаемым в редакторе.

Специальные символы:

  • ! — если присутствует в маске, все неподходящие под маску значения вставятся пробелами перед значением, иначе вставятся пробелами после значения.

  • > — символы, следующие за этим, переводятся в верхний регистр;

  • < — символы, следующие за этим, переводятся в нижний регистр;

  • <> — прекращение преобразования регистра символов;

  • \ — символ экранирования. Следующий символ становится литеральным;

  • L — в данной позиции должна быть буква;

  • l — в данной позиции должна быть буква. Позиция может быть оставлена пустой;

  • A — в данной позиции должна быть цифра или буква;

  • a — в данной позиции должна быть цифра или буква. Позиция может быть оставлена пустой;

  • C — в данной позиции возможен ввод любого символа;

  • c — в данной позиции возможен ввод любого символа. Позиция может быть оставлена пустой;

  • 0 — в данной позиции должна быть цифра;

  • 9 — в данной позиции должна быть цифра. Позиция может быть оставлена пустой;

  • # — в данной позиции должна быть цифра, либо символ + или -. Позиция может быть оставлена пустой;

Attention

Если позиция остается пустой - в результирующем значении редактора вставится пробел, а не символ невведенного значения.

Символы не описанные выше являются литеральными, то есть станут частью шаблона.

Вторая часть маски - переменная SaveLiteralCharacters, отвечающая за то как введенные данные будут записываться в БД. Возможные значения:

  • 0 - в поле зупишутся только введенные символы, а все литеральные символы маски отбросятся. Является значением по-умолчанию.

  • 1 - в поле запишется значение вместе с литеральными символами маски.

Третья часть маски отвечает за символ невведенного значения. Может быть любым одиночным символом. По умолчанию используется пробел.

Маска ввода автодополняемая, что позволяет вводить только шаблон. Пример корректных масок:

Значение свойства

Пустой редактор

Сохраняемое значение

_0\;0-00)

_ ; -  )

1234

_0\;0-00);

_ ; -  )

1234

_0\;0-00);1

_ ; -  )

_1;2-34)

_0\;0-00);1;

_ ; -  )

_1;2-34)

_0\;0-00);1;=

_=;=-==)

_1;2-34)

_0\;0-00);;

_ ; -  )

1234

_0\;0-00);;=

_=;=-==)

1234

Attention

Если в указанной для автодополнения маске была допущена ошибка, об этом будет выведено сообщение в DBMonitor. Вместо маски с ошибкой будет использоваться пустая маска.

Note

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