Toggles sorting of drawing objects by regeneration order.
Supported platforms: Windows only
VBA:
object.ObjectSortByRegens
Type: DatabasePreferences
The object this property applies to.
Read-only: No
Type: Boolean
The initial value of this property is False.
AutoCAD initially enables sorting for plotting and PostScript output only. Setting additional sorting options can result in slower regeneration and redrawing times.
VBA:
Sub Example_ObjectSortByRegens() ' This example reads and modifies the preference value that controls ' the sorting of drawing objects by regeneration order. ' When finished, this example resets the preference value back to ' its original value. Dim ACADPref As AcadDatabasePreferences Dim originalValue As Variant, newValue As Variant ' Get the user preferences object Set ACADPref = ThisDrawing.preferences ' Read and display the original value originalValue = ACADPref.ObjectSortByRegens MsgBox "The ObjectSortByRegens preference is set to: " & originalValue ' Modify the ObjectSortByRegens preference by toggling the value ACADPref.ObjectSortByRegens = Not (ACADPref.ObjectSortByRegens) newValue = ACADPref.ObjectSortByRegens MsgBox "The ObjectSortByRegens 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.ObjectSortByRegens = originalValue MsgBox "The ObjectSortByRegens preference was reset back to: " & originalValue End Sub
Visual LISP:
(vl-load-com) (defun c:Example_ObjectSortByRegens() ;; This example reads and modifies the preference value that controls ;; the sorting of drawing objects by regeneration order. ;; When finished, this example resets the preference value back to ;; its original value. (setq acadObj (vlax-get-acad-object)) (setq doc (vla-get-ActiveDocument acadObj)) (setq preferences (vla-get-Preferences doc)) ;; Read and display the original value (setq originalValue (vla-get-ObjectSortByRegens preferences)) (alert (strcat "The ObjectSortByRegens preference is set to: " (if (= originalValue :vlax-true) "True" "False"))) ;; Modify the ObjectSortByRegens preference by toggling the value (vla-put-ObjectSortByRegens preferences (if (= originalValue :vlax-true) :vlax-false :vlax-true)) (setq newValue (vla-get-ObjectSortByRegens preferences)) (alert (strcat "The ObjectSortByRegens 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-ObjectSortByRegens preferences originalValue) (alert (strcat "The ObjectSortByRegens preference was reset back to: " (if (= originalValue :vlax-true) "True" "False"))) )