ADCInsertUnitsDefaultSource Property (ActiveX)

Determines the units to use automatically for objects in DesignCenter for a source drawing that does not have assigned insert units.

Supported platforms: Windows only

Signature

VBA:

object.ADCInsertUnitsDefaultSource

object

Type: PreferencesUser

The object this property applies to.

Property Value

Read-only: No

Type: acInsertUnits enum

• acInsertUnitsAngstroms
• acInsertUnitsAstronomicalUnits
• acInsertUnitsCentimeters
• acInsertUnitsDecameters
• acInsertUnitsDecimeters
• acInsertUnitsFeet
• acInsertUnitsGigameters
• acInsertUnitsHectometers
• acInsertUnitsInches
• acInsertUnitsKilometers
• acInsertUnitsLightYears
• acInsertUnitsMeters
• acInsertUnitsMicroinches
• acInsertUnitsMicrons
• acInsertUnitsMiles
• acInsertUnitsMillimeters
• acInsertUnitsMils
• acInsertUnitsNanometers
• acInsertUnitsParsecs
• acInsertUnitsUnitless
• acInsertUnitsUSSurveyFeet
• acInsertUnitsUSSurveyInch
• acInsertUnitsUSSurveyMile
• acInsertUnitsUSSurveyYard
• acInsertUnitsYards

Remarks

The initial value for this property is acInsertUnitsUnitless.

Note: The value of this property is stored in the INSUNITSDEFSOURCE system variable.

Examples

VBA:

Sub Example_ADCInsertUnitsDefaultSource()
    ' This example reads and modifies the ADCInsertUnitsDefaultSource
    ' preference value.
    ' When finished, this example resets the preference value back to
    ' its original value.
    
    Dim ACADPref As AcadPreferencesUser
    Dim originalValue As Integer, newValue As Integer
    
    ' Get the user preferences object

    Set ACADPref = ThisDrawing.Application.preferences.User
    
    ' Read and display the original value
    originalValue = ACADPref.ADCInsertUnitsDefaultSource
    MsgBox "The ADCInsertUnitsDefaultSource preference is set to: " & originalValue

    ' Modify the ADCInsertUnitsDefaultSource preference by toggling the value
    ACADPref.ADCInsertUnitsDefaultSource = acInsertUnitsMillimeters

    MsgBox "The ADCInsertUnitsDefaultSource preference has been set to: " & ACADPref.ADCInsertUnitsDefaultSource

    ' Reset the preference back to its original value
    ACADPref.ADCInsertUnitsDefaultSource = originalValue
    MsgBox "The ADCInsertUnitsDefaultSource preference was reset back to: " & originalValue
End Sub

Visual LISP:

(vl-load-com)
(defun c:Example_ADCInsertUnitsDefaultSource()
    ;; This example reads and modifies the ADCInsertUnitsDefaultSource
    ;; preference value.
    ;; When finished, this example resets the preference value back to
    ;; its original value.
    (setq acadObj (vlax-get-acad-object))

    ;; Get the user preferences object
    (setq pref (vla-get-Preferences acadObj))
    (setq user (vla-get-User pref))
    
    ;; Read and display the original value
    (setq originalValue (vla-get-ADCInsertUnitsDefaultSource user))
    (alert (strcat "The ADCInsertUnitsDefaultSource preference is set to: " (itoa originalValue)))

    ;; Modify the ADCInsertUnitsDefaultSource preference by toggling the value
    (vla-put-ADCInsertUnitsDefaultSource user acInsertUnitsMillimeters)
    (alert (strcat "The ADCInsertUnitsDefaultSource preference has been set to: " (itoa (vla-get-ADCInsertUnitsDefaultSource user))))

    ;; Restore the preference back to its original value
    (vla-put-ADCInsertUnitsDefaultSource user originalValue)
    (alert (strcat "The ADCInsertUnitsDefaultSource preference was restored back to: " (itoa originalValue)))
)