dos_summaryinfo

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

Syntax

(dos_summaryinfo)
(dos_summaryinfo nil)
(dos_summaryinfo field_id [field_value])

Parameters

nil

Clears all drawing summary information.

field_id The identifier of the field to retrieve. The possible field identifiers are as follows:

Value	Description
0	Title
1	Subject
2	Author
3	Keywords
4	Comments
5	Last Saved By
6	Revision Number
7	Hyperlink Base

field_value

The new string value, if specified.

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

Returns

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

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

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

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

nil on error.

Example

Command: (dos_summaryinfo)
((0 . "3rd Floor Plumbing") (1 . "McNeel Project") (2 . "Dale Fugier") (3 . "McNeel, Plumbing") (4 . "In progress") (5 . "Dale") (6 . "") (7 . "www.mcneel.com"))
Command: (dos_summaryinfo 0)
"3rd Floor Plumbing"
Command: (dos_summaryinfo 0 "2nd Floor Plumbing")
T
Command: (dos_summaryinfo 2 "")
T
Command: (dos_summaryinfo)
((0 . "2nd Floor Plumbing") (1 . "McNeel Project") (2 . "") (3 . "McNeel, Plumbing") (4 . "In progress") (5 . "Dale") (6 . "") (7 . "www.mcneel.com"))