You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: Document-Processing/Word/Word-Library/NET/Working-with-Ink.md
+27-13Lines changed: 27 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ platform: document-processing
5
5
control: DocIO
6
6
documentation: UG
7
7
---
8
-
# Working with Ink
8
+
# Working with Ink Elements
9
9
10
10
An Ink annotation is a freehand drawing or handwritten input composed of stroke points that conveys signatures, notes, or sketches directly on a page. You can add and modify Ink in Word documents using Syncfusion<sup>®</sup> Word library (DocIO).
11
11
@@ -17,7 +17,7 @@ The following code example illustrating how to create an Ink in a Word document.
FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
@@ -723,14 +723,28 @@ document.Close()
723
723
724
724
{% endtabs %}
725
725
726
-
You can download a complete working sample from [GitHub](https://github.com/SyncfusionExamples/DocIO-Examples/tree/main/Paragraphs/Remove-ink/.NET/).
727
-
726
+
You can download a complete working sample from [GitHub]().
728
727
## Limitations
729
728
729
+
The .NET Word Library (DocIO) has the following limitations when creating Ink programmatically or processing Ink from an existing Word document.
730
+
731
+
**Document Processing Functionalities**
732
+
733
+
Document Comparison - Ink elements are not included in document comparison operations.
734
+
735
+
**Compatibility with Older Documents**
736
+
737
+
DocIO supports Ink elements only in DOCX format. However, documents created in Word 2003 compatibility mode are an exception. In these documents, DocIO does not treat the Ink as Ink elements but instead treats it as document model data stored as base64-encoded ISF data. As a result, Ink content cannot be **edited or converted**.
738
+
739
+
**To resolve this**, upgrade the document to the latest Word compatibility format. Open the document in **Microsoft Word**, save it with the **latest compatibility** version, and then reload it in DocIO. After upgrading, you can edit or convert the Ink elements as needed.
740
+
741
+
**Word-to-PDF and Image Conversion**
742
+
743
+
During Word-to-PDF and Word-to-Image conversions, Syncfusion Word Library uses fallback images embedded in the document to preserve the Ink visual appearance. However, when Ink is created or modified using the Syncfusion Word Library, some Ink effects cannot be rendered accurately due to rendering engine limitations. Although the Ink stroke geometry is preserved, visual brush effects are lost.
744
+
745
+
**To resolve this**, save the document using DocIO first. Then, open the saved document in Microsoft Word and save it again. Finally, convert it to PDF or Image using DocIO. This process regenerates the required Ink fallback images, ensuring accurate visual output.
730
746
731
747
## Online Demo
732
748
733
749
* Explore how to create a Word document with Ink using the .NET Word Library (DocIO) in a live demo [here]().
734
750
* Explore how to edit a Word document with Ink using the .NET Word Library (DocIO) in a live demo [here]().
0 commit comments