Skip to content

Commit b125543

Browse files
SyncfusionBuildSyncfusionBuild
authored
Merge pull request #3483 from Syncfusion-Content/hotfix/hotfix-v30.1.37
DOCINFRA-2341_merged_using_automation
2 parents cbc0676 + d451693 commit b125543

File tree

3 files changed

+109
-13
lines changed

3 files changed

+109
-13
lines changed

‎MAUI/PDF-Viewer/Migration.md‎

Lines changed: 25 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -197,6 +197,11 @@ To make migration from [Xamarin SfPdfViewer](https://www.syncfusion.com/xamarin-
197197
<td>{{'[AnnotationSettings.Stamp](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.PdfViewer.AnnotationSettings.html#Syncfusion_Maui_PdfViewer_AnnotationSettings_Stamp)'| markdownify}}</td>
198198
<td>Gets or sets the default settings for stamp annotations.</td>
199199
</tr>
200+
<tr>
201+
<td>{{'[AnnotationMode.HandwrittenSignature](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfPdfViewer.XForms.AnnotationMode.html#Syncfusion_SfPdfViewer_XForms_AnnotationMode_HandwrittenSignature)'| markdownify}}</td>
202+
<td>{{'[AnnotationMode.Signature](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.PdfViewer.AnnotationMode.html#Syncfusion_Maui_PdfViewer_AnnotationMode_Signature)'| markdownify}}</td>
203+
<td>This will display the signature dialog, allowing the user to create a signature. The created signature can then be added at the tapped location in the PDF Viewer.</td>
204+
</tr>
200205
<tr>
201206
<td>{{'[Selector](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfPdfViewer.XForms.AnnotationSettings.html#Syncfusion_SfPdfViewer_XForms_AnnotationSettings_Selector)'| markdownify}}</td>
202207
<td>{{'[AnnotationSettings.Selector](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.PdfViewer.AnnotationSettings.html#Syncfusion_Maui_PdfViewer_AnnotationSettings_Selector)'| markdownify}}</td>
@@ -232,6 +237,11 @@ To make migration from [Xamarin SfPdfViewer](https://www.syncfusion.com/xamarin-
232237
<td>{{'[ShowToolbars](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.PdfViewer.SfPdfViewer.html#Syncfusion_Maui_PdfViewer_SfPdfViewer_ShowToolbars)'| markdownify}}</td>
233238
<td>Backing store for the ShowToolbars property.</td>
234239
</tr>
240+
<tr>
241+
<td>{{'[AnnotationSettings.HandwrittenSignature](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfPdfViewer.XForms.AnnotationSettings.html#Syncfusion_SfPdfViewer_XForms_AnnotationSettings_HandwrittenSignature)'| markdownify}}</td>
242+
<td>API Unavailable</td>
243+
<td>In .NET MAUI PDF Viewer, there is no API to configure common settings for handwritten signatures. However, you can achieve this by handling the [SignatureCreated](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.PdfViewer.SfPdfViewer.html#Syncfusion_Maui_PdfViewer_SfPdfViewer_SignatureCreated) event, which allows you to access and customize each handwritten signature when it is created using the built-in signature dialog.</td>
244+
</tr>
235245
</table>
236246

237247
## Events
@@ -351,14 +361,12 @@ private void PdfViewer_PropertyChanged(object? sender, PropertyChangedEventArgs
351361
</tr>
352362
<tr>
353363
<td>
354-
<div>{{'[ExportAsImageAsync](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfPdfViewer.XForms.SfPdfViewer.html#Syncfusion_SfPdfViewer_XForms_SfPdfViewer_ExportAsImageAsync_System_Int32_System_Int32_System_Single_System_Threading_CancellationToken_)'| markdownify }}</div>
355-
364+
{{'[DocumentSaveInitiated](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfPdfViewer.XForms.SfPdfViewer.html#Syncfusion_SfPdfViewer_XForms_SfPdfViewer_DocumentSaveInitiated)'| markdownify }}
356365
</td>
357366
<td>API Unavailable</td>
358-
<td>In .NET MAUI PDF Viewer, there is no support for exporting PDF as images. However, you can use the Syncfusion PDF to Image Converter library to convert PDF documents into images.
359-
For detailed implementation guidance, please refer to the following API documentation:
360-
{{'[PdfToImageConverter](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.PdfToImageConverter.PdfToImageConverter.html)'| markdownify }}
367+
<td> In Xamarin, clicking the Save button in the built-in toolbar raises the [DocumentSaveInitiated](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfPdfViewer.XForms.SfPdfViewer.html#Syncfusion_SfPdfViewer_XForms_SfPdfViewer_DocumentSaveInitiated) event. However, in .NET MAUI, a Save button is not provided in the built-in toolbar, so the [DocumentSaveInitiated](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfPdfViewer.XForms.SfPdfViewer.html#Syncfusion_SfPdfViewer_XForms_SfPdfViewer_DocumentSaveInitiated) event is not available. To save documents from the PDF viewer in .NET MAUI, you can use the [SaveDocument](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.PdfViewer.SfPdfViewer.html#Syncfusion_Maui_PdfViewer_SfPdfViewer_SaveDocument_System_IO_Stream_) method. The PdfViewer control exposes this method as an API, which can be easily integrated into your application. For more details on using the SaveDocument method, refer to the relevant UG Documentation [Save a Document](https://help.syncfusion.com/maui/pdf-viewer/save-a-document).
361368

369+
In .NET MAUI PDF Viewer, you can implement custom save logic at the application level. If you would like to include a Save button in the built-in toolbar, this can be achieved by customizing the toolbar items. Refer to the [Customize toolbar items user guide](https://help.syncfusion.com/maui/pdf-viewer/toolbar#customize-toolbar-items) for instructions on adding a custom Save button.
362370
</td>
363371
</tr>
364372
</table>
@@ -464,6 +472,18 @@ For detailed implementation guidance, please refer to the following API document
464472
<td>{{'[FormField.FlattenOnSave](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.PdfViewer.FormField.html#Syncfusion_Maui_PdfViewer_FormField_FlattenOnSave)'| markdownify }}</td>
465473
<td>Specifies whether the form fields should be flattened or not on saving.</td>
466474
</tr>
475+
<tr>
476+
<td>
477+
<div>{{'[ExportAsImageAsync](https://help.syncfusion.com/cr/xamarin/Syncfusion.SfPdfViewer.XForms.SfPdfViewer.html#Syncfusion_SfPdfViewer_XForms_SfPdfViewer_ExportAsImageAsync_System_Int32_System_Int32_System_Single_System_Threading_CancellationToken_)'| markdownify }}</div>
478+
479+
</td>
480+
<td>API Unavailable</td>
481+
<td>In .NET MAUI PDF Viewer, there is no support for exporting PDF as images. However, you can use the Syncfusion PDF to Image Converter library to convert PDF documents into images.
482+
For detailed implementation guidance, please refer to the following API documentation:
483+
{{'[PdfToImageConverter](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.PdfToImageConverter.PdfToImageConverter.html)'| markdownify }}
484+
485+
</td>
486+
</tr>
467487
</table>
468488

469489
## Classes

‎MAUI/PDF-Viewer/Signature.md‎

Lines changed: 33 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -117,15 +117,15 @@ N> To add a text signature, you can use an image containing the signature text .
117117

118118
## Signature modal view
119119

120-
The signature modal view appears when a signature needs to be created. The [Sfpdfviewer](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.PdfViewer.SfPdfViewer.html) notifies when the modal view is appearing and disappearing through events. The events help you in hiding and showing elements that are part of the app UI that are not necessary as long as the modal view is visible.
120+
The signature modal view appears when a signature needs to be created. The [SfPdfViewer](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.PdfViewer.SfPdfViewer.html) notifies when the modal view is appearing and disappearing through events. The events help you in hiding and showing elements that are part of the app UI that are not necessary as long as the modal view is visible.
121121

122122
**Mobile:**
123123
![Signature pad modal view mobile](Images/Annotations/signature-pad-modal-view-mobile.png)
124124

125125
**Desktop:**
126126
![Signature pad modal view desktop](Images/Annotations/signature-pad-modal-view-desktop.png)
127127

128-
The `Sfpdfviewer.SignatureModalViewAppearing` event is triggered whenever the modal view opens.
128+
The `SfPdfViewer.SignatureModalViewAppearing` event is triggered whenever the modal view opens.
129129

130130
{% tabs %}
131131
{% highlight c# %}
@@ -140,7 +140,7 @@ private void PdfViewer_SignatureModalViewAppearing(object? Sender, FormFieldModa
140140
{% endhighlight %}
141141
{% endtabs %}
142142

143-
The `Sfpdfviewer.SignatureModalViewDisappearing` event is triggered when the modal view is closing.
143+
The `SfPdfViewer.SignatureModalViewDisappearing` event is triggered when the modal view is closing.
144144

145145
{% tabs %}
146146
{% highlight c# %}
@@ -155,11 +155,11 @@ Private void PdfViewer_SignatureModalViewDisappearing(object? Sender, EventArgs
155155
{% endhighlight %}
156156
{% endtabs %}
157157

158-
### Supressing the signature modal view and implement your own UI
158+
### Suppressing the signature modal view and implement your own UI
159159

160-
The [Sfpdfviewer](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.PdfViewer.SfPdfViewer.html) allows you to supress the signature modal view and use your own UI in its place. This can be achieved by setting the `FormFieldModalViewAppearingEventArgs.Cancel` property to `true` in the `SignatureModalViewAppearing` event handler.
160+
The [SfPdfViewer](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.PdfViewer.SfPdfViewer.html) allows you to suppress the signature modal view and use your own UI in its place. This can be achieved by setting the `FormFieldModalViewAppearingEventArgs.Cancel` property to `true` in the `SignatureModalViewAppearing` event handler.
161161

162-
The below code snippet illustrates supressing the signature modal view and using a UI implemented in the app in its place. In this illustration, it is assumed that the signature is produced in the form of an image stream when the user completes drawing the signature in the custom dialog. When the PDF viewer is tapped, the created signature is added as a stamp annotation.
162+
The below code snippet illustrates suppressing the signature modal view and using a UI implemented in the app in its place. In this illustration, it is assumed that the signature is produced in the form of an image stream when the user completes drawing the signature in the custom dialog. When the PDF viewer is tapped, the created signature is added as a stamp annotation.
163163

164164
{% tabs %}
165165
{% highlight c# %}
@@ -192,3 +192,30 @@ private void PdfViewer_Tapped(object sender, GestureEventArgs e)
192192
{% endhighlight %}
193193
{% endtabs %}
194194

195+
## Signature Created Event
196+
197+
The [SignatureCreated](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.PdfViewer.SfPdfViewer.html#Syncfusion_Maui_PdfViewer_SfPdfViewer_SignatureCreated) event in the .NET MAUI PDF Viewer provides a way to access and customize the properties of a handwritten signature immediately after it is created using built-in signature dialog. This is especially helpful when you want to apply consistent styling such as stroke color, border width, or opacity to all handwritten signatures.
198+
199+
To customize the signature, check whether the [e.Signature](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.PdfViewer.SignatureCreatedEventArgs.html#Syncfusion_Maui_PdfViewer_SignatureCreatedEventArgs_Signature) object is of type [InkAnnotation](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.PdfViewer.InkAnnotation.html), which represents a handwritten ink-based signature. If it is, you can modify its properties as needed.
200+
201+
The following example demonstrates how to handle the SignatureCreated event and apply custom styling to a handwritten signature:
202+
203+
{% tabs %}
204+
{% highlight c# %}
205+
// Subscribe to the SignatureCreated event to customize the appearance of handwritten signatures.
206+
pdfViewer.SignatureCreated += PdfViewer_SignatureCreated;
207+
208+
// Event handler triggered when a signature is created in the PDF Viewer.
209+
private void PdfViewer_SignatureCreated(object? sender, SignatureCreatedEventArgs e)
210+
{
211+
// Ensure the signature is valid and is of type InkAnnotation (used for handwritten signatures).
212+
if (e.Signature is InkAnnotation handWrittenSignature)
213+
{
214+
// Customize the appearance of the handwritten signature.
215+
handWrittenSignature.BorderWidth = 6; // Set the thickness of the signature stroke.
216+
handWrittenSignature.Color = Colors.Yellow; // Set the stroke color to yellow.
217+
handWrittenSignature.Opacity = 0.75f; // Set the transparency level of the signature.
218+
}
219+
}
220+
{% endhighlight %}
221+
{% endtabs %}

‎MAUI/Release-notes/v30.1.42.md‎

Lines changed: 51 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,59 @@ documentation: ug
77

88
# Essential Studio for MAUI Release Notes
99

10-
{% include release-info.html date="July 29, 2025" version="v30.1.42" %}
10+
{% include release-info.html date="July 29, 2025" version="v30.1.42" passed="157787" failed="0" %}
1111

1212
{% directory path: _includes/release-notes/v30.1.42 %}
1313

1414
{% include {{file.url}} %}
1515

16-
{% enddirectory %}
16+
{% enddirectory %}
17+
18+
## Test Results
19+
20+
| Component Name | Test Cases | Passed | Failed | Remarks |
21+
|---------------|------------|--------|--------|---------|
22+
| SfAIAssistView | 119 | 119 | 0 | All Passed |
23+
| SfAutocomplete | 262 | 262 | 0 | All Passed |
24+
| SfBarcodeGenerator | 1763 | 1763 | 0 | All Passed |
25+
| SfButton | 104 | 104 | 0 | All Passed |
26+
| SfCalendar | 2345 | 2345 | 0 | All Passed |
27+
| SfCards | 235 | 235 | 0 | All Passed |
28+
| SfCarousel | 203 | 203 | 0 | All Passed |
29+
| SfCharts | 521 | 521 | 0 | All Passed |
30+
| SfCheck Box | 154 | 154 | 0 | All Passed |
31+
| SfComboBox | 344 | 344 | 0 | All Passed |
32+
| SfDataForms | 3324 | 3324 | 0 | All Passed |
33+
| SfDataGrid | 2357 | 2357 | 0 | All Passed |
34+
| SfExpander | 215 | 215 | 0 | All Passed |
35+
| SfGauge | 1184 | 1184 | 0 | All Passed |
36+
| SfImageEditor | 3393 | 3393 | 0 | All Passed |
37+
| SfKanban | 204 | 204 | 0 | All Passed |
38+
| SfListView | 4607 | 4607 | 0 | All Passed |
39+
| SfMaps | 1229 | 1229 | 0 | All Passed |
40+
| SfMaskedEntry | 174 | 174 | 0 | All Passed |
41+
| SfNavigationDrawer | 125 | 125 | 0 | All Passed |
42+
| SfNumericEntry | 233 | 233 | 0 | All Passed |
43+
| SfNumericUpDown | 233 | 233 | 0 | All Passed |
44+
| SfPdfViewer | 14271 | 14271 | 0 | All Passed |
45+
| SfPicker | 445 | 445 | 0 | All Passed |
46+
| SfPopup | 1240 | 1240 | 0 | All Passed |
47+
| SfProgressBar | 624 | 624 | 0 | All Passed |
48+
| SfRadialMenu | 200 | 200 | 0 | All Passed |
49+
| SfRadioButton | 183 | 183 | 0 | All Passed |
50+
| SfRating | 200 | 200 | 0 | All Passed |
51+
| SfRotator | 1194 | 1194 | 0 | All Passed |
52+
| SfScheduler | 10977 | 10977 | 0 | All Passed |
53+
| SfSegment | 338 | 338 | 0 | All Passed |
54+
| SfShimmer | 371 | 371 | 0 | All Passed |
55+
| SfSlider | 292 | 292 | 0 | All Passed |
56+
| SfSwitch | 131 | 131 | 0 | All Passed |
57+
| SfTab View | 1620 | 1620 | 0 | All Passed |
58+
| SfTextInputLayout | 199 | 199 | 0 | All Passed |
59+
| SfTreeMap | 454 | 454 | 0 | All Passed |
60+
| SfTreeView | 233 | 233 | 0 | All Passed |
61+
| DocIO | 16352 | 16352 | 0 | All Passed |
62+
| Metafilerenderer | 863 | 863 | 0 | All Passed |
63+
| PDF | 12737 | 12737 | 0 | All Passed |
64+
| Presentation | 54266 | 54266 | 0 | All Passed |
65+
| XlsIO | 17269 | 17269 | 0 | All Passed |

0 commit comments

Comments
 (0)