Named Object Library Methods
Cadcorp SIS Desktop methods offer control over the setup of Named Object Libraries (NOLs) within a SIS Desktop application.
Methods are also provided for querying the contents of NOLs and creating new NOL objects.
There are two special NOLs:
- "(standard)" which contains all of the built-in NOL objects and is read-only
- "(temporary)" which is empty at the start of a session,
Note: The "(temporary)" NOL by default, contains new objects.
NOL objects can be created in other NOLs either by
- Making the target NOL the default NOL using the Libraries Control Bar or the _DefaultNol$ System Variable. (or)
- Specifying a "pathname" for the NOL object, e.g. "C:\\Sis\\NOLs\\Brushes.nol\\Red Cross Hatch" or "(temporary)\\Red Cross Hatch".
Note: The default NOL will always be searched first when a NOL object is requested (unless a "pathname" is used). NOL object names cannot contain the Tab or Escape character.
NOL object names can be made hierarchical (like a disk directory structure of folders and files) by using the "." (full stop) character as a separator.
For example the NOL Print Template objects "A4.Landscape", "A4.Portrait", "A3.Landscape", and "A3.Portrait" will appear in two "folders", "A4" and "A3", as "Landscape" and "Portrait".
Named objects without a "." will appear at the "root" of the "directory" tree.
In SIS Desktop applications, all modified NOLs (other than "(temporary)" are saved at the end of the session.
They are also saved when a Project Workspace file is closed.
NOLs can be removed without saving using the NolClose method. In the ActiveX Control , NOLs are not saved, except by the NolSave method.
ChangePrjUnits | Copies a named Transverse Mercator coordinate reference system, changing the units. |
CopyNolObject | Copies a named object between Named Object Libraries. |
CopyFeatureCode |
Copies an existing feature code into the currently loaded feature table. |
DefineNolDatum |
Defines a named geodetic datum, using the standard seven Bursa-Wolf parameters to modify WGS 84. |
DefineNolItem |
Stores the current open item in a Named Object Library. |
DefineNolItemFromLocus |
Stores a named spatial filter in a Named Object Library as a named item. |
DefineNolObject |
Creates a named object from an implicit string. |
DefineNolPrintTemplate |
Defines a named print template from the current window contents. |
DefineNolPrj |
Creates a named coordinate reference system from an EPSG code. |
DefineNolPrjLatLon |
Defines a named (Latitude,Longitude) coordinate reference system. |
DefineNolShape |
Defines a named Symbol from the items in a named list. |
DefineNolView |
Defines a named view from the view in the current window. |
DeleteNolObject |
Deletes a named object from a Named Object Library. |
ExportFeatureTable |
Exports a named feature table to a comma-separated file. |
GetFeatureTableBranches |
Gets the feature codes branching from a parent feature code in the currently loaded feature table. |
GetImplicitNolObject |
Gets the implicit equivalent of an object in a Named Object Library. |
GetNumNol |
Gets the number of Named Object Libraries in use. |
GetPrjCode |
Gets the EPSG code of a named coordinate reference system. |
ImportFeatureTable |
Imports a named feature table from a comma-separated file. |
InsertFeatureCode |
Inserts a new feature code into the currently loaded feature table. |
LoadFeatureTable |
Loads a named feature table for editing. |
NolCatalog |
Lists all of objects of a given class in all of the Named Object Libraries. |
NolClose |
Closes a Named Object Library, optionally saving any changes. |
NolCompact |
Discards all old Named Object Library (NOL) objects and defragments the memory used by a NOL. |
NolCreate |
Creates an empty Named Object Library file. |
NolInsert |
Inserts a Named Object Library file. |
NolOwn |
Sets the ownership of a Named Object Library. |
NolSave |
Saves a Named Object Library file. |
RecallNolItem |
Creates an item from a Named Object Library item. |
RecallNolView |
Recalls a named view from a Named Object Library. |
RemoveFeatureCode |
Removes an existing feature code from the currently loaded feature table. |
ShowNolObjectDialog | Shows the edit dialog for an object in a Named Object Library. |
ShowUI | Opens a SIS dialog to acquire user input, e.g. select an overlay or style or edit an expression, etc. |
StoreFeatureTable | Stores the currently open feature table. |