1. Свойства атрибутов¶

1.1. Основные свойства¶

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

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

Пока описаны не все свойства.

UrlLinkInExternalAttribute¶

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

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

Редактор гиперссылки (etHyperLink).

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

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

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

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

New in version Global_5.9.0_ms_4.

UrlCaptionValueAttribute¶

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

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

Редактор гиперссылки (etHyperLink).

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

New in version Global_5.4.1.

Changed in version Global_5.9.0_ms_4: Добавлена зависимость от свойства UrlLinkInExternalAttribute.

See also

UrlLinkInExternalAttribute

UrlLinkValueAttribute¶

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

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

Редактор гиперссылки (etHyperLink).

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

New in version Global_5.9.0_ms_4.

See also

UrlLinkInExternalAttribute

CellMerging¶

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

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

CellMergingAttr¶

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

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

See also

CellMergingAttr

New in version Global_5.12.

1.1.1. Свойства редактора атрибута¶

ADD.DisplayFormat¶

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

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

Редактор в строке (etEdit).

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

See also

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

ShowHint¶

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

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

TbtkLookUpCardFrame.

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

AttrDesc¶

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

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

TbtkLookUpCardFrame.

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

ADD.InputMaskKind¶

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

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

Редактор в строке (etEdit)

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

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

“Стандартная” - стандартная маска ввода
“Регулярное выражение”
“Расширенное регулярное выражение”

ADD.INPUTMASK¶

Title:	Маска ввода

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

Редактор в строке (etEdit)

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

See also

Маска ввода

Note

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

DropDownCount¶

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

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

etImageCollection
etCombo
etLookUp

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

LookUpLazyLoad¶

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

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

etLookUp

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

CanEdit¶

Title:	temp

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

etEditButton
etButtonsEdit

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

ResetButtonVisible¶

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

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

etTimePick
etLookUp
etEditButton
etColorPick

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

ADD.AutoRunSetter¶

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

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

Редактор в строке (etEdit)

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

WantTabs¶

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

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

etMemo

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

EDITORTYPE¶

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

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

ReadOnly¶

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

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

HideSeconds¶

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

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

etTimePick
etDateTimePick

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

DecimalNumbers¶

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

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

etCurrency

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

ImageCollectionName¶

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

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

etImageCollection

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

DEFAULTVALUE¶

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

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

EditButtons¶

Title:	Список кнопок

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

etButtonsEdit
etTagLookUp

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

BeforeEditLock¶

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

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

ImageListName¶

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

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

etIcon

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

ADD.AutoRunSetterInterval¶

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

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

Редактор в строке (etEdit)

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

UnlimDeclNumbersInput¶

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

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

etCurrency

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

EditorTypeAttribute¶

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

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

ValueChecked¶

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

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

etCheck

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

ValueUnChecked¶

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

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

etCheck

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

WordWrap¶

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

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

etMemo

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

SEL.GroupEditAvailable¶

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

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

ImageSource¶

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

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

etIcon

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

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

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

ImageStretch¶

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

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

etIcon

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

ScrollOnMouseBtn¶

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

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

etLookUp

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

AutoDateTimeSupplement¶

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

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

etDate
etDateTime

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

SEL.GroupEditAvailableDirect¶

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

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

AutoDateTimeSupplementBehavior¶

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

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

etDateTime

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

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

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

AutoDateTimeSupplementCustomTime¶

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

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

etDateTime

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

SEL.GroupEditClientSet¶

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

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

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

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

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

Пока описаны не все свойства.

ADD.SUMMARYFORMAT¶

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

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

See also

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

ADD.GROUPSUMMARYFORMAT¶

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

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

See also

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

TagLookup.AttrTagStyle¶

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

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

TagLookup.AttrTagStyle.Hover¶

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

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

1.3. Дополнительные свойства¶

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

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

Свойства будут добавлены позже.

1.4. Строка формата¶

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

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

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

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

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

При указании формата который приводит к формированию числа содержащего больше 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), тип не расширяется, значение числа не изменяется, и в строку не попадают лишние знаки (как в третьей колонке).

1.5. Маска ввода¶

1.5.1. Стандартная маска ввода¶

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

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

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

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

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

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

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

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

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

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