Gets an AutoCAD Map option setting.
(ade_prefgetval variable)
Returns an option setting or nil.
| variable |
Option name (string). See the Options tables below. |
The function return value depends on which option you specify. The tables below show option names and return values, organized by option type.
Work Session Options
| RestoreLastActiveDwgsOnStartup |
T or nil. |
| ActivateDwgsOnAttach |
T or nil. |
| DontAddObjectsToSaveSet |
T or nil. |
| MarkObjectsForEditingWithoutPrompting |
T or nil. |
| LogFileActive |
T or nil. |
| LogFileName |
File name (string). For example, "ade.log". |
| LogMessageLevel |
0, 1, or 2. |
Query Options
| QueryFileDirectory. |
Path (string). For example, "c:\\data\\qry". |
| CaseSensitiveMatch. |
T or nil. |
| SaveCurrQueryInSession. |
T or nil. |
| MkSelSetWithQryObj |
T or nil. |
| DefaultJoinOperator |
1 = OR, 2 = AND. |
| ColorForAdd |
Color (string). |
| ColorForRemove |
Color (string). |
| BlockLocnForQuery |
1 = insertion point, 2 = bounding box. |
| TextLocnForQuery |
1 = insertion point, 2 = bounding box. |
| ShowBlockAsInsPt |
T or nil. |
| ShowImageAsBoundary |
T or nil. |
| CreateAssociativeHatchObjects |
T or nil. |
| ReferenceBoundaryForAreaLocation |
T or nil. |
Save Back Options
| RedefineBlockDefinitions |
T or nil. |
| RedefineLayerDefinitions |
T or nil. |
| RedefineTextStyleDefinitions |
T or nil. |
| RemoveUnusedGroups |
T or nil. |
| EraseSavedBackObjects |
T or nil. |
| RemoveLockAfterSave |
T or nil. |
| CreateHistoryFileOfChanges |
T or nil. |
| CreateBackupFileOfSourceDwg |
T or nil. |
External Database Options
| NoOfSQLConditionsInHistory |
integer. |
| DisplayTabsInSingleView |
T or nil. |
| OpenDataViewReadOnly |
T or nil. |
| SaveDataViewFmtChanges |
T or nil. |
| ReconnectDbOnWSOpen |
T or nil. |
| ShowFullDBPath |
T or nil. |
| KeepDataViewOnTop |
T or nil. |
| dbfDatabases |
string, one of the following: "Prompt", "DB3", "DB4", "DB5", "FOX2.0", "FOX2.5", or "FOX2.6". |
| xlsDatabases |
string, one of the following: "Prompt", "Excel3", "Excel4", "Excel5", or "Excel7". |
| dbDatabases |
string, one of the following: "Prompt", "Paradox3.0", "Paradox4.0", or "Paradox5.0". |
Coordinate Transformation Options
| AdjustSizesAndScalesForChangesInUnits |
T or nil. |
| AdjustRotationsForMapDistortions |
T or nil. |
| AdjustSizesAndScalesForMapDistortions |
T or nil. |
| AdjustElevations |
T or nil. |
| AdjustZeroRotationObjects |
T or nil. |
System Options
| AccessWorkCenter |
T or nil. |
| CheckoutDirectory |
Path (string). For example, "c:\\data\\dwg" or "" if none. |
| PreserveAWCFiles |
T or nil. |
| ForceUserLogin |
T or nil. |
| EnableObjectLocking |
T or nil. |
| ReadPrefFromINI |
T or nil. |
| NumberofOpenDwgs |
integer | .
| DoublePrec |
real, 0 or greater, but less than 1. |
The "ForceUserLogin" and "DoublePrec" system options cannot be modified unless your end user has superuser privileges.
If "DoublePrec" is set to 0, the behavior of data extension queries is the same as before introducing this option. The "DoublePrec" option has no user interface equivalent.
Workspace Options
| CheckClasses |
T or nil. |
| CheckDrawings |
T or nil. |
| CheckQueryLibrary |
T or nil. |
| CheckDatabases |
T or nil. |
| CheckTables |
T or nil. |
| CheckQueries |
T or nil. |
| CheckTopologies |
T or nil. |
| CheckLPNs |
T or nil. Note that link path names (LPNs) have been replaced by link templates in AutoCAD Map. |
| ShowOPMOnStartup |
T or nil. |
| ShowWSpaceOnStartup |
T or nil. |
| WSpaceDockingView |
T or nil. |
| WSpaceWindowRect |
A list of four values (integer) that define the left, top, right, and bottom of the window rectangle. |
Database tables and database query categories are visible in the workspace only if "CheckTables" and "CheckQueries" are set to T and "CheckDatabases" is set to T also.
The following workspace options are read only. That is, they can be used only with ade_prefgetval to determine if a category is visible in the workspace.
Read-Only Workspace Options
| ClassesVisible |
T or nil. |
|
DrawingsVisible |
T or nil. |
| QueryLibraryVisible |
T or nil. |
| DatabasesVisible |
T or nil. |
| TablesVisible |
T or nil. |
| QueriesVisible |
T or nil. |
| TopologiesVisible |
T or nil. |
| LPNsVisible |
T or nil. |
