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