Свойство Shape.DistanceFromPoint (Visio)

Статья
04/07/2023

Возвращает расстояние от фигуры до точки. Только для чтения.

Синтаксис

выражение. DistanceFromPoint( _x_ , _y_ , _Flags_ , _[pvPathIndex]_ , _[pvCurveIndex]_ , _[pvt]_ )

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

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
x	Обязательный	Double	Координата X.
y	Обязательный	Double	Координата по оси Y.
Flags	Обязательный	Integer	Флаги, влияющие на тип записей, возвращаемых в результатах.
pvPathIndex	Необязательный	Variant	Определяет точку фигуры в сочетании с pvCurveIndex и pvt.
pvCurveIndex	Необязательный	Variant	Определяет точку фигуры в сочетании с pvPathIndex и pvt.
Pvt	Необязательный	Variant	Определяет точку фигуры в сочетании с pvPathIndex и pvCurveIndex.

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

Двойное с плавающей точкой

Замечания

Точка ( x,y) выражается во внутренних единицах рисования (дюймах в документе) относительно пространства координат, определенного листом, непосредственно содержащим ThisShape.

Аргументы pvPathIndex, pvCurveIndex и pvt при необходимости возвращают значения, которые идентифицируют точку, от которую измеряется возвращаемое расстояние. Вызовите такую точку ( xOnThis, yOnThis). Он лежит вдоль кривой c'й пути ThisShape p'th и может быть определен с помощью:

ThisShape.Paths(*pvPathIndex).Item(*pvCurveIndex).Point(*pvt,&xOnThis ,&yOnthis)

Используйте метод PointAndDerivatives вместо метода Point , если нужно найти первую и вторую производные в позиции t вдоль кривой.

Если значение pvPathIndex или pvCurveIndex не равно NULL, возвращается целое число (тип VT_I4). Если параметр pvt не имеет значение NULL, функция DistanceFromPoint возвращает значение Double (тип VT_R8).

Свойство DistanceFromPoint учитывает, что направляющие имеют экстент, а также заполненные области и пути фигуры.

Аргумент Flags может быть любым сочетанием значений констант, определенных в следующей таблице. Эти константы также определены в VisSpatialRelationFlags в библиотеке типов Microsoft Visio.

Константа	Значение	Описание
visSpatialIncludeDataGraphics	&H40	Включает графические фигуры данных и их подформы. По умолчанию графические выноски данных и их подформы не включаются. Если родительская фигура сама по себе является выноской графического элемента данных, выполняется поиск между геометрией родительской фигуры и фигурами без выноски, если этот флаг не установлен.
visSpatialIncludeHidden	&H10	Рассмотрим скрытые разделы Geometry. По умолчанию скрытые разделы Geometry не влияют на результат.
visSpatialIgnoreVisible	&H20	Не учитывайте видимые разделы Geometry. По умолчанию видимые разделы Geometry влияют на результат.

Используйте ячейку NoShow, чтобы определить, является ли раздел Geometry скрытым или видимым. Скрытые разделы geometry имеют значение TRUE, а видимые разделы Geometry имеют значение FALSE в ячейке NoShow.

Если у родительского объекта нет геометрии или если flags исключает учет всей геометрии, свойство DistanceFromPoint возвращает большое число (1E+30), которое следует интерпретировать как бесконечное.

Свойство DistanceFromPoint не учитывает ширину линии, теней, концы линий, контрольных точек или точек подключения фигуры при вычислении результата.

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.

Share via