dos_custominfo - dalefugier/DOSLib GitHub Wiki

Returns or modifies AutoCAD's custom drawing summary information, or DWGPROPS. Note, this function just manipulates the custom information fields. If you want to manipulate summary fields, use dos_summaryinfo.

Syntax

(dos_custominfo)
(dos_custominfo nil)
(dos_custominfo field_name [field_value])

Parameters

nil

Clears all custom drawing summary information.

field_name

The name of the custom field to retrieve.

field_value

The new string value, if specified.

Note, if no argument is specified, all of the custom drawing summary information is returned in an association list. To delete a field, specified a field value of either "" or nil.

Returns

If no arguments are specified, then all of the custom drawing summary information is returned in an association list.

If nil is specified, then all of the drawing custom summary information is cleared and T is returned if successful.

If a valid field name is specified, then the field value is returned if successful.

If a valid field name and a field value is specified, then T returned if successful.

nil on error.

Example

Command: (dos_custominfo)
nil
Command: (dos_custominfo "Field1" "Value1")
T
Command: (dos_custominfo "Field2" "Value2")
T
Command: (dos_custominfo)
(("Field1" . "Value1") ("Field2" . "Value2"))
Command: (dos_custominfo "Field2" "Value10")
T
Command: (dos_custominfo)
(("Field1" . "Value1") ("Field2" . "Value10"))
Command: (dos_custominfo "Field2" "")
T
Command: (dos_custominfo)
(("Field1" . "Value1"))