References ▼
Begins a process that will update the elements (nodes) of an SVG document.
#include "l_bitmap.h"
L_LTSVG_API L_INT L_SvgBeginUpdateDocument(docHandle)
The SVG document handle that will be updated.
| Value | Meaning |
|---|---|
| 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.
Win32, x64, Linux.
For an example, refer to L_SvgEnumerateElements.