GetOrientation Method （ActiveX）

签名

工 务 局：

RetVal = object.GetOrientation([Point [, Prompt]])

对象

类型：实用工具

此方法适用的对象。

点

访问：仅输入;自选

类型：变体（双精度的三元素数组）

指定基点的 3D WCS 坐标。

提示

访问：仅输入;自选

类型：变体（字符串）

用于提示用户输入的文本。

返回值（RetVal）

类型：双

指定的角度。

言论

AutoCAD 为用户输入的角度而暂停，并将返回值设置为所选角度的值。点参数指定 WCS 中的角度基点。提示参数指定 AutoCAD 在暂停之前显示的字符串。“点”和“提示”都是可选的。

AutoCAD 用户可以通过输入当前角度单位格式的数字来指定角度。用户还可以通过在图形屏幕上指定两个 2D 位置来指定角度。AutoCAD 绘制一条从第一个点到当前十字准线位置的橡皮筋线，以帮助用户可视化角度。如果提供了“点”参数，AutoCAD 将使用此值作为两个点中的第一个。角度在 WCS 的XY平面中测量（此方法忽略点的Z字段）。角增加的方向总是逆时针方向。

无论使用哪种方法指定角度，始终将返回值设置为以弧度表示的值。GetOrientation

此方法类似于该方法，但它忽略了存储在 ANGBASE 系统变量中的角度 0 的当前方向。使用的 0 角度始终在右侧：“东”或“三点钟”。GetAngleGetOrientation

如果返回的是关键字而不是角度，AutoCAD 将生成错误消息“用户输入关键字”。使用该方法从返回值中获取关键字。GetInput

例子

工 务 局：

Sub Example_GetOrientation()
    ' This example uses the GetOrientation method to demonstrate three different ways to retrieve
    ' an orientation from the user.
    
    AppActivate ThisDrawing.Application.Caption
        
    Dim retOrientation As Double
    
    ' Return the Orientation in radians with a prompt
    retOrientation = ThisDrawing.Utility.GetOrientation(, "Enter an Orientation: ")
    MsgBox "The Orientation entered was " & retOrientation & vbCrLf & _
            "(Enter the next value without prompting.)", , "GetOrientation Example"
    
    ' Return the Orientation in radians without any prompt
    retOrientation = ThisDrawing.Utility.GetOrientation()
    MsgBox "The Orientation entered was " & retOrientation, , "GetOrientation Example"
    
    ' Return the Orientation in radians with a prompt and an Orientation base point
    Dim basePnt(0 To 2) As Double
    basePnt(0) = 2#: basePnt(1) = 2#: basePnt(2) = 0#
    retOrientation = ThisDrawing.Utility.GetOrientation(basePnt, "Enter an Orientation: ")
    MsgBox "The Orientation entered was " & retOrientation, , "GetOrientation Example"
        
End Sub

Visual LISP：

(vl-load-com)
(defun c:Example_GetOrientation()
    ;; This example uses the GetOrientation method to demonstrate three different ways to retrieve
    ;; an orientation from the user.
    (setq acadObj (vlax-get-acad-object))
    (setq doc (vla-get-ActiveDocument acadObj))
  
    ;; Return the Orientation in radians with a prompt
    (setq retOrientation (vla-GetOrientation (vla-get-Utility doc) nil "Enter an Orientation: "))
    (alert (strcat "The Orientation entered was " (rtos retOrientation 2) "\n"
                   "(Enter the next value without prompting.)"))

    ;; Return the Orientation in radians without any prompt
    (setq retOrientation (vla-GetOrientation (vla-get-Utility doc)))
    (alert (strcat "The Orientation entered was " (rtos retOrientation 2)))
    
    ;; Return the Orientation in radians with a prompt and an Orientation base point
    (setq basePnt (vlax-3d-point 2 2 0))
    (setq retOrientation (vla-GetOrientation (vla-get-Utility doc) basePnt "Enter an Orientation: "))
    (alert (strcat "The Orientation entered was " (rtos retOrientation 2)))
)