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

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

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

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

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

ADD.DisplayFormat

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

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

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

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

See also

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

ShowHint

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

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

• TbtkLookUpCardFrame.

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

AttrDesc

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

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

• TbtkLookUpCardFrame.

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

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

ADD.INPUTMASK

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

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

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

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

See also

• Маска ввода

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

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

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

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

ADD.SUMMARYFORMAT

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

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

See also

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

ADD.GROUPSUMMARYFORMAT

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

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

See also

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

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

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