.. _oracle_attribute_properties: Свойства атрибутов `````````````````` .. underconstruction:: Перечислены все задокументированные свойства Global1, часть из которых не работает в ApplicationServer. Основные свойства ''''''''''''''''' Свойства, непосредственно влияющие на отображение атрибута выборки. .. btk:attrprop:: UrlLinkInExternalAttribute :title: Ссылка хранится во внешнем поле Доступен при использовании редакторов: * :ref:`hyperlink_editor`. Определяет, хранится ли ссылка в атрибуте или во внешнем поле. Значение по умолчанию: **0**. Возможные значения: - **0** — в атрибуте, ассоциированном с редактором хранится значение ссылки. По-умолчанию, в редакторе отображается значение ссылки. Отображаемое значение можно изменить с помощью :btk:attrprop:`UrlCaptionValueAttribute`; - **1** — в атрибуте ассоциированном с редактором хранится отображаемое значение. Значение ссылки хранится в атрибуте :btk:attrprop:`UrlLinkValueAttribute`. Если атрибут со ссылкой отсутствует, будет возбуждено исключение. .. seealso:: * Документация Global1 :btk:attrprop:`btk:UrlLinkInExternalAttribute` .. btk:attrprop:: UrlCaptionValueAttribute :title: Атрибут, содержащий текст отображаемый вместо гиперссылки Доступен при использовании редакторов: * :ref:`hyperlink_editor`. Системное имя атрибута, содержащего текст который должен отображаться вместо ссылки. .. seealso:: * :btk:attrprop:`UrlLinkInExternalAttribute` * Документация Global1 :btk:attrprop:`btk:UrlCaptionValueAttribute` .. btk:attrprop:: UrlLinkValueAttribute :title: Атрибут, содержащий гиперссылку Доступен при использовании редакторов: * :ref:`hyperlink_editor`. Системное имя атрибута, содержащего ссылку .. seealso:: * :btk:attrprop:`UrlLinkInExternalAttribute` * Документация Global1 :btk:attrprop:`btk:UrlLinkValueAttribute` .. btk:attrprop:: CellMerging :title: Вертикальное объединение ячеек Объединение ячеек одного атрибута с одинаковыми значениями. .. seealso:: * Документация Global1 :btk:attrprop:`btk:CellMerging` .. btk:attrprop:: CellMergingAttr :title: Атрибут вертикального объединения ячеек Дополнительный атрибут, значения которого будут учитываться при расчёте объединения ячеек. То есть, ячейки будут объединены при совпадении значений как самого атрибута, для которого задана настройка, так и дополнительного. Значение данного свойства перекрывает значение свойства :btk:frameprop:`CellMergingAttr`. .. seealso:: * Документация Global1 :btk:attrprop:`btk:CellMergingAttr` .. btk:attrprop:: REF.NotUseRefReg :title: Не заполнять регистр ссылочности При включении данного свойства из соответствующих сеттеров исключаются процедуры регистрации связи между объектами, что приведет к невозможности отслеживания ссылочности из универсального интерфейса с одной стороны, и ускорит скорость работы сетера с другой. Свойства редактора атрибута ............................. .. btk:attrprop:: ADD.DisplayFormat :title: Формат отображения значений числовых атрибутов. Доступен при использовании редакторов: * :ref:`string_editor`. Свойство определяет формат представления числовых атрибутов в виде строки. .. seealso:: * :ref:`format_string` * Свойство атрибута :btk:attrprop:`AttrDesc` * Документация Global1 :btk:attrprop:`btk:ADD.DisplayFormat` .. btk:attrprop:: ShowHint :title: Показывать всплывающую подсказку. Доступно в следующих фреймах: * :class:`TbtkLookUpCardFrame`. Показывать всплывающую подсказку для редактора атрибута. Текст всплывающей подсказки берется из свойства :btk:attrprop:`AttrDesc`. Если :btk:attrprop:`AttrDesc` пуст, используется отображаемое название атрибута. .. seealso:: * Документация Global1 :btk:attrprop:`btk:ShowHint` .. btk:attrprop:: AttrDesc :title: Описание атрибута. Доступно в следующих фреймах: * :class:`TbtkLookUpCardFrame`. Определяет текст всплывающей подсказки при наведении курсора мыши на текст поля ввода. .. seealso:: * Документация Global1 :btk:attrprop:`btk:AttrDesc` .. btk:attrprop:: ADD.InputMaskKind :title: Тип маски ввода .. deprecated:: 1.26.0-ms7. Данное свойство больше не поддерживается. Доступен при использовании редакторов: * :ref:`string_editor` Тип маски ввода, задаваемой настройкой :btk:attrprop:`ADD.INPUTMASK` Возможные значения: - "Стандартная" - :ref:`стандартная маска ввода ` - "Регулярное выражение" - "Расширенное регулярное выражение" .. seealso:: * Документация Global1 :btk:attrprop:`btk:ADD.InputMaskKind` .. btk:attrprop:: ADD.INPUTMASK :title: Маска ввода .. deprecated:: 1.26.0-ms7. Данное свойство больше не поддерживается. Доступен при использовании редакторов: * :ref:`string_editor` Шаблон ввода значения в редактор .. seealso:: * :ref:`edit_mask` * Документация Global1 :btk:attrprop:`btk:ADD.INPUTMASK` .. note:: Если не задан :btk:attrprop:`формат отображения области итогов `, а маска ввода имеет :btk:attrprop:`тип ` "Стандартная", то эта маска ввода будет применена для форматирования значения в области итогов. .. btk:attrprop:: DropDownCount :title: Количество выпадающих строк Доступен при использовании редакторов: * etImageCollection * etCombo * etLookUp Количество отображаемых строк выпадающего списка. .. seealso:: * Документация Global1 :btk:attrprop:`btk:DropDownCount` .. btk:attrprop:: LookUpLazyLoad :title: Отложенная загрузка Доступен при использовании редакторов: * etLookUp Запрос списка значений выполнится не при создании карточки, а только при попытке открыть выпадающий список либо при попытке редактирования значения. .. seealso:: * Документация Global1 :btk:attrprop:`btk:LookUpLazyLoad` .. btk:attrprop:: CanEdit :title: temp Доступен при использовании редакторов: * etEditButton * etButtonsEdit Если включено, появляется возможность редактировать значение атрибута через поле ввода, а не только через кнопку. .. seealso:: * Документация Global1 :btk:attrprop:`btk:CanEdit` .. btk:attrprop:: ResetButtonVisible :title: Отображать кнопку сброса значения Доступен при использовании редакторов: * etTimePick * etLookUp * etEditButton * etColorPick Управляет видимостью кнопки сброса значения. .. seealso:: * Документация Global1 :btk:attrprop:`btk:ResetButtonVisible` .. btk:attrprop:: ADD.AutoRunSetter :title: Автозапуск сеттера Доступен при использовании редакторов: * :ref:`string_editor` Сеттер атрибута будет автоматически срабатывать после прекращения редактрирования поля через указанный в свойстве :btk:attrprop:`ADD.AutoRunSetterInterval` интервал времени. .. seealso:: * Документация Global1 :btk:attrprop:`btk:ADD.AutoRunSetter` .. btk:attrprop:: WantTabs :title: Клавиша Tab создает отступ в тексте Доступен при использовании редакторов: * etMemo Управляет реакцией редактора на нажатие клавиши TAB. ``False`` - произойдёт перевод фокуса ввода, ``True`` - произойдёт ввод симвода табуляции. .. seealso:: * Документация Global1 :btk:attrprop:`btk:WantTabs` .. btk:attrprop:: EDITORTYPE :title: Тип редактора Свойство определяет тип редактора, который будет отображаться при редатрировании ячейки списка/дерева, или отображаться в карточке. .. seealso:: * Документация Global1 :btk:attrprop:`btk:EDITORTYPE` .. btk:attrprop:: ReadOnly :title: Только чтение Определят доступность редактирования для атрибута. .. seealso:: * Документация Global1 :btk:attrprop:`btk:ReadOnly` .. btk:attrprop:: HideSeconds :title: Скрыть секунды Доступен при использовании редакторов: * etTimePick * etDateTimePick Скрывает секунды. .. seealso:: * Документация Global1 :btk:attrprop:`btk:HideSeconds` .. btk:attrprop:: DecimalNumbers :title: Количество знаков после запятой Доступен при использовании редакторов: * etCurrency Определяет количество знаков после запятой. .. seealso:: * Документация Global1 :btk:attrprop:`btk:DecimalNumbers` .. _oracle_attribute_properties_image_collection_name: .. btk:attrprop:: ImageCollectionName :title: Имя коллекции изображений Доступен при использовании редакторов: * etImageCollection Указывается системное имя коллекции, которая будет отображаться в редакторе. .. seealso:: * Документация Global1 :btk:attrprop:`btk:ImageCollectionName` * :ref:`Спецификация сервиса коллекций изображений ` .. btk:attrprop:: DEFAULTVALUE :title: Значение по умолчанию Значение по умолчанию атрибута класса. Подставляется при вставке нового объекта. Тип данных вводимого значения должен совпадать с типом данных атрибута с учетом автоматического преобразования из строки в тип данных атрибута. .. seealso:: * Документация Global1 :btk:attrprop:`btk:DEFAULTVALUE` .. btk:attrprop:: EditButtons :title: Список кнопок Доступен при использовании редакторов: * etButtonsEdit * etTagLookUp Список кнопок, которые будут отображаться в редакторе. .. seealso:: * Документация Global1 :btk:attrprop:`btk:EditButtons` .. btk:attrprop:: BeforeEditLock :title: Не выполнять BeforeEdit перед началом редактирования Позволяет отключить вызов операции BeforeEdit при редактировании данного атрибута. .. seealso:: * Документация Global1 :btk:attrprop:`btk:BeforeEditLock` .. btk:attrprop:: ImageListName :title: Коллекция изображений Доступен при использовании редакторов: * etIcon Указывает на коллекцию изображений, используемую при оботображении иконки в столбце списка или дерева. .. seealso:: * Документация Global1 :btk:attrprop:`btk:ImageListName` .. btk:attrprop:: ADD.AutoRunSetterInterval :title: Интервал автозапуска сеттера Доступен при использовании редакторов: * :ref:`string_editor` Задает интервал срабатывания сеттера после прекращения редактрирования поля в милисекундах (по умолчанию 1000 мс.). Свойсто имеет смысл, если включено :btk:attrprop:`ADD.AutoRunSetter`. .. seealso:: * Документация Global1 :btk:attrprop:`btk:ADD.AutoRunSetterInterval` .. btk:attrprop:: UnlimDeclNumbersInput :title: Ввод неограниченного количества знаков после запятой Доступен при использовании редакторов: * etCurrency При включении становится возможможным ввод более 2 символов после запятой. .. seealso:: * Документация Global1 :btk:attrprop:`btk:UnlimDeclNumbersInput` .. btk:attrprop:: EditorTypeAttribute :title: Атрибут, отвечающий за тип редактора Содержит имя поля выборки, содержащего информацию о типе редактора ячейки. .. seealso:: * Документация Global1 :btk:attrprop:`btk:EditorTypeAttribute` .. btk:attrprop:: ValueChecked :title: Значение Checked чекбокса Доступен при использовании редакторов: * etCheck Позволяет задать значение, которое будет подставляться в поле при установке "галочки" в редакторе. .. seealso:: * Документация Global1 :btk:attrprop:`btk:ValueChecked` .. btk:attrprop:: ValueUnChecked :title: Значение UnChecked чекбокса Доступен при использовании редакторов: * etCheck Позволяет задать значение, которое будет подставляться в поле при снятии "галочки" в редакторе. .. seealso:: * Документация Global1 :btk:attrprop:`btk:ValueUnChecked` .. btk:attrprop:: WordWrap :title: Переносить слова на другую строку Доступен при использовании редакторов: * etMemo Управляет режимом отображения длинных строк. Если установлено ``True`` - слова строки, не влезающие в строку, будут переноситься на следующую строку. .. seealso:: * Документация Global1 :btk:attrprop:`btk:WordWrap` .. btk:attrprop:: SEL.GroupEditAvailable :title: Доступно групповое редактирование Позволяет при помощи операции раздела «Дополнительно» выполнять групповое редактирование данного атрибута. .. seealso:: * Документация Global1 :btk:attrprop:`btk:SEL.GroupEditAvailable` .. btk:attrprop:: ImageSource :title: Источник изображения Доступен при использовании редакторов: * etIcon Возможные значения: * Коллекция изображений - изображение задается номером в используемой коллекции * Поле атрибута выборки - изображение загружается как ``blob``. .. seealso:: * Документация Global1 :btk:attrprop:`btk:ImageSource` .. btk:attrprop:: ImageStretch :title: Вписать сохраняя пропорции Доступен при использовании редакторов: * etIcon Если включено - изображение отображается в оригинальном масштабе, иначе вписывается, сохраняя пропорции размерам ячейки. .. seealso:: * Документация Global1 :btk:attrprop:`btk:ImageStretch` .. btk:attrprop:: ScrollOnMouseBtn :title: Прокручивать мышью значения Доступен при использовании редакторов: * etLookUp Отвечает за синхронизацию выбранного значения и сфокусированного значения выпадающего списка. Если выключено - значение активного редактора не изменяется при прокрутке колеса мыши. .. seealso:: * Документация Global1 :btk:attrprop:`btk:ScrollOnMouseBtn` .. btk:attrprop:: AutoDateTimeSupplement :title: Автоматическое дополнение даты-время по начальному вводу Доступен при использовании редакторов: * etDate * etDateTime Автоматически дополняет дату текущим днем, месяцем и годом. Для даты-времени если время не указано, а дата указано полностью или частично, используется время указанное в свойстве :btk:attrprop:`AutoDateTimeSupplementBehavior`. Если время указано частично, то оно дополняется нолями. .. seealso:: * Документация Global1 :btk:attrprop:`btk:AutoDateTimeSupplement` .. btk:attrprop:: SEL.GroupEditAvailableDirect :title: Доступен при прямом изменении в групповом редактировании При включении появится возможность редактирования через режим прямого изменения. .. seealso:: * Документация Global1 :btk:attrprop:`btk:SEL.GroupEditAvailableDirect` .. btk:attrprop:: AutoDateTimeSupplementBehavior :title: Время для автодополнения Доступен при использовании редакторов: * etDateTime Определяет какое время будет использоваться при автодополнении в качестве времени по умолчанию. Возможные значения: * acbCurrentTime - используется текущее системное время * acbCustomTime - используется время, указанное в свойстве :btk:attrprop:`AutoDateTimeSupplementCustomTime`. .. seealso:: * Документация Global1 :btk:attrprop:`btk:AutoDateTimeSupplementBehavior` .. btk:attrprop:: AutoDateTimeSupplementCustomTime :title: Пользовательское время для автодополнения Доступен при использовании редакторов: * etDateTime Время для автодополнения по умолчанию для свойства :btk:attrprop:`AutoDateTimeSupplement` .. seealso:: * Документация Global1 :btk:attrprop:`btk:AutoDateTimeSupplementCustomTime` .. btk:attrprop:: SEL.GroupEditClientSet :title: Вызвать клиентский сеттер в групповом редактировании При включении, при изменении атрибута через групповое редактирование будет вызван клиентский сеттер. .. seealso:: * Документация Global1 :btk:attrprop:`btk:SEL.GroupEditClientSet` Размер, положение и стиль ''''''''''''''''''''''''' Свойства, управляющие размером поля вывода атрибута, его надписью, стилем раскраски, положением на форме и другими настройками визуализации. .. btk:attrprop:: ADD.SUMMARYFORMAT :title: Формат отображения итогов. Свойство определяет формат представления итогов в виде строки. .. seealso:: * :ref:`format_string` * Документация Global1 :btk:attrprop:`btk:ADD.SUMMARYFORMAT` .. btk:attrprop:: ADD.GROUPSUMMARYFORMAT :title: Формат отображения промежуточных итогов. Свойство определяет формат представления промежуточных итогов в виде строки. .. seealso:: * :ref:`format_string` * Документация Global1 :btk:attrprop:`btk:ADD.GROUPSUMMARYFORMAT` .. btk:attrprop:: TagLookup.AttrTagStyle :title: Атрибут управления стилем раскраски значения. Свойство определяет атрибут, в котором хранится стиль раскраски тегов. .. seealso:: * Документация Global1 :btk:attrprop:`btk:TagLookup.AttrTagStyle` .. btk:attrprop:: TagLookup.AttrTagStyle.Hover :title: Атрибут управления стилем раскраски значения (наведена мышь). Свойство определяет атрибут, в котором хранится стиль раскраски тегов при наведйнном курсоре мыши. .. seealso:: * Документация Global1 :btk:attrprop:`btk:TagLookup.AttrTagStyle.Hover` Дополнительные свойства ''''''''''''''''''''''' Свойства, управляющие сортировкой, фильтрацией и администрированием атрибута выборки. .. _format_string: Строка формата '''''''''''''' В строке формата могут использоваться следующие обозначения: | **`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), тип не расширяется, значение числа не изменяется, и в строку не попадают лишние знаки (как в третьей колонке). .. _edit_mask: Маска ввода '''''''''''''' Маски ввода не реализованы для Oracle-решений. Если необходимо сделать реализацию масок ввода для Oracle-решений, то нужно написать об этом в системный отдел.