TMappl.HighlightObjectsByFieldValue

Модуль: Mappl
Класс: TMappl

Показать совокупность объектов миганием на карте

Объявление

function HighlightObjectsByFieldValue(lCode: integer;
	 aFieldName,aFieldValue: string;
	 aShowObjectMode: TShowObjectsMode = somSaveScale;
	 aHwnd: integer = 0): boolean;

Параметры

lCode
код слоя
aFieldName
имя поля таблицы слоя (если пустая строка, то подсвечиваются объекты,
aFieldValue
значение поля таблицы слоя
aShowObjectMode
режим позиционирования карты при подсвечивании объектов
aHwnd
дискриптор Handle окна, вызывающего функцию (по умолчанию 0)

Возвращает

false, если ошибка, иначе true

Описание

Объекты подсвечиваются таким же образом, как и найденные на карте объекты. Объекты могут принадлежать как одному и тому же слою, так и разным слоям. Дескриптор Hwnd используется для перехвата события отжатия клавиши мыши элемента управления и вызова метода RepaintMap для сброса подсветки объекта. Если значение дескриптора равно 0, то вызов метода RepaintMap для сброса подсветки объекта необходимо осуществить в приложении. По умолчанию значение дескриптора равно 0. Рекомендуется вызывать метод из события обработки нажатия мыши, а в событии обработки отжатия мыши вызывать заданные именем поля и значением предыдущего вызова метода - может использоваться для оптимизации процедуры подсветки объектов, чтобы не читать данные из таблицы при многократном вызове, при повторной подсветке может быть применен метод HighlightObjects с параметром aMapObjects, равным nil)