Saves the current query.
(ade_qrysave catname qryparams)
Returns a query ID or nil.
| catname | Category name (string). The category is created if it does not exist. |
| qryparams | List of a-lists, each composed of an information type and a value. See the Information Types table below. |
| name | Query name (string) |
| description | Query description (string) |
| qtype | How the query is saved (integer): 1 = internal (default), 2 = external. |
| filename | For an external query, full path name (string). |
| saveoption | Bit code for the save options you are choosing (integer). See the Save Options table below. |
The function saves the current query to the project's query library or to a file.
- A query saved to the query library is called an internal query.
- A query saved to a file is called an external query.
You must specify a category name and a query name. In a project, no two queries can have the same name, even if they are saved in different categories. The default value for a description is the same as the query name. The default value for the storage type is internal. If you want to save the query externally, you must specify a file name for it.
| 1 | Keep reference in query library. |
| 2 | Save list of active drawings. |
| 4 | Save location coordinates. |
| 8 | Save current property alteration definition. |
| 16 | Execute automatically. |
A query gets a name and an ID only if it is referenced the query library. A new query that you have not yet saved does not have a name or an ID, and neither does an external query unless you keep a reference to it in the query library.
The following example saves the current query to the query library without saving it to a file.
(ade_qrysave "CATEGORY1"
'( ("name" . "QUERY1")
("saveoption" . 2)
)
)
The expression saves the query in CATEGORY1 and names it QUERY1. Because there is no "qtype" list element, it saves the query internally by default, which eliminates the need for a "filename" element.
The following example saves the current query to the query library and also to a file.
(ade_qrysave "CATEGORY1"
'( ("name" . "QUERY1")
("description" . "Query1 description")
("qtype" . 2)
("filename" . "c:\\qryfiles\\Query1.qry")
("saveoption" . 3)
)
)