L_LTSVG_API L_INT L_SvgBeginUpdateDocument(docHandle)
Begins a process that will update the elements (nodes) of an SVG document.
The SVG document handle that will be updated.
|SUCCESS||The function was successful.|
|< 1||An error occurred. Refer to Return Codes.|
Support for SVG is only available in the Document and Medical Imaging toolkits.
The user can modify the elements of an SVG document using L_SvgEnumerateElements and updating the nodes elements or attributes.
After modifying the values of an SVG document using, it may be necessary to re-calculate the document flat, render optimization and bounding rectangles (refer to Document and Medical more information). Therefore, it is recommended to call L_SvgBeginUpdateDocument before making any updates to the document and calling L_SvgEndUpdateDocument when done. The engine will check during L_SvgEndUpdateDocument if any internal state values need to be re-calculated and update as necessary.
L_SvgBeginUpdateDocument increments an internal counter and L_SvgEndUpdateDocument decrements it. When the counter reaches 0 again, the document is updated. Therefore, the user can chain calls to L_SvgBeginUpdateDocument/L_SvgEndUpdateDocument pairs and the update will only occur once at the end.
Required DLLs and Libraries
Win32, x64, Linux.