VS:DBDocGetDB
.VectorScript|VectorScript ..VS:Function Reference|Function Reference ..VS:Function_Reference_Appendix|Appendix
Description
Returns a string representing a ';' delimited list of the databases currently connected to the document.
FUNCTION DBDocGetDB(
VAR outDatabases :DYNARRAY[] of CHAR) : BOOLEAN;
def vs.DBDocGetDB(): return (BOOLEAN, outDatabases)
Parameters
outDatabases DYNARRAY[] of CHAR
Remarks
_c_ 2010.09.27: Some observations:
- no database connections in the document: returns FALSE
- one database connected to the document: the string won't end with colon ";".
- more databases connected: colon-separated string of database names.
Example
VectorScript
PROCEDURE ODBCtest; VAR outDatabases : DYNARRAY [] OF CHAR; BEGIN outDatabases := ''; IF DBDocGetDB(outDatabases) THEN BEGIN AlrtDialog(outDatabases); { colon-separated list of databases, if more than one } { .... } END; END; Run(ODBCtest);
Python
def ODBCtest(): outDatabases = '' hasDB, outDatabases= vs.DBDocGetDB() if hasDB: vs.AlrtDialog(outDatabases); #{ colon-separated list of databases, if more than one } ODBCtest()
Version
Availability: from Vectorworks 2011