Skip to content

Commit bfe37d4

Browse files
1012753: CI issue resolved and added limitations
1 parent 1109d6c commit bfe37d4

3 files changed

Lines changed: 31 additions & 14 deletions

File tree

Document-Processing-toc.html

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4553,6 +4553,9 @@
45534553
<li>
45544554
<a href="/document-processing/word/word-library/net/Working-with-SmartArts">Working with SmartArts</a>
45554555
</li>
4556+
<li>
4557+
<a href="/document-processing/word/word-library/net/Working-with-Ink">Working with Inks</a>
4558+
</li>
45564559
<li>
45574560
<a href="/document-processing/word/word-library/net/Working-with-Charts">Working with Charts</a>
45584561
<ul>

Document-Processing/Word/Word-Library/NET/Working-with-Ink.md

Lines changed: 27 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ platform: document-processing
55
control: DocIO
66
documentation: UG
77
---
8-
# Working with Ink
8+
# Working with Ink Elements
99

1010
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>&reg;</sup> Word library (DocIO).
1111

@@ -17,7 +17,7 @@ The following code example illustrating how to create an Ink in a Word document.
1717

1818
{% tabs %}
1919

20-
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="" %}
20+
{% highlight c# tabtitle="C# [Cross-platform]" %}
2121

2222
//Creates a new Word document.
2323
WordDocument document = new WordDocument();
@@ -133,7 +133,7 @@ The following code example illustrating how to create an Ink with Multiple Tra
133133

134134
{% tabs %}
135135

136-
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="" %}
136+
{% highlight c# tabtitle="C# [Cross-platform]" %}
137137

138138
//Creates a new Word document.
139139
WordDocument document = new WordDocument();
@@ -250,7 +250,7 @@ The following code example shows GetPoints method which is used to get trace poi
250250

251251
{% tabs %}
252252

253-
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="" %}
253+
{% highlight c# tabtitle="C# [Cross-platform]" %}
254254

255255
public List<PointF[]> GetPoints()
256256
{
@@ -375,7 +375,7 @@ The following code example demonstrates how to customize the Ink Effect.
375375

376376
{% tabs %}
377377

378-
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="" %}
378+
{% highlight c# tabtitle="C# [Cross-platform]" %}
379379

380380
//Opens the template document
381381
FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
@@ -442,7 +442,7 @@ The following code example demonstrates how to customize the Ink Color.
442442

443443
{% tabs %}
444444

445-
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="" %}
445+
{% highlight c# tabtitle="C# [Cross-platform]" %}
446446

447447
//Opens the template document
448448
FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
@@ -511,7 +511,7 @@ The following code example demonstrates how to customize the Ink thickness.
511511

512512
{% tabs %}
513513

514-
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="" %}
514+
{% highlight c# tabtitle="C# [Cross-platform]" %}
515515

516516
//Opens the template document
517517
FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
@@ -580,7 +580,7 @@ The following code example demonstrates how to customize the Ink Points.
580580

581581
{% tabs %}
582582

583-
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="" %}
583+
{% highlight c# tabtitle="C# [Cross-platform]" %}
584584

585585
//Opens the template document
586586
FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
@@ -650,7 +650,7 @@ You can remove ink by iterating through Ink objects or specifying an index. The
650650

651651
{% tabs %}
652652

653-
{% highlight c# tabtitle="C# [Cross-platform]" playgroundButtonLink="" %}
653+
{% highlight c# tabtitle="C# [Cross-platform]" %}
654654

655655
//Opens the template document
656656
FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
@@ -723,14 +723,28 @@ document.Close()
723723

724724
{% endtabs %}
725725

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]().
728727
## Limitations
729728

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.
730746

731747
## Online Demo
732748

733749
* Explore how to create a Word document with Ink using the .NET Word Library (DocIO) in a live demo [here]().
734750
* Explore how to edit a Word document with Ink using the .NET Word Library (DocIO) in a live demo [here]().
735-
736-
## Frequently Asked Questions

Document-Processing/Word/Word-Library/NET/faqs/paragraph-and-paragraph-items-faqs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ platform: document-processing
55
control: DocIO
66
documentation: UG
77
---
8-
# Frequently asked questions about paragraph and paragraph items in Word document
8+
# Frequently asked questions on paragraphs and items in Word document
99

1010
The frequently asked questions about working with paragraph and paragraph items in Word documents using DocIO are listed below.
1111

0 commit comments

Comments
 (0)