AutoSnapAperture プロパティ(ActiveX)

AutoSnap ターゲット ボックスの表示を切り替えます。

サポートされているプラットフォーム: Windows のみ

構文と要素

VBA:

object.AutoSnapAperture

object

タイプ: PreferencesDrafting

このプロパティが適用されるオブジェクト。

プロパティの値

読み込み専用: いいえ

タイプ: ブール型

• True: AutoSnap ターゲット ボックスを表示します。
• False: AutoSnap ターゲット ボックスを非表示にします。

注意

このプロパティの初期値は True です。

オブジェクトにスナップすると、AutoSnap ターゲット ボックスはクロスヘア カーソルの中央に表示されます。このオプションは AutoSnap のマーカー、自動吸着、またはツールチップが使用可能である場合にのみ有効です。

注: このプロパティの値は、システム変数 APBOX に格納されます。

例

VBA:

Sub Example_AutoSnapAperture()
    ' This example reads and modifies the preference value that controls
    ' the display of the AutoSnap aperture.
    ' When finished, this example resets the preference value back to
    ' its original value.
    
    Dim ACADPref As AcadPreferencesDrafting
    Dim originalValue As Variant, newValue As Variant
    
    ' Get the drafting preferences object
    Set ACADPref = ThisDrawing.Application.preferences.Drafting
    
    ' Read and display the original value
    originalValue = ACADPref.AutoSnapAperture
    MsgBox "The AutoSnapAperture preference is set to: " & originalValue

    ' Modify the AutoSnapAperture preference by toggling the value
    ACADPref.AutoSnapAperture = Not (originalValue)
    newValue = ACADPref.AutoSnapAperture
    MsgBox "The AutoSnapAperture preference has been set to: " & newValue

    ' Reset the preference back to its original value
    '
    ' * Note: Comment out this last section to leave the change to
    '         this preference in effect
    ACADPref.AutoSnapAperture = originalValue
    MsgBox "The AutoSnapAperture preference was reset back to: " & originalValue
End Sub

Visual LISP:

(vl-load-com)
(defun c:Example_AutoSnapAperture()
    ;; This example reads and modifies the preference value that controls
    ;; the display of the AutoSnap aperture.
    ;; When finished, this example resets the preference value back to
    ;; its original value.
    (setq acadObj (vlax-get-acad-object))
    (setq preferences (vla-get-Preferences acadObj))
  
    ;; Get the drafting preferences object
    (setq ACADPref (vla-get-Drafting preferences))
    
    ;; Read and display the original value
    (setq originalValue (vla-get-AutoSnapAperture ACADPref))
    (alert (strcat "The AutoSnapAperture preference is set to: " (if (= originalValue :vlax-true) "True" "False")))

    ;; Modify the AutoSnapAperture preference by toggling the value
    (vla-put-AutoSnapAperture ACADPref (if (= originalValue :vlax-true) :vlax-false :vlax-true))
    (setq newValue (vla-get-AutoSnapAperture ACADPref))
    (alert (strcat "The AutoSnapAperture preference has been set to: " (if (= newValue :vlax-true) "True" "False")))

    ;; Reset the preference back to its original value
    ;;
    ;; * Note: Comment out this last section to leave the change to
    ;;         this preference in effect
    (vla-put-AutoSnapAperture ACADPref originalValue)
    (alert (strcat "The AutoSnapAperture preference was reset back to: " (if (= originalValue :vlax-true) "True" "false")))
)