diff --git a/xamarin-android/SfMaskedEdit/Basic-Features.md b/xamarin-android/SfMaskedEdit/Basic-Features.md index 005eae09..0c6adc8e 100644 --- a/xamarin-android/SfMaskedEdit/Basic-Features.md +++ b/xamarin-android/SfMaskedEdit/Basic-Features.md @@ -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# %} @@ -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# %} @@ -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# %} diff --git a/xamarin-android/SfMaskedEdit/Events.md b/xamarin-android/SfMaskedEdit/Events.md index 1490a737..8766a062 100644 --- a/xamarin-android/SfMaskedEdit/Events.md +++ b/xamarin-android/SfMaskedEdit/Events.md @@ -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# %} @@ -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# %} @@ -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). diff --git a/xamarin-android/SfMaskedEdit/Formatting-Value.md b/xamarin-android/SfMaskedEdit/Formatting-Value.md index 51dead75..6a244c91 100644 --- a/xamarin-android/SfMaskedEdit/Formatting-Value.md +++ b/xamarin-android/SfMaskedEdit/Formatting-Value.md @@ -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# %} @@ -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). diff --git a/xamarin-android/SfMaskedEdit/Formatting-clipboard-text.md b/xamarin-android/SfMaskedEdit/Formatting-clipboard-text.md index 0b50e5a1..9843ac86 100644 --- a/xamarin-android/SfMaskedEdit/Formatting-clipboard-text.md +++ b/xamarin-android/SfMaskedEdit/Formatting-clipboard-text.md @@ -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# %} @@ -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# %} @@ -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# %} @@ -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# %} @@ -70,3 +70,4 @@ maskedEdit.Mask = "00/00/0000"; maskedEdit.CutCopyMaskFormat = MaskFormat.IncludePromptAndLiterals; {% endhighlight %} {% endtabs %} + diff --git a/xamarin-android/SfMaskedEdit/Getting-Started.md b/xamarin-android/SfMaskedEdit/Getting-Started.md index c2e376de..dd4bf526 100644 --- a/xamarin-android/SfMaskedEdit/Getting-Started.md +++ b/xamarin-android/SfMaskedEdit/Getting-Started.md @@ -1,7 +1,7 @@ --- 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 @@ -9,19 +9,19 @@ 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® components in your solution +## Reference Essential Studio® Components in Your Solution -Syncfusion® 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® 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# %} @@ -29,9 +29,9 @@ using Syncfusion.Android.MaskedEdit; {% endhighlight %} {% endtabs %} -N> Starting with v16.2.0.x, if you reference Syncfusion® 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® license key in your Xamarin application to use our components. +N> Starting with v16.2.0.x, if you reference Syncfusion® 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® 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# %} @@ -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# %} @@ -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). diff --git a/xamarin-android/SfMaskedEdit/Hiding-Prompt-Characters.md b/xamarin-android/SfMaskedEdit/Hiding-Prompt-Characters.md index 44cc22d3..2a2f4dc9 100644 --- a/xamarin-android/SfMaskedEdit/Hiding-Prompt-Characters.md +++ b/xamarin-android/SfMaskedEdit/Hiding-Prompt-Characters.md @@ -1,18 +1,17 @@ --- layout: post -title: Hiding propmpt characters of SfMaskedEdit control for Xamarin.Android paltform -description: Learn how to hide the prompt characters of SfMasedEdit while control loses focus -platform: Xamarin.Android +title: Syncfusion® SfMaskedEdit Hiding Prompt Characters +description: Learn how to hide the prompt characters of the Syncfusion® SfMaskedEdit control when the control loses focus. +platform: xamarin.android control: SfMaskedEdit documentation: ug -keywords: mask, SfMaskedEdit, maskededit - +keywords: mask, SfMaskedEdit, maskededit, prompt characters, hide prompt, focus --- # Hiding Prompt Characters -When the `HidePromptOnLeave` property is set to true, prompt characters are ignored when control loses focus. Again, the prompt characters are restored when the control is focused. +When the `HidePromptOnLeave` property is set to `true`, prompt characters are hidden when the control loses focus. The prompt characters are restored when the control regains focus. {% tabs %} {% highlight c# %} @@ -23,6 +22,6 @@ maskedEdit.HidePromptOnLeave = true; {% endhighlight %} {% endtabs %} -![](SfMaskedEditImages/HPL.png) +![Hiding Prompt Characters](SfMaskedEditImages/HPL.png) -This demo can be downloaded from this [link](http://files2.syncfusion.com/Xamarin.Android/Samples/MaskedEdit_HidingPrompt.zip). +You can download the complete hiding prompt characters sample from this [link](http://files2.syncfusion.com/Xamarin.Android/Samples/MaskedEdit_HidingPrompt.zip). diff --git a/xamarin-android/SfMaskedEdit/Localization.md b/xamarin-android/SfMaskedEdit/Localization.md index c34bcedb..75f4b529 100644 --- a/xamarin-android/SfMaskedEdit/Localization.md +++ b/xamarin-android/SfMaskedEdit/Localization.md @@ -1,11 +1,11 @@ --- layout: post -title: Localization with Syncfusion® SfMaskedEdit control for Xamarin.Android platform -description: Learn how to localize the special symbols such as currency symbol, date separator, decimal separator etc., in SfMaskedEdit control for Xamarin.Forms platform -platform: Xamarin.Android +title: Localization with Syncfusion® SfMaskedEdit for Xamarin.Android +description: Learn how to localize special symbols like currency, date separator, and decimal separator in SfMaskedEdit control for Xamarin.Android. +platform: xamarin.android control: SfMaskedEdit documentation: ug -keywords: mask, SfMaskedEdit, maskededit +keywords: mask, SfMaskedEdit, maskededit, localization, culture, symbols --- @@ -13,7 +13,7 @@ keywords: mask, SfMaskedEdit, maskededit # Localization -The special symbols such as currency symbol, date separator, decimal separator etc., can be localized to any specific culture using the **Culture** property. +Special symbols such as currency symbol, date separator, and decimal separator can be localized to any specific culture using the `Culture` property. @@ -76,6 +76,6 @@ maskedEdit.Culture = new CultureInfo("fr-FR"); Now the '$' will be localized to '€';'.' will be localized to ',' and ',' will be localized to ' '(single white space). -![](SfMaskedEditImages/Localization.png) +![Localization Example](SfMaskedEditImages/Localization.png) -You can find the runnable localization sample from this [link](http://files2.syncfusion.com/Xamarin.Android/Samples/MaskedEdit_Localization.zip). +You can find the complete localization sample from this [link](http://files2.syncfusion.com/Xamarin.Android/Samples/MaskedEdit_Localization.zip). diff --git a/xamarin-android/SfMaskedEdit/MaskType.md b/xamarin-android/SfMaskedEdit/MaskType.md index 97232503..622c4b49 100644 --- a/xamarin-android/SfMaskedEdit/MaskType.md +++ b/xamarin-android/SfMaskedEdit/MaskType.md @@ -1,26 +1,25 @@ --- layout: post -title: Mask Types of SfMaskedEdit control for Xamarin.Android platform -description: Learn the different types of mask characters available in SfMaskedEdit control to restrict the user input -platform: Xamarin.Android +title: Mask Types of Syncfusion® SfMaskedEdit for Xamarin.Android +description: Learn about the different types of mask characters available in the SfMaskedEdit control to restrict user input. +platform: xamarin.android control: SfMaskedEdit documentation: ug -keywords: mask, SfMaskedEdit, maskededit - +keywords: mask, SfMaskedEdit, maskededit, mask types, text mask, regex mask --- # MaskType -Each MaskType has different set of mask characters that are combined to form a mask expression. Based on the complexity and usage, mask types are classified as: +Each `MaskType` has a different set of mask characters that are combined to form a mask expression. Based on complexity and usage, mask types are classified as: * Text * RegEx ## Text -The expressions that are generated with letters, digits, and special characters come under this group. This is mainly used for fixed length inputs. For example: phone number, zip code, and so on. +Expressions that are generated with letters, digits, and special characters come under this group. This is mainly used for fixed-length inputs such as phone numbers, zip codes, and similar data. -### Text Mask characters +### Text Mask Characters
@@ -121,18 +120,18 @@ maskedEdit.Mask = "+1(000)000000"; {% 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`. -## Regex +## RegEx -The expressions that are generated with regular expressions come under this group, preferable for variable length inputs and input in range. For example: hexadecimal values [0-9A-C]. -The regular expressions provide significant advantages when creating masks as compared with other mask modes. +Expressions that are generated with regular expressions come under this group, preferable for variable-length inputs and input ranges. For example: hexadecimal values [0-9A-F]. +Regular expressions provide significant advantages when creating masks compared to other mask modes. -**Advantages** +### Advantages -* Allows you to enter the value of indeterminate length. -* Restricts with specific pattern. Example email, password, and more. -* Restricts you to enter specific range at specific position. +* Allows you to enter values of indeterminate length +* Restricts input with specific patterns (e.g., email, password, and more) +* Restricts you to enter specific ranges at specific positions ### Regex Mask Characters @@ -229,8 +228,8 @@ maskedEdit.Mask = @"+1(\d{3})\d{6}"; {% endhighlight %} {% endtabs %} -This mask expression '\d{3}' and '\d{6}' allows only numeric, where {n} is the count that the input should be accepted. +This mask expression `\d{3}` and `\d{6}` allows only numeric input, where `{n}` is the count that specifies how many times the input should be accepted. -![](SfMaskedEditImages/MaskType.png) +![MaskType Example](SfMaskedEditImages/MaskType.png) You can find the complete mask type sample from this [link](http://files2.syncfusion.com/Xamarin.Android/Samples/MaskedEdit_MaskType.zip). diff --git a/xamarin-android/SfMaskedEdit/Overview.md b/xamarin-android/SfMaskedEdit/Overview.md index 6298a8d6..4b5290bf 100644 --- a/xamarin-android/SfMaskedEdit/Overview.md +++ b/xamarin-android/SfMaskedEdit/Overview.md @@ -1,14 +1,17 @@ --- -platform: Xamarin.Android +layout: post +title: Overview of Syncfusion® SfMaskedEdit Control for Xamarin.Android +description: Overview of the SfMaskedEdit control features and capabilities for input masking in Xamarin.Android applications. +platform: xamarin.android control: SfMaskedEdit documentation: ug -keywords: mask, SfMaskedEdit, maskededit +keywords: mask, SfMaskedEdit, maskededit, overview, masked input, input validation --- # Overview -The Masked text box is an advanced version of the EditText control that restricts your input to certain types of characters, text, and numbers using a mask pattern. This control is used to create a template for providing information such as telephone numbers, IP addresses, product IDs, and so on. +The `SfMaskedEdit` control is an advanced version of the `EditText` control that restricts user input to certain types of characters, text, and numbers using a mask pattern. This control is used to create templates for providing structured information such as telephone numbers, IP addresses, product IDs, and similar data formats. -![](SfMaskedEditImages/OverView_img1.jpeg) +![SfMaskedEdit Overview](SfMaskedEditImages/OverView_img1.jpeg) ## Key features * The input can be masked with a fixed or variable length by setting the `MaskType` to `Text` or `RegEx`, respectively. @@ -20,3 +23,4 @@ The Masked text box is an advanced version of the EditText control that restrict * Watermark text can be used to display an instruction or important information. * The UI of the masked text box is completely customizable. + diff --git a/xamarin-android/SfMaskedEdit/Using-Mask-Characters-as-Literals.md b/xamarin-android/SfMaskedEdit/Using-Mask-Characters-as-Literals.md index 000a4a88..774a258c 100644 --- a/xamarin-android/SfMaskedEdit/Using-Mask-Characters-as-Literals.md +++ b/xamarin-android/SfMaskedEdit/Using-Mask-Characters-as-Literals.md @@ -1,18 +1,17 @@ --- layout: post -title: Using Mask Characters as Literals in SfMaskedEdit control for Xamarin.Android platform -description: Learn how to use mask characters as literals in SfMaskedEdit control for Xamarin.Forms platform -platform: Xamarin.Android +title: Using Mask Characters as Literals in Syncfusion® SfMaskedEdit +description: Learn how to use mask characters as literals in the SfMaskedEdit control for the Xamarin.Android platform. +platform: xamarin.android control: SfMaskedEdit documentation: ug -keywords: mask, SfMaskedEdit, maskededit - +keywords: mask, SfMaskedEdit, maskededit, literals, escape characters, backslash --- # Using Mask Characters as Literals -To use mask character as a literal, precede the mask character with a backslash (\\). For example, to display the dollar sign ($), then set the mask as follows: +To use a mask character as a literal, precede the mask character with a backslash (`\`). This escape sequence allows you to display special mask characters as static text rather than as input placeholders. {% tabs %} {% highlight c# %} @@ -22,8 +21,8 @@ maskedEdit.Mask = @"\$ 0000"; {% endhighlight %} {% endtabs %} -This will produce a mask that displays a dollar sign ($) followed by the prompt characters for entering numbers. +This mask will produce a display that shows a dollar sign (`$`) followed by prompt characters for entering four numeric digits. -![](SfMaskedEditImages/MaskAsLiterals.png) +![Using Mask Characters as Literals](SfMaskedEditImages/MaskAsLiterals.png) -This demo can be downloaded from this [link](http://files2.syncfusion.com/Xamarin.Android/Samples/MaskedEdit_UsingMaskCharactersAsLiterals.zip). +You can download the complete mask characters as literals sample from this [link](http://files2.syncfusion.com/Xamarin.Android/Samples/MaskedEdit_UsingMaskCharactersAsLiterals.zip). diff --git a/xamarin-android/SfMaskedEdit/Validation.md b/xamarin-android/SfMaskedEdit/Validation.md index 74dbc8bd..1653b844 100644 --- a/xamarin-android/SfMaskedEdit/Validation.md +++ b/xamarin-android/SfMaskedEdit/Validation.md @@ -1,21 +1,24 @@ --- layout: post -title: Input validation in Xamarin.Android SfMaskedEdit Control | Syncfusion® -description: Learn here about Input validation in Syncfusion® Essential® Xamarin.Android SfMaskedEdit Control, its elements, and more. -platform: Xamarin.Android +title: Input Validation in Xamarin.Android SfMaskedEdit Control | Syncfusion® +description: Learn about input validation in the Syncfusion® Essential® Xamarin.Android SfMaskedEdit Control, its elements, and more. +platform: xamarin.android control: SfMaskedEdit documentation: ug -keywords: mask, SfMaskedEdit, maskededit +keywords: mask, SfMaskedEdit, maskededit, validation, input validation, validation mode --- # Validation in Xamarin.Android SfMaskedEdit +The `SfMaskedEdit` control provides input validation capabilities to ensure data integrity and user input compliance with the specified mask pattern. + ## Validation Mode -Input validation happens based on the value of the `ValidationMode` property. The enum values of this property are: +Input validation occurs based on the value of the `ValidationMode` property. This property accepts the following enumeration values: -* KeyPress -* LostFocus +* `KeyPress` - Validation is triggered on each key press +* `LostFocus` - Validation is triggered when the control loses focus +The default value for the validation mode is `LostFocus`. The default value for validation mode is `LostFocus`. @@ -28,9 +31,9 @@ maskedEdit.ValidationMode = InputValidationMode.KeyPress; {% endhighlight %} {% endtabs %} -When the ValidationMode is LostFocus, the validation takes place when the control lost its focus. For KeyPress, the validation triggers for each key press. +When the `ValidationMode` is set to `LostFocus`, validation takes place when the control loses its focus. When set to `KeyPress`, validation is triggered for each key press event. -## HasError +## HasError Property This read only property is used to check whether the validation succeeds or not. It returns true once validation succeeds or else returns false. The following code example shows the usage of `HasError` property. @@ -61,9 +64,8 @@ private void MaskedEdit_ValueChanged(object sender, ValueChangedEventArgs e) {% endhighlight %} {% endtabs %} +Refer to this [link](Events#valuechanged-event) to learn more about the `ValueChanged` event of the `SfMaskedEdit` control. -Refer this [link](Events#valuechanged-event) to know more about the `ValueChanged` event of SfMaskedEdit control. - -![Xamarin.Android SfMaskedEdit validation](SfMaskedEditImages/Validation.png) +![Xamarin.Android SfMaskedEdit Validation](SfMaskedEditImages/Validation.png) -This demo can be downloaded from this [link](http://files2.syncfusion.com/Xamarin.Android/Samples/MaskedEdit_Validation.zip). +You can download the complete validation sample from this [link](http://files2.syncfusion.com/Xamarin.Android/Samples/MaskedEdit_Validation.zip). diff --git a/xamarin-android/SfMaskedEdit/Visual-Customization.md b/xamarin-android/SfMaskedEdit/Visual-Customization.md index 217318f9..2ffe2b13 100644 --- a/xamarin-android/SfMaskedEdit/Visual-Customization.md +++ b/xamarin-android/SfMaskedEdit/Visual-Customization.md @@ -1,16 +1,16 @@ --- layout: post -title: Visual appearence customization of SfMaskedEdit control for Xamarin.Android Platform -description: Learn how to customize the visual appearence of SfMaskedEdit control -platform: Xamarin.Android +title: Visual Customization of Syncfusion® SfMaskedEdit for Xamarin.Android +description: Learn how to customize the visual appearance of the Syncfusion® SfMaskedEdit control for Xamarin.Android applications. +platform: xamarin.android control: SfMaskedEdit documentation: ug -keywords: mask, SfMaskedEdit, maskededit - +keywords: mask, SfMaskedEdit, maskededit, visual customization, appearance, styling --- +# Visual Customization -# Visual Customization: +The appearance of the `SfMaskedEdit` control can be customized using the following properties to match your application's design requirements. The appearance of SfMaskedEdit can be customized using the following properties: @@ -27,15 +27,15 @@ maskedEdit.BorderColor = Color.Green; {% endhighlight %} {% endtabs %} -![](SfMaskedEditImages/Visual_BorderColor.png) +![Border Color Customization](SfMaskedEditImages/Visual_BorderColor.png) -## ErrorBorderColor +### ErrorBorderColor -Sets the custom error border color to SfMaskedEdit. Error border color indicates the color to be used when the validation fails for your input with respect to the mask used. +Sets a custom error border color for the `SfMaskedEdit` control. The error border color indicates the color to be used when validation fails for the input with respect to the mask pattern. -> Validation triggers based on `ValidationMode` property. +> **Note:** Validation triggers based on the `ValidationMode` property setting. -Refer this [link](Validation#validation-mode) to know more about the `ValidationMode` property of SfMaskedEdit control. +Refer to this [link](Validation#validation-mode) to learn more about the `ValidationMode` property of the `SfMaskedEdit` control. {% tabs %} {% highlight c# %} @@ -46,17 +46,18 @@ maskedEdit.ErrorBorderColor = Color.Yellow; {% endhighlight %} {% endtabs %} -![](SfMaskedEditImages/Visual_ErrorBorderColor.png) +![Error Border Color Customization](SfMaskedEditImages/Visual_ErrorBorderColor.png) +## Text Appearance Customization -## Setting Appearance of Text +You can customize the display text appearance of the `SfMaskedEdit` control using the following properties: -You can customize the display text appearance of SfMaskedEdit control using the following properties: +* `SetTextColor` - Changes the color of the text +* `TextAlignment` - Changes the horizontal alignment of the text +* `Typeface` - Changes the font family and sets font attributes (bold/italic/normal) of the text +* `TextSize` - Sets the font size of the text -* `SetTextColor`: Changes the color of the text. -* `TextAlignment`: Changes the horizontal alignment of the text. -* `Typeface`: Changes the font family of the text and sets font attributes(bold/italic/none) of the text. -* `TextSize`: Sets font size of the text. +### Example {% tabs %} {% highlight c# %} @@ -70,6 +71,6 @@ maskedEdit.TextSize = 20; {% endhighlight %} {% endtabs %} -![](SfMaskedEditImages/Visual_TextColor.png) +![Text Appearance Customization](SfMaskedEditImages/Visual_TextColor.png) This demo can be downloaded from this [link](http://files2.syncfusion.com/Xamarin.Android/Samples/MaskedEdit_VisualCustomize.zip). diff --git a/xamarin-android/SfNumericTextBox/Assign-Nullable-Value.md b/xamarin-android/SfNumericTextBox/Assign-Nullable-Value.md index c9006a0f..3e77d6a8 100644 --- a/xamarin-android/SfNumericTextBox/Assign-Nullable-Value.md +++ b/xamarin-android/SfNumericTextBox/Assign-Nullable-Value.md @@ -1,16 +1,16 @@ --- layout: post -title: Various features in Syncfusion® NumericTextBox control for Xamarin.Android -description: Learn how to decide maximum decimal digits to be displayed and nullable value support in NumericTextBox. -platform: Xamarin.Android +title: Syncfusion® NumericTextBox Nullable Value Support +description: Learn how to assign nullable values and set hint text in NumericTextBox control for Xamarin.Android. +platform: xamarin.android control: NumericTextBox documentation: ug --- # Assign Nullable Value -The null values can be set in SfNumericTextBox `Value` property, by setting `AllowNull` property value to true. +Null values can be set in the SfNumericTextBox `Value` property by setting the `AllowNull` property value to `true`. -N> By default, the property value is false. +N> By default, the property value is `false`. {% tabs %} @@ -22,11 +22,10 @@ N> By default, the property value is false. {% endtabs %} -![](images/AllowNull.png) - +![NumericTextBox with AllowNull enabled](images/AllowNull.png) ## Set Hint Text -The `WaterMark` property can be used to provide a hint that helps the user to get started with their input. The watermark text is visible when the value is empty or null. +The `WaterMark` property can be used to provide a hint that helps the user get started with their input. The watermark text is visible when the value is empty or null. {% tabs %} @@ -38,5 +37,4 @@ The `WaterMark` property can be used to provide a hint that helps the user to ge {% endtabs %} -![](images/WaterMark.png) - +![NumericTextBox with Watermark](images/WaterMark.png) diff --git a/xamarin-android/SfNumericTextBox/Decimal-Digits.md b/xamarin-android/SfNumericTextBox/Decimal-Digits.md index 4ef3ea7c..901aa0e2 100644 --- a/xamarin-android/SfNumericTextBox/Decimal-Digits.md +++ b/xamarin-android/SfNumericTextBox/Decimal-Digits.md @@ -1,18 +1,18 @@ --- layout: post -title: Various features in Syncfusion® NumericTextBox control. -description: Here learn how to decide maximum decimal digits and default decimal digits support in Xamarin.Android NumericTextBox. -platform: Xamarin.Android +title: Syncfusion® NumericTextBox Decimal Digits for Xamarin.Android +description: Learn how to set maximum decimal digits and control default decimal digits support in Xamarin.Android NumericTextBox. +platform: xamarin.android control: NumericTextBox documentation: ug --- -# Decimal Digits in NumericTextBox control +# Decimal Digits in NumericTextBox Control ## Set Maximum Number of Decimal Digits The maximum number of digits to be displayed after the decimal point can be specified by using the [`MaximumNumberDecimalDigits`](https://help.syncfusion.com/cr/xamarin-android/Com.Syncfusion.Numerictextbox.SfNumericTextBox.html#Com_Syncfusion_Numerictextbox_SfNumericTextBox_MaximumNumberDecimalDigits) property. -N> The `MaximumNumberDecimalDigits` property can be provided with positive value only. +N> The `MaximumNumberDecimalDigits` property can be provided with a positive value only. {% tabs %} @@ -24,11 +24,11 @@ N> The `MaximumNumberDecimalDigits` property can be provided with positive value {% endtabs %} -![Display the textbox value with maximum decimal digits](images/MaximumNumberDecimalDigits.png) +![Display the NumericTextBox value with maximum decimal digits](images/MaximumNumberDecimalDigits.png) -## Remove Default Decimal Digits in Xamarin Numeric Entry +## Remove Default Decimal Digits in Xamarin NumericTextBox -Based on the [`MaximumNumberDecimalDigits`](https://help.syncfusion.com/cr/xamarin-android/Com.Syncfusion.Numerictextbox.SfNumericTextBox.html#Com_Syncfusion_Numerictextbox_SfNumericTextBox_MaximumNumberDecimalDigits) property, the default number of decimal digits is displayed. By disabling the `AllowDefaultDecimalDigits` Boolean property, those default digits can be removed from the numeric entry view. +Based on the [`MaximumNumberDecimalDigits`](https://help.syncfusion.com/cr/xamarin-android/Com.Syncfusion.Numerictextbox.SfNumericTextBox.html#Com_Syncfusion_Numerictextbox_SfNumericTextBox_MaximumNumberDecimalDigits) property, the default number of decimal digits is displayed. By disabling the `AllowDefaultDecimalDigits` Boolean property, those default digits can be removed from the NumericTextBox view. {% tabs %} @@ -40,4 +40,4 @@ Based on the [`MaximumNumberDecimalDigits`](https://help.syncfusion.com/cr/xamar {% endtabs %} -![Display the textbox value without default decimal digits](images/AllowDefaultDecimalDigits.png) +![Display the NumericTextBox value without default decimal digits](images/AllowDefaultDecimalDigits.png) diff --git a/xamarin-android/SfNumericTextBox/Getting-Started.md b/xamarin-android/SfNumericTextBox/Getting-Started.md index fd06a09c..05a9f5da 100644 --- a/xamarin-android/SfNumericTextBox/Getting-Started.md +++ b/xamarin-android/SfNumericTextBox/Getting-Started.md @@ -1,31 +1,31 @@ --- layout: post -title: Getting Started with Syncfusion® NumericTextBox control -description: A quick tour to initial users on Syncfusion® NumericTextBox (SfNumericTextBox) control for Xamarin.Android platform -platform: Xamarin.Android +title: Getting Started with Syncfusion® NumericTextBox for Android +description: A quick tour for initial users on Syncfusion® NumericTextBox (SfNumericTextBox) control for Xamarin.Android platform +platform: xamarin.android control: NumericTextBox documentation: ug --- # Getting Started with Xamarin.Android NumericTextBox (SfNumericTextBox) -This section explains you the steps to configure a SfNumericTextBox control in a real-time scenario and also provides a walk-through on some of the customization features available in SfNumericTextBox control. +This section explains the steps to configure a SfNumericTextBox control in a real-time scenario and also provides a walk-through on some of the customization features available in the SfNumericTextBox control. -## Reference Essential Studio® components in your solution +## Reference Essential Studio® Components in Your Solution -After installing Essential Studio® for Xamarin, you can find all the required assemblies in the installation folders, +After installing Essential Studio® for Xamarin, you can find all the required assemblies in the installation folders: {Syncfusion Installed location}\Essential Studio\12.4.0.24\lib -N> Assemblies are available in unzipped package location in Mac. +N> Assemblies are available in the unzipped package location on Mac. -Add the following assembly references to the Android project, +Add the following assembly reference to the Android project: android\Syncfusion.SfNumericTextBox.Android.dll ## Add SfNumericTextBox -* Adding reference to NumericTextBox. +* Adding reference to NumericTextBox: {% capture codesnippet1 %} @@ -64,7 +64,7 @@ SetContentView(numericTextBox); ## Set Value -The SfNumericTextBox control display value can be set using `Value` property. +The SfNumericTextBox control display value can be set using the `Value` property. {% tabs %} @@ -97,13 +97,13 @@ numericTextBox.ParsingMode=Parsers.Decimal; The `FormatString` property determines the format specifier by which the display text has to be formatted. -It has three types, +It has three types: * c - Display the value with currency notation. -* n – Display the value in number format. -* p – Display the value in Percentage. +* n - Display the value in number format. +* p - Display the value in percentage. -N> The control displays the formatted text on lost focus. Default Value of `FormatString` is "n". +N> The control displays the formatted text on lost focus. The default value of `FormatString` is "n". {% tabs %} @@ -115,4 +115,4 @@ N> The control displays the formatted text on lost focus. Default Value of `Form {% endtabs %} -![Xamarin.Android NumericTextBox](images/gettingstarted.png) \ No newline at end of file +![Xamarin.Android NumericTextBox Getting Started](images/gettingstarted.png) diff --git a/xamarin-android/SfNumericTextBox/Localization.md b/xamarin-android/SfNumericTextBox/Localization.md index 6ec45047..7de37a89 100644 --- a/xamarin-android/SfNumericTextBox/Localization.md +++ b/xamarin-android/SfNumericTextBox/Localization.md @@ -1,16 +1,16 @@ --- layout: post -title: Localization in Syncfusion® NumericTextBox control for Xamarin.Android -description: Learn how to localize the NumericTextBox -platform: Xamarin.Android +title: Localization in Syncfusion® NumericTextBox Control for Xamarin.Android +description: Learn how to localize the Syncfusion® NumericTextBox control to support different cultures and regions effectively. +platform: xamarin.android control: NumericTextBox documentation: ug --- # Localization -The SfNumericTextBox value can be localized to any specific culture. It can be specified by setting the `Culture` property with `System.Globalization.CultureInfo` object instance. +The SfNumericTextBox value can be localized to any specific culture. It can be specified by setting the `Culture` property with a `System.Globalization.CultureInfo` object instance. -N> Default `Culture` property value is en-US. +N> The default `Culture` property value is en-US. {% tabs %} @@ -22,6 +22,4 @@ N> Default `Culture` property value is en-US. {% endtabs %} - -![](images/Culture.png) - +![NumericTextBox with French localization](images/Culture.png) diff --git a/xamarin-android/SfNumericTextBox/Number-Formatting.md b/xamarin-android/SfNumericTextBox/Number-Formatting.md index 5309222d..e2c98aad 100644 --- a/xamarin-android/SfNumericTextBox/Number-Formatting.md +++ b/xamarin-android/SfNumericTextBox/Number-Formatting.md @@ -1,21 +1,21 @@ --- layout: post title: Number Formatting in Syncfusion® NumericTextBox for Xamarin.Android -description: Learn how to format string, enable parser mode and percent display mode for syncfusion® NumericTextBox control. -platform: Xamarin.Android +description: Learn how to format strings, enable parser mode, and percent display mode for Syncfusion® NumericTextBox control. +platform: xamarin.android control: NumericTextBox documentation: ug --- -# Number formatting and group separator +# Number Formatting and Group Separator -The Values of the SfNumericTextBox can be configured to display different formats like currency format, percent format etc. +The values of the SfNumericTextBox can be configured to display different formats like currency format, percent format, etc. ## Format String The `FormatString` property determines the format specifier by which the display text has to be formatted. -N> The control displays the formatted text on lost focus. Default Value of `FormatString` is "n". +N> The control displays the formatted text on lost focus. The default value of `FormatString` is "n". ### Display Currency Notation @@ -33,7 +33,7 @@ N> The control displays the formatted text on lost focus. Default Value of `Form ### Display Number Notation -`n` – Displays the value in number format. +`n` - Displays the value in number format. {% tabs %} @@ -47,7 +47,7 @@ N> The control displays the formatted text on lost focus. Default Value of `Form ### Display Percentage Notation -`p` – Displays the value in percentage. +`p` - Displays the value in percentage. {% tabs %} @@ -59,7 +59,7 @@ N> The control displays the formatted text on lost focus. Default Value of `Form {% endtabs %} -N> Instead of using above `FormatString` types, we can provide any symbol or value as string in `FormatString` property which will be appended with the value in SfNumericTextBox. +N> Instead of using the above `FormatString` types, you can provide any symbol or value as a string in the `FormatString` property, which will be appended with the value in SfNumericTextBox. ![Format string](images/FormatString.png) @@ -67,7 +67,7 @@ N> Instead of using above `FormatString` types, we can provide any symbol or val The value of the SfNumericTextBox can be parsed based on the `ParsingMode` property. -N> The `ParsingMode` is of type Parsers containing enum values of Double and Decimal. The default Value for `ParsingMode` is Double. +N> The `ParsingMode` is of type Parsers containing enum values of Double and Decimal. The default value for `ParsingMode` is Double. {% tabs %} @@ -83,7 +83,7 @@ N> The `ParsingMode` is of type Parsers containing enum values of Double and Dec ## Compute to Percentage -The `PercentDisplayMode` property can be used to display numeric data in Percent mode. +The `PercentDisplayMode` property can be used to display numeric data in percent mode. N> The control displays the percent value on lost focus. @@ -125,12 +125,10 @@ N> The control displays the percent value on lost focus. ![Percent display mode](images/PercentDisplayMode.png) -## Group separator modes +## Group Separator Modes -[`GroupSeparatorMode`](https://help.syncfusion.com/cr/xamarin-android/Com.Syncfusion.Numerictextbox.GroupSeparatorMode.html) provides 2 states to display the group separator. -When the mode is set as `Always`, it will display separator while typing itself on the other hand when the mode is set as `LostFocus` it will enable the separator when the control lost its focus. - -N> [`EnableGroupSeparator`](https://help.syncfusion.com/cr/xamarin-android/Com.Syncfusion.Numerictextbox.SfNumericTextBox.html#Com_Syncfusion_Numerictextbox_SfNumericTextBox_EnableGroupSeparator) property must be enabled to use the `GroupSeparatorMode`. +[`GroupSeparatorMode`](https://help.syncfusion.com/cr/xamarin-android/Com.Syncfusion.Numerictextbox.GroupSeparatorMode.html) provides two states to display the group separator. When the mode is set as `Always`, it will display the separator while typing. On the other hand, when the mode is set as `LostFocus`, it will enable the separator when the control loses its focus. +N> The [`EnableGroupSeparator`](https://help.syncfusion.com/cr/xamarin-android/Com.Syncfusion.Numerictextbox.SfNumericTextBox.html#Com_Syncfusion_Numerictextbox_SfNumericTextBox_EnableGroupSeparator) property must be enabled to use the `GroupSeparatorMode`. {% tabs %} @@ -147,4 +145,4 @@ N> [`EnableGroupSeparator`](https://help.syncfusion.com/cr/xamarin-android/Com.S {% endtabs %} -![Display the value with enable group separator](images/SeparatorMode.png) \ No newline at end of file +![Display the value with enabled group separator](images/SeparatorMode.png) diff --git a/xamarin-android/SfNumericTextBox/Overview.md b/xamarin-android/SfNumericTextBox/Overview.md index 20678a61..5983b51f 100644 --- a/xamarin-android/SfNumericTextBox/Overview.md +++ b/xamarin-android/SfNumericTextBox/Overview.md @@ -1,7 +1,7 @@ --- layout: post -title: Overview of Syncfusion® NumericTextBox control for Xamarin.Android -description: This explains about the Overview and key features of Syncfusion® Essential® Xamarin.Android NumericTextBox control +title: Overview of Syncfusion® NumericTextBox Control for Xamarin.Android +description: This explains the overview and key features of Syncfusion® Essential® Xamarin.Android NumericTextBox control. platform: xamarin.android control: NumericTextBox documentation: ug @@ -11,20 +11,16 @@ documentation: ug The Essential® Xamarin.Android NumericTextBox is an advanced version of the Entry control that restricts input to numeric values. -Also provides, a gesture friendly UI culture and can be configured to display different formats like currency format, scientific format etc. +It also provides a gesture-friendly UI culture and can be configured to display different formats like currency format, scientific format, etc. ![Xamarin.Android NumericTextBox Overview](images/overview.png) ## Key Features -* `FormatString` - Input string can be formatted by using the format strings. +* `FormatString` - Input string can be formatted by using format strings. * `Culture` - Number format can be localized to any specific culture. * `AllowNull` - Allows the user to set null value. -* `ParserMode` - Value gets parsed based on parser mode. - - - - +* `ParsingMode` - Value gets parsed based on parsing mode. diff --git a/xamarin-android/SfNumericTextBox/Range-Support.md b/xamarin-android/SfNumericTextBox/Range-Support.md index 96e0a09a..57fd9ba4 100644 --- a/xamarin-android/SfNumericTextBox/Range-Support.md +++ b/xamarin-android/SfNumericTextBox/Range-Support.md @@ -1,14 +1,15 @@ --- layout: post -title: Range Support in Syncfusion® NumericTextBox control for Xamarin.Android -description: Learn how to use range support for NumericTextBox control. -platform: Xamarin.Android +title: Syncfusion® NumericTextBox Range Support for Xamarin.Android +description: Learn how to use range support to restrict input values within specified minimum and maximum limits in NumericTextBox control. +platform: xamarin.android control: NumericTextBox documentation: ug --- + # Range Support -Restrict the values within a specific range by setting the Maximum and Minimum property values. +You can restrict the values within a specific range by setting the `Maximum` and `Minimum` property values. {% tabs %} diff --git a/xamarin-android/SfNumericUpDown/Assign-Nullable-Value.md b/xamarin-android/SfNumericUpDown/Assign-Nullable-Value.md index 42ea84cd..41ae39df 100644 --- a/xamarin-android/SfNumericUpDown/Assign-Nullable-Value.md +++ b/xamarin-android/SfNumericUpDown/Assign-Nullable-Value.md @@ -1,14 +1,16 @@ --- layout: post -title: Various Features in Syncfusion® NumericUpDown control for Xamarin.Android -description: Learn how to decide maximum decimal digits to be displayed, nullable value support, autoreverse, setting range and configuring step value in NumericUpDown -platform: Xamarin.Android +title: Assign Nullable Value in Syncfusion® NumericUpDown for Xamarin.Android +description: Learn how to assign nullable values and configure watermark text in the SfNumericUpDown control for Xamarin.Android. +platform: xamarin.android control: NumericUpDown documentation: ug +keywords: NumericUpDown, nullable value, watermark, hint text, AllowNull --- # Assign Nullable Value -The null values can be set in SfNumericUpDown `Value` property, by setting `AllowNull` property value to true. +The `SfNumericUpDown` control supports nullable values, allowing you to set null values in the `Value` property by setting the `AllowNull` property to `true`. +N> By default, the `AllowNull` property value is `false`. N> By default, the property value is false. @@ -22,11 +24,11 @@ N> By default, the property value is false. {% endtabs %} -![](images/allownull.png) +![Nullable Value Support](images/allownull.png) ## Set Hint Text -The `WaterMark` property can be used to provide a hint that helps the user to get started with their input. The watermark text is visible when value is empty or null. +The `Watermark` property can be used to provide a hint that helps users get started with their input. The watermark text is visible when the value is empty or null. {% tabs %} @@ -38,4 +40,4 @@ The `WaterMark` property can be used to provide a hint that helps the user to ge {% endtabs %} -![](images/watermark.png) \ No newline at end of file +![Watermark Text](images/watermark.png) diff --git a/xamarin-android/SfNumericUpDown/Auto-Reverse.md b/xamarin-android/SfNumericUpDown/Auto-Reverse.md index 8571e49c..42b6196f 100644 --- a/xamarin-android/SfNumericUpDown/Auto-Reverse.md +++ b/xamarin-android/SfNumericUpDown/Auto-Reverse.md @@ -1,14 +1,16 @@ --- layout: post -title: Various Features in Syncfusion® NumericUpDown control for Xamarin.Android -description: Learn how to decide maximum decimal digits to be displayed, nullable value support, autoreverse, setting range and configuring step value in NumericUpDown -platform: Xamarin.Android +title: Auto Reverse in Syncfusion® NumericUpDown for Xamarin.Android +description: Learn how to enable auto reverse functionality, set value ranges, and configure step values in the SfNumericUpDown control for Xamarin.Android. +platform: xamarin.android control: NumericUpDown documentation: ug +keywords: NumericUpDown, auto reverse, minimum, maximum, step value, range, continuous spinning --- # Auto Reverse -While incrementing, the control will start from Minimum value once it reaches the Maximum value and vice-versa. +The Auto Reverse feature allows the `SfNumericUpDown` control to automatically cycle between minimum and maximum values. When incrementing, the control will start from the minimum value once it reaches the maximum value, and vice versa when decrementing. +N> By default, the `AutoReverse` property value is `false`. N> By default the property value is false. @@ -24,7 +26,8 @@ numericupdown.AutoReverse = true; ## Continuous Spinning Between Ranges -User can restrict the Values between a specific range by setting `Maximum` and `Minimum` property value. +You can restrict the values between a specific range by setting the `Maximum` and `Minimum` property values. When auto reverse is enabled, the control will continuously cycle within this defined range. +N> By default, the `Minimum` property value is `0` and the `Maximum` property value is `100`. N> By default the minimum property value is 0 and maximum property value is 100. @@ -39,13 +42,14 @@ sfNumericUpDown.Maximum = 50 {% endtabs %} -![](images/maximum.png) +![Maximum Value](images/maximum.png) -![](images/minimum.png) +![Minimum Value](images/minimum.png) -## Set Increment +## Set Increment Step -Frequency in which values gets incremented can be decided using `StepValue` property. +The frequency at which values are incremented or decremented can be configured using the `StepValue` property. This determines how much the value changes with each increment or decrement operation. +N> By default, the `StepValue` property value is `1`. N> By default the property value is 1. diff --git a/xamarin-android/SfNumericUpDown/Localization.md b/xamarin-android/SfNumericUpDown/Localization.md index fd3ac487..253bdf55 100644 --- a/xamarin-android/SfNumericUpDown/Localization.md +++ b/xamarin-android/SfNumericUpDown/Localization.md @@ -1,16 +1,17 @@ --- layout: post -title: Localization in Syncfusion® NumericUpDown control for Xamarin.Android -description: Learn how to localize the NumericUpDown control -platform: Xamarin.Android +title: Localization in Syncfusion® NumericUpDown Control for Xamarin.Android +description: Learn how to localize the Syncfusion® NumericUpDown control to support different cultures and regions. +platform: xamarin.android control: NumericUpDown documentation: ug +keywords: NumericUpDown, localization, culture, globalization, regional settings, formatting --- # Localization -The SfNumericUpDown value can be localized to any specific culture. It can be specified by setting the `Culture` property with `System.Globalization.CultureInfo` object instance. +The `SfNumericUpDown` control supports localization to display values according to specific cultural conventions. You can localize the control by setting the `Culture` property with a `System.Globalization.CultureInfo` object instance. -N> Default `Culture` property value is en-US. +N> The default `Culture` property value is `en-US`. {% tabs %} @@ -22,7 +23,7 @@ N> Default `Culture` property value is en-US. {% endtabs %} -![](images/Culture.png) +![Culture](images/Culture.png) diff --git a/xamarin-android/SfNumericUpDown/Number-Formatting.md b/xamarin-android/SfNumericUpDown/Number-Formatting.md index c2b906b8..f21f6a30 100644 --- a/xamarin-android/SfNumericUpDown/Number-Formatting.md +++ b/xamarin-android/SfNumericUpDown/Number-Formatting.md @@ -1,25 +1,25 @@ --- layout: post -title: Number Formatting in Syncfusion® NumericUpDown control -description: Learn how to add format String, enable parser mode and percent display mode for NumericUpDown control. -platform: Xamarin.Android +title: Number Formatting in Syncfusion® NumericUpDown for Xamarin.Android +description: Learn how to add format strings, enable parser mode, and configure percent display mode for the NumericUpDown control. +platform: xamarin.android control: NumericUpDown documentation: ug +keywords: NumericUpDown, number formatting, format string, parser mode, percentage, currency, localization --- # Number Formatting in NumericUpDown (SfNumericUpDown) -The Values of the SfNumericUpDown can be configured to display different formats like currency format, percent format etc. +The values of the `SfNumericUpDown` control can be configured to display different formats such as currency format, percent format, and custom number formats to meet various application requirements. ## Format String -The `FormatString` property determines the format specifier by which the display text has to be formatted. +The `FormatString` property determines the format specifier by which the display text is formatted. This property allows you to control how numeric values are presented to users. -N> The control displays the formatted text on lost focus. Default Value of `FormatString` is "n". +N> The control displays the formatted text when it loses focus. The default value of `FormatString` is "n". ### Display Currency Notation -`c` - Displays the value with currency notation. - +Use `c` to display the value with currency notation based on the current culture settings. {% tabs %} {% highlight C# %} @@ -32,8 +32,7 @@ N> The control displays the formatted text on lost focus. Default Value of `Form ### Display Number Notation -`n` – Displays the value in number format. - +Use `n` to display the value in standard number format with appropriate decimal and group separators. {% tabs %} {% highlight C# %} @@ -46,8 +45,7 @@ N> The control displays the formatted text on lost focus. Default Value of `Form ### Display Percentage Notation -`p` – Displays the value in Percentage. - +Use `p` to display the value as a percentage (the value is multiplied by 100 and the % symbol is appended). {% tabs %} {% highlight C# %} @@ -58,7 +56,8 @@ N> The control displays the formatted text on lost focus. Default Value of `Form {% endtabs %} -N> Instead of using above `FormatString` types, we can provide any symbol or value as string in `FormatString` property which will be appended with the value in SfNumericUpDown. +### Custom Format Strings +You can also provide custom symbols or values as strings in the `FormatString` property, which will be appended to the value in the `SfNumericUpDown`. ![Xamarin.Android SfNumericUpDown percentage notation](images/format.png) diff --git a/xamarin-android/SfNumericUpDown/Overview.md b/xamarin-android/SfNumericUpDown/Overview.md index d035f011..3759e5f5 100644 --- a/xamarin-android/SfNumericUpDown/Overview.md +++ b/xamarin-android/SfNumericUpDown/Overview.md @@ -1,17 +1,17 @@ --- layout: post -title: About Xamarin.Android NumericUpDown Control | Syncfusion® -description: Learn here all about introduction of Syncfusion® Xamarin.Android NumericUpDown control its features, and more. +title: Xamarin.Android NumericUpDown Control Overview | Syncfusion® +description: Learn about the Syncfusion® Xamarin.Android NumericUpDown control, its features, capabilities, and use cases. platform: xamarin.android control: NumericUpDown documentation: ug +keywords: NumericUpDown, SfNumericUpDown, overview, numeric input, up down control, spinner control --- # Xamarin.Android NumericUpDown Overview -The Essential® Xamarin.Android NumericUpDown control provides up and down repeat buttons to increase and decrease values. The control respects UI culture and can be configured to display different formats like currency, scientific, etc. - -![Xamarin.Android NumericUpDown Overview Image](images/overview.png) +The Essential® Xamarin.Android NumericUpDown (`SfNumericUpDown`) control provides an intuitive way for users to enter numeric values using up and down buttons or direct text input. The control includes increment and decrement buttons that allow users to easily adjust values within a specified range. It respects UI culture settings and can be configured to display different formats such as currency, percentage, scientific notation, and custom formats. +![Xamarin.Android NumericUpDown Overview](images/overview.png) ## Key Features diff --git a/xamarin-android/SfNumericUpDown/Set-Maximum-Number-of-Decimal-Digits.md b/xamarin-android/SfNumericUpDown/Set-Maximum-Number-of-Decimal-Digits.md index 4b24b0a5..b63e1612 100644 --- a/xamarin-android/SfNumericUpDown/Set-Maximum-Number-of-Decimal-Digits.md +++ b/xamarin-android/SfNumericUpDown/Set-Maximum-Number-of-Decimal-Digits.md @@ -1,17 +1,19 @@ --- layout: post -title: Various Features in Syncfusion® NumericUpDown control for Xamarin.Android -description: Learn how to decide maximum decimal digits to be displayed, nullable value support, autoreverse, setting range and configuring step value in NumericUpDown -platform: Xamarin.Android +title: Syncfusion® NumericUpDown Maximum Decimal Digits Setting +description: Learn how to configure the maximum number of decimal digits to be displayed in the NumericUpDown control. +platform: xamarin.android control: NumericUpDown documentation: ug +keywords: NumericUpDown, decimal digits, precision, number formatting, decimal places --- # Set Maximum Number of Decimal Digits -The maximum number of digits to be displayed after the decimal point can be specified by using `MaximumNumberDecimalDigits` property. +The `SfNumericUpDown` control allows you to specify the maximum number of digits to be displayed after the decimal point using the `MaximumNumberDecimalDigits` property. This feature is useful for controlling the precision of numeric values and ensuring consistent formatting across your application. -N> The `MaximumNumberDecimalDigits` property can be provided with positive value only. +N> The `MaximumNumberDecimalDigits` property accepts positive values only. The default value is determined by the current culture settings. +## Basic Usage {% tabs %} {% highlight C# %} @@ -20,4 +22,4 @@ numeric.MaximumNumberDecimalDigits = 2; {% endhighlight %} -{% endtabs %} \ No newline at end of file +{% endtabs %} diff --git a/xamarin-android/SfNumericUpDown/Spin-Button-Customization.md b/xamarin-android/SfNumericUpDown/Spin-Button-Customization.md index 1070713b..a87a8cb7 100644 --- a/xamarin-android/SfNumericUpDown/Spin-Button-Customization.md +++ b/xamarin-android/SfNumericUpDown/Spin-Button-Customization.md @@ -1,26 +1,29 @@ --- layout: post -title: Appearance in Syncfusion® NumericUpDown control for Xamarin.Android -description: Learn how to add customize spin buttons position in NumericUpDown. -platform: Xamarin.Android +title: Spin Button Customization in Syncfusion® NumericUpDown for Xamarin +description: Learn how to customize spin button position, alignment, and visual appearance in the Xamarin NumericUpDown control. +platform: xamarin.android control: NumericUpDown documentation: ug +keywords: NumericUpDown, spin buttons, button alignment, button customization, appearance, UI customization --- -# Spin Button Alignment +# Spin Button Customization -Spin Button position in the SfNumericUpDown control can be changed relative to the TextBox based on `SpinButtonAlignment` property. +The `SfNumericUpDown` control provides extensive customization options for spin buttons, including position alignment and visual appearance. You can customize both the placement and the visual representation of the increment and decrement buttons to match your application's design requirements. -There are three built-in modes. +## Spin Button Alignment +The spin button position in the `SfNumericUpDown` control can be changed relative to the text box using the `SpinButtonAlignment` property. This property offers three built-in alignment modes: -* Right -* Left -* Both +* `Right` - Buttons aligned to the right side +* `Left` - Buttons aligned to the left side +* `Both` - Buttons aligned to both sides -### Right +N> By default, the `SpinButtonAlignment` property value is `Right`. -Spin Buttons will get aligned to the right side of the control. +### Right Alignment +Spin buttons will be aligned to the right side of the control, providing a traditional numeric input appearance. {% tabs %} {% highlight C# %} @@ -31,12 +34,11 @@ numeric.SpinButtonAlignment = SpinButtonAlignment.Right; {% endtabs %} -![](images/spinright.png) +![Right Aligned Spin Buttons](images/spinright.png) -### Left - -Spin Buttons will get aligned to the left side of the control. +### Left Alignment +Spin buttons will be aligned to the left side of the control, useful for right-to-left layouts or specific design requirements. {% tabs %} {% highlight C# %} @@ -47,12 +49,11 @@ numeric.SpinButtonAlignment = SpinButtonAlignment.Left; {% endtabs %} -![](images/spinleft.png) - -### Both +![Left Aligned Spin Buttons](images/spinleft.png) -Spin Buttons will get aligned to the both side of the control. +### Both Sides Alignment +Spin buttons will be aligned to both sides of the control, with increment on one side and decrement on the other. {% tabs %} {% highlight C# %} @@ -63,24 +64,22 @@ numeric.SpinButtonAlignment = SpinButtonAlignment.Both; {% endtabs %} -![](images/spinboth.png) - -N> By default the property value is Right. +![Both Sides Aligned Spin Buttons](images/spinboth.png) +## UpDownButtonSettings Customization -## UpDownButtonSetting Customization +The `SfNumericUpDown` control allows you to customize the appearance of increment and decrement buttons using the `UpDownButtonSettings` class. You can customize buttons using three different approaches: -We can set the Up Down button of SfNumericUpDown control by using any of the below given ways. +1. **Custom View** - Use any Android view as a button +2. **Image** - Use image resources for button appearance +3. **Font Icon** - Use font icons for scalable button graphics -1. View -2. Image -3. FontIconText +N> **Resource Requirements:** +> * For images: Add image files to `Resources/drawable/` folder +> * For font icons: Add TTF font files to `Assets/` folder -N> For image and FontIcon we need to add the the respective image and TTF file. - For android: Add image at Resource/Drawable/{Image} and .ttf file at Asserts/{.ttf} - - -### By using View +### Custom View Customization +You can use any Android view as a custom button, providing complete control over button appearance and behavior. {% tabs %} {% highlight C# %} @@ -128,8 +127,9 @@ N> For image and FontIcon we need to add the the respective image and TTF file. {% endtabs %} -### By using Image +### Image-Based Customization +Use image resources to create visually appealing buttons with custom graphics. {% tabs %} {% highlight C# %} @@ -165,8 +165,9 @@ N> For image and FontIcon we need to add the the respective image and TTF file. {% endtabs %} -### By using FontIconText +### Font Icon Customization +Use font icons for scalable, customizable button graphics that maintain quality at any size. {% tabs %} {% highlight C# %} @@ -207,7 +208,5 @@ N> For image and FontIcon we need to add the the respective image and TTF file. {% endtabs %} -![](images/image.png) - - +![Customized Spin Buttons](images/image.png) diff --git a/xamarin-android/SfNumericUpDown/getting-started.md b/xamarin-android/SfNumericUpDown/getting-started.md index cfa021b2..928db122 100644 --- a/xamarin-android/SfNumericUpDown/getting-started.md +++ b/xamarin-android/SfNumericUpDown/getting-started.md @@ -1,17 +1,18 @@ --- layout: post -title: Getting Started for Syncfusion® NumericUpDown Control -description: A quick tour to initial users on Syncfusion® NumericUpDown(SfNumericUpDown) control for Xamarin.Android platform +title: Getting Started with Syncfusion® NumericUpDown for Xamarin.Android +description: A quick tour for initial users on the Syncfusion® NumericUpDown (SfNumericUpDown) control for the Xamarin.Android platform. platform: xamarin.android control: NumericUpDown documentation: ug +keywords: NumericUpDown, SfNumericUpDown, getting started, Xamarin.Android, setup, installation --- -# Getting Started of Xamarin.Android NumericUpDown(SfNumericUpDown) +# Getting Started with Xamarin.Android NumericUpDown (SfNumericUpDown) -This section provides overview for working with Essential® NumericUpDown for Xamarin.Android. You can walk through the entire process of creating a SfNumericUpDown. +This section provides an overview for working with the Essential® NumericUpDown control for Xamarin.Android. You can walk through the entire process of creating and configuring an `SfNumericUpDown` control. -## Referencing Essential Studio® Components in Your Solution +## Reference Essential Studio® Components in Your Solution After installing Essential Studio® for Xamarin, you can find all the required assemblies in the installation folders, @@ -23,9 +24,10 @@ android\Syncfusion.SfNumericUpDown.Android.dll ## Add SfNumericUpDown -The `SfNumericUpDown` control configured entirely in C# code or using the AXML markup. The following steps explain how to create a `SfNumericUpDown` and configure their elements. +The `SfNumericUpDown` control can be configured entirely in C# code or using AXML markup. The following steps explain how to create an `SfNumericUpDown` control and configure its elements. -Add the following code in the Main.axml to include `NumericUpDown` control. +### Using AXML Markup +Add the following code in the Main.axml file to include the `NumericUpDown` control: {% highlight xaml %} @@ -44,7 +46,7 @@ Add the following code in the Main.axml to include `NumericUpDown` control. {% endhighlight %} -In MainActivity, you can access the `NumericUpDown` instance defined in axml page using the following code. +In MainActivity, you can access the `NumericUpDown` instance defined in the AXML page using the following code: {% highlight C# %} @@ -69,7 +71,7 @@ public class MainActivity : Activity {% endhighlight %} -Also, you can create the `NumericUpDown` control using the code behind. The following steps help to add `NumericUpDown` control using the code behind. +Also, you can create the `NumericUpDown` control using the code behind. The following steps help to add the `NumericUpDown` control using the code behind. * Adding reference to NumericUpDown. @@ -110,7 +112,7 @@ SetContentView(numeric); ## Set Value -The SfNumericUpDown control display value can be set using `Value` property. +The `SfNumericUpDown` control's display value can be set using the `Value` property: {% tabs %} @@ -124,9 +126,9 @@ numeric.Value= 5; ## Enable Parsing Mode -The value of the SfNumericUpDown can be parsed based on the `ParsingMode` property. +The value of the `SfNumericUpDown` can be parsed based on the `ParsingMode` property, which determines how the input text is converted to a numeric value. -N> The `ParsingMode` is of type Parsers containing enum values of Double and Decimal. +N> The `ParsingMode` is of type `Parsers` containing enum values of `Double` and `Decimal`. {% tabs %} @@ -140,15 +142,14 @@ N> The `ParsingMode` is of type Parsers containing enum values of Double and Dec ## Add Format String -The `FormatString` property determines the format specifier by which the display text has to be formatted. +The `FormatString` property determines the format specifier by which the display text is formatted. -It has three types, +The control supports the following format types: +* **c** - Display the value with currency notation +* **n** - Display the value in number format +* **p** - Display the value in percentage format -* c - Display the value with currency notation. -* n – Display the value in number format. -* p – Display the value in Percentage. - -N> The control displays the formatted text on lost focus. Default Value of `FormatString` is "n". +N> The control displays the formatted text when it loses focus. The default value of `FormatString` is "n". {% tabs %}