Merge pull request #110 from Syncfusion-Content/development

DOCINFRA-2341_merged_using_automation

Author: SyncfusionBuild

xamarin-android-toc.html

@@ -1,13 +1,13 @@
 ---
 layout: post
 title: System Requirements | Xamarin.Android | Syncfusion
-description: System Requirements
+description: Describes about system requirements to install the Syncfusion Xamarin Android Components and list of supported platforms.
 platform: Xamarin.Android
 control: Introduction
 documentation: ug
 ---
 
-# System Requirements
+# System Requirements for Xamarin.Android
 
 ### Hardware Environment
 
@@ -45,18 +45,18 @@ The following table lists the platforms supported by our Xamarin.Android control
         </th>
     </tr>
     <tr>
-        <td rowspan="2">
+        <td>
             Android
             <br/>
             <br/>
         </td>
-        <td rowspan="2">
+        <td>
         Phone, Tablet
         <br/>
         <br/>
         </td>
         <td>
-            SfPdfViewer, SfCheckBox
+            All controls 
             <br/>
             <br/>
         </td>
@@ -66,18 +66,6 @@ The following table lists the platforms supported by our Xamarin.Android control
             <br/>
         </td>
     </tr>
-     <tr>
-        <td>
-            All other controls 
-            <br/>
-            <br/>
-        </td>
-         <td>
-            API level 19 and later versions
-            <br/>
-            <br/>
-        </td>
-    </tr>
 </table>
 
 ### Target Framework (Compile SDK Version) for Android

xamarin-android/Introduction/System-Requirements.md

@@ -9,9 +9,9 @@ documentation: ug
 
 # How to upgrade from Trial version after purchasing a license?
 
-To upgrade from trial version, there are two possible solutions.
+To upgrade from trial version,
 
-* Uninstall the trial version and install the fully licensed build from the [License & Downloads](https://www.syncfusion.com/account/downloads) section of our website.  
 * If you are using Syncfusion controls from [nuget.org](https://www.nuget.org/packages?q=syncfusion), replace the currently used trial license key with a paid license key that can be generated from the [License & Downloads](https://www.syncfusion.com/account/downloads) section of our website. Refer to [this](https://help.syncfusion.com/xamarin-android/licensing/registering-license-keys) topic for more information regarding registering the license in the application.
 
-N> License registration is not required if you reference Syncfusion assemblies from Licensed installer. These licensing changes applicable to all evaluators who refers the Syncfusion assemblies from evaluation installer and those who use Syncfusion NuGet packages from [nuget.org](https://www.nuget.org/).
+N> Starting with 2022 Volume 1 v20.1.0.47, all Syncfusion customers (evaluators and paid customers) who use Syncfusion installers or nuget packages from [nuget.org](https://www.nuget.org/packages?q=Syncfusion) must generate and register the corresponding platform and version license key in your projects.<br>
+For more information, please see [this](https://help.syncfusion.com/xamarin-android/licensing/licensing) help topic.

xamarin-android/Licensing/licensing-faq/how-to-upgrade-from-trial-version-after-purchasing-a-license.md

@@ -19,7 +19,7 @@ margin-top: 1.5em;     margin-bottom: 1.5em;
 
 # Syncfusion Licensing in Xamarin
 
-We have introduced a new licensing system starting with version 16.2.0.x release of Essential Studio. These modifications apply to all evaluators and only to paid customers who use NuGet packages from [nuget.org](https://www.nuget.org/). Starting with v16.2.0.x, if you use the evaluation installer or the NuGet feed to reference Syncfusion assemblies, you must also include the corresponding platform and version license key in your projects.
+Starting with 2022 Volume 1 v20.1.0.47, all Syncfusion customers (evaluators and paid customers) who use Syncfusion installers or nuget packages from [nuget.org](https://www.nuget.org/packages?q=Syncfusion) must generate and register the corresponding platform and version license key in your projects.
 
 ### Difference between unlock key and license key
 

xamarin-android/Licensing/licensing.md

@@ -0,0 +1,32 @@
+---
+title: Essential Studio for Xamarin.Android 2022 volume 1 Main release Release Notes  
+description: Essential Studio for Xamarin.Android 2022 volume 1 Main release Release Notes  
+platform: Xamarin.Android
+documentation: ug
+---
+
+# Essential Studio for Xamarin.Android  Release Notes  
+
+{% include release-info.html date="April 4, 2022" version="v20.1.0.47" %} 
+
+<style>
+#license {
+    font-size: .88em!important;
+margin-top: 1.5em;     margin-bottom: 1.5em;
+    background-color: #def8ff;
+    padding: 10px 17px 14px;
+}
+</style>
+
+
+<div id="license">
+Starting with 2022 Volume 1 v20.1.0.47, all Syncfusion customers (evaluators and paid customers) who use Syncfusion installers or nuget packages from <a href="https://www.nuget.org/packages?q=Syncfusion">nuget.org</a> must generate and register the corresponding platform and version license key in your projects.
+For more information, please see this <a href="https://help.syncfusion.com/common/essential-studio/licensing/license-key">help topic</a>
+</div>
+
+
+{% directory path: _includes/release-notes/v20.1.0.47 %}
+
+{% include {{file.url}} %}
+
+{% enddirectory %}

xamarin-android/Release-Notes/v20.1.0.47.md

@@ -371,6 +371,56 @@ private void PdfViewer_FreeTextAnnotationRemoved(object sender, FreeTextAnnotati
 {% endhighlight %}
 {% endtabs %}
 
+## How to lock or unlock the free text annotations?
+ 
+To lock or unlock all the free text annotation, set the `IsLocked` API to `true` or `false` respectively, and the following sample explains the same. But other annotation types can be moved, resized, removed or their attributes can be changed. 
+
+{% tabs %}
+{% highlight c# %}
+
+//Disable the free text annotation interaction such as move, resize, remove, and attributes changes.
+pdfViewerControl.AnnotationSettings.FreeText.IsLocked = true;
+
+{% endhighlight %}
+{% endtabs %}
+ 
+Interactions with free text annotation types such as move, resize, remove or attribute changes will be allowed only if the `SfPdfViewer.AnnotationSettings.IsLocked` API is set to `false`. The following code prevents the unlocking of the free text annotations, although the `IsLocked` property of the free text annotation is set to `false`.
+ 
+{% tabs %}
+{% highlight c# %}
+
+//Disable the free text annotation interaction, though its 'IsLocked' property is set to ‘false’ .
+pdfViewerControl.AnnotationSettings.IsLocked = true;
+pdfViewerControl.AnnotationSettings.FreeText.IsLocked = false;
+
+{% endhighlight %}
+{% endtabs %}
+
+## How to enable or disable the free text annotation selection?
+
+To enable or disable the free text annotation selection, set the `Constraints` API to `AnnotationConstraints.Selectable` or `~AnnotationConstraints.Selectable` respectively, and the following sample explains the same. But other annotation types can be selected, moved, resized, removed or their attributes can be changed. 
+
+{% tabs %}
+{% highlight c# %}
+
+//Disable the selection of free text annotations.
+pdfViewerControl.AnnotationSettings.FreeText.Constraints = ~AnnotationConstraints.Selectable;
+
+{% endhighlight %}
+{% endtabs %}
+
+Free text annotation selection will be allowed only if the `SfPdfViewer.AnnotationSettings.Constraints` API is set to `AnnotationConstraints.Selectable`. The following code prevents the free text annotations selection, even though the `Constraints` property of the free text annotation is set to `AnnotationConstraints.Selectable`.
+
+{% tabs %}
+{% highlight c# %}
+
+//Disable the free text annotation selection, though its 'Constraints' property is set to ‘AnnotationConstraints.Selectable’ 
+pdfViewerControl.AnnotationSettings.Constraints= ~AnnotationConstraints.Selectable;
+pdfViewerControl.AnnotationSettings.FreeText.Constraints = AnnotationConstraints.Selectable;
+
+{% endhighlight %}
+{% endtabs %}
+
 ## How to get and set the name of the free text annotations?
 
 The PDF Viewer allows the users to get and set the name of free text annotations through the [Name](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfPdfViewer.Android.IAnnotation.html#Syncfusion_SfPdfViewer_Android_IAnnotation_Name) API.

xamarin-android/SfPdfViewer/FreeText-Annotation.md

@@ -401,6 +401,36 @@ private void PageDownButton_Click(object sender, System.EventArgs e)
 
 N>When the current page is the first page, GoToPreviousPage method will not have any effect. Similarly, when in last page, GoToNextPage method will not have any effect.
 
+## How to lock or unlock all the annotations?
+
+To lock or unlock all the annotations in a PDF, set the `SfPdfViewer.AnnotationSettings.IsLocked` API to `true` or `false` respectively. The default value of the API is false, and when it is set to true, annotations can be selected, but resizing, moving, editing, and removing actions will be disabled. Only the tapped and selected events from the annotations will be raised. The following code sample explains the same.
+
+{% tabs %}
+{% highlight c# %}
+
+//Lock all the annotations
+pdfViewerControl.AnnotationSettings.IsLocked = true;
+
+{% endhighlight %}
+{% endtabs %}
+
+N>The lock operation can also be enabled or disabled for a particular annotation type such as shape, free text, text markup, etc. Please find the code samples to enable or disable interaction for particular annotation from their respective sections.
+
+## How to enable or disable the annotation selection?
+
+To enable or disable the annotation selection, set the `SfPdfViewer.AnnotationSettings.Constraints` API to `AnnotationConstraints.Selectable` or `~AnnotationConstraints.Selectable` respectively. Annotations will be selected by default, and when this API is set to `~AnnotationConstraints.Selectable`, annotation selection, moving, resizing, removing and attribute changes will be disabled. Only the tapped events of the annotations will be raised. The following code sample explains the same.
+
+{% tabs %}
+{% highlight c# %}
+
+//Disable the selection of all annotation types.
+pdfViewerControl.AnnotationSettings.Constraints = ~AnnotationConstraints.Selectable;
+
+{% endhighlight %}
+{% endtabs %}
+
+N>The selection operation can also be enabled or disabled for a particular annotation type such as shape, free text, text markup, etc. Please find the code samples to enable or disable interaction for particular annotation from their respective sections.
+
 ## How to get the list of annotations present in the PDF?
 
 By using `Annotations` property, You can get the list of annotations present in the PDF document.

xamarin-android/SfPdfViewer/Getting-Started.md

@@ -192,6 +192,56 @@ private void PdfViewer_InkSelected(object sender, Syncfusion.SfPdfViewer.Android
 {% endhighlight %}
 {% endtabs %}
 
+## How to lock or unlock the handwritten signature?
+ 
+To lock or unlock all the handwritten signature, set the `IsLocked` API to `true` or `false` respectively, and the following sample explains the same. But other annotation types can be moved, resized, removed or their attributes can be changed. 
+
+{% tabs %}
+{% highlight c# %}
+
+//Disable the handwritten signature interaction such as move, resize, remove, and attributes changes.
+pdfViewerControl.AnnotationSettings.HandwrittenSignature.IsLocked = true;
+
+{% endhighlight %}
+{% endtabs %}
+ 
+Interactions with handwritten signature types such as move, resize, remove or attribute changes will be allowed only if the `SfPdfViewer.AnnotationSettings.IsLocked` API is set to `false`. The following code prevents the unlocking of the handwritten signatures, although the `IsLocked` property of the handwritten signature is set to `false`.
+ 
+{% tabs %}
+{% highlight c# %}
+
+//Disable the handwritten signature interaction, though its 'IsLocked' property is set to ‘false’ .
+pdfViewerControl.AnnotationSettings.IsLocked = true;
+pdfViewerControl.AnnotationSettings.HandwrittenSignature.IsLocked = false;
+
+{% endhighlight %}
+{% endtabs %}
+
+## How to enable or disable the handwritten signature selection?
+
+To enable or disable the handwritten signature selection, set the `Constraints` API to `AnnotationConstraints.Selectable` or `~AnnotationConstraints.Selectable` respectively, and the following sample explains the same. But other annotation types can be selected, moved, resized, removed or their attributes can be changed. 
+
+{% tabs %}
+{% highlight c# %}
+
+//Disable the selection of handwritten signatures.
+pdfViewerControl.AnnotationSettings.HandwrittenSignature.Constraints = ~AnnotationConstraints.Selectable;
+
+{% endhighlight %}
+{% endtabs %}
+
+Handwritten signature selection will be allowed only if the `SfPdfViewer.AnnotationSettings.Constraints` API is set to `AnnotationConstraints.Selectable`. The following code prevents the handwritten signatures selection, even though the `Constraints` property of the handwritten signature annotation is set to `AnnotationConstraints.Selectable`.
+
+{% tabs %}
+{% highlight c# %}
+
+//Disable the handwritten signature selection, though its 'Constraints' property is set to ‘AnnotationConstraints.Selectable’ 
+pdfViewerControl.AnnotationSettings.Constraints= ~AnnotationConstraints.Selectable;
+pdfViewerControl.AnnotationSettings.HandwrittenSignature.Constraints = AnnotationConstraints.Selectable;
+
+{% endhighlight %}
+{% endtabs %}
+
 ## How to get and set the name of the handwritten signatures?
 
 The PDF Viewer allows the users to get and set the name of handwritten signatures through the [Name](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfPdfViewer.Android.IAnnotation.html#Syncfusion_SfPdfViewer_Android_IAnnotation_Name) API.

xamarin-android/SfPdfViewer/Handwritten-Signature.md

@@ -524,6 +524,56 @@ private void PdfViewer_AnnotationMovedOrResized(object sender, AnnotationMovedOr
 {% endhighlight %}
 {% endtabs %}
 
+## How to lock or unlock the ink annotations?
+ 
+To lock or unlock all the ink annotation, set the `IsLocked` API to `true` or `false` respectively, and the following sample explains the same. But other annotation types can be moved, resized, removed or their attributes can be changed. 
+
+{% tabs %}
+{% highlight c# %}
+
+//Disable the ink annotation interaction such as move, resize, remove, and attributes changes.
+pdfViewerControl.AnnotationSettings.Ink.IsLocked = true;
+
+{% endhighlight %}
+{% endtabs %}
+ 
+Interactions with ink annotation types such as move, resize, remove or attribute changes will be allowed only if the `SfPdfViewer.AnnotationSettings.IsLocked` API is set to `false`. The following code prevents the unlocking of the ink annotations, although the `IsLocked` property of the ink annotation is set to `false`.
+ 
+{% tabs %}
+{% highlight c# %}
+
+//Disable the ink annotation interaction, though its 'IsLocked' property is set to ‘false’ .
+pdfViewerControl.AnnotationSettings.IsLocked = true;
+pdfViewerControl.AnnotationSettings.Ink.IsLocked = false;
+
+{% endhighlight %}
+{% endtabs %}
+
+## How to enable or disable the ink annotation selection?
+
+To enable or disable the ink annotation selection, set the `Constraints` API to `AnnotationConstraints.Selectable` or `~AnnotationConstraints.Selectable` respectively, and the following sample explains the same. But other annotation types can be selected, moved, resized, removed or their attributes can be changed. 
+
+{% tabs %}
+{% highlight c# %}
+
+//Disable the selection of ink annotations.
+pdfViewerControl.AnnotationSettings.Ink.Constraints = ~AnnotationConstraints.Selectable;
+
+{% endhighlight %}
+{% endtabs %}
+
+Ink annotation selection will be allowed only if the `SfPdfViewer.AnnotationSettings.Constraints` API is set to `AnnotationConstraints.Selectable`. The following code prevents the ink annotations selection, even though the `Constraints` property of the ink annotation is set to `AnnotationConstraints.Selectable`.
+
+{% tabs %}
+{% highlight c# %}
+
+//Disable the ink annotation selection, though its 'Constraints' property is set to ‘AnnotationConstraints.Selectable’ 
+pdfViewerControl.AnnotationSettings.Constraints= ~AnnotationConstraints.Selectable;
+pdfViewerControl.AnnotationSettings.Ink.Constraints = AnnotationConstraints.Selectable;
+
+{% endhighlight %}
+{% endtabs %}
+
 ## How to render Ink strokes using custom ink points?
 
 By default, ink strokes are drawn by recording the points on the screen traversed by the input device (stylus or finger). The quality of the strokes thus drawn may not be satisfactory as it considers only raw points. If needed, the points can be modified using any algorithms to smoothen the strokes.