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.
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.