 | CDBCreateSymb Method |
Create a new Symbol.
Namespace: GeoEngine.Core.GXNetX
Assembly: geoengine.core.gxnetx (in geoengine.core.gxnetx.dll) Version: 2024.2.0.25
Syntaxpublic int CreateSymb( string name, int symb, int owner, int category ) public int CreateSymb( string name, int symb, int owner, int category )
Parameters
- name
- Type: SystemString
Symbol Name - symb
- Type: SystemInt32
<define>DB_SYMB_TYPE</define> - owner
- Type: SystemInt32
<define>DB_OWN</define> - category
- Type: SystemInt32
<define>DB_CATEGORY_USER</define>, <define>DB_CATEGORY_LINE</define>, <define>DB_CATEGORY_CHAN</define>, <define>DB_CATEGORY_BLOB</define>
Return Value
Type: Int32DB_SYMB Object
Remarks
If symbol already exits, and it is the same type
simply returns a handle to the existing symbol.
This method simple calls CreateSymbEx_DB with the
extra info set to 1.
STRING-type channels: To create a string-type channel,
enter a negative number for the channel category below.
For instance, "-32" will create a string channel with
32 characters per item.
BLOBS: Blobs (Binary Large Objects) can be used for storing
miscellaneous data which does not fit well into any of the
other various storage objects, such as a REG. Generally,
one or more objects is serialized to a BF object, which
is then written to the blob using the sWriteBlobBF_DB()
function. Retrieval is done in the reverse order, using
sWriteBlobBF_DB() first, then extracting the objects from the
BF object.
To avoid namespace problems, Geosoft reserves the following
name prefixes:
OE. (Core functions)
GS. (Applications)
CS. (Custom Solutions applications)
Programmers should avoid using the above prefixes as the starting
letters of their blob names to avoid any possible conflicts.
See Also