непонятное поведение

Читайте выше:

Перебираете все объекты карты, нужные по вашему мнению заносите в TMapSelect с помощью метода SelectSample.
Либо, если все условия для выделения объектов находятся в БД, то рациональнее сначала там составить список подходящих объектов и уже по этому списку искать объекты на карте и их добавлять для выделения в SelectSample.

А далее выделение никак не меняется. Используете либо штатные возможности TMapView/TMapScreen:

Либо выделяете сами:

спасибо. проверю

Однако такое выделение придется самостоятельно "восстанавливать" после перерисовки карты. - не понимаю.
что именно восстанвливать?
повторять DoViewSelect ?

сейчас наткнулся на такое:
когда выполняется поиск, приходится объекты поиска разрушать и создавать заново.
если делать только Clear/ClearAll и сопутствующее - не всегда работает как надо.
не нашел метод, который сбрасывает критерии поиска в исходному. проще пересоздать объект.

Пользуйтесь справочными материалами,
примерами из состава GIS ToolKit

Можно также подать заявку на обучение.
В этом году плановые курсы по GIS ToolKit уже прошли, но могут быть и дополнительные по мере набора группы на обучение.

при поиске и выделении обнаружилось следующее:
сейчас делаю так (кусок кода):        // ищем объект на карте по xMapObjKey

       if xFinderMapObjKey.Find_ByKey( xMapObjKey) then begin
         // объект найден
         // ищем все ПТ, прилегающие к найденному объекту xMapObjKey
         xFinderPT:= TGTK_MapFindHelper.Create( mvMap);
         try
           // ищем оъекты ПТ, пересекающие найденный объект по xMapObjKey
           if xFinderPT.Select then begin
             // перебираем найденные ПТ
             while NOT xFinderPT.EOF do begin
               // проверяем пересечение ПТ и объекта xMapObjKey
               MapCheckInside_Find_MKD.ObjectIn1 := xFinderMapObjKey.MapFindObj;
               MapCheckInside_Find_MKD.ObjectIn2 := xFinderPT.MapFindObj;
               case MapCheckInside_Find_MKD.CheckObjects of
                 // объекты должны только пересекаться
                 CHI_CROSS: begin
                       // сохраняем
                       // выделяем объект на карте
                       xFinderPT.SelectSample( true);   // это макрос -> fMapFind.MapSelect.SelectSample(...)
                       xFinderPT.MapFindObj.Center;

                       // фиксируем ПТ в МКД
                       xSZTPDataMKD.AddPT( Format( 'ПТ = %d',[ xFinderPT.MapFindObj.Key]),
                                           xFinderPT.MapFindObj.Key,
                                           xFinderPT.MapFindObj.Square);
               
                       Memo1.Lines.Add(
                         format(  #13#10'--[ ПТ ]----------------'
                                 +#13#10'Key = %d (%s)'
                                 +#13#10'ExCode (классификатор) = %d'
                                 +#13#10'Площадь = %f',
                                 [ xFinderPT.MapFindObj.Key,
                                   xFinderPT.MapFindObj.KeyName,
                                   xFinderPT.MapFindObj.ExCode,
                                   xFinderPT.MapFindObj.Square]));
                     end;
               end;//case//
               xFinderPT.Next;
             end;//while//
           end;
           // выделяем все найденные ПТ
           xFinderPT.MapFindObj.ColorImage := clYellow;
           xFinderPT.MapFindObj.ThickLine := 5;
           mvMap.SetViewSelected( false, xFinderPT.MapFindObj.ColorImage);//clGreen);
           mvMap.SetObjSelected( xFinderPT.MapFind.MapSelect, xFinderPT.MapFindObj.ColorImage, true);
           finally//              xFinderPT.Free;    <---- проблема тут          end;
       end;
       finally
         xFinderMapObjKey.Free;
     end;

если разрушать объекты поиска сразу после завершения поиска, выделение объектов (код помечет жирным) снимается. т.е. выделение мелькает и пропадает.
а если объекты поиска не разрушать - тогда выделение остается.
крайне неудобно!!!
мне придется алгоритм поиска переделывать, чтобы хранить результаты поиска и сохранялось выделение отмеченных объектов.
странно что работает. именно так. ведь отметка о выделении объектов делается по ключу объектов, и сами объекты на карте не удаляются и, по идее, пока не выполняется снятие выделения, объекты должны оставаться .выделенными.

в итоге получилось сделать выделение найденных объектов разными цветами без DoViewSelect.