SpatialSearch Property
TOC
Collapse the table of content
Expand the table of content

Page.SpatialSearch Property (Visio)

Office 2013 and later
GitHub-Mark-64px

Contribute to this content

Use GitHub to suggest and submit changes. See our guidelines for contributing to VBA documentation.

Returns a Selection object whose shapes meet certain criteria in relation to a point that is expressed in the coordinate space of a page, master, or group. Read-only.

expression .SpatialSearch(x, y, Relation, Tolerance, Flags)

expression A variable that represents a Page object.

Parameters

Name

Required/Optional

Data Type

Description

x

Required

Double

The x-coordinate.

y

Required

Double

The y-coordinate.

Relation

Required

Integer

Any combination of the values of the constants visSpatialContainedIn and visSpatialTouching.

Tolerance

Required

Double

A distance in internal drawing units with respect to the coordinate space.

Flags

Required

Integer

Flags that influence the result.

Return Value

Selection

  • The relation argument can be any combination of the constants defined in VisSpatialRelationCodes. If relation is not specified, the SpatialSearch property uses both relationships as criteria.

  • The flags argument can be any combination of the values of the constants defined in VisSpatialRelationFlags in the Visio type library (except visSpatialIncludeHidden, which is reserved for future use, and should not be used).

Use the NoShow cell to determine whether a Geometry section is hidden or visible. Hidden Geometry section sections have a value of TRUE and visible Geometry sections have a value of FALSE in the NoShow cell.

Beginning with Microsoft Visio 2002, if flags contains visSpatialFrontToBack, items in the Selection object returned by the SpatialNeighbors property are ordered front to back. If visSpatialBackToFront is set, the items returned are ordered back to front. If this flag is not set, or if you are running an earlier version of Visio, the order is unpredictable. You can determine the order by using the Index property of the shapes identified in the Selection object.

Note Note

When it compares two shapes, the SpatialSearch property does not consider the width of a shape's line, shadows, line ends, control points, or connection points.

Show:
© 2016 Microsoft