Объектный интерфейс IMarker Назад В начало Вперед

Для управления пометкой записей в броузере в Атлантис введен объектный интерфейс IMarker.

Его реализация по умолчанию описана Vip интерфейсом:

vipInterface marker implements IMarker, IModify ;
  public : constructor init;
  destructor done;
end;

Методы интерфейса

Метод

Параметры

Описание

MarkUnMarkRec

(Nrec : comp)

Помечает, если не помечена, и сбрасывает, если помечена, запись с номером Nrec. Валидность не проверяется.

MarkUnMark

 

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

Mark

 

Помечает текущую запись.

UnMark

 

Снимает пометку с текущей записи.

UnselectAll

 

Снимает все пометки.

SelectAll

 

Помечает все записи.

InvertSel

 

Инвертирует пометку всех записей.

ImportFrom

(stdMarker : longInt)

Импортирует (загружает) помеченные записи из маркера StdMarker. Информация о ранее отмеченных записях теряется.

ExportTo

(stdMarker : longInt)

Выгружает помеченные записи в маркер StdMarker. Содержимое StdMarker перед операцией очищается.

ImportFromName

(stdMarker : string)

Импортирует (загружает) помеченные записи из маркера StdMarker. Информация о ранее отмеченных записях теряется.

ExportToName

(stdMarker : string)

Выгружает помеченные записи в маркер StdMarker. Содержимое StdMarker перед операцией очищается.

StoreToDsk

 

Сохраняет помеченные записи в dsk файл.

LoadFromDsk

 

Загружает помеченные записи из dsk файла.

DeleteRec

 

Удаляет помеченные записи.

Свойства интерфейса

Свойство

Доступ

Описание

AutoSave : boolean

Чтение /Запись

Если свойство установлено, то информация о помеченных записях автоматически сохраняется в dsk файле по закрытию интерфейса. Значение по умолчанию false.

Caption : string

Чтение /Запись

Строка добавляемая к заголовку интерфейса с информацией о количестве отмеченных записей. Формат строки '... %d .....'. Вместо %d подставится количество записей. Значение по умолчанию 'Отмечено %d записей'.

Count : longInt

Чтение

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

Disable : boolean

Чтение /Запись

Запретить /разрешить автоматизированную пометку. Значение по умолчанию false.

ImageName : string

Чтение /Запись

Имя битмапки помечаемой записи. Значение по умолчанию 'bmMarkBitmap'.

IsCaption : boolean

Чтение /Запись

Если свойство установлено, то к заголовку интерфейса прибавляется информация о количестве отмеченных записей. Значение по умолчанию true.

IsMarkNestedTreeNode : boolean

Чтение /Запись

Если свойство установлено, то включается режим пометки вложеных элементов при пометке узла дерева. Значение по умолчанию true.

IsMarkTreeNodeUp : boolean

Чтение /Запись

Если свойство установлено, то включается проверка необходимости автоматической пометки /снятия узла. Если пометились все вложенные элементы, узел помечается. Если снимается пометка хотя бы с одного вложенного элемента, то пометка узла снимается. Значение по умолчанию true.

IsNeedCheckDelete : boolean

Чтение /Запись

При установленном свойстве обработка по команде cmDelete идет так:

- на прикладной уровень посылается событие cmMarkDelete;

- при абортировании обработки данного события в прикладном коде (оператор Abort) дальнейшая обработка не ведется;

- при остановке обработки данного события в прикладном коде (оператор Stop) обработка удаления идет без выдачи запроса на удаление записей;

- при отсутствии обработки данного сообщения в прикладном коде или при наличии обработки без остановки и абортирования обработка удаления идет с выдачей запроса на удаление;

- при любой обработке сообщение cmDelete на прикладной уровень не приходит.

При значении данного свойства false никакая автоматическая обработка не ведется и сообщение cmDelete обрабатывается стандартно.

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

LoadAuto : boolean

Чтение /Запись

Если свойство установлено, то информация о помеченных записях автоматически загружается из dsk файла в момент создания интерфейса, где описан броузер с автоматизированной пометкой. Значение по умолчанию false.

pNRec : comp

Чтение /Запись

NRec записи в таблице маркера.

SendPosChangedWhithGroupDelete : boolean

Чтение /Запись

Посылать /не посылать сообшение cmPositionChanged, если при удалении помеченных записей была уделена текущая запись. Значение по умолчанию false.

ShowCaptIsZero : boolean

Чтение /Запись

Показывать /скрывать заголовок, если количество отмеченных записей равно 0. Значение по умолчанию false.

StoreName : string

Чтение /Запись

Имя под которым будет сохраняться информация о помеченных записях в dsk файле. Значение по умолчанию не присвоено. Если данное свойство не установленно в прикладном коде, то имя, под которым будет идти сохранение в dsk, сформируется автоматически.

Комбинация

IsMarkNestedTreeNode := false;

IsMarkTreeNodeUp := true;

не запрещена но может ввести в заблуждение пользователей.

Версия

Начиная с Атлантис 5.2.08 доступно свойство IsNeedCheckDelete.

Начиная с Атлантис 5.2.02 доступны свойства IsMarkNestedTreeNode и IsMarkTreeNodeUp.

Начиная с Атлантис 5.1.36 доступны методы ImportFromName, ExportToName, DeleteRec и свойства LoadAuto, Count, ShowCaptIsZero, Disable, SendPosChangedWhithGroupDelete.