Метод QueryByContour (Объект IIngeoMapObjects)

Поиск пространственных объектов имеющих указанное пространственное отношение к заданному контуру.

Синтаксис

ЯзыкОписание
VBScript, JavaScriptFunctionQueryByContour(aLayerIDs, aContour, aRelationMask, aRelation)
Visual BasicFunction QueryByContour(ByVal aLayerIDs As Variant, ByVal aContour As IIngeoContour, ByVal aRelationMask As TIngeoContourRelation, ByVal aRelation As TIngeoContourRelation) As IIngeoMapObjectsQuery
Delphifunction QueryByContour(aLayerIDs: OleVariant; aContour: IIngeoContour; aRelationMask: TIngeoContourRelation; aRelation: TIngeoContourRelation): IIngeoMapObjectsQuery;
C, C++HRESULT QueryByContour(VARIANT aLayerIDs, IIngeoContour* aContour, TIngeoContourRelation aRelationMask, TIngeoContourRelation aRelation, IIngeoMapObjectsQuery** Value);

Параметры

aLayerIDs
Список идентификаторов слоев, в которых следует производить поиск. Данный параметр может содержать строку или массив строк.
aContour
Контур, по отношению к которому производится поиск.
aRelationMask
Маска пространственных отношений, на которые необходимо производить проверку.
aRelation
Значения пространственных отношений, удовлетворяющих поиску. Пространственные отношения, не указанные в параметре aRelationMask игнорируются.

Возвращаемое значение

Объект для перебора результатов поиска.

Примечания

При анализе каждого пространственного объекта производится вычисление пространственного отношения заданного контура с контурами форм объекта, определяющими геометрию.

Затем к вычисленному отношению применяется маска aRelationMask и результат сравнивается с aRelation. Если значения совпали, то объект считается удовлетворяющим поиску.

Пример

Пример 1

 aRelationMask  incrIntersected + incrTouched 
 aRelation incrIntersected

Будут найдены все объекты имеющие пересечения, но не имеющие точек соприкосновения с заданным контуром.

Пример 2

 aRelationMask  incrContains + incrTouched 
 aRelation incrTouched

Будут найдены все объекты имеющие точки соприкосновения, но не лежащие внутри заданного контура.

Пример 3

 aRelationMask   incrContained 
 aRelation incrContained

Будут найдены все объекты, содержащие внутри себя указанный контур.