Свойство Shape.DistanceFromPoint (Visio)
Возвращает расстояние от фигуры до точки. Только для чтения.
Синтаксис
выражение. 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 и обратная связь.