Command
QisLib_GetDataVector

QisLib_GetDataVector


Function:
	int QisLib_GetDataVector(void);

Inputs: -

Return:
	success: 0
	failure: one of the following values:

Errors:
	-1: QisLib has not been initialized.
	-2: The callback function to handle vector data has not been set.
	-3: Internal error occurred while processing vector data.
	-4: File open in progress, operation not permitted.

Description:
	- Starting from the currently opened cell, all the way down through the cell
	references hierarchy, this function outputs vector data (boundaries, paths, texts,
	cell and array references) as long as the extents of the data overlap with the
	current viewing area window, the layers on which the data exists are on, the cell
	references are within the specified nesting level, etc.
	- QisLib returns data to the user's program by calling a handler callback function set
	by the user's program via a call to QisLib_SetVectorDataCallback. If this callback
	function is not set, QisLib_GetDataVector fails and an error code is returned. The
	callback function is called by QisLib, potentially many times, once per data,
	before QisLib_GetDataVector returns. When QisLib_GetDataVector returns, it means all
	data are sent via the callback function.
	- Display filter size and cell display filter size do not affect the output of this
	function.
	- To interrupt this function while it is returning data, the user program can call
	QisLib_Stop. This feature can only be used if QisLib_SetProcessEvents is on. Also,
	for Unix/Linux, the program's application context must be passed as a parameter to
	QisLib_InitLib.

References:
QisLib_SetVectorDataCallback
QisLib_SetExactWindow
QisLib_SetWindow
QisLib_Stop
QisLib_InitLib
QisLib_SetProcessEvents