Получает расстояние от линии подсказки или выбранного набора точек на экране.

См. также | Пример

Синтаксис

RetVal = GetDistance([Point][, Prompt])

Object

Utility
Объект или объекты обращающиеся к этому методу.

Point

Variant (массив с тремя элементами double); только для ввода; дополнительный
Трехмерные координаты полежения WCS арифметическая запятая. Если эта точка не обеспечена, пользователь должен ввести две точки.

Prompt

Variant (строка); только для ввода; дополнительный
Текст запроса пользователя относительно ввода.

RetVal

Variant (double или массив double)
Расстояние от линии подсказки или выбранного набора точек на экране.

Замечания

AutoCAD делает паузу для пользовательского ввода линейного расстояния и устанавливает возвращаемое значение на значение выбранного расстояния. Параметр Point определяет арифметическую запятую в координатах WCS. Параметр Prompt определяет строку, которую отображает AutoCAD. Обе Точки и Подсказка являются дополнительными.

Пользователь AutoCADа может определить расстояние, вводя число в текущем формате единиц. Пользователь может также установить расстояние, определяя два местоположения на графическом экране. AutoCAD рисует дугу от первой точки до текущей позиции перекрестия, чтобы помочь пользователю визуализировать расстояние. Если параметр Point обеспечен, AutoCAD использует это значение как первую из двух точек.

По умолчанию, GetDistance обрабатывает Point и возвращаемое значение как трехмерные точки. Предшествующий запрос к методу InitializeUserInput может вынудить Point быть двумерным, гарантируя, что этот метод возвращает плоское расстояние.

Независимо от метода, используемого, чтобы определить расстояние или текущие линейные единицы (например, футы и дюймы), этот метод всегда устанавливает возвращаемое значение на значение с плавающей точкой с двойной точностью.