Command
QisLib_GetWindowInfo Function: int QisLib_GetWindowInfo(CQisWindow Window); Inputs: Window: Window area for which data is desired. 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: - This function can be used to get a stream of vector data (boundaries, paths, texts, cell references and array references) that falls within the specified window. - The data is considered to be within a window when it has a vertex inside the window (paths and boundaries) or insertion point inside the window (texts and cell references) or when the cell reference outline is turned on, at least one of the four corners of the reference outline extent box is within the window area. - The window specified as the parameter to QisLib_GetWindowInfo must be inside the window currently set. (window set by QisLib_SetWindow, QisLib_SetExactWindow, QisLib_SetZoomIn or QisLib_ZoomHome) - If QisLib_SetVectorFull is on, entity data will be returned only if the data lies completely inside the window currently set (window set by QisLib_SetWindow, QisLib_SetExactWindow, QisLib_SetZoomIn or QisLib_ZoomHome) and the data lies within the window specified as the parameter to QisLib_GetWindowInfo (as defined by point #2 of the description above). - Just like QisLib_GetDataVector and QisLib_GetDisplayVector, this function returns data by calling a handler function set by the user program using QisLib_SetVectorDataCallback. This handler function must be set in order to use QisLib_GetWindowInfo. - This function is not affected by display filters. - To stop 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' and for Unix/Linux, the program's application context was passed as a parameter to QisLib_InitLib.References: QisLib_SetVectorFull QisLib_SetVectorDataCallback QisLib_GetDataVector QisLib_Stop QisLib_SetProcessEvents QisLib_InitLib QisLib_SetStructureOutline CQisWindow |