Skip to content

959295 - Review changes the last three Xamarin-Android Tools Controls by AI #671

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: development
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 13 additions & 14 deletions xamarin-android/SfMaskedEdit/Basic-Features.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,19 @@
---
layout: post
title: Basic features in syncfusion® MaskedEdit for Xamarin.Android platform
description: Learn how to customize the value and setting prompt character and hint text for syncfusion® masked edit control.
platform: Xamarin.Android
title: Basic Features in Syncfusion® MaskedEdit for Xamarin.Android Platform
description: Learn how to customize the value and configure prompt characters and hint text for the Syncfusion® MaskedEdit control.
platform: xamarin.android
control: SfMaskedEdit
documentation: ug
keywords: mask, SfMaskedEdit, maskededit

keywords: mask, SfMaskedEdit, maskededit, prompt character, hint text, value setting
---

# Basic features in masked edit
# Basic Features in MaskedEdit


## Setting Value

The SfMaskedEdit control displays the value that can be set using the `Value` property:
The `SfMaskedEdit` control displays a value that can be configured using the `Value` property:

{% tabs %}
{% highlight c# %}
Expand All @@ -29,7 +28,7 @@ maskedEdit.Value =@"14/11/2014";

## Setting Prompt Character

Displays prompt character for the absence of your input in Mask and its default value is '_'. You can set the custom prompt character using `PromptChar` property.
The prompt character is displayed when no input is provided for a mask position. The default value is '_'. You can customize the prompt character using the `PromptChar` property:

{% tabs %}
{% highlight c# %}
Expand All @@ -41,15 +40,15 @@ maskedEdit.PromptChar = '*';

![Prompt Character](SfMaskedEditImages/BF_Prompt.png)

## Setting Hint
## Setting Hint Text

The hint will prompt you with instructions or important information when it is not on focus and any valid characters are not entered. The `Hint` property of `SfMaskedEdit` is used to set the hint text for the control.
The hint text provides instructions or important information when the control is not focused and no valid characters have been entered. Use the `Hint` property of `SfMaskedEdit` to configure the hint text for the control.

The following properties are used to customize its appearance:
The following properties are available to customize the hint text appearance:

* `SetHintTextColor`: Sets text color for the hint.
* `HintTypeface`: Sets font family and sets font attributes(bold/italic/none) for the hint.
* `HintTextSize`: Sets font size for the hint.
* `SetHintTextColor`: Sets the text color for the hint
* `HintTypeface`: Sets the font family and font attributes (bold/italic/normal) for the hint
* `HintTextSize`: Sets the font size for the hint

{% tabs %}
{% highlight c# %}
Expand Down
43 changes: 21 additions & 22 deletions xamarin-android/SfMaskedEdit/Events.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,29 @@
---
layout: post
title: Eevnts in SfMaskedEdit for Xamarin.Android platform
description: Learn how to get the value changed and Mask input reject events in SfMaskedEdit
platform: Xamarin.Android
title: Events in Syncfusion® SfMaskedEdit for Xamarin.Android
description: Learn how to handle value changed and mask input rejected events in Syncfusion® SfMaskedEdit control for Xamarin.Android.
platform: xamarin.android
control: SfMaskedEdit
documentation: ug
keywords: mask, SfMaskedEdit, maskededit

keywords: mask, SfMaskedEdit, maskededit, events, ValueChanged, MaskInputRejected
---


# Events

The SfMaskedEdit exposes the following events:
The `SfMaskedEdit` control exposes the following events:

* `ValueChanged`: Occurs when the value of `Value` property is changed.
* `ValueChanged`: Occurs when the value of the `Value` property changes.
* `MaskInputRejected`: Occurs when a character is rejected by the input mask.

## ValueChanged event
## ValueChanged Event

Occurs when the value of the `Value` property is changed by either entering the valid input character or setting the value to the `Value` property through C# code. The event arguments are of type ValueChangedEventArgs and expose the following property:
The `ValueChanged` event occurs when the value of the `Value` property changes, either by entering a valid input character or by setting the value programmatically through C# code. The event arguments are of type `ValueChangedEventArgs` and expose the following property:

* `Value`: The read only property contains the updated value of the `Value` property of SfMaskedEdit.
* `Value`: A read-only property that contains the updated value of the `Value` property of `SfMaskedEdit`.

> Your valid input character is updated to `Value` property based on the `ValidationMode` property.
> Refer to this [link](Validation#validation-mode) to know more about the `ValidationMode` property of SfMaskedEdit control.
> **Note:** Valid input characters are updated to the `Value` property based on the `ValidationMode` property setting.
> Refer to this [link](Validation#validation-mode) to learn more about the `ValidationMode` property of the `SfMaskedEdit` control.

{% tabs %}
{% highlight c# %}
Expand Down Expand Up @@ -61,20 +60,20 @@ private void MaskedEdit_OnValueChanged(object sender, ValueChangedEventArgs e)
{% endhighlight %}
{% endtabs %}

![](SfMaskedEditImages/ValueChangedevent.png)
![ValueChanged event](SfMaskedEditImages/ValueChangedevent.png)

## MaskInputRejected event
## MaskInputRejected Event

Occurs when your input or assigned character does not match the corresponding format element of the input mask. The event arguments are type of MaskInputRejectedEventArgs and expose the following properties:
The `MaskInputRejected` event occurs when an input or assigned character does not match the corresponding format element of the input mask. The event arguments are of type `MaskInputRejectedEventArgs` and expose the following properties:

* `Position`: The position in the mask corresponding to the invalid input character.
* `RejectionHint`: The enumerated value that describes why the input character was rejected.
* `RejectionHint`: An enumerated value that describes why the input character was rejected.

MaskInputRejected is raised in the following situations:
The `MaskInputRejected` event is raised in the following situations:

* An input character does not match the corresponding format element. For example, if you enter an alphabetic character when a digit is required. This is probably the most common reason why this event is raised.
* When you try to input extraneous characters beyond the end of the mask.
* A paste operation inserts a character that does not match with its associated format element.
* An input character does not match the corresponding format element (for example, entering an alphabetic character when a digit is required). This is the most common reason for this event.
* When attempting to input extraneous characters beyond the end of the mask.
* A paste operation inserts a character that does not match its associated format element.

{% tabs %}
{% highlight c# %}
Expand Down Expand Up @@ -103,6 +102,6 @@ private void MaskedEdit_OnMaskInputRejected(object sender, MaskInputRejectedEven
{% endhighlight %}
{% endtabs %}

![](SfMaskedEditImages/MaskInputRejectedevent.png)
![MaskInputRejected event](SfMaskedEditImages/MaskInputRejectedevent.png)

This demo can be downloaded from this [link](http://files2.syncfusion.com/Xamarin.Android/Samples/MaskedEdit_Events.zip).
You can download the complete events sample from this [link](http://files2.syncfusion.com/Xamarin.Android/Samples/MaskedEdit_Events.zip).
33 changes: 17 additions & 16 deletions xamarin-android/SfMaskedEdit/Formatting-Value.md
Original file line number Diff line number Diff line change
@@ -1,39 +1,40 @@
---
layout: post
title: Formatting value of Value property of SfMaskedEdit control for Xamarin.Android platform
description: Learn how to format the characters in the Value property of SfMaskedEdit control
platform: Xamarin.Android
title: Formatting Syncfusion® SfMaskedEdit Value Property for Xamarin.Android
description: Learn how to format the characters in the Value property of the Syncfusion® SfMaskedEdit control for Xamarin.Android.
platform: xamarin.android
control: SfMaskedEdit
documentation: ug
keywords: mask, SfMaskedEdit, maskededit
keywords: mask, SfMaskedEdit, maskededit, value formatting, mask format

---


# Formatting Value

SfMaskedEdit allows you to format the characters in the `Value` property in a mask scenario (when the Mask property is set). By default, the Value property holds your input characters, prompt characters and the literals defined in the mask. You can modify this and allow the Value property to hold the characters without prompt and literals by setting the ValueMaskFormat property of the control. The Value in the SfMaskedEdit is formatted by any one of the following formatting enum values:
The `SfMaskedEdit` control allows you to format the characters in the `Value` property in mask scenarios (when the `Mask` property is set). By default, the `Value` property holds your input characters, prompt characters, and the literals defined in the mask. You can modify this behavior and control whether the `Value` property holds characters with or without prompt characters and literals by setting the `ValueMaskFormat` property of the control.

* ExcludePromptAndLiterals
* IncludePrompt
* IncludeLiterals
* IncludePromptAndLiterals
The `Value` in the `SfMaskedEdit` control can be formatted using any of the following `MaskFormat` enumeration values:
* `ExcludePromptAndLiterals`
* `IncludePrompt`
* `IncludeLiterals`
* `IncludePromptAndLiterals`

## ExcludePromptAndLiterals

Value contains only the typed characters, the prompt characters and literals are excluded.
The `Value` contains only the typed characters. Prompt characters and literals are excluded.

## IncludePrompt

Value contains the typed characters and prompt characters, literals are excluded.
The `Value` contains the typed characters and prompt characters. Literals are excluded.

## IncludeLiterals

Value contains the typed characters and literals, prompt characters are excluded.
The `Value` contains the typed characters and literals. Prompt characters are excluded.

## IncludePromptAndLiterals

Value contains typed characters, prompt characters, and literals.
The `Value` contains typed characters, prompt characters, and literals.

{% tabs %}
{% highlight c# %}
Expand Down Expand Up @@ -104,8 +105,8 @@ private void MaskedEdit4_ValueChanged(object sender, Syncfusion.XForms.MaskedEdi
{% endhighlight %}
{% endtabs %}

Refer this [link](Events#valuechanged-event) to know more about the ValueChanged event of SfMaskedEdit control.
Refer to this [link](Events#valuechanged-event) to learn more about the `ValueChanged` event of the `SfMaskedEdit` control.

![](SfMaskedEditImages/FormattingValue.png)
![Formatting Value](SfMaskedEditImages/FormattingValue.png)

This demo can be downloaded from this [link](http://files2.syncfusion.com/Xamarin.Android/Samples/MaskedEdit_FormattingValue.zip).
You can download the complete value formatting sample from this [link](http://files2.syncfusion.com/Xamarin.Android/Samples/MaskedEdit_FormattingValue.zip).
31 changes: 16 additions & 15 deletions xamarin-android/SfMaskedEdit/Formatting-clipboard-text.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,27 @@
---
layout: post
title: Formatting clipboard text of SfMaskedEit in Xamarin.Android plarform
description: Learn how to format the clipboard text during cut and copy operation of SfMaskedEdit control
platform: Xamarin.Android
title: Syncfusion® SfMaskedEdit Clipboard Text Formatting in Xamarin.Android
description: Learn how to format the clipboard text during cut and copy operations of the Syncfusion® SfMaskedEdit control.
platform: xamarin.android
control: SfMaskedEdit
documentation: ug
keywords: mask, SfMaskedEdit, maskededit
keywords: mask, SfMaskedEdit, maskededit, clipboard, cut, copy, formatting

---

# Formatting Clipboard Text

# Formatting clipboard text
The `SfMaskedEdit` control allows you to format clipboard text in mask scenarios (when the `Mask` property is set). When you perform cut or copy operations, the clipboard text is formatted with your input characters and the literals defined in the mask. You can modify this behavior and control whether the clipboard holds characters with or without prompt characters and literals by setting the `CutCopyMaskFormat` property of the control.

SfMaskedEdit allows you to format the clipboard text in a mask scenario (when the Mask property is set). When you perform the cut or copy operation, the clipboard text will be formatted with your input characters and the literals defined in the mask. You can modify this and allow the clipboard to hold the characters with or without prompt and literals by setting the CutCopyMaskFormat property of the control. The clipboard text is formatted by any one of the following formatting enum values:

* ExcludePromptAndLiterals
* IncludePrompt
* IncludeLiterals
* IncludePromptAndLiterals
The clipboard text can be formatted using any of the following `MaskFormat` enumeration values:
* `ExcludePromptAndLiterals`
* `IncludePrompt`
* `IncludeLiterals`
* `IncludePromptAndLiterals`

## ExcludePromptAndLiterals

Clipboard text will contain only the typed characters, the prompt characters and literals are excluded.
The clipboard text will contain only the typed characters. Prompt characters and literals are excluded.

{% tabs %}
{% highlight c# %}
Expand All @@ -34,7 +34,7 @@ maskedEdit.CutCopyMaskFormat = MaskFormat.ExcludePromptAndLiterals;

## IncludePrompt

Clipboard text contains the typed characters and prompt characters, literals are excluded.
The clipboard text contains the typed characters and prompt characters. Literals are excluded.

{% tabs %}
{% highlight c# %}
Expand All @@ -47,7 +47,7 @@ maskedEdit.CutCopyMaskFormat = MaskFormat.IncludePrompt;

## IncludeLiterals

Clipboard text contains the typed characters and literals, prompt characters are excluded.
The clipboard text contains the typed characters and literals. Prompt characters are excluded.

{% tabs %}
{% highlight c# %}
Expand All @@ -60,7 +60,7 @@ maskedEdit.CutCopyMaskFormat = MaskFormat.IncludeLiterals;

## IncludePromptAndLiterals

Clipboard text contains typed characters, prompt characters, and literals.
The clipboard text contains typed characters, prompt characters, and literals.

{% tabs %}
{% highlight c# %}
Expand All @@ -70,3 +70,4 @@ maskedEdit.Mask = "00/00/0000";
maskedEdit.CutCopyMaskFormat = MaskFormat.IncludePromptAndLiterals;
{% endhighlight %}
{% endtabs %}

32 changes: 16 additions & 16 deletions xamarin-android/SfMaskedEdit/Getting-Started.md
Original file line number Diff line number Diff line change
@@ -1,37 +1,37 @@
---
layout: post
title: Getting Started with Syncfusion® MaskedEdit control for Xamarin.Android
description: A quick tour to initial users on Syncfusion® SfMaskedEdit control and customization features available in Xamarin.Android platform
title: Getting Started with Syncfusion® MaskedEdit for Xamarin.Android
description: A quick tour for initial users on the Syncfusion® SfMaskedEdit control and customization features available in the Xamarin.Android platform.
platform: xamarin.android
control: SfMaskedEdit
documentation: ug
---


# Getting Started
This section explains you the steps required to configure a SfMaskedEdit control in a real-time scenario and provides a walk-through on some of the customization features available in `SfMaskedEdit` control.
This section explains the steps required to configure an `SfMaskedEdit` control in a real-time scenario and provides a walk-through of some customization features available in the `SfMaskedEdit` control.

## Reference Essential Studio<sup>®</sup> components in your solution
## Reference Essential Studio<sup>®</sup> Components in Your Solution

Syncfusion<sup>®</sup> Xamarin components are available in [nuget.org](https://www.nuget.org/). To add masked edit to your project, open the NuGet package manager in Visual Studio, and search for "[syncfusion.xamarin.sfmaskededit.android](https://www.nuget.org/packages/Syncfusion.Xamarin.SfMaskedEdit.Android)", and then install it.
Syncfusion<sup>®</sup> Xamarin components are available in [nuget.org](https://www.nuget.org/). To add the SfMaskedEdit to your project, open the NuGet package manager in Visual Studio, search for "[syncfusion.xamarin.SfMaskedEdit.android](https://www.nuget.org/packages/Syncfusion.Xamarin.SfMaskedEdit.Android)", and then install it.

![Xamarin.Android masked edit nuget](SfMaskedEditImages/nuget.png)
![Xamarin.Android MaskedEdit NuGet](SfMaskedEditImages/nuget.png)

## Create a Simple SfMaskedEdit

The SfMaskedEdit control is configured entirely in C# code. The following steps explain how to create a SfMaskedEdit and configure its elements:
The `SfMaskedEdit` control is configured entirely in C# code. The following steps explain how to create an `SfMaskedEdit` control and configure its elements:

### Add namespace for referred assemblies
### Add Namespace for Referenced Assemblies

{% tabs %}
{% highlight c# %}
using Syncfusion.Android.MaskedEdit;
{% endhighlight %}
{% endtabs %}

N> Starting with v16.2.0.x, if you reference Syncfusion<sup>®</sup> assemblies from trial setup or from the NuGet feed, you also have to include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/license-key) to know about registering Syncfusion<sup>®</sup> license key in your Xamarin application to use our components.
N> Starting with v16.2.0.x, if you reference Syncfusion<sup>®</sup> assemblies from the trial setup or from the NuGet feed, you also have to include a license key in your projects. Please refer to this [link](https://help.syncfusion.com/common/essential-studio/licensing/license-key) to learn about registering the Syncfusion<sup>®</sup> license key in your Xamarin application to use our components.

### Create a sample with simple SfMaskedEdit
### Create a Sample with Simple SfMaskedEdit

{% tabs %}
{% highlight c# %}
Expand Down Expand Up @@ -62,9 +62,9 @@ namespace MaskEdit
{% endhighlight %}
{% endtabs %}

## Masking the input
## Masking the Input

To mask the input, set the Mask properties as follows:
To mask the input, set the `Mask` property as follows:

{% tabs %}
{% highlight c# %}
Expand All @@ -73,12 +73,12 @@ maskedEdit.Mask = "00/00/0000";
{% endhighlight %}
{% endtabs %}

This mask expression allows only numeric inputs in the places of 0.
This mask expression allows only numeric inputs in the places of `0`.

Refer to this [link](MaskType) to know more about the Mask characters and Mask Types available in SfMaskedEdit control.
Refer to this [link](MaskType) to learn more about the mask characters and mask types available in the `SfMaskedEdit` control.

Run the project and check if you get the following output to make sure that you have configured your project properly to add `SfMaskedEdit`.
Run the project and check if you get the following output to make sure that you have configured your project properly to add the `SfMaskedEdit` control.

![Xamarin.Android masked edit](SfMaskedEditImages/GettingStarted.png)
![Xamarin.Android MaskedEdit](SfMaskedEditImages/GettingStarted.png)

You can find the complete getting started sample from this [link](http://files2.syncfusion.com/Xamarin.Android/Samples/MaskedEdit_GettingStarted.zip).
Loading