diff --git a/xamarin-android/SfAutoComplete/Customizing-the-Suggestion-DropDown.md b/xamarin-android/SfAutoComplete/Customizing-the-Suggestion-DropDown.md index 11be29f9f..72e781801 100644 --- a/xamarin-android/SfAutoComplete/Customizing-the-Suggestion-DropDown.md +++ b/xamarin-android/SfAutoComplete/Customizing-the-Suggestion-DropDown.md @@ -1,20 +1,20 @@ --- -layout : post -title : MinimumPrefixCharacters for Syncfusion® AutoComplete Control in Xamarin.Android -description : Learn how to set the MinimumPrefixCharacter in SfAutoComplete -platform : Xamarin.Android -control : SfAutoComplete -documentation : ug +layout: post +title: Syncfusion® AutoComplete MinimumPrefixCharacters Android +description: Learn how to set MinimumPrefixCharacter property in SfAutoComplete to define minimum characters needed for suggestion dropdown display. +platform: xamarin.android +control: SfAutoComplete +documentation: ug --- # Customizing the Suggestion DropDown -The suggestion list displaying behavior can be customized based on the entered text and delays in displaying the items. +The suggestion list display behavior can be customized based on the entered text and delays in displaying the items. -## Set Minimum Prefix Character +## Set Minimum Prefix Characters -Instead of displaying suggestion list on every text entry, the most possible match can be filtered and displayed after few text entries. This can be done by modifying `MinimumPrefixCharacters`. +Instead of displaying the suggestion list on every text entry, you can filter and display the most relevant matches after a few text entries. This can be achieved by modifying the `MinimumPrefixCharacters` property. N> The default property value is 1. @@ -32,9 +32,9 @@ countryAutoComplete.MinimumPrefixCharacters = 4; ## Set PopUp Delay -We can delay the time taken to display the dropdown with suggestion list by using the `PopUpDelay` property in SfAutoComplete . +You can delay the time taken to display the dropdown with the suggestion list by using the `PopUpDelay` property in SfAutoComplete. -N> The default value is 0. The property value is maintained in milliseconds. +N> The default value is 0. The property value is specified in milliseconds. {% tabs %} @@ -46,9 +46,9 @@ countryAutoComplete.PopUpDelay = 100; {% endtabs %} -## Set Maximum Height to the DropDown +## Set Maximum Height for the DropDown -The height of the drop-down portion of the SfAutocomplete control can be varied using `MaximumDropDownHeight` property. +The height of the dropdown portion of the SfAutoComplete control can be customized using the `MaximumDropDownHeight` property. N> The `MaximumDropDownHeight` value can be any positive integer value. @@ -64,9 +64,9 @@ countryAutoComplete.MaximumDropDownHeight = 200; ![Maximum drop down height](images/maximumdropdownheight.png) -## Set border color to the DropDown +## Set Border Color for the DropDown -The DropDownBorderColor property is used to change the border color of DropDown. The following code example demonstrates how to change the border color of DropDown. +The `DropDownBorderColor` property is used to change the border color of the dropdown. The following code example demonstrates how to change the border color of the dropdown. {% tabs %} diff --git a/xamarin-android/SfAutoComplete/Diacritic-Sensitivity.md b/xamarin-android/SfAutoComplete/Diacritic-Sensitivity.md index f2661cdb5..a43a05479 100644 --- a/xamarin-android/SfAutoComplete/Diacritic-Sensitivity.md +++ b/xamarin-android/SfAutoComplete/Diacritic-Sensitivity.md @@ -1,17 +1,17 @@ --- -layout : post -title : Diacritic sensitivity in Syncfusion® SfAutoComplete control for Xamarin.Android -description : Learn how to enable and disable Diacritic sensitivity in SfAutoComplete -platform : Xamarin.Android -control : SfAutoComplete -documentation : ug +layout: post +title: Syncfusion® SfAutoComplete Diacritic Sensitivity Android +description: Learn how to enable and disable diacritic sensitivity in SfAutoComplete for multilingual text search +platform: xamarin.android +control: SfAutoComplete +documentation: ug --- # Diacritic Sensitivity -The control does not stick with one type of keyboard, so you can populate items from a language with letters containing diacritics, and search for them with English characters from an en-US keyboard. Users can enable or disable the diacritic sensitivity with the `IgnoreDiacritic` property. +The control supports multiple keyboard types, allowing you to populate items from languages with diacritical marks and search for them using English characters from an en-US keyboard. Users can enable or disable diacritic sensitivity using the `IgnoreDiacritic` property. -In the below code example we have illustrate how to enable the diacritic sensitivity so that items in the suggestion list get populated by entering any diacritic character of that alphabet. +The following code example demonstrates how to disable diacritic sensitivity so that items in the suggestion list are populated when entering any diacritic character of that alphabet. {% tabs %} @@ -39,7 +39,4 @@ countryAutoComplete.IgnoreDiacritic=false; {% endtabs %} -![](images/diacritic.png) - - - \ No newline at end of file +![Diacritic sensitivity example](images/diacritic.png) diff --git a/xamarin-android/SfAutoComplete/Getting-Started.md b/xamarin-android/SfAutoComplete/Getting-Started.md index 5734f1659..3ebddc2ba 100644 --- a/xamarin-android/SfAutoComplete/Getting-Started.md +++ b/xamarin-android/SfAutoComplete/Getting-Started.md @@ -1,29 +1,29 @@ --- -layout : post -title : Getting Started with Syncfusion® AutoComplete Control for Xamarin.Android -description : A quick tour to initial users on Syncfusion® SfAutoComplete control for Xamarin.Android platform -platform : Xamarin.Android -control : SfAutoComplete -documentation : ug +layout: post +title: Syncfusion® AutoComplete Getting Started for Android +description: A quick tour and step-by-step guide for initial users to get started with Syncfusion® SfAutoComplete control implementation in Xamarin.Android +platform: xamarin.android +control: SfAutoComplete +documentation: ug --- # Getting Started -This section explains you the steps to configure a SfAutoComplete control in a real-time scenario and also provides a walk-through on some of the customization features available in SfAutoComplete control. +This section explains the steps to configure an SfAutoComplete control in a real-time scenario and also provides a walk-through on some of the customization features available in the SfAutoComplete control. ## Referencing 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 -Add the following assembly references to the Android project, +Add the following assembly reference to the Android project: android\Syncfusion.SfAutoComplete.Android.dll ### Add SfAutoComplete -The following steps helps to add a SfAutoComplete control through code. +The following steps help to add an SfAutoComplete control through code. * Adding namespace for the added assemblies. @@ -59,9 +59,9 @@ SetContentView(linearLayout); ## Add Items -A list of string with country names are created and added to auto complete source. This list will be populated as suggestion list by setting the `AutoCompleteSource` property based on text entry . +A list of strings with country names is created and added to the AutoComplete source. This list will be populated as a suggestion list by setting the `AutoCompleteSource` property based on text entry. -You can set the suggestion list to the SfAutoComplete using the property `AutoCompleteSource`. Add the AutoCompleteSource for the SfAutoComplete as follows. +You can set the suggestion list to the SfAutoComplete using the `AutoCompleteSource` property. Add the AutoCompleteSource for the SfAutoComplete as follows: {% tabs %} @@ -94,9 +94,9 @@ SetContentView(linearLayout); ## Set Filter Mode -Filters can be applied to the displayed items based on starting letter. We can also append the first item from the suggested list to the TextBox. This can be done by using the `SuggestionMode` and `AutoCompleteMode` properties in SfAutoComplete control. +Filters can be applied to the displayed items based on the starting letter. You can also append the first item from the suggested list to the TextBox. This can be achieved by using the `SuggestionMode` and `AutoCompleteMode` properties in the SfAutoComplete control. -The following example shows the SfAutoComplete control which suggest the country list starting with the letter U. +The following example shows the SfAutoComplete control which suggests countries from the list starting with the letter "U": {% tabs %} @@ -132,13 +132,12 @@ SetContentView(linearLayout); {% endtabs %} -![](images/gettingstarted.png) - -## Creating AutoComplete control in AXML layout +![AutoComplete getting started example](images/gettingstarted.png) +## Creating AutoComplete Control in AXML Layout Create a new blank application for Android using Visual Studio. Add reference to the required assemblies in the project. -Add the following code in the Main.axml file to include SfAutoComplete control. +Add the following code in the Main.axml file to include the SfAutoComplete control: {% tabs %} @@ -160,9 +159,9 @@ android:id="@+id/autocomplete" /> {% endtabs %} -Add the following code in MainActivity.cs file. +Add the following code in the MainActivity.cs file. -Declare an instance of SfAutoComplete to access the control and its properties. +Declare an instance of SfAutoComplete to access the control and its properties: {% tabs %} diff --git a/xamarin-android/SfAutoComplete/Header-and-Footer.md b/xamarin-android/SfAutoComplete/Header-and-Footer.md index a17a31fc0..86802d7d9 100644 --- a/xamarin-android/SfAutoComplete/Header-and-Footer.md +++ b/xamarin-android/SfAutoComplete/Header-and-Footer.md @@ -1,21 +1,21 @@ --- -layout : post -title: Header and Footer in Xamarin.Android SfAutoComplete Control|Syncfusion® +layout: post +title: Header and Footer in Syncfusion® SfAutoComplete Xamarin.Android description: Learn here about how to enable Header and Footer in Syncfusion® Essential® Xamarin.Android SfAutoComplete Control, its elements, and more. -platform: Xamarin.Android +platform: xamarin.android control: SfAutoComplete documentation: ug --- # Header and Footer in Xamarin.Android SfAutoComplete -We can provide Header and Footer content in the SfAutoComplete by enabling `ShowDropDownHeaderView` and `ShowDropDownFooterView`. +You can provide header and footer content in the SfAutoComplete by enabling `ShowDropDownHeaderView` and `ShowDropDownFooterView` properties. ## Header Content -We can provide Header Content at the top of the AutoComplete's Suggestion box. `DropDownHeaderView` property is used to set the content of the header. The height of the Header in the SfAutoComplete can be adjusted by the property `DropDownHeaderViewHeight`. +You can provide header content at the top of the AutoComplete suggestion box. The `DropDownHeaderView` property is used to set the content of the header. The height of the header in the SfAutoComplete can be adjusted using the `DropDownHeaderViewHeight` property. - The following code example illustrate how to set Header content in SfAutoComplete. +The following code example illustrates how to set header content in SfAutoComplete: {% tabs %} @@ -25,7 +25,7 @@ countryAutoComplete.ShowDropDownHeaderView = true; countryAutoComplete.DropDownItemHeight = 30; countryAutoComplete.DropDownTextSize = 16; -// set the Height for the HeaderView +// Set the height for the HeaderView countryAutoComplete.DropDownHeaderViewHeight = 50; @@ -46,9 +46,9 @@ countryAutoComplete.DropDownHeaderView = textView; ## Footer Content -We can provide Footer Content at the bottom of the AutoComplete's Suggestion box. `DropDownFooterView` property is used to set the content of the footer. The height of the Footer in the SfAutoComplete can be adjusted by the property `DropDownFooterViewHeight`. +You can provide footer content at the bottom of the AutoComplete suggestion box. The `DropDownFooterView` property is used to set the content of the footer. The height of the footer in the SfAutoComplete can be adjusted using the `DropDownFooterViewHeight` property. -The following code example illustrate how to set Footer content in SfAutoComplete. +The following code example illustrates how to set footer content in SfAutoComplete: {% tabs %} @@ -58,7 +58,7 @@ countryAutoComplete.ShowDropDownHeaderView = true; countryAutoComplete.DropDownItemHeight = 30; countryAutoComplete.DropDownTextSize = 16; -// set the Height for the FooterView +// Set the height for the FooterView countryAutoComplete.DropDownFooterViewHeight = 50; TextView textView = new TextView(this); @@ -75,7 +75,3 @@ countryAutoComplete.DropDownFooterView = textView; {% endtabs %} ![Xamarin.Android SfAutoComplete footer](images/Footer.png) - - - - \ No newline at end of file diff --git a/xamarin-android/SfAutoComplete/Maximum-display-item-with-Expander.md b/xamarin-android/SfAutoComplete/Maximum-display-item-with-Expander.md index 7a558025b..049277b63 100644 --- a/xamarin-android/SfAutoComplete/Maximum-display-item-with-Expander.md +++ b/xamarin-android/SfAutoComplete/Maximum-display-item-with-Expander.md @@ -1,15 +1,15 @@ --- -layout : post -title : LoadMore in Syncfusion® SfAutoComplete control for Xamarin.Android -description : Learn how to restrict maximum suggestion to be displayed in SfAutoComplete -platform : Xamarin.Android -control : SfAutoComplete -documentation : ug +layout: post +title: Max Display Items with Load More Syncfusion® SfAutoComplete +description: Learn how to restrict the maximum number of suggestions displayed in SfAutoComplete and implement load more functionality +platform: xamarin.android +control: SfAutoComplete +documentation: ug --- -# Maximum Display Item with Expander +# Maximum Display Items with Load More -Restrict the number of suggestions displayed and have the remaining items loaded by selecting LoadMore.We can restrict maximum suggestion to be displayed with the `MaximumSuggestion` property. We can set the desire text for the displaying the Load more text with the property `LoadMoreText`. +You can restrict the number of suggestions displayed and load the remaining items by selecting Load More. The maximum number of suggestions to be displayed can be restricted using the `MaximumSuggestion` property. You can set the desired text for displaying the Load More text using the `LoadMoreText` property. {% tabs %} @@ -23,20 +23,19 @@ countryAutoComplete.LoadMoreText="LOAD MORE"; {% endtabs %} -![](images/loadmore.png) +![Load More functionality example](images/loadmore.png) +## Restricting Maximum Display Items Dynamically -### Restricting the maximum display of item dynamically - -We can restrict the maximum display of items dynamically by calling `LoadMore` method. The user can dynamically change the maximum suggestion count by calling LoadMore method by giving the maximum suggestion as the argument inside. +You can restrict the maximum display of items dynamically by calling the `LoadMore` method. The maximum suggestion count can be changed dynamically by calling the LoadMore method with the maximum suggestion count as an argument. {% tabs %} {% highlight c# %} -// without passing arguments +// Without passing arguments autoComplete.LoadMore(); -// with passing arguments +// With passing arguments autoComplete.LoadMore(5); {% endhighlight %} diff --git a/xamarin-android/SfAutoComplete/Multiple-selection.md b/xamarin-android/SfAutoComplete/Multiple-selection.md index ab2140c27..fd670e96a 100644 --- a/xamarin-android/SfAutoComplete/Multiple-selection.md +++ b/xamarin-android/SfAutoComplete/Multiple-selection.md @@ -1,15 +1,15 @@ --- layout: post -title: Multipe Selection in Xamarin.Android SfAutoComplete | Syncfusion® +title: Multiple Selection in Xamarin.Android SfAutoComplete | Syncfusion® description: Learn how to select multiple items in Syncfusion® Essential® Xamarin.Android SfAutoComplete Control, its elements, and more. -platform: Xamarin.Android +platform: xamarin.android control: SfAutoComplete documentation: ug --- # Multiple Selection in Xamarin.Android SfAutoComplete -Select multiple items from a suggestion list. There are two ways to perform multi selection in autocomplete. +You can select multiple items from a suggestion list. There are two ways to perform multiple selection in AutoComplete: * Token Representation @@ -17,15 +17,14 @@ Select multiple items from a suggestion list. There are two ways to perform mult ## Token Representation -Selected items will be displayed with a customizable token representation and the users can remove each tokenized item with the close button. +Selected items will be displayed with customizable token representation, and users can remove each tokenized item using the close button. -### Wrap Mode of Token +### Wrap Mode of Tokens -The selected item can be displayed as token inside SfAutoComplete in two ways. They are +Selected items can be displayed as tokens inside SfAutoComplete in two ways: -* `Wrap` - When `TokensWrapMode` is set to `Wrap` the selected items will be wrap to the next line of the SfAutoComplete. - -* `None` - When `TokensWrapMode` is set to `None` the selected item will be wrap in horizontal orientation. +* `Wrap` - When `TokensWrapMode` is set to `Wrap`, the selected items will wrap to the next line of the SfAutoComplete. +* `None` - When `TokensWrapMode` is set to `None`, the selected items will be displayed in horizontal orientation. {% tabs %} @@ -89,24 +88,15 @@ SetContentView(linearLayout); ### Token Customization -Customization can be done for Token. There are various ways to customize the tokens. They are as follows. - -* `TextColor` - sets the color of the text inside the token. - -* `FontSize` - sets the size of the Font inside the token. - -* `FontFamily` - sets the Font family for the text inside the token. - -* `BackgroundColor` - sets the background color of the token. - -* `SelectedBackgroundColor` - sets the background color of the token when it is selected. - -* `IsCloseButtonVisible` - Enables and disables the close button inside SfAutoComplete. - -* `DeleteButtonColor` - sets the color of the close button inside SfAutoComplete. - -* `CornerRadius` - sets the corner radius for the token. - +Tokens can be customized in various ways. The available customization options are as follows: +* `TextColor` - Sets the color of the text inside the token. +* `FontSize` - Sets the size of the font inside the token. +* `FontFamily` - Sets the font family for the text inside the token. +* `BackgroundColor` - Sets the background color of the token. +* `SelectedBackgroundColor` - Sets the background color of the token when it is selected. +* `IsCloseButtonVisible` - Enables and disables the close button inside the token. +* `DeleteButtonColor` - Sets the color of the close button inside the token. +* `CornerRadius` - Sets the corner radius for the token. {% tabs %} @@ -131,7 +121,7 @@ employeeAutoComplete.TokenSettings = token; ## Delimiter -When selecting the multiple items, the selected items can be divided with a desired character given for a delimiter. We can set delimiter character with the `Delimiter` property. +When selecting multiple items, the selected items can be separated using a desired delimiter character. You can set the delimiter character using the `Delimiter` property. {% tabs %} @@ -151,3 +141,4 @@ countryAutoComplete.Delimiter="#"; + diff --git a/xamarin-android/SfAutoComplete/No-Result-Found.md b/xamarin-android/SfAutoComplete/No-Result-Found.md index fa1dae123..5661156cf 100644 --- a/xamarin-android/SfAutoComplete/No-Result-Found.md +++ b/xamarin-android/SfAutoComplete/No-Result-Found.md @@ -1,15 +1,15 @@ --- -layout : post -title : No Result Found Text in Syncfusion® SfAutoComplete control for Xamarin.Android -description : Learn how to display the no result found text in SfAutoComplete -platform : Xamarin.Android -control : SfAutoComplete -documentation : ug +layout: post +title: Syncfusion® SfAutoComplete No Results Found Text Android +description: Learn how to display and customize the no results found text in SfAutoComplete control when search queries return no matching results. +platform: xamarin.android +control: SfAutoComplete +documentation: ug --- # No Results Found -When the entered item is not in the suggestion list, SfAutoComplete displays a text indicating there is no search results found. We can set the desire text to be displayed for indicating no results found with the `NoResultsFoundText` property. +When the entered item is not in the suggestion list, SfAutoComplete displays text indicating that no search results were found. You can set the desired text to be displayed when no results are found using the `NoResultsFoundText` property. {% tabs %} @@ -21,11 +21,12 @@ countryAutoComplete.NoResultsFoundText="No Results Found"; {% endtabs %} -![NoResultsFound](images/NoResultsFound.png) +![No results found example](images/NoResultsFound.png) -## Customizing NoResultsFoundText +## Customizing No Results Found Text + +The `NoResultsFoundTextColor`, `NoResultsFoundFontSize`, and `NoResultsFoundTypeface` properties are used to customize the foreground color, font size, and typeface of the no results found text. -The `NoResultsFoundTextColor`, `NoResultsFoundFontSize` and `NoResultsFoundTypeface` properties are used to customize the foreground color, font size and typeface of NoResultsFoundText. {% tabs %} {% highlight c# %} @@ -39,4 +40,4 @@ countryAutoComplete.NoResultsFoundTypeface = Typeface.CreateFromAsset(this.Asset {% endtabs %} -![NoResultsFound_Customization](images/NoResultsFound_Customization.jpg) \ No newline at end of file +![No results found customization example](images/NoResultsFound_Customization.jpg) diff --git a/xamarin-android/SfAutoComplete/Overview.md b/xamarin-android/SfAutoComplete/Overview.md index dcb5f18f9..def5141dd 100644 --- a/xamarin-android/SfAutoComplete/Overview.md +++ b/xamarin-android/SfAutoComplete/Overview.md @@ -1,7 +1,7 @@ --- layout: post -title: Overview of Syncfusion® AutoComplete control for Xamarin.Android -description: This explains about the Overview and key features of Syncfusion® Essential® Xamarin.Android SfAutoComplete control +title: Overview of Syncfusion® AutoComplete Control for Xamarin.Android +description: This section provides an overview and key features of the Syncfusion® Essential® Xamarin.Android SfAutoComplete control platform: xamarin.android control: SfAutoComplete documentation: ug @@ -9,32 +9,30 @@ documentation: ug # Overview -The Essential® Xamarin.Android AutoComplete widget provides the suggestions while typing. The suggested text can be appended to the original text or it can be displayed in a drop-down list. Also provides a gesture friendly UI to perform operations like Suggest, Append and SuggestAppend. +The Essential® Xamarin.Android AutoComplete widget provides suggestions while typing. The suggested text can be appended to the original text or displayed in a dropdown list. It also provides a gesture-friendly UI to perform operations like Suggest, Append, and SuggestAppend. -Essential® AutoComplete can be used in any search box. +The Essential® AutoComplete can be used in any search scenario. ![Xamarin.Android AutoComplete Overview](images/overview.png) ## Key Features -* `Watermark` - The control shows the watermark text. +* `Watermark` - The control displays watermark text when no input is provided. -* `Autocomplete Mode` - The control provides suggestions based on a predefined collection while typing. +* `AutoComplete Mode` - The control provides suggestions based on a predefined collection while typing. -* `Suggestion Mode` - The suggestions list can be displayed with 8 types of search pattern. +* `Suggestion Mode` - The suggestion list can be displayed with multiple types of search patterns. * `AutoCompleteSource` - A list of strings that is loaded to the control for displaying suggestions. -* `Multiple Selection` - AutoComplete provides 2 different ways to select multiple items from the suggestion list. They are using Token representation and Delimiter. +* `Multiple Selection` - AutoComplete provides two different ways to select multiple items from the suggestion list: Token representation and Delimiter. -* `Load More` - Restrict the number of suggestions displayed and have the remaining items loaded by selecting LoadMore. +* `Load More` - Restricts the number of suggestions displayed and allows loading remaining items by selecting Load More. -* `Header and Footer` - Header and Footer content can be given in the top and bottom of the Suggestion list in SfAutoComplete. +* `Header and Footer` - Header and footer content can be added to the top and bottom of the suggestion list in SfAutoComplete. -* `Diacritic Sense` - AutoComplete provides populating the items from a language with letters containing diacritics, and search for them with English characters from an en-US keyboard. - -* `Highlighting Text` - AutoComplete provides highlighting the matching text in the Suggestion list based on the input given in it. - -* `Custom filter` - AutoComplete provides the user to filter the item in the Suggestion list based on their filtering condition. +* `Diacritic Sensitivity` - AutoComplete supports populating items from languages with diacritical marks and searching for them with English characters from an en-US keyboard. +* `Text Highlighting` - AutoComplete supports highlighting matching text in the suggestion list based on the input provided. +* `Custom Filter` - AutoComplete allows users to filter items in the suggestion list based on their custom filtering conditions. diff --git a/xamarin-android/SfAutoComplete/Populating-Items.md b/xamarin-android/SfAutoComplete/Populating-Items.md index a83f27a6d..3487e8085 100644 --- a/xamarin-android/SfAutoComplete/Populating-Items.md +++ b/xamarin-android/SfAutoComplete/Populating-Items.md @@ -1,19 +1,19 @@ --- layout: post -title: Populating Items in Xamarin.Android SfAutoComplete Control| Syncfusion® +title: Syncfusion® SfAutoComplete Populating Items for Android description: Learn here about Populating Items in Syncfusion® Essential® Xamarin.Android SfAutoComplete Control, its elements, and more. -platform: Xamarin.Android +platform: xamarin.android control: SfAutoComplete documentation: ug --- # Populating Items in Xamarin.Android SfAutoComplete -* The `AutoCompleteSource` property in the SfAutoComplete control is used to set the list of strings to the suggestions dropdown using DataAdapter. +The `AutoCompleteSource` property in the SfAutoComplete control is used to set the list of strings for the suggestion dropdown using a DataAdapter. -* To create a Text Box that automatically completes input strings by comparing the prefix being entered to the prefixes of all strings in a maintained source. This is useful for Text Box controls in which URLs, addresses, file names, or commands will be frequently entered. +The AutoComplete functionality creates a text input that automatically completes input strings by comparing the entered prefix to the prefixes of all strings in the data source. This is useful for text input controls where URLs, addresses, file names, or commands are frequently entered. -* The use of this is optional, but you must set this to Custom Source in order to use `AutoCompleteCustomSource`. +Setting the AutoCompleteSource is optional, but it must be configured to use custom data sources with the `AutoCompleteCustomSource` property. {% tabs %} diff --git a/xamarin-android/SfAutoComplete/Suggestion-Display-Mode.md b/xamarin-android/SfAutoComplete/Suggestion-Display-Mode.md index 21e41e983..ccbdd90a1 100644 --- a/xamarin-android/SfAutoComplete/Suggestion-Display-Mode.md +++ b/xamarin-android/SfAutoComplete/Suggestion-Display-Mode.md @@ -1,15 +1,15 @@ --- -layout : post -title: AutoComplete mode in Xamarin.Android SfAutoComplete Control|Syncfusion® +layout: post +title: SfAutoComplete Suggestion Display Mode Syncfusion® Android description: Learn here about Suggestion Display Mode in Syncfusion® Essential® Xamarin.Android SfAutoComplete Control, its elements, and more. -platform: Xamarin.Android +platform: xamarin.android control: SfAutoComplete documentation: ug --- # Suggestion Display Mode in Xamarin.Android SfAutoComplete -The `AutocompleteMode` property is used to decide the suggestion pattern for displaying the filtered data according to the text entered. The different types of pattern are described below +The `AutoCompleteMode` property is used to determine the suggestion pattern for displaying the filtered data according to the text entered. The different types of patterns are described below: * Suggest @@ -17,11 +17,11 @@ The `AutocompleteMode` property is used to decide the suggestion pattern for dis * Suggest and Append -N> The default option is suggest mode. +N> The default mode is Suggest. ## Append -* Append - It appends the first matching string with the entered character. +Appends the first matching string to the entered text. {% tabs %} @@ -35,7 +35,7 @@ countryAutoComplete.AutoCompleteMode = AutoCompleteMode.Append; ## Suggest in Dropdown -* Suggest - It displays the suggestion in the dropdown. +Displays suggestions in the dropdown. {% tabs %} @@ -47,10 +47,9 @@ countryAutoComplete.AutoCompleteMode = AutoCompleteMode.Suggest; {% endtabs %} -## Both Append and Suggest in DropDown - -* SuggestAppend - It displays the suggestion in the dropdown along with appending the first matching string. +## Suggest and Append +Displays suggestions in the dropdown and appends the first matching string to the entered text. {% tabs %} {% highlight C# %} @@ -63,3 +62,4 @@ countryAutoComplete.AutoCompleteMode = AutoCompleteMode.SuggestAppend; ![Xamarin.Android SfAutoComplete autocomplete mode](images/autocompletemode.png) + diff --git a/xamarin-android/SfAutoComplete/Various-Filter-Options-for-Suggestion.md b/xamarin-android/SfAutoComplete/Various-Filter-Options-for-Suggestion.md index 19645e905..3195e42e3 100644 --- a/xamarin-android/SfAutoComplete/Various-Filter-Options-for-Suggestion.md +++ b/xamarin-android/SfAutoComplete/Various-Filter-Options-for-Suggestion.md @@ -1,19 +1,19 @@ --- -layout : post -title : Suggestion mode for Syncfusion® AutoComplete Control in Xamarin.Android -description : Learn how to display suggestion mode in SfAutoComplete -platform : Xamarin.Android -control : SfAutoComplete -documentation : ug +layout: post +title: Syncfusion® AutoComplete Filter Options for Suggestion +description: Learn how to configure various filter options and suggestion modes in SfAutoComplete control to enhance search functionality and user experience. +platform: xamarin.android +control: SfAutoComplete +documentation: ug --- # Various Filter Options for Suggestion -By default, the items that matches with the starting letter will be displayed as suggestion. This phenomenon can be changed using `SuggestionMode` property, which provides various option to filter the data according to the text entered. There are eight types of suggestion modes and are described as follows. +By default, items that match the starting letter will be displayed as suggestions. This behavior can be changed using the `SuggestionMode` property, which provides various options to filter the data according to the text entered. There are eight types of suggestion modes, which are described as follows: -## Words that Starts with Input Text +## Words that Start with Input Text -Displays the list of suggestions based on starting letter. +Displays the list of suggestions based on the starting letter. {% tabs %} @@ -25,11 +25,10 @@ Displays the list of suggestions based on starting letter. {% endtabs %} -![](images/startswith.png) - +![StartsWith filter mode example](images/startswith.png) ### Filter with Character Casing -Displays the list of suggestions based on starting letter with case sensitive. +Displays the list of suggestions based on the starting letter with case sensitivity. {% tabs %} @@ -41,11 +40,10 @@ Displays the list of suggestions based on starting letter with case sensitive. {% endtabs %} -![](images/startswithcasesensitive.png) - -## Words that Contains the Input Text +![StartsWith case sensitive filter mode example](images/startswithcasesensitive.png) +## Words that Contain the Input Text -Displays the list of suggestions, if autocomplete list contains that words. +Displays the list of suggestions if the AutoComplete list contains those words. {% tabs %} @@ -57,11 +55,10 @@ Displays the list of suggestions, if autocomplete list contains that words. {% endtabs %} -![](images/contains.png) - +![Contains filter mode example](images/contains.png) ### Filter with Character Casing -Displays the list of suggestions, if autocomplete list contains that words with case sensitive. +Displays the list of suggestions if the AutoComplete list contains those words with case sensitivity. {% tabs %} @@ -73,12 +70,10 @@ Displays the list of suggestions, if autocomplete list contains that words with {% endtabs %} -![](images/containswithcasesensitive.png) - -## Words that Equals to the Input Text - -Displays the word that matches. +![Contains case sensitive filter mode example](images/containswithcasesensitive.png) +## Words that Equal the Input Text +Displays words that exactly match the input text. {% tabs %} {% highlight C# %} @@ -89,11 +84,10 @@ Displays the word that matches. {% endtabs %} -![](images/equals.png) - +![Equals filter mode example](images/equals.png) ### Filter with Character Casing -Displays the word that matches with case sensitive. +Displays words that exactly match the input text with case sensitivity. {% tabs %} @@ -105,11 +99,10 @@ Displays the word that matches with case sensitive. {% endtabs %} -![](images/equalswithcasesensitive.png) +![Equals case sensitive filter mode example](images/equalswithcasesensitive.png) +## Words that End with Input Text -## Words that Ends with Input Text - -Displays the list of suggestions based on ending word. +Displays the list of suggestions based on the ending text. {% tabs %} @@ -121,11 +114,10 @@ Displays the list of suggestions based on ending word. {% endtabs %} -![](images/endswith.png) - +![EndsWith filter mode example](images/endswith.png) ### Filter with Character Casing -Displays the list of suggestions based on the ending word with case sensitive. +Displays the list of suggestions based on the ending text with case sensitivity. {% tabs %} @@ -137,12 +129,11 @@ countryAutoComplete.SuggestionMode = SuggestionMode.EndsWithCaseSensitive; {% endtabs %} -![](images/endswithcasesensitive.png) - +![EndsWith case sensitive filter mode example](images/endswithcasesensitive.png) +## Custom Filter -### Custom filter +Displays the list of suggestions based on custom filtering logic in the SfAutoComplete. -Displays the list of suggestions based on the custom words in the SfAutoComplete. {% tabs %} {% highlight C# %} @@ -153,7 +144,4 @@ countryAutoComplete.SuggestionMode = SuggestionMode.Custom; {% endtabs %} -![](images/customfilter.png) - - - +![Custom filter mode example](images/customfilter.png) diff --git a/xamarin-android/SfAutoComplete/Watermark.md b/xamarin-android/SfAutoComplete/Watermark.md index 2b568e24d..fa7c13f94 100644 --- a/xamarin-android/SfAutoComplete/Watermark.md +++ b/xamarin-android/SfAutoComplete/Watermark.md @@ -1,16 +1,15 @@ --- -layout : post -title : WaterMark in Syncfusion® AutoComplete Control for Xamarin.Android -description : Learn how to set the Watermark in SfAutoComplete -platform : Xamarin.Android -control : SfAutoComplete -documentation : ug +layout: post +title: Watermark in Syncfusion® AutoComplete for Xamarin.Android +description: Learn how to set and customize the watermark text in SfAutoComplete control to provide helpful placeholder guidance for users. +platform: xamarin.android +control: SfAutoComplete +documentation: ug --- # Watermark -This property is used to customize the watermark text that is displayed when the textbox is empty. - +The `Watermark` property is used to set placeholder text that is displayed when the text input is empty. This provides users with helpful hints about the expected input format or content. {% tabs %} {% highlight C# %} @@ -21,4 +20,4 @@ This property is used to customize the watermark text that is displayed when the {% endtabs %} -![](images/watermark.png) +![Watermark example in AutoComplete](images/watermark.png) diff --git a/xamarin-android/SfAutoComplete/highlighting-matched-text.md b/xamarin-android/SfAutoComplete/highlighting-matched-text.md index 1d81a5686..bbad53342 100644 --- a/xamarin-android/SfAutoComplete/highlighting-matched-text.md +++ b/xamarin-android/SfAutoComplete/highlighting-matched-text.md @@ -1,13 +1,13 @@ --- -layout : post -title: MatchHighlighting text in Syncfusion® SfAutoComplete control. -description: Learn on how to highlight the matched text in SfAutoComplete for Xamarin.Android and also understood the highlight the matching characters in suggestion list -platform : Xamarin.Android -control : SfAutoComplete -documentation : ug +layout: post +title: Highlighting Matched Text in Syncfusion® SfAutoComplete Control +description: Learn how to highlight matched text in SfAutoComplete for Xamarin.Android and understand how to highlight matching characters in the suggestion list +platform: xamarin.android +control: SfAutoComplete +documentation: ug --- -# Highlighting matched text +# Highlighting Matched Text Highlight matching characters in a suggestion list to pick an item with more clarity. There are two ways to highlight the matching text: @@ -16,15 +16,14 @@ Highlight matching characters in a suggestion list to pick an item with more cla * Multiple Occurrence -The text highlight can be indicated with various customizing styles by enabling the below properties. They are +Text highlighting can be customized with various styles using the following properties: -* HighlightedTextColor - sets the color of the highlighted text for differentiating the highlighted characters. - -* HighlightedTextFontTypeFace - sets the FontAttributes of the highlighted text. +* `HighlightedTextColor` - Sets the color of the highlighted text for differentiating the highlighted characters. +* `HighlightedTextFontTypeFace` - Sets the font attributes of the highlighted text. ## First Occurrence -It highlights the first position of the matching characters in the suggestion list. +This mode highlights the first position of the matching characters in the suggestion list. {% tabs %} @@ -39,14 +38,12 @@ countryAutoComplete.HighlightedTextFontTypeFace = TypefaceStyle.Bold; {% endtabs %} -N> The default Color of HighlightedTextColor is Red. - The default FontAttribute of HighlightedTextFontTypeFace is None. - +N> The default color of `HighlightedTextColor` is Red. The default font attribute of `HighlightedTextFontTypeFace` is None. ![First Occurrence AutoComplete Image](images/FirstOccurrence.png) ## Multiple Occurrence -It highlights the matching character that are present everywhere in the suggestion list for Contains case in SuggestionMode. +This mode highlights the matching characters that are present everywhere in the suggestion list for Contains case in SuggestionMode. {% tabs %} @@ -65,3 +62,4 @@ countryNameAutoComplete.HighlightedTextFontTypeFace = TypefaceStyle.Bold; + diff --git a/xamarin-android/SfBusyIndicator/AnimationType.md b/xamarin-android/SfBusyIndicator/AnimationType.md index bf9beca03..88cf6b4ae 100644 --- a/xamarin-android/SfBusyIndicator/AnimationType.md +++ b/xamarin-android/SfBusyIndicator/AnimationType.md @@ -1,16 +1,15 @@ --- layout: post -title: AnimationTypes in Syncfusion® BusyIndicator control for Xamarin.Android -description: Learn various animation types in SfBusyIndicator -platform: Xamarin.Android +title: AnimationTypes in Syncfusion® BusyIndicator for Xamarin.Android +description: Learn various animation types in SfBusyIndicator control and how to customize visual loading effects +platform: xamarin.android control: SfBusyIndicator documentation: ug --- # AnimationType -The `AnimationType` property of SfBusyIndicator allows to set anyone of the animation from the built-in animations as a SfBusyIndicator. - +The `AnimationType` property of SfBusyIndicator allows you to set any of the built-in animations for the SfBusyIndicator control. This property provides various predefined animation styles to enhance the visual appeal of the loading indicator. {% tabs %} {% highlight c# %} @@ -24,5 +23,6 @@ The `AnimationType` property of SfBusyIndicator allows to set anyone of the anim N> For getting animation types of SfBusyIndicator, need to add the `using Com.Syncfusion.Sfbusyindicator.Enums` namespace. -![](images/Ball.png) +![Image of Ball animation type](images/Ball.png) + diff --git a/xamarin-android/SfBusyIndicator/Getting-Started.md b/xamarin-android/SfBusyIndicator/Getting-Started.md index 0b1124938..094dac0d0 100644 --- a/xamarin-android/SfBusyIndicator/Getting-Started.md +++ b/xamarin-android/SfBusyIndicator/Getting-Started.md @@ -1,31 +1,31 @@ --- layout: post -title: Getting Started with Xamarin.Android BusyIndicator Control| Syncfusion® +title: Getting Started with Syncfusion® BusyIndicator for Android description: Learn here about Getting Started with Syncfusion® Essential® Xamarin.Android BusyIndicator Control, its elements, and more. -platform: Xamarin.Android +platform: xamarin.android control: SfBusyIndicator documentation: ug --- # Getting Started with Xamarin.Android BusyIndicator -This section explains you the steps to configure a SfBusyIndicator control in a real-time scenario and also provides a walk-through on some of the customization features available in SfBusyIndicator control. +This section explains the steps to configure a SfBusyIndicator control in a real-time scenario and provides a walk-through of some customization features available in the SfBusyIndicator control. ## Referencing 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 -Add the following assembly references to the Android project, +Add the following assembly reference to the Android project: android\Syncfusion.SfBusyIndicator.Android.dll ## Add SfBusyIndicator -The following steps helps to add a SfBusyIndicator control through code. +The following steps help you add a SfBusyIndicator control through code. -* Adding namespace for the added assemblies. +* Add the namespace for the added assemblies. {% tabs %} @@ -37,7 +37,7 @@ using Com.Syncfusion.SfBusyIndicator; {% endtabs %} -* Now add the SfBusyIndicator control with a required optimal name by using the included namespace. +* Now add the SfBusyIndicator control with the required optimal name using the included namespace. {% tabs %} @@ -52,9 +52,9 @@ SetContentView(busyIndicator); ## Setting Animation Type -SfBusyIndicator provides 10 predefined animation types like Ball, Battery, Globe and so on. User can select any one of the animation types using AnimationType property. +SfBusyIndicator provides 10 predefined animation types such as Ball, Battery, Globe, and more. You can select any one of the animation types using the `AnimationType` property. -Following example depicts the battery type animation for SfBusyIndicator. +The following example demonstrates the battery type animation for SfBusyIndicator: {% tabs %} @@ -67,9 +67,9 @@ busyIndicator.AnimationType = AnimationTypes.Battery; {% endtabs %} -## Configure the Properties in SfBusyIndicator +## Configure Properties in SfBusyIndicator -User can customize the height, width and TextColor properties in SfBusyIndicator as follows. +You can customize the height, width, and text color properties in SfBusyIndicator as follows: {% tabs %} diff --git a/xamarin-android/SfBusyIndicator/Make-Busy-Animation-Idle.md b/xamarin-android/SfBusyIndicator/Make-Busy-Animation-Idle.md index 37c3ca91b..08f91b15f 100644 --- a/xamarin-android/SfBusyIndicator/Make-Busy-Animation-Idle.md +++ b/xamarin-android/SfBusyIndicator/Make-Busy-Animation-Idle.md @@ -1,15 +1,15 @@ --- layout: post -title: IsBusy support in Syncfusion® BusyIndicator control for Xamarin.Android -description: Learn how to enable and disable animation in BusyIndicator -platform: Xamarin.Android +title: IsBusy support in Syncfusion® BusyIndicator for Xamarin.Android +description: Learn how to enable and disable animation in BusyIndicator control to manage loading states effectively +platform: xamarin.android control: SfBusyIndicator documentation: ug --- # Make Busy Animation Idle -SfBusyIndicator control provides support to determine whether an animation needs to be executed or not. Setting the `IsBusy` property to false will stop the animation and removes the control from view. +The SfBusyIndicator control provides support to control whether the animation should be running. The `IsBusy` property determines the visibility and animation state of the busy indicator. {% tabs %} @@ -23,9 +23,10 @@ SfBusyIndicator control provides support to determine whether an animation needs {% endtabs %} -![](images/IsBusy_img1.png) +![IsBusy Image](images/IsBusy_img1.png) BusyIndicator {:.caption} + diff --git a/xamarin-android/SfBusyIndicator/Overview.md b/xamarin-android/SfBusyIndicator/Overview.md index 2db844ce3..76ee1913b 100644 --- a/xamarin-android/SfBusyIndicator/Overview.md +++ b/xamarin-android/SfBusyIndicator/Overview.md @@ -1,18 +1,17 @@ --- layout: post title: Overview of Syncfusion® BusyIndicator for Xamarin.Android -description: Overview and key features of BusyIndicator control -platform: Xamarin.Android -control: BusyIndicator +description: Overview and key features of BusyIndicator control for displaying loading states and progress animations +platform: xamarin.android +control: SfBusyIndicator documentation: ug --- # SfBusyIndicator -SfBusyIndicator makes it easy to let the user know when an application is busy. Simply wrap the relevant content in an instance of the SfBusyIndicator control and toggle its `IsBusy` property to True during any long-running process. The busy indicator should be used to indicate activity while content is being loaded or the UI is blocked waiting for a resource to become available. - -![](images/overview.png) +The SfBusyIndicator control makes it easy to let users know when an application is busy. Simply wrap the relevant content in an instance of the SfBusyIndicator control and toggle its `IsBusy` property to `true` during any long-running process. The busy indicator should be used to indicate activity while content is being loaded or the UI is blocked waiting for a resource to become available. +![SfBusyIndicator overview](images/overview.png) ## Key Features * `IsBusy` – The control shows the animation when this property is set. @@ -22,3 +21,4 @@ SfBusyIndicator makes it easy to let the user know when an application is busy. + diff --git a/xamarin-android/SfBusyIndicator/Set-Header.md b/xamarin-android/SfBusyIndicator/Set-Header.md index c2a3404eb..eda6b34c0 100644 --- a/xamarin-android/SfBusyIndicator/Set-Header.md +++ b/xamarin-android/SfBusyIndicator/Set-Header.md @@ -1,16 +1,15 @@ --- layout: post -title: Set title to the Syncfusion® BusyIndicator control for Xamarin.Android -description: Learn how to set title and fontface to BusyIndicator control -platform: Xamarin.Android +title: Set header to the Syncfusion® BusyIndicator for Xamarin.Android +description: Learn how to set header text and customize font properties for the BusyIndicator control in Xamarin.Android +platform: xamarin.android control: SfBusyIndicator documentation: ug --- # Set Header -SfBusyIndicator provides option to set the text that indicates the information related to loading. This can be done using `Title` property. - +The SfBusyIndicator control provides an option to display informative text that indicates the current loading status. You can set this header text using the `Title` property to provide users with context about the ongoing operation. {% tabs %} {% highlight c# %} @@ -23,15 +22,14 @@ SfBusyIndicator provides option to set the text that indicates the information r {% endtabs %} -![](images/Title_img1.png) +![Image showing BusyIndicator with header text](images/Title_img1.png) -BusyIndicator with title +BusyIndicator with header text {:.caption} ## FontFace -User can modify the Font style and Font size of the title which is displayed beneath the animation. `FontFace` property can be used to modify these settings. - +You can customize the font style and size of the header text that appears beneath the animation. Use the `FontFace` property to modify the typography settings and enhance the visual appearance of your loading indicator. {% tabs %} {% highlight c# %} @@ -45,8 +43,9 @@ User can modify the Font style and Font size of the title which is displayed ben {% endtabs %} -![](images/Title_img2.png) +![Image showing BusyIndicator with custom header text](images/Title_img2.png) -BusyIndicator with font face +BusyIndicator with custom font face {:.caption} + diff --git a/xamarin-android/SfBusyIndicator/Sizing.md b/xamarin-android/SfBusyIndicator/Sizing.md index 753afa119..3d00d5b48 100644 --- a/xamarin-android/SfBusyIndicator/Sizing.md +++ b/xamarin-android/SfBusyIndicator/Sizing.md @@ -1,16 +1,15 @@ --- layout: post -title: Sizing support in Syncfusion® BusyIndicator control for Xamarin.Android -description: Learn how to customize the size of the animation type -platform: Xamarin.Android +title: Sizing support in Syncfusion® BusyIndicator for Xamarin.Android +description: Learn how to customize the size and dimensions of the BusyIndicator animation control for optimal display across different screen sizes and layouts. +platform: xamarin.android control: SfBusyIndicator documentation: ug --- # Sizing -Drawing size can be customized in SfBusyIndicator. `ViewBoxHeight` and `ViewBoxWidth` properties can be used to set height and width of the SfBusyIndicator. - +You can customize the display size of the SfBusyIndicator control to fit your application's layout requirements. The `ViewBoxHeight` and `ViewBoxWidth` properties allow you to set the height and width dimensions of the animation area, giving you precise control over how the busy indicator appears in your user interface. {% tabs %} {% highlight c# %} @@ -24,7 +23,8 @@ busyIndicator.ViewBoxHeight=200; {% endtabs %} -![](images/Sizing_img1.png) +![Image of BusyIndicator customization](images/Sizing_img1.png) ViewBox height and width {:.caption} + diff --git a/xamarin-android/SfBusyIndicator/images/Ball.png b/xamarin-android/SfBusyIndicator/images/Ball.png index 655cb216f..c86cef49b 100644 Binary files a/xamarin-android/SfBusyIndicator/images/Ball.png and b/xamarin-android/SfBusyIndicator/images/Ball.png differ diff --git a/xamarin-android/SfCarousel/Linear-Arrangement.md b/xamarin-android/SfCarousel/Linear-Arrangement.md index 3a90db00b..44e93bc5a 100644 --- a/xamarin-android/SfCarousel/Linear-Arrangement.md +++ b/xamarin-android/SfCarousel/Linear-Arrangement.md @@ -1,15 +1,15 @@ --- -layout : post -title : Overview of Syncfusion® Carousel control for Xamarin.Forms -description : Overview and key features of Carousel control -platform : Xamarin -control : Carousel -documentation : ug +layout: post +title: Linear Arrangement in Syncfusion® Carousel control for Xamarin.Android +description: Learn how to arrange carousel items in linear layout using ViewMode property in Xamarin.Android platform +platform: xamarin.android +control: SfCarousel +documentation: ug --- # Linear Arrangement -The Carousel items can be populated in the view in a stacked linear layout by setting the `ViewMode` property to Linear. The present option is `Default`. +The Carousel items can be arranged in a stacked linear layout by setting the `ViewMode` property to `Linear`. The default option is `Default`, which displays items in the standard carousel arrangement. {% highlight C# %} @@ -18,9 +18,7 @@ carousel.ViewMode = ViewMode.Linear; {% endhighlight %} -N> It is important to include Xamarin.Android.Support.v17.Leanback library to use carousel linear mode in Android platform. - -![](images/linear.png) - +N> It is important to include the Xamarin.Android.Support.v17.Leanback library to use the carousel linear mode on the Android platform. +![Linear arrangement](images/linear.png) diff --git a/xamarin-android/SfCarousel/animation.md b/xamarin-android/SfCarousel/animation.md index 5024afdcd..f32d51c4f 100644 --- a/xamarin-android/SfCarousel/animation.md +++ b/xamarin-android/SfCarousel/animation.md @@ -1,16 +1,15 @@ --- -layout : post -title : Setting the duration for animation in Syncfusion® Carousel control in Xamarin.Android -description : Learn how to set the duration for animation in Carousel for Xamarin.Android -platform : Xamarin.Android -control : SfCarousel -documentation : ug +layout: post +title: Setting Syncfusion® Carousel animation duration in Xamarin.Android +description: Learn how to set the duration for animation in Carousel for Xamarin.Android and customize timing properties +platform: xamarin.android +control: SfCarousel +documentation: ug --- # Animation -The Duration property of the SfCarousel control is used to specify the time taken to move an item to the selected item position. The duration is specified in seconds. The default value is 300s. - +The Duration property of the SfCarousel control specifies the time taken for the animation when an item moves to the selected position. The duration is specified in milliseconds. The default value is 300 milliseconds. {% highlight C# %} SfCarousel carousel= new SfCarousel(this); @@ -18,3 +17,4 @@ SfCarousel carousel= new SfCarousel(this); carousel.Duration=500; {% endhighlight %} + diff --git a/xamarin-android/SfCarousel/getting-started.md b/xamarin-android/SfCarousel/getting-started.md index 18638aa96..ab11ec4b8 100644 --- a/xamarin-android/SfCarousel/getting-started.md +++ b/xamarin-android/SfCarousel/getting-started.md @@ -1,23 +1,23 @@ --- -layout : post -title : Getting Started with Syncfusion® Carousel Control for Xamarin.Android -description : A quick tour to initial users on Syncfusion® carousel control for Xamarin.Android platform. -platform : Xamarin.Android -control : SfCarousel -documentation : ug +layout: post +title: Getting Started with Syncfusion® Carousel Control for Xamarin.Android +description: A quick tour to initial users on Syncfusion® carousel control for Xamarin.Android platform and setup +platform: xamarin.android +control: SfCarousel +documentation: ug --- # Getting Started -This section explains you the steps to configure a SfCarousel control in a real-time scenario and also provides a walk-through on some of the customization features available in SfCarousel control. +This section explains the steps to configure a SfCarousel control in a real-time scenario and provides a walk-through of some customization features available in the SfCarousel control. ## Referencing 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\15.x.x.x\lib -Add the following assembly references to the Android project, +Add the following assembly references to the Android project: android\Syncfusion.SfCarousel.Android.dll @@ -27,7 +27,7 @@ Xamarin.Android.Support.v17.Leanback library (from NuGet Packages) ## Add SfCarousel -The SfCarousel control is configured entirely in C# code. The following steps explain on how to create a SfCarousel and configure its elements, +The SfCarousel control is configured entirely in C# code. The following steps explain how to create a SfCarousel and configure its elements: * Adding namespace for the added assemblies. @@ -37,7 +37,7 @@ using Com.Syncfusion.Carousel; {% endhighlight %} -* Now add the SfCarousel control with a required optimal name by using the included namespace. +* Now add the SfCarousel control with a required optimal name using the included namespace. {% highlight C# %} @@ -48,7 +48,7 @@ SetContentView(carousel); ## Set Gap between Items -SfCarousel provides option to set the distance between the items in the panel. This can be done by using the `Offset` property in SfCarousel control. +SfCarousel provides an option to set the distance between items in the panel. This can be accomplished using the `Offset` property in the SfCarousel control. {% highlight C# %} @@ -57,9 +57,9 @@ carousel.Offset=20; {% endhighlight %} -## Tilt Non Selected Items +## Tilt Non-Selected Items -Items in the SfCarousel control can be rotated in user defined angle. `RotationAngle` property is used to decide the angle in which items should be rotated. +Items in the SfCarousel control can be rotated at a user-defined angle. The `RotationAngle` property is used to specify the angle at which items should be rotated. {% highlight C# %} @@ -70,7 +70,7 @@ carousel.RotationAngle = 45; ## Setting DataSource -SfCarousel items can be populated with a collection of image data. For example, a user may want to create a SfCarousel control which will display a list of images. +SfCarousel items can be populated with a collection of image data. For example, you may want to create a SfCarousel control that displays a list of images. {% highlight c# %} @@ -88,10 +88,9 @@ carousel.DataSource = tempCollection; {% endhighlight %} +### Setting the height and width of carousel items -### Setting the height and width of carousel's Item - -`ItemHeight` and `ItemWidth` properties are used to change the height and width of carouselItem in carousel panel. +The `ItemHeight` and `ItemWidth` properties are used to change the height and width of carousel items in the carousel panel. {% highlight C# %} @@ -103,7 +102,7 @@ sfCarousel.ItemHeight=170; ## SelectedIndex -We can bring particular item to the center of the screen using `SelectedIndex` property in SfCarousel control. +You can bring a particular item to the center of the screen using the `SelectedIndex` property in the SfCarousel control. N> The `SelectedIndex` property will be 0 by default. @@ -114,6 +113,6 @@ carousel.SelectedIndex=2; {% endhighlight %} -![](images/carousel.png) +![Carousel](images/carousel.png) -You can find the complete getting started sample from this [Link](http://www.syncfusion.com/downloads/support/directtrac/general/ze/GettingStartedSampleCarousel39791457) \ No newline at end of file +You can find the complete getting started sample from this [Link](http://www.syncfusion.com/downloads/support/directtrac/general/ze/GettingStartedSampleCarousel39791457) diff --git a/xamarin-android/SfCarousel/how-to.md b/xamarin-android/SfCarousel/how-to.md index b810d8084..800edf73b 100644 --- a/xamarin-android/SfCarousel/how-to.md +++ b/xamarin-android/SfCarousel/how-to.md @@ -1,15 +1,15 @@ --- -layout : post -title : Interaction in Syncfusion® Carousel Control in Xamarin.Android. -description : Learn how to perform an operation while changing the carouselItem or Collection in Carousel for Xamarin.Android. -platform : Xamarin.Android -control : Carousel -documentation : ug +layout: post +title: Interaction in Syncfusion® Carousel Control in Xamarin.Android +description: Learn how to perform an operation while changing the carouselItem or Collection in Carousel for Xamarin.Android +platform: xamarin.android +control: SfCarousel +documentation: ug --- -# How to perform an operation while changing the carouselItem? +# How to perform an operation while changing the carousel item? -We can perform operation while changing the carouselItem using `SelectionChanged` event. SelectionChanged event returns the index changed SfCarouselItem. +You can perform an operation while changing the carousel item using the `SelectionChanged` event. The SelectionChanged event returns the SfCarouselItem with the changed index. {% highlight C# %} @@ -20,9 +20,9 @@ carousel.SelectionChanged += (object sender, SfCarousel.SelectionChangedEventArg {% endhighlight %} -# How to perform an operation while changing the collection of carousel? +## How to perform an operation while changing the collection of carousel? -We can perform operation while changing the collection of carousel using `ItemsCollectionChanged` event. ItemsCollectionChanged event returns changed collection of SfCarouselItem +You can perform an operation while changing the collection of carousel using the `ItemsCollectionChanged` event. The ItemsCollectionChanged event returns the changed collection of SfCarouselItem. {% highlight C# %} diff --git a/xamarin-android/SfCarousel/overview.md b/xamarin-android/SfCarousel/overview.md index 14f8e66fb..977dfea5c 100644 --- a/xamarin-android/SfCarousel/overview.md +++ b/xamarin-android/SfCarousel/overview.md @@ -3,19 +3,20 @@ layout: post title: Overview of Syncfusion® Carousel control for Xamarin.Android description: This explains about the Overview and key features of Syncfusion® Essential® Xamarin.Android Carousel Control platform: xamarin.android -control: Carousel +control: SfCarousel documentation: ug --- # Overview -Essential® SfCarousel control for Xamarin.Android is a user interface providing rich visual navigation experience of image data. Also provides efficient customization of items and interactive navigation features. +The Essential® SfCarousel control for Xamarin.Android is a user interface control that provides a rich visual navigation experience for image data. It also provides efficient customization of items and interactive navigation features, allowing developers to create engaging carousel interfaces for mobile applications. ![Xamarin.Android Carousel Overview](images/carousel.png) -## Key Features: +## Key Features * `Offset` - Options to specify the space between the unselected carousel items. * `Rotation Angle` - Support to rotate the items to a specified angle. * `Duration` - Options to specify the time taken to move an item to the selected item position. + diff --git a/xamarin-android/SfCarousel/populating-data.md b/xamarin-android/SfCarousel/populating-data.md index e053f991d..7bf9cddc3 100644 --- a/xamarin-android/SfCarousel/populating-data.md +++ b/xamarin-android/SfCarousel/populating-data.md @@ -2,18 +2,18 @@ layout: post title: Populating data in Syncfusion® Carousel control in Xamarin.Android description: Learn details about how to set the DataSource, set the customview, adapter support and selected index in Carousel for Xamarin.Android platform -platform: Xamarin.Android -control: Carousel +platform: xamarin.android +control: SfCarousel documentation: ug --- # Populating Data in Xamarin.Android Carousel (SfCarousel) -`DataSource` property is used to populate the collection of SfCarouselItem which can be either the collection of Image or custom view. +The `DataSource` property is used to populate the collection of SfCarouselItem, which can be either a collection of images or custom views. ## DataSource with collection of images -SfCarousel items can be populated with a collection of image data. For example, a user may wants to create a SfCarousel control which will display a list of images. +SfCarousel items can be populated with a collection of image data. For example, you may want to create a SfCarousel control that displays a list of images. {% highlight C# %} @@ -34,9 +34,9 @@ SetContentView(carousel); {% endhighlight %} -## DataSource with collection of custom view +## DataSource with collection of custom views -`ContentView` property used to populate with a collection of custom view. +The `ContentView` property is used to populate the carousel with a collection of custom views. {% highlight C# %} @@ -74,11 +74,11 @@ SetContentView(carousel); ## Adapter Support in Carousel control -Instead of giving the collection of desired SfCarouselItem, we can pass the single view which connects with some kind of DataSource. +Instead of providing a collection of SfCarouselItem objects, you can pass a single view that connects with a data source using the adapter pattern. ### Create an adapter class by inheriting CarouselAdapter -By extending the `CarouselAdapter` class, we can have Adapter support in Carousel with `getItemView` method. +By extending the `CarouselAdapter` class, you can implement adapter support in Carousel using the `GetItemView` method. {% highlight c# %} @@ -108,7 +108,7 @@ public class AdapterTestingClass:CarouselAdapter } {% endhighlight %} -### Way to use this adapter class into Carousel panel view +### Using the adapter class with Carousel {% highlight C# %} @@ -141,7 +141,7 @@ SetContentView(carousel); ## SelectedIndex -It gets or sets the Selected Item index value of SfCarousel control to bring the particular item to center of the screen. +The SelectedIndex property gets or sets the selected item index value of the SfCarousel control to bring a particular item to the center of the screen. N> The `SelectedIndex` property will be 0 by default. @@ -152,5 +152,4 @@ carousel.SelectedIndex=2; {% endhighlight %} - Load images from SD card or internal storage to carousel view sample available in this [link](https://github.com/SyncfusionExamples/how-to-load-image-from-sdcard-or-internal-storage-in-carousel-view-xamarin-android). - +You can find a sample for loading images from SD card or internal storage to carousel view at this [link](https://github.com/SyncfusionExamples/how-to-load-image-from-sdcard-or-internal-storage-in-carousel-view-xamarin-android). diff --git a/xamarin-android/SfCarousel/transformation.md b/xamarin-android/SfCarousel/transformation.md index 81e3f43c1..d5383a018 100644 --- a/xamarin-android/SfCarousel/transformation.md +++ b/xamarin-android/SfCarousel/transformation.md @@ -1,21 +1,21 @@ --- -layout : post -title : Transformation in Syncfusion® Carousel control in Xamarin.Android -description : Learn how to set the Transformation in Carousel for Xamarin.Android -platform : Xamarin.Android -control : Carousel -documentation : ug +layout: post +title: Transformation in Syncfusion® Carousel control in Xamarin.Android +description: Learn how to implement Transformation settings in Carousel control for Xamarin.Android and customize advanced visual effects and transitions. +platform: xamarin.android +control: SfCarousel +documentation: ug --- # Transformation -## Tilt Non Selected Items +## Tilt Non-Selected Items -The `RotationAngle` property in the SfCarousel control is used to rotate all the items in a specified angle. +The `RotationAngle` property in the SfCarousel control is used to rotate all items to a specified angle. -If the angle value is positive, then the rotation is in the clockwise direction. If the angle value is negative, the rotation is in the counterclockwise direction. +If the angle value is positive, the rotation is in the clockwise direction. If the angle value is negative, the rotation is in the counterclockwise direction. -N> This angle can also be specified from 0 to 360. +N> This angle can be specified from 0 to 360 degrees. {% highlight C# %} @@ -25,12 +25,11 @@ carousel.RotationAngle=40; {% endhighlight %} - -![](images/rotationangle.png) +![Rotation angle transformation](images/rotationangle.png) ## Set Gap between Unselected Items -Specify the distance between the items in SfCarousel panel using `Offset` property. +Specify the distance between items in the SfCarousel panel using the `Offset` property. N> The default value is 20. @@ -42,11 +41,11 @@ carousel.Offset=30; {% endhighlight %} -![](images/offset.png) +![Offset between items](images/offset.png) -## Set Gap between Selected Item and Unselected Item +## Set Gap between Selected Item and Unselected Items -Distance between the selected item and other items can be customized by using `SelectedItemOffset` property. +The distance between the selected item and other items can be customized using the `SelectedItemOffset` property. N> The default value is 0. @@ -60,7 +59,7 @@ carousel.SelectedItemOffset=5; ## Set Scaling for Carousel Items -The `ScaleOffset` property in the SfCarousel control is used to scale all the unselected items to the specified scale value. +The `ScaleOffset` property in the SfCarousel control is used to scale all unselected items to the specified scale value. {% highlight C# %} @@ -69,12 +68,11 @@ carousel.ScaleOffset=0.7f; {% endhighlight %} +![Scale offset transformation](images/scaleoffset.png) -![](images/scaleoffset.png) - -## Spacing between the Items in Linear mode +## Spacing between Items in Linear Mode -Spacing of all the items in Linear mode can be determined by using `ItemSpacing` property. +The spacing of all items in Linear mode can be determined using the `ItemSpacing` property. {% highlight C# %} diff --git a/xamarin-android/SfComboBox/ComboBox-Modes.md b/xamarin-android/SfComboBox/ComboBox-Modes.md index 5c503d9b4..19e965983 100644 --- a/xamarin-android/SfComboBox/ComboBox-Modes.md +++ b/xamarin-android/SfComboBox/ComboBox-Modes.md @@ -1,20 +1,18 @@ --- -layout : post -title : ComboBox modes for Syncfusion® ComboBox control in Xamarin.Android -description : Learn how to change the ComboBox modes in SfComboBox -platform : Xamarin.Android -control : SfComboBox -documentation : ug +layout: post +title: ComboBox Modes in Syncfusion® SfComboBox for Xamarin.Android +description: Learn how to configure and use different ComboBox modes in the Syncfusion SfComboBox control for Xamarin.Android applications +platform: xamarin.android +control: SfComboBox +documentation: ug --- -# ComboBox modes +# ComboBox Modes -The SfComboBox supports both editable and non-editable text boxes to choose selected items in given data source. Users can select an item from the suggestion list. - -## Editable combo box - -In editable mode, the combo box allows users to edit in the text box that shows the suggestion in drop-down list based on the input. +The Syncfusion SfComboBox control supports both editable and non-editable modes, providing flexibility in how users interact with the control. In both modes, users can select items from a dropdown list populated with data from a given data source. +## Editable ComboBox +In editable mode, the ComboBox allows users to type directly into the text input field. As users type, the control displays filtered suggestions in a dropdown list based on their input. This mode is ideal when you want to provide both selection and custom input capabilities. {% tabs %} {% highlight C# %} @@ -23,12 +21,11 @@ comboBox.IsEditableMode = true; {% endtabs %} -![](images/editable.png) +![Editable ComboBox](images/editable.png) -## Non-editable combo box - -Non-editable mode is used to prevent users from typing and allows them select from the drop-down list. +## Non-editable ComboBox +Non-editable mode restricts user input to selection only, preventing users from typing in the text field. Users can only choose from the predefined items in the dropdown list. This mode is suitable when you want to limit user choices to specific options and prevent custom input. {% tabs %} {% highlight C# %} @@ -37,5 +34,6 @@ comboBox.IsEditableMode = false; {% endtabs %} -![](images/noneditable.png) +![Non-editable ComboBox](images/noneditable.png) + diff --git a/xamarin-android/SfComboBox/Customizing.md b/xamarin-android/SfComboBox/Customizing.md index f7de5084c..5b0d8dbef 100644 --- a/xamarin-android/SfComboBox/Customizing.md +++ b/xamarin-android/SfComboBox/Customizing.md @@ -1,20 +1,18 @@ --- -layout : post -title : UI Customization for Syncfusion® ComboBox Control in Xamarin.Android -description : Learn how to use customization in SfComboBox -platform : Xamarin.Android -control : SfComboBox -documentation : ug +layout: post +title: UI Customization for Syncfusion® SfComboBox in Xamarin.Android +description: Learn how to customize the appearance and styling of the Syncfusion SfComboBox control, including entry field, dropdown, buttons, and watermark customization +platform: xamarin.android +control: SfComboBox +documentation: ug --- -# UI customization +# UI Customization -The combo box control provides user-friendly customizing options for both entry part and drop-down part. This section explains how to customize the entire combo box control. - -## Customizing the entry - -The `TextColor`, `TextSize`, `FontAttributes`, `FontFamily` and `BorderColor` properties are used to customize the foreground color, font size, font attribute, font family, and border color of the entry part. +The Syncfusion SfComboBox control provides comprehensive customization options for both the entry field and dropdown components. This section demonstrates how to customize the visual appearance of the entire ComboBox control to match your application's design requirements. +## Customizing the Entry Field +The entry field appearance can be customized using properties such as `TextColor`, `TextSize`, `FontTypeface`, and `BorderColor` to modify the text color, font size, font style, and border color respectively. {% tabs %} {% highlight C# %} @@ -36,13 +34,13 @@ SetContentView(linearLayout); {% endtabs %} -![Customizing entry](images/customizingentry.png) +![Customized entry field appearance](images/customizingentry.png) -## Customizing the suggestion box +## Customizing the Dropdown -### Changing suggestion item height +### Changing Dropdown Item Height -The `DropDownItemHeight` property is used to modify the height of suggestion items in the drop-down list. The following code example shows this: +The `DropDownItemHeight` property allows you to modify the height of individual items in the dropdown list, providing better visual spacing and improved readability. {% tabs %} @@ -59,12 +57,11 @@ comboBox.DropDownItemHeight = 70; {% endtabs %} -![Suggestion item height](images/suggestionitemheight.png) +![Custom dropdown item height](images/suggestionitemheight.png) -### Changing the border color of suggestion box - -The DropDownBorderColor property is used to change the border color of suggestion box. The following code example demonstrates how to change the border color of suggestion box. +### Changing the Dropdown Border Color +The `DropDownBorderColor` property customizes the border color of the dropdown container, allowing you to match your application's color scheme. {% tabs %} {% highlight C# %} @@ -189,3 +186,4 @@ comboBox.WatermarkColor= Color.ParseColor("#1976d2"); + diff --git a/xamarin-android/SfComboBox/Dealing-with-SuggestionBox.md b/xamarin-android/SfComboBox/Dealing-with-SuggestionBox.md index 32b40a544..48a40eddc 100644 --- a/xamarin-android/SfComboBox/Dealing-with-SuggestionBox.md +++ b/xamarin-android/SfComboBox/Dealing-with-SuggestionBox.md @@ -1,25 +1,24 @@ --- -layout : post -title : Suggestionbox Placement in Syncfusion® SfComboBox control for Xamarin.Android -description : Learn how to place the Suggestion Box in SfComboBox -platform : Xamarin.Android -control : ComboBox -documentation : ug +layout: post +title: Suggestion Box Placement in Syncfusion® SfComboBox for Xamarin.Android +description: Learn how to configure and control the placement of the suggestion box in the Syncfusion SfComboBox control for optimal user experience +platform: xamarin.android +control: SfComboBox +documentation: ug --- -# Dealing with suggestion box -In the combobox control, the DropDown Box can placed in the following two positions: +# Suggestion Box Placement -* Bottom +The Syncfusion SfComboBox control provides flexible positioning options for the suggestion box (dropdown) to ensure optimal user experience across different screen layouts and orientations. The suggestion box can be positioned in two locations relative to the ComboBox control: -* Top +* **Bottom** - Displays below the ComboBox (default behavior) +* **Top** - Displays above the ComboBox -Using the `SuggestionBoxPlacement` property, you can place the suggestion box at the top or bottom. +The `SuggestionBoxPlacement` property allows you to explicitly control where the suggestion box appears, ensuring it remains visible and accessible. -## SuggestionBox placement at bottom +## Bottom Placement -Displays the suggestion box at the bottom of the combo box control. - +Bottom placement displays the suggestion box below the ComboBox control. This is the default behavior. {% tabs %} {% highlight c# %} @@ -28,12 +27,11 @@ combobox.SuggestionBoxPlacement = SuggestionBoxPlacement.Bottom; {% endhighlight %} {% endtabs %} -![](images/bottom.png) +![Suggestion box positioned at bottom](images/bottom.png) -## SuggestionBox placement at top +## Top Placement -Displays the suggestion box at the top of the combo box control. - +Top placement displays the suggestion box above the ComboBox control. {% tabs %} {% highlight c# %} @@ -42,4 +40,4 @@ combobox.SuggestionBoxPlacement = SuggestionBoxPlacement.Top; {% endhighlight %} {% endtabs %} -![](images/top.png) \ No newline at end of file +![Suggestion box positioned at top](images/top.png) diff --git a/xamarin-android/SfComboBox/Filtering-Option.md b/xamarin-android/SfComboBox/Filtering-Option.md index cab274d87..82e0e01f4 100644 --- a/xamarin-android/SfComboBox/Filtering-Option.md +++ b/xamarin-android/SfComboBox/Filtering-Option.md @@ -1,17 +1,17 @@ --- -layout : post -title : Filtering in Syncfusion® SfComboBox control for Xamarin.Android -description : Learn how to filter the text in SfComboBox -platform : Xamarin.Android -control : ComboBox -documentation : ug +layout: post +title: Filtering Options in Syncfusion® SfComboBox for Xamarin.Android +description: Learn how to enable and configure text filtering in the SfComboBox dropdown list for enhanced user experience +platform: xamarin.android +control: SfComboBox +documentation: ug --- -# Filtering Option +# Filtering Options -The combo box control provides an option to filter the dropdown list based on the text typed. You can set filter option by setting the `AllowFiltering` boolean property to true. +The SfComboBox control provides filtering functionality that allows users to filter the dropdown list based on the text they type. You can enable this feature by setting the `AllowFiltering` boolean property to `true`. -N> The Allow-Filtering property works only when the IsEditableMode property is set to true. +N> The AllowFiltering property works only when the IsEditableMode property is set to true. {% tabs %} @@ -25,4 +25,4 @@ combobox.AllowFiltering = true; {% endtabs %} -![](images/filtering.png) \ No newline at end of file +![SfComboBox filtering demonstration](images/filtering.png) diff --git a/xamarin-android/SfComboBox/Getting-Started.md b/xamarin-android/SfComboBox/Getting-Started.md index 03339e43e..ab57f6ff6 100644 --- a/xamarin-android/SfComboBox/Getting-Started.md +++ b/xamarin-android/SfComboBox/Getting-Started.md @@ -1,23 +1,27 @@ --- layout: post -title: Getting Started with Syncfusion® ComboBox Control for Xamarin.Android -description: Learn here about getting started with Syncfusion® Essential® Xamarin.Android ComboBox Control, its elements, and more. -platform: Xamarin.Android +title: Getting Started with Syncfusion® SfComboBox Control for Xamarin.Android +description: A comprehensive guide to implementing the Syncfusion SfComboBox control in Xamarin.Android applications, including setup, data population, and configuration options. +platform: xamarin.android control: SfComboBox documentation: ug --- -# Getting started with Xamarin.Android ComboBox +# Getting Started with Xamarin.Android SfComboBox -This section explains the steps required to create combo box, populate it with data, and filter suggestions.Here we create a simple sample for changing the resolution and this section covers only the minimal features that are needed to get started with the ComboBox. +## Prerequisites -## Referencing Essential Studio® components in your solution +Before getting started, ensure you have: +- Xamarin.Android development environment set up +- Syncfusion Essential Studio® for Xamarin installed +- Basic knowledge of Xamarin.Android development -After installing Essential Studio® for Xamarin,find all the required assemblies in the installation folders, +## Referencing Essential Studio® Components +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 -Add the following assembly references to the Android project, +Add the following assembly references to the Android project: android\Syncfusion.SfComboBox.Android.dll diff --git a/xamarin-android/SfComboBox/Header-and-Footer.md b/xamarin-android/SfComboBox/Header-and-Footer.md index 52156d19b..4544617be 100644 --- a/xamarin-android/SfComboBox/Header-and-Footer.md +++ b/xamarin-android/SfComboBox/Header-and-Footer.md @@ -1,21 +1,29 @@ --- -layout : post -title : Header and Footer in Syncfusion® SfComboBox control for Xamarin.Android -description : Learn how to enable Header and Footer in SfComboBox -platform : Xamarin.Android -control : SfComboBox -documentation : ug +layout: post +title: Header and Footer Views in Syncfusion® SfComboBox control for Xamarin.Android +description: Learn how to add and customize header and footer views in the SfComboBox dropdown list to enhance user experience and provide additional functionality. +platform: xamarin.android +control: SfComboBox +documentation: ug --- -## Header and footer +# Header and Footer Views -You can add header and footer view to the suggestion list in the combo box by enabling the `ShowDropDownHeaderView` and `ShowDropDownFooterView` properties. +The SfComboBox control allows you to add custom header and footer views to the dropdown list, providing additional functionality and improved user experience. These views can display contextual information, search hints, action buttons, or any custom content that enhances the dropdown interface. -## Header content +## Overview +You can add header and footer views to the dropdown list in the SfComboBox by enabling the `ShowDropDownHeaderView` and `ShowDropDownFooterView` properties. This feature is particularly useful for: -The header content can be added at the top of the combo box’s Suggestion box. The `DropDownHeaderView` property is used to set the content of the header. The height of the header in the combo box can be adjusted using the `DropDownHeaderViewHeight` property. +- Displaying search context or instructions +- Adding action buttons (like "Add New Item") +- Showing category information +- Providing additional navigation options +## Header Content -The following code example illustrate how to set Header content in SfComboBox. +The header content appears at the top of the SfComboBox dropdown list. Use the `DropDownHeaderView` property to set the header content, and adjust its height using the `DropDownHeaderViewHeight` property. + +### Implementation +The following code example illustrates how to set header content in the SfComboBox: {% tabs %} @@ -44,13 +52,13 @@ comboBox.TextChanged += (object sender, TextChangedEventArgs e) => {% endtabs %} -![](images/Header.png) - -## Footer content +![SfComboBox with custom header view displaying search context](images/Header.png) +## Footer Content -The footer content can be added at the bottom of the combo box’s suggestion box. `The DropDownFooterView` property is used to set the content of the footer. The height of the footer in the combo box can be adjusted using the `DropDownFooterViewHeight` property. +The footer content appears at the bottom of the SfComboBox dropdown list. Use the `DropDownFooterView` property to set the footer content, and adjust its height using the `DropDownFooterViewHeight` property. -The following code example illustrate how to set Footer content in SfComboBox. +### Implementation +The following code example illustrates how to set footer content in the SfComboBox: {% tabs %} @@ -75,8 +83,4 @@ comboBox.DropDownFooterView = footerView; {% endtabs %} -![](images/Footer.png) - - - - \ No newline at end of file +![SfComboBox with custom footer view showing "Add New" action](images/Footer.png) diff --git a/xamarin-android/SfComboBox/Multiple-selection.md b/xamarin-android/SfComboBox/Multiple-selection.md index 69e5524dc..b49a3287d 100644 --- a/xamarin-android/SfComboBox/Multiple-selection.md +++ b/xamarin-android/SfComboBox/Multiple-selection.md @@ -2,12 +2,12 @@ layout: post title: Multiple Selection in Xamarin.Android SfComboBox Control | Syncfusion® description: Learn here about Multiple Selection in Syncfusion® Essential® Xamarin.Android SfComboBox Control, its elements, and more. -platform: Xamarin.Android +platform: xamarin.android control: SfComboBox documentation: ug --- -# Multiple selection in Xamarin.Android SfComboBox +# Multiple Selection in Xamarin.Android SfComboBox Select multiple items from a suggestion list. In the combo box, you can perform multi selection in the following two ways: @@ -31,14 +31,14 @@ comboBox.IsSelectedItemsVisibleInDropDown = false; {% endtabs %} -### Wrap mode of token +### Token Wrap Modes -The selected item can be displayed as token inside the combo box in two ways. They are, +The `TokensWrapMode` property controls how tokens are arranged within the SfComboBox: -* `Wrap` - When `TokensWrapMode` is set to `Wrap` ,the selected items will be wrapped to the next line of the SfComboBox. - -* `None` - When `TokensWrapMode` is set to `None`, the selected item will be wrapped in horizontal orientation. +- **`Wrap`**: Selected items wrap to the next line when the available width is exceeded +- **`None`**: Selected items are arranged horizontally in a single line with horizontal scrolling +### Data Binding Example {% tabs %} {% highlight C# %} @@ -105,9 +105,9 @@ comboBox.ImageMemberPath = "Image"; {% endtabs %} -![Xamarin.Android SfComboBox Token Representation Wrap](images/TokenRepresentationWrap.png) +![SfComboBox with token representation and wrap mode enabled](images/TokenRepresentationWrap.png) -### Token customization +### Token Customization Token can be customized in the following ways: @@ -144,9 +144,9 @@ comboBox.TokenSettings = token; {% endtabs %} -![Xamarin.Android SfComboBox Token Customization](images/TokenCustomization.png) +![SfComboBox with customized token appearance](images/TokenCustomization.png) -## Delimiter +## Delimiter Mode When selecting the multiple items, the selected items can be divided with a desired character given for delimiter. The delimiter character can be set using the `Delimiter` property. @@ -161,7 +161,7 @@ comboBox.MultiSelectMode = MultiSelectMode.Delimiter; {% endtabs %} -![Xamarin.Android SfComboBox default delimiter](images/defaultdelimiter.png) +![SfComboBox with default comma delimiter](images/defaultdelimiter.png) We can add the custom delimiter character by `Delimiter` property. @@ -175,7 +175,8 @@ comboBox.Delimiter = '#'; {% endtabs %} -![Xamarin.Android SfComboBox delimiter](images/delimiter.png) +![SfComboBox with custom hash delimiter](images/delimiter.png) + diff --git a/xamarin-android/SfComboBox/No-Result-Found.md b/xamarin-android/SfComboBox/No-Result-Found.md index a67352217..6c935fa6d 100644 --- a/xamarin-android/SfComboBox/No-Result-Found.md +++ b/xamarin-android/SfComboBox/No-Result-Found.md @@ -1,15 +1,15 @@ --- -layout : post -title : No Result Found Text in Syncfusion® SfComboBox control for Xamarin.Android -description : Learn how to display the no result found text in SfComboBox -platform : Xamarin.Android -control : SfComboBox -documentation : ug +layout: post +title: No Result Found Text in Syncfusion® SfComboBox control for Xamarin.Android +description: Learn how to display and customize the no result found text in SfComboBox when search queries return no matches +platform: xamarin.android +control: SfComboBox +documentation: ug --- # No Results Found -When the entered item is not in the suggestion list, SfComboBox displays a text indicating there is no search results found. We can set the desire text to be displayed for indicating no results found with the `NoResultsFoundText` property. +When the entered item is not in the suggestion list, SfComboBox displays text indicating that no search results are found. You can set the desired text to be displayed for indicating no results found using the `NoResultsFoundText` property. {% tabs %} @@ -25,7 +25,8 @@ comboBox.NoResultsFoundText="No Results Found"; ## Customizing NoResultsFoundText -The `NoResultsFoundTextColor`, `NoResultsFoundFontSize` and `NoResultsFoundTypeface` properties are used to customize the foreground color, font size and typeface of NoResultsFoundText. +The `NoResultsFoundTextColor`, `NoResultsFoundFontSize`, and `NoResultsFoundTypeface` properties are used to customize the foreground color, font size, and typeface of the NoResultsFoundText. + {% tabs %} {% highlight c# %} diff --git a/xamarin-android/SfComboBox/Overview.md b/xamarin-android/SfComboBox/Overview.md index 23df7bc20..690f2e330 100644 --- a/xamarin-android/SfComboBox/Overview.md +++ b/xamarin-android/SfComboBox/Overview.md @@ -1,35 +1,32 @@ --- -layout : post -title : Overview of Syncfusion® ComboBox control for Xamarin.Android -description : Overview and key features of SfComboBox control -platform : Xamarin.Android -control : SfComboBox -documentation : ug +layout: post +title: Overview of Syncfusion® ComboBox control for Xamarin.Android +description: Comprehensive overview and key features of the SfComboBox control including data binding, filtering, customization, and multi-selection capabilities +platform: xamarin.android +control: SfComboBox +documentation: ug --- # Overview -The combo box is a text box component that allows users to type a value or choose an option from the list of predefined options. This has several out-of-the-box features such as data binding, filtering, and UI customization. +The SfComboBox is a text box component that allows users to type a value or choose an option from a list of predefined options. It provides several out-of-the-box features such as data binding, filtering, and UI customization. -![](images/overview.png) +![SfComboBox Overview](images/overview.png) -## Key features +## Key Features -* `Editable mode` – Supports both the editable and non-editable text boxes to choose selected item from given data source. +* **Editable Mode** – Supports both editable and non-editable text boxes to choose a selected item from the given data source. -* `Filtering mode` – Provides options to support both filtering and non-filtering suggestion lists. Combo box provides 3 different ways to display the filtered suggestions. They display suggestion through a drop-down list, append the first suggestion to text, and append suggestion to both of these. +* **Filtering Mode** – Provides options to support both filtering and non-filtering suggestion lists. The ComboBox offers three different ways to display filtered suggestions: through a drop-down list, by appending the first suggestion to the text, or by combining both approaches. -* `Suggestion modes` – Suggestions can be filtered in different modes, such as StartsWith, EndWith, Contains, Equals, Custom, etc. The combo box provides both case sensitive and insensitive modes. The items can be filtered only when the Allow Filtering property has enabled. +* **Suggestion Modes** – Suggestions can be filtered using different modes such as StartsWith, EndsWith, Contains, Equals, and Custom. The ComboBox supports both case-sensitive and case-insensitive filtering. Items can be filtered only when the AllowFiltering property is enabled. -* `MultiSelection` – Provides two different ways to select multiple items from the suggestion list using Token representation and Delimiter. In Token mode, the text can be wrapped in two ways: Wrap and None. In Wrap mode, text will be wrapped to next line. When using None, the text will be wrapped horizontally. +* **Multi-Selection** – Provides two different ways to select multiple items from the suggestion list using Token representation and Delimiter. In Token mode, text can be wrapped in two ways: Wrap and None. In Wrap mode, text wraps to the next line, while in None mode, text wraps horizontally. -* `Customization Support` – Provides options to customize both the Entry and Suggestion drop-down. - -* `Header and Footer` – Header and Footer content can be given in the top and bottom of the suggestion list in the combo box. - -* `Highlighting Text` – Highlights the matching text in the suggestion list based on the input given. - -* `Watermark` – Supports explanatory text inside the combo box control until users input the text. Watermark is restored again if user clear the text. +* **Customization Support** – Provides options to customize both the Entry and Suggestion drop-down components. +* **Header and Footer** – Allows you to add header and footer content at the top and bottom of the suggestion list in the ComboBox. +* **Text Highlighting** – Highlights matching text in the suggestion list based on the user's input. +* **Watermark** – Displays explanatory text inside the ComboBox control until the user inputs text. The watermark is restored if the user clears the text. diff --git a/xamarin-android/SfComboBox/Populating-Items.md b/xamarin-android/SfComboBox/Populating-Items.md index 188bd1a21..8defb8628 100644 --- a/xamarin-android/SfComboBox/Populating-Items.md +++ b/xamarin-android/SfComboBox/Populating-Items.md @@ -1,21 +1,21 @@ --- layout: post title: DataSource mode in Syncfusion® ComboBox control for Xamarin.Android -description: Learn here about populating items in Syncfusion Essential® Xamarin.Android ComboBox Control, its elements, and more. -platform: Xamarin.Android +description: Learn how to populate items in the Syncfusion Xamarin.Android ComboBox Control with string data and business objects, including DataSource configuration and DisplayMemberPath usage. +platform: xamarin.android control: SfComboBox documentation: ug --- -# Populating items in Xamarin.Android ComboBox +# Populating Items in Xamarin.Android ComboBox -* The combo box control can be populated with a list of string or business objects, which assist users when typing. Users can choose an item from the filtered suggestion list. +The SfComboBox control can be populated with a list of strings or business objects, which assist users when typing. Users can choose an item from the filtered suggestion list. -* The `DataSource` property is used to populate data in the SfComboBox control. This section explains how to populate the combo box with list of string and list of employee details separately. +The `DataSource` property is used to populate data in the SfComboBox control. This section explains how to populate the ComboBox with a list of strings and a list of employee details separately. -## Populating string data +## Populating String Data -Create an instance of the string list, and populate items as shown below. +Create an instance of the string list and populate items as shown below. {% tabs %} @@ -33,15 +33,15 @@ comboBox.ComboBoxMode= ComboBoxMode.Suggest; {% endtabs %} -![Xamarin.Android ComboBox Populating business objects](images/populatestringdata.png) +![Xamarin.Android ComboBox populated with string data](images/populatestringdata.png) -## Populating business objects +## Populating Business Objects -Apart from string data, the SfComboBox can deal with business object data also. Now, create Model and ViewModel classes to populate the combo box with employee details. +Apart from string data, the SfComboBox can also work with business object data. The following example demonstrates how to create Model and ViewModel classes to populate the ComboBox with employee details. -### Create and initialize business models +### Create and Initialize Business Models -Define a simple model class “Employee” with fields ID, and name. Then, populate employee data in ViewModel. +Define a simple model class "Employee" with fields ID and Name. Then, populate employee data in the ViewModel. {% tabs %} @@ -101,17 +101,17 @@ employeeCollection.Add(new Employee() { ID = 9, Name = "Howard" }); ### Setting DisplayMemberPath -The control is populated with list of employees. But, the Employee model contains two properties: ID and Name. So, you should intimate by which property it should filter suggestions. The `DisplayMemberPath` property specifies the property path with which filtering is done on business objects.In this case, make the control to provide suggestions based on Name. +The control is populated with a list of employees. However, the Employee model contains two properties: ID and Name. You need to specify which property should be used for filtering suggestions. The `DisplayMemberPath` property specifies the property path used for filtering on business objects. In this case, configure the control to provide suggestions based on the Name property. {% tabs %} {% highlight C# %} -//To display the Name, set the DisplayMemberPath +// To display the Name, set the DisplayMemberPath comboBox.DisplayMemberPath = "Name"; -//Add the data source +// Add the data source comboBox.DataSource = new EmployeeViewModel().EmployeeCollection; {% endhighlight %} {% endtabs %} -![Xamarin.Android ComboBox populate business](images/populatebusiness.png) +![Xamarin.Android ComboBox populated with business objects](images/populatebusiness.png) diff --git a/xamarin-android/SfComboBox/Suggestion-Display-Mode.md b/xamarin-android/SfComboBox/Suggestion-Display-Mode.md index bb5724be2..a47c61f89 100644 --- a/xamarin-android/SfComboBox/Suggestion-Display-Mode.md +++ b/xamarin-android/SfComboBox/Suggestion-Display-Mode.md @@ -1,28 +1,25 @@ --- -layout : post -title : ComboBoxMode mode for Syncfusion® ComboBox control in Xamarin.Android -description : Learn how to change the ComboBoxMode in SfComboBox -platform : Xamarin.Android -control : SfComboBox -documentation : ug +layout: post +title: ComboBoxMode for Syncfusion® ComboBox control in Xamarin.Android +description: Learn how to configure the ComboBoxMode property in SfComboBox to control suggestion display patterns +platform: xamarin.android +control: SfComboBox +documentation: ug --- -# Suggestion display mode - -The `ComboBoxMode` property is used to decide the suggestion pattern for displaying the filtered data according to the text entered. The different types of patterns are, described below +# Suggestion Display Mode +The `ComboBoxMode` property determines how filtered suggestions are displayed based on the text entered by the user. The available display modes are described below: * Suggest * Append +* SuggestAppend -* Suggest and Append - -N> The default option is suggest mode. - -## Suggest in drop-down +N> The default mode is Suggest. -* Suggest - Displays suggestions in the drop-down. +## Suggest Mode +The Suggest mode displays filtered suggestions in a drop-down list below the ComboBox. {% tabs %} {% highlight C# %} @@ -33,10 +30,9 @@ comboBox.ComboBoxMode = ComboBoxMode.Suggest; {% endtabs %} -## Append - -* Append - Appends the first matching string with the entered character. +## Append Mode +The Append mode automatically appends the first matching string to the entered text, allowing users to see potential completions inline. {% tabs %} {% highlight C# %} @@ -47,10 +43,9 @@ comboBox.ComboBoxMode = ComboBoxMode.Append; {% endtabs %} -## Both append and suggest in drop-down - -* SuggestAppend - Displays the suggestion in the drop-down along with appending the first matching string. +## SuggestAppend Mode +The SuggestAppend mode combines both approaches by displaying suggestions in a drop-down list while simultaneously appending the first matching string to the entered text. {% tabs %} {% highlight C# %} @@ -61,5 +56,4 @@ comboBox.ComboBoxMode = ComboBoxMode.SuggestAppend; {% endtabs %} -![](images/comboboxmode.png) - +![ComboBox modes demonstration](images/comboboxmode.png) diff --git a/xamarin-android/SfComboBox/Various-Filter-Options-for-Suggestion.md b/xamarin-android/SfComboBox/Various-Filter-Options-for-Suggestion.md index d77a89e4c..b46d460fc 100644 --- a/xamarin-android/SfComboBox/Various-Filter-Options-for-Suggestion.md +++ b/xamarin-android/SfComboBox/Various-Filter-Options-for-Suggestion.md @@ -1,15 +1,15 @@ --- -layout : post -title : Suggestion mode for Syncfusion® ComboBox Control in Xamarin.Android -description : Learn how to display suggestion mode in SfComboBox -platform : Xamarin.Android -control : SfComboBox -documentation : ug +layout: post +title: Suggestion mode for Syncfusion® ComboBox Control in Xamarin.Android +description: Learn how to configure various filtering modes and suggestion display options in SfComboBox +platform: xamarin.android +control: SfComboBox +documentation: ug --- -# Various filter options for suggestion +# Various Filter Options for Suggestions -The combo box enables filer option for filtering the suggestions in drop-down. +The SfComboBox provides filtering options to filter suggestions in the dropdown list. {% tabs %} @@ -20,32 +20,24 @@ comboBox.IsEditableMode = true; {% endtabs %} -## Types Of filtering +## Types of Filtering -The phenomenon of string comparison for filtering suggestions can be changed using the `SuggestionMode `property. The default filtering strategy is `StartsWith`, and it is case insensitive. The available filtering modes are, +String comparison for filtering suggestions can be configured using the `SuggestionMode` property. The default filtering strategy is `StartsWith`, and it is case insensitive. The available filtering modes are: -* StartsWith +* StartsWith +* StartsWithCaseSensitive +* Contains +* ContainsWithCaseSensitive +* Equals +* EqualsWithCaseSensitive +* EndsWith +* EndsWithCaseSensitive +* Custom -* StartsWithCaseSensitive - -* Contains - -* ContainsWithCaseSensitive - -* Equals - -* EqualsWithCaseSensitive - -* EndsWith - -* EndsWithCaseSensitive - -* Custom - -## Words that starts with input text - -Displays the list of suggestions based on the starting letter. +## StartsWith Mode +### Words that Start with Input Text +Displays suggestions based on items that begin with the entered characters. {% tabs %} {% highlight C# %} @@ -56,12 +48,11 @@ Displays the list of suggestions based on the starting letter. {% endtabs %} -![](images/startswith.png) - -### Filter with character casing +![StartsWith filtering mode](images/startswith.png) -Displays the list of suggestions based on the starting letter with case sensitive. +### Case-Sensitive StartsWith +Displays suggestions based on items that begin with the entered characters, with case-sensitive matching. {% tabs %} {% highlight C# %} @@ -72,12 +63,12 @@ Displays the list of suggestions based on the starting letter with case sensitiv {% endtabs %} -![](images/startswithcasesensitive.png) +![StartsWith case-sensitive filtering mode](images/startswithcasesensitive.png) -## Words that contain the input text - -Displays the list of suggestions if the combo box list contains that words. +## Contains Mode +### Words that Contain the Input Text +Displays suggestions for items that contain the entered text anywhere within the string. {% tabs %} {% highlight C# %} @@ -88,12 +79,11 @@ Displays the list of suggestions if the combo box list contains that words. {% endtabs %} -![](images/contains.png) - -### Filter with character casing +![Contains filtering mode](images/contains.png) -Displays the list of suggestions if the combo box list contains that words with case sensitive. +### Case-Sensitive Contains +Displays suggestions for items that contain the entered text with case-sensitive matching. {% tabs %} {% highlight C# %} @@ -104,12 +94,12 @@ Displays the list of suggestions if the combo box list contains that words with {% endtabs %} -![](images/containswithcasesensitive.png) - -## Words that equals to input text +![Contains case-sensitive filtering mode](images/containswithcasesensitive.png) -Displays the word that matches. +## Equals Mode +### Words that Equal the Input Text +Displays suggestions for items that exactly match the entered text. {% tabs %} {% highlight C# %} @@ -120,12 +110,11 @@ Displays the word that matches. {% endtabs %} -![](images/equals.png) +![Equals filtering mode](images/equals.png) -### Filter with character casing - -Displays the word that matches with case sensitive. +### Case-Sensitive Equals +Displays suggestions for items that exactly match the entered text with case-sensitive comparison. {% tabs %} {% highlight C# %} @@ -136,12 +125,12 @@ Displays the word that matches with case sensitive. {% endtabs %} -![](images/equalswithcasesensitive.png) - -## Words that ends with input text +![Equals case-sensitive filtering mode](images/equalswithcasesensitive.png) -Displays the list of suggestions based on the ending word. +## EndsWith Mode +### Words that End with Input Text +Displays suggestions based on items that end with the entered characters. {% tabs %} {% highlight C# %} @@ -152,12 +141,11 @@ Displays the list of suggestions based on the ending word. {% endtabs %} -![](images/endswith.png) +![EndsWith filtering mode](images/endswith.png) -### Filter with character casing - -Displays the list of suggestions based on the ending word with case sensitive. +### Case-Sensitive EndsWith +Displays suggestions based on items that end with the entered characters, with case-sensitive matching. {% tabs %} {% highlight C# %} @@ -168,12 +156,11 @@ comboBox.SuggestionMode = SuggestionMode.EndsWithCaseSensitive; {% endtabs %} -![](images/endswithcasesensitive.png) - +![EndsWith case-sensitive filtering mode](images/endswithcasesensitive.png) -### Custom filter +## Custom Filter Mode -Displays the list of suggestions based on the custom words in the combo box. +The Custom mode allows you to implement custom filtering logic by handling the filtering events or providing custom filter predicates. {% tabs %} {% highlight C# %} @@ -184,7 +171,4 @@ comboBox.SuggestionMode = SuggestionMode.Custom; {% endtabs %} -![](images/customfilter.png) - - - +![Custom filtering mode](images/customfilter.png) diff --git a/xamarin-android/SfComboBox/highlighting-matched-text.md b/xamarin-android/SfComboBox/highlighting-matched-text.md index f990ca245..14ed44fc4 100644 --- a/xamarin-android/SfComboBox/highlighting-matched-text.md +++ b/xamarin-android/SfComboBox/highlighting-matched-text.md @@ -1,10 +1,10 @@ --- -layout : post -title : MatchHighlighting in Syncfusion® SfComboBox control for Xamarin.Android -description : Learn how to highlight the matched text in SfComboBox -platform : Xamarin.Android -control : SfComboBox -documentation : ug +layout: post +title: Text Highlighting in Syncfusion® SfComboBox control for Xamarin.Android +description: Learn how to highlight matching text in the SfComboBox dropdown list to improve user experience and make item selection more intuitive with customizable highlighting options. +platform: xamarin.android +control: SfComboBox +documentation: ug --- # Highlighting matched text @@ -41,15 +41,11 @@ comboBox.HighlightedTextFontTypeFace = TypefaceStyle.Bold; {% endtabs %} -N> The default Color of HighlightedTextColor is Red. - The default FontTypeFace of HighlightedTextFontTypeFace is None. - -![](images/FirstOccurrence.png) - -## Multiple Occurrence +![SfComboBox with first occurrence text highlighting](images/FirstOccurrence.png) -Highlights the matching character that occurs everywhere in the suggestion list for Contains case in SuggestionMode. +## Multiple Occurrence Highlighting +This mode highlights all occurrences of matching characters throughout each item in the dropdown list. It works particularly well with the `Contains` suggestion mode to provide comprehensive text matching. {% tabs %} {% highlight C# %} @@ -65,7 +61,5 @@ comboBox.SuggestionMode = SuggestionMode.Contains; {% endtabs %} -![](images/MultipleOccurrence.png) - - +![SfComboBox with multiple occurrence text highlighting](images/MultipleOccurrence.png) diff --git a/xamarin-android/SfNavigationDrawer/Drawer-Content.md b/xamarin-android/SfNavigationDrawer/Drawer-Content.md index c166a4cb2..fd5598d0d 100644 --- a/xamarin-android/SfNavigationDrawer/Drawer-Content.md +++ b/xamarin-android/SfNavigationDrawer/Drawer-Content.md @@ -1,7 +1,7 @@ --- layout: post -title: Various features of Syncfusion® NavigationDrawer control for Android. -description: Learn how to set content view, drawer content view, footer view, header view, drawer size in NavigationDrawer. +title: Various features of Syncfusion® NavigationDrawer control for Android +description: Learn how to configure content view, drawer content view, footer view, header view, drawer size, and multiple drawer settings in NavigationDrawer. platform: Xamarin.Android control: NavigationDrawer documentation: ug @@ -9,18 +9,16 @@ documentation: ug # Sliding Panel Contents -The sliding panel contents are divided into three parts and they are as follows - +The sliding panel contents in SfNavigationDrawer are organized into three distinct sections: * [Drawer Content](#drawer-main-content) * [Header Content](#drawer-header-content) * [Footer Content](#drawer-footer-content) -The header and footer contents are optional and Drawer content is the mandatory one which is due to the maximum space allocated for Drawer content view. +The header and footer contents are optional, while the drawer content is mandatory as it occupies the primary space within the drawer panel. ## Drawer Main Content -The sliding main content of the SfNavigationDrawer which is a part of DrawerPanel can be set using `DrawerContentView` property with desired views. - +The main content of the SfNavigationDrawer sliding panel can be configured using the `DrawerContentView` property. This property accepts any desired view to be displayed as the primary drawer content. {% tabs %} {% highlight c# %} @@ -106,12 +104,11 @@ namespace navigationDrawerSample {% endtabs %} -![DrawerContentView](images/DrawerContentView.png) +![NavigationDrawer with custom drawer content](images/DrawerContentView.png) ## Drawer Header Content -Gets or sets the header of the DrawerView panel in the SfNavigationDrawer control using `DrawerHeaderView` property. - +The header section of the drawer panel can be configured using the `DrawerHeaderView` property. This allows you to display user information, branding, or navigation elements at the top of the drawer. {% tabs %} {% highlight c# %} @@ -151,12 +148,11 @@ namespace navigationDrawerSample {% endtabs %} -![DrawerHeaderView](images/DrawerHeaderView.png) +![NavigationDrawer with header content](images/DrawerHeaderView.png) ## Drawer Footer Content -Gets or sets the footer for the DrawerView panel in the SfNavigationDrawer control using `DrawerFooterView` property. - +The footer section of the drawer panel can be configured using the `DrawerFooterView` property. This is typically used for additional actions, settings, or supplementary information. {% tabs %} {% highlight c# %} @@ -193,12 +189,11 @@ namespace navigationDrawerSample {% endtabs %} -![DrawerFooterView](images/DrawerFooterView.png) +![NavigationDrawer with footer content](images/DrawerFooterView.png) ## Drawer Size -Gets or sets the height and width of the DrawerView panel in the SfNavigationDrawer control using `DrawerHeight` and `DrawerWidth` properties. - +You can customize the dimensions of the drawer panel using the `DrawerHeight` and `DrawerWidth` properties to control the drawer's appearance and space utilization. {% tabs %} {% highlight c# %} @@ -210,18 +205,17 @@ navigationDrawer.DrawerWidth = (float)(200); {% endtabs %} -## Multiple drawers +## Multiple Drawers -The Navigation Drawer allows users to open the drawer on multiple sides with different toggle methods. The DrawerSettings class and its properties need to be used where users need to provide multiple drawers. The multiple drawers can be implemented using the following drawer settings: +The SfNavigationDrawer supports multiple drawers that can be opened from different sides of the screen. This functionality is implemented using the `DrawerSettings` class, which provides two types of drawer configurations: * Default drawer settings * Secondary drawer settings -N> The header and footer content are optional, but the drawer content is mandatory to allocate space for the drawer. +N> While header and footer content are optional, drawer content is mandatory to properly allocate space for the drawer functionality. -## Default drawer settings - -Implement the default drawer using the default drawer settings class. The following code sample demonstrates how to set the properties of default drawer settings inside the DrawerSettings class. +## Default Drawer Settings +The default drawer can be configured using the `DefaultDrawerSettings` property with a `DrawerSettings` instance. The following example demonstrates how to configure the default drawer properties: {% tabs %} {% highlight c# %} @@ -240,12 +234,10 @@ navigationDrawer.DefaultDrawerSettings = defaultDrawerSettings; {% endtabs %} -N> The Navigation Drawer works with the value given for the properties inside the DrawerSettings class when using the default drawer settings. - -### Header view of the default drawer - -The header content can be provided to the default drawer using the `DrawerHeaderView` property inside the DrawerSettings class of DefaultDrawerSettings. The following code sample demonstrates how to set header content to the default drawer. +N> When using default drawer settings, the NavigationDrawer will use the property values defined within the DrawerSettings class. +### Header View of the Default Drawer +Configure the header content for the default drawer using the `DrawerHeaderView` property within the `DrawerSettings` class: {% tabs %} {% highlight c# %} @@ -266,7 +258,7 @@ defaultDrawerSettings.DrawerHeaderView = headerLayout; {% endtabs %} -### Content view of the default drawer +### Content View of the Default Drawer The drawer content can be provided to the default drawer using the `DrawerContentView` property inside the DrawerSettings class. The following code sample demonstrates how to set drawer content to the default drawer. @@ -298,10 +290,9 @@ SetContentView(navigationDrawer); {% endtabs %} -### Footer view of the default drawer - -The footer content can be provided to the default drawer using the `DrawerFooterView` property inside the DrawerSettings class of DefaultDrawerSettings. The following code sample demonstrates how to set footer content to the default drawer. +### Footer View of the Default Drawer +Configure the footer content for the default drawer using the `DrawerFooterView` property within the `DrawerSettings` class: {% tabs %} {% highlight c# %} @@ -322,10 +313,9 @@ defaultDrawerSettings.DrawerFooterView = footerLayout; {% endtabs %} -## Secondary drawer settings - -Implement the secondary drawer using the secondary drawer settings class. Its properties and functionalities are same as the default drawer. The secondary drawer can be set to different positions similar to the default drawer. The following code sample demonstrates how to set the properties of secondary drawer settings inside the DrawerSettings class. +## Secondary Drawer Settings +The secondary drawer provides the same functionality as the default drawer but can be positioned differently. Configure it using the `SecondaryDrawerSettings` property: {% tabs %} {% highlight c# %} @@ -345,9 +335,9 @@ navigationDrawer.SecondaryDrawerSettings = secondaryDrawerSettings; {% endtabs %} -N> When the default drawer and the secondary drawer are set to the same position, the default drawer will open on swiping. +N> When both default and secondary drawers are positioned on the same side, the default drawer will take precedence during swipe gestures. -### Header view of the secondary drawer +### Header View of the Secondary Drawer The header content can be provided to the secondary drawer using the `DrawerHeaderView` property inside the DrawerSettings class of SecondaryDrawerSettings. The following code sample demonstrates how to set the header content to the secondary drawer. @@ -371,7 +361,7 @@ secondaryDrawerSettings.DrawerHeaderView = headerLayout; {% endtabs %} -### Content view of the secondary drawer +### Content View of the Secondary Drawer The drawer content can be provided to the secondary drawer using the `DrawerContentView` property inside the DrawerSettings class of SecondaryDrawerSettings. The following code sample demonstrates how to set the drawer content to the secondary drawer. @@ -403,7 +393,7 @@ SetContentView(navigationDrawer); {% endtabs %} -### Footer view of secondary drawer +### Footer View of the Secondary Drawer The footer content can be provided to the secondary drawer using the `DrawerFooterView` property inside the DrawerSettings class of SecondaryDrawerSettings. The following code sample demonstrates how to set footer content to the secondary drawer. @@ -427,7 +417,7 @@ secondaryDrawerSettings.DrawerFooterView = footerLayout; {% endtabs %} -## Toggling method +## Toggling Methods Users can toggle the secondary drawer using the `ToggleSecondaryDrawer` method. diff --git a/xamarin-android/SfNavigationDrawer/Main-Content.md b/xamarin-android/SfNavigationDrawer/Main-Content.md index 2ff3c8d52..3b87bb879 100644 --- a/xamarin-android/SfNavigationDrawer/Main-Content.md +++ b/xamarin-android/SfNavigationDrawer/Main-Content.md @@ -1,7 +1,7 @@ --- layout: post title: Various features of Syncfusion® NavigationDrawer control for Xamarin.Android -description: Learn how to set content view, drawer content view, footer view, header view, drawer size in NavigationDrawer. +description: Learn how to configure the main content view in NavigationDrawer, including setup, customization, and best practices for content management. platform: Xamarin.Android control: NavigationDrawer documentation: ug @@ -9,12 +9,14 @@ documentation: ug # Setting Main Content -The SfNavigationDrawer is mainly divided into two parts, such as [Main Content](#main-content) and [Drawer Panel Content](/xamarin-android/SfNavigationDrawer/Drawer-Content "Sliding Panel Content") - +The SfNavigationDrawer consists of two primary components: the [Main Content](#main-content) area and the [Drawer Panel Content](/xamarin-android/SfNavigationDrawer/Drawer-Content "Sliding Panel Content"). This document focuses on configuring the main content area, which serves as the primary interface that users interact with when the drawer is closed. ## Main Content -The main view of the SfNavigationDrawer can be set using `ContentView` property with desired views. +The main content area displays your application's primary interface and can be configured using the `ContentView` property. This property accepts any Android view or layout that you want to display as the main content. + +### Basic Implementation +The following example demonstrates how to set up a basic main content area with an image view: {% tabs %} {% highlight c# %} @@ -46,5 +48,5 @@ namespace navigationDrawerSample {% endtabs %} -![](images/Content-View.png) +![NavigationDrawer main content configuration](images/Content-View.png) diff --git a/xamarin-android/SfNavigationDrawer/getting-started.md b/xamarin-android/SfNavigationDrawer/getting-started.md index 8e799ca10..c1571e518 100644 --- a/xamarin-android/SfNavigationDrawer/getting-started.md +++ b/xamarin-android/SfNavigationDrawer/getting-started.md @@ -1,15 +1,15 @@ --- layout: post title: Getting Started with Syncfusion® NavigationDrawer for Xamarin.Android -description: Learn here about getting started with Syncfusion® Xamarin.Android NavigationDrawer control, its elements, and more. -platform: xamarin.android +description: Learn how to get started with the Syncfusion Xamarin.Android NavigationDrawer control, including setup, configuration, and basic implementation. +platform: Xamarin.Android control: NavigationDrawer documentation: ug --- # Getting Started with Xamarin.Android NavigationDrawer -This section provides overview for working with Essential® NavigationDrawer for Xamarin.Android. You can walk through the entire process of creating an NavigationDrawer. +This section provides an overview for working with the Syncfusion NavigationDrawer for Xamarin.Android. You can walk through the entire process of creating a NavigationDrawer control and implementing its key features. ## Referencing Essential Studio® Components in Your Solution @@ -52,10 +52,9 @@ SetContentView(navigationDrawer); {% endtabs %} -## Add Drawer Content - -The sliding main content of the SfNavigationDrawer which is a part of DrawerPanel can be set using `DrawerContentView` property with desired views. +## Configuring Drawer Content +The drawer content is the main sliding panel that contains your navigation items. Configure it using the `DrawerContentView` property: {% tabs %} {% highlight c# %} @@ -98,13 +97,9 @@ namespace NavigationDrawerSample {% endtabs %} +## Adding Drawer Header Content -## Add Drawer Header Content - -SfNavigationDrawer provides option to display certain information like user id or names in the header part instead of providing everything in the drawer content view. - -This can be done using `DrawerHeaderView` property in SfNavigationDrawer. - +The NavigationDrawer provides an option to display user information or branding in the header section. This can be configured using the `DrawerHeaderView` property: {% tabs %} {% highlight c# %} @@ -146,10 +141,9 @@ This can be done using `DrawerHeaderView` property in SfNavigationDrawer. {% endtabs %} -## Add Main Content - -The main view of the SfNavigationDrawer can be set using `ContentView` property with desired views. +## Setting Up Main Content +The main content area displays your primary application content. Configure it using the `ContentView` property: {% tabs %} {% highlight c# %} @@ -181,7 +175,7 @@ The main view of the SfNavigationDrawer can be set using `ContentView` property {% endtabs %} -![Xamarin.Android NavigationDrawer Add Main Content](images/getting-started.png) +![Xamarin.Android NavigationDrawer getting started example](images/getting-started.png) ## Set Drawing Edge for Drawer Panel diff --git a/xamarin-android/SfNavigationDrawer/overview.md b/xamarin-android/SfNavigationDrawer/overview.md index 3d80b9573..c302f10a2 100644 --- a/xamarin-android/SfNavigationDrawer/overview.md +++ b/xamarin-android/SfNavigationDrawer/overview.md @@ -1,7 +1,7 @@ --- layout: post title: Overview of Syncfusion® NavigationDrawer control for Xamarin.Android -description: Overview and key features of NavigationDrawer control +description: Comprehensive overview and key features of the NavigationDrawer control including positioning, transitions, content management, and customization options platform: Xamarin.Android control: NavigationDrawer documentation: ug @@ -11,7 +11,7 @@ documentation: ug The SfNavigationDrawer is a sliding panel menu that comes out from the edge of the window and allows to have the contents in a hidden panel. It can be shown by swiping from any of the four screen edges or by demand. -![](images/Overview.png) +![SfNavigationDrawer overview showing sliding panel functionality](images/Overview.png) ## Key Features diff --git a/xamarin-android/SfNavigationDrawer/position.md b/xamarin-android/SfNavigationDrawer/position.md index f4cd794de..f7cd0ed75 100644 --- a/xamarin-android/SfNavigationDrawer/position.md +++ b/xamarin-android/SfNavigationDrawer/position.md @@ -1,15 +1,14 @@ --- layout: post title: Position of Drawer in Syncfusion® NavigationDrawer control for Xamarin.Android -description: Learn how to set position of the DrawerView panel. +description: Learn how to configure the position of the DrawerView panel and understand the best practices for different drawer positions. platform: Xamarin.Android control: NavigationDrawer documentation: ug --- -# Configuring The Drawer In Different Sides - -The `Position` property specifies the sliding position of the DrawerView panel. The `Position` property has the following four options, +# Configuring Drawer Position +The `Position` property determines from which edge of the screen the drawer panel will slide. This property provides flexibility in designing your navigation interface to match your application's layout and user experience requirements. The `Position` property supports four distinct options: * Left * Right @@ -35,7 +34,7 @@ Sets the SfNavigationDrawer sliding position to the left. {% endtabs %} -![](images/Left.png) +![NavigationDrawer positioned on the left side](images/Left.png) ## Right @@ -52,7 +51,7 @@ Sets the SfNavigationDrawer sliding position to the right. {% endtabs %} -![](images/Right.png) +![NavigationDrawer positioned on the right side](images/Right.png) ## Top @@ -69,7 +68,7 @@ Sets the SfNavigationDrawer sliding position to the top. {% endtabs %} -![](images/Top.png) +![NavigationDrawer positioned at the top](images/Top.png) ## Bottom @@ -89,3 +88,4 @@ Sets the SfNavigationDrawer sliding position to the bottom. + diff --git a/xamarin-android/SfNavigationDrawer/transition.md b/xamarin-android/SfNavigationDrawer/transition.md index 4eb338fd2..b50722d75 100644 --- a/xamarin-android/SfNavigationDrawer/transition.md +++ b/xamarin-android/SfNavigationDrawer/transition.md @@ -1,15 +1,14 @@ --- layout: post title: Transition of drawer in Syncfusion® NavigationDrawer control for Xamarin.Android -description: Learn how to set Transition of the DrawerView panel. +description: Learn how to configure transition animations for the DrawerView panel, including SlideOnTop, Push, and Reveal effects with best practices and performance considerations. platform: Xamarin.Android control: NavigationDrawer documentation: ug --- # Drawer Opening Animation -The `Transition` property specifies the sliding animations for the DrawerView panel. The `Transition` property has the following three options, - +The `Transition` property controls the animation behavior when the drawer opens and closes, providing different visual effects that can enhance your application's user experience. The property offers three distinct animation types, each creating a unique interaction pattern: * SlideOnTop * Push * Reveal diff --git a/xamarin-android/SfRadialMenu/CenterButtonCustomization.md b/xamarin-android/SfRadialMenu/CenterButtonCustomization.md index 47cebc892..2dd1aa760 100644 --- a/xamarin-android/SfRadialMenu/CenterButtonCustomization.md +++ b/xamarin-android/SfRadialMenu/CenterButtonCustomization.md @@ -9,7 +9,7 @@ documentation: ug # Dealing with CenterButton and BackButton -The CenterButton or BackButton in the radial menu can be viewed in the center of the radial menu. It performs operations such as opening and closing the rim and navigating to next level items. The radial menu allows you to customize the CenterButton/BackButton with `FontIcon`, `Custom View`, and `Caption`. +The CenterButton and BackButton are displayed at the center of the radial menu. These buttons perform operations such as opening and closing the rim and navigating to next-level items. The radial menu allows you to customize the CenterButton and BackButton using `FontIcon`, `Custom View`, and `Caption`. ## CenterButtonText and CenterButtonBackText @@ -131,7 +131,7 @@ namespace GettingStarted ## CenterButtonBackground -The [CenterButtonBackgroundColor](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_CenterButtonBackground) changes the background color of the center button in [SfRadialMenu](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html). +The [CenterButtonBackground](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_CenterButtonBackground) changes the background color of the center button in [SfRadialMenu](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html). {% tabs %} {% highlight C# %} @@ -674,3 +674,5 @@ namespace GettingStarted {% endhighlight %} {% endtabs %} + + diff --git a/xamarin-android/SfRadialMenu/Events.md b/xamarin-android/SfRadialMenu/Events.md index d7ceb4d0b..996a778b7 100644 --- a/xamarin-android/SfRadialMenu/Events.md +++ b/xamarin-android/SfRadialMenu/Events.md @@ -11,7 +11,7 @@ documentation: ug ## Perform an action when navigating to the next level -In a radial menu, you can perform actions when navigating from one level to another. The `Navigating` event occurs when navigating from one level to another, and the `Navigated` event occurs after navigating to another level. +In a radial menu, you can perform actions when navigating from one level to another. The `Navigating` event occurs when navigating from one level to another, and the `Navigated` event occurs after navigating to another level. {% tabs %} {% highlight c# %} @@ -224,7 +224,7 @@ namespace GettingStarted {% endhighlight %} {% endtabs %} -N> You can close navigation using the `Cancel` event argument. +N> You can cancel closing using the `Cancel` event argument. ## Perform an action by tapping the center button @@ -284,7 +284,7 @@ namespace GettingStarted ## Perform an action by tapping the radial menu item -You can perform an action by tapping a radial menu item. The `CenterButtonBackTapped` event occurs when the radial menu item is tapped. +You can perform an action by tapping a radial menu item. The `ItemTapped` event occurs when the radial menu item is tapped. {% tabs %} {% highlight xaml %} diff --git a/xamarin-android/SfRadialMenu/GettingStarted.md b/xamarin-android/SfRadialMenu/GettingStarted.md index d458be0cb..283ce2c91 100644 --- a/xamarin-android/SfRadialMenu/GettingStarted.md +++ b/xamarin-android/SfRadialMenu/GettingStarted.md @@ -17,13 +17,13 @@ After installing Essential Studio® for Xamarin, you can find all the {Syncfusion Installed location}\Essential Studio\14.XXXX.X.XX\lib -Add the following assembly references to the Android project. +Add the following assembly reference to the Android project: android\Syncfusion.SfRadialMenu.Andriod.dll ## Adding SfRadialMenu -* Add namespace for the added assemblies. +* Add the namespace for the added assemblies. {% tabs %} {% highlight c# %} @@ -33,7 +33,7 @@ using Syncfusion.SfRadialMenu.Android; {% endhighlight %} {% endtabs %} -* Now, instantiate and add the SfRadialMenu control with a required optimal name. +* Now, instantiate and add the SfRadialMenu control with the required optimal name. {% tabs %} {% highlight c# %} @@ -64,7 +64,7 @@ namespace GettingStarted ## Adding RadialMenu items -SfRadialMenu provides the option to add a number of radial menu items. Add an external font icon typeface into the `Asset` folder, and then set its build action to Android assets. The Unicode can be passed as text to display icons in the SfRadialMenu item. +SfRadialMenu provides the option to add multiple radial menu items. Add an external font icon typeface into the `Assets` folder, and then set its build action to Android assets. The Unicode can be passed as text to display icons in the SfRadialMenu items. {% tabs %} {% highlight c# %} diff --git a/xamarin-android/SfRadialMenu/Overview.md b/xamarin-android/SfRadialMenu/Overview.md index 79d1b6667..99df89e51 100644 --- a/xamarin-android/SfRadialMenu/Overview.md +++ b/xamarin-android/SfRadialMenu/Overview.md @@ -1,7 +1,7 @@ --- layout: post title: Overview of Syncfusion® RadialMenu control for Xamarin.Android. -description: Overview and key features of Syncfusion® RadialMenu control to know more about the control in Xamarin.Android. +description: Overview and key features of Syncfusion® RadialMenu control to know more about the control in Xamarin.Android. platform: Xamarin.Android control: SfRadialMenu documentation: ug @@ -9,16 +9,15 @@ documentation: ug # Overview -The SfRadialMenu control displays a hierarchical menu in a circular layout, which is optimized for touch-enabled devices. Typically, it is used as a context menu, and it can expose more menu items in the same space than traditional menus. +The SfRadialMenu control displays a hierarchical menu in a circular layout, optimized for touch-enabled devices. Typically used as a context menu, it can expose more menu items in the same space than traditional menus. ## Key features -* Supports automatic item arrangement. -* Supports rotating items. -* Supports custom view, like an image. -* Provides the option for users to place items as needed. -* Supports floating over the layout to avoid obscuring the content behind the layout. -* Allows you to provide a built-in icon font option that helps users to add vector images that prevent the control from experiencing image glitches that are often faced with traditional image icons. -* Provides complete customization options for the menu and its items, such as coloring, size, placement, and shapes using the segmentation option. - +* **Automatic item arrangement**: Supports automatic positioning and layout of menu items. +* **Item rotation**: Supports rotating menu items for enhanced visual presentation. +* **Custom views**: Supports custom views, including images and other UI elements. +* **Flexible item placement**: Provides options for users to position items as needed. +* **Floating layout**: Supports floating over existing layouts to avoid obscuring content behind the menu. +* **Built-in icon fonts**: Allows you to use built-in icon font options that provide vector images, eliminating image quality issues commonly encountered with traditional bitmap icons. +* **Complete customization**: Provides comprehensive customization options for the menu and its items, including colors, sizes, placement, and shapes using segmentation options. ![OverView of SfRadialMenu](images/overview.png) \ No newline at end of file diff --git a/xamarin-android/SfRadialMenu/PlaceAndDragRadialMenu.md b/xamarin-android/SfRadialMenu/PlaceAndDragRadialMenu.md index 5d061410a..1592e12e6 100644 --- a/xamarin-android/SfRadialMenu/PlaceAndDragRadialMenu.md +++ b/xamarin-android/SfRadialMenu/PlaceAndDragRadialMenu.md @@ -9,11 +9,11 @@ documentation: ug # Placing and dragging RadialMenu -You can place the radial menu anywhere on its parent layout and drag it within the parent layout. +You can place the RadialMenu anywhere within its parent layout and enable dragging functionality to allow users to reposition it dynamically. ## Dragging RadialMenu -You can enable or disable dragging using the [IsDragEnabled](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_IsDragEnabled) property. +You can enable or disable dragging functionality using the [IsDragEnabled](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_IsDragEnabled) property. {% tabs %} {% highlight c# %} @@ -48,19 +48,19 @@ namespace GettingStarted {% endhighlight %} {% endtabs %} -## DragEvents +## Drag Events SfRadialMenu provides the DragBegin and DragEnd events that occur when the RadialMenu is dragged. +SfRadialMenu provides the DragBegin and DragEnd events that occur when the RadialMenu is being dragged. ### DragBegin -This event occurs when you start dragging RadialMenu with `DragBeginEventArgs`. +This event occurs when you start dragging the RadialMenu. It provides `DragBeginEventArgs` with the following properties: -* `Position`: Gets the start position of the RadialMenu. +* **Position**: Gets the starting position of the RadialMenu. +* **Handled**: Gets or sets a Boolean value to enable or disable the dragging operation. -* `Handled`: Gets or sets the Boolean value for enabling and disabling the dragging of RadialMenu. - -To hook the [DragBegin](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html) event and to get the start position and restrict dragging, refer to the following code example. +To handle the [DragBegin](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html) event and get the start position or restrict dragging, refer to the following code example: {% tabs %} {% highlight c# %} @@ -103,15 +103,12 @@ namespace GettingStarted ### DragEnd -This event occurs when dragging ends in RadialMenu with `DragEndEventArgs`. - -* `OldValue`: Gets the start position of the RadialMenu. - -* `NewValue`: Gets the end position of the RadialMenu. +This event occurs when the dragging operation ends. It provides `DragEndEventArgs` with the following properties: +* **OldValue**: Gets the starting position of the RadialMenu. +* **NewValue**: Gets the ending position of the RadialMenu. +* **Handled**: Gets or sets a Boolean value to restrict the RadialMenu from moving to the new position. -* `Handled`: Gets or sets the Boolean value for restricting the RadialMenu from moving to another position. - -To hook the [DragEnd](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html) event, to get the start and end positions, and to restrict the movement of RadialMenu, refer to the following code example. +To handle the [DragEnd](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html) event and get the start and end positions or restrict the movement, refer to the following code example: {% tabs %} {% highlight c# %} @@ -154,13 +151,12 @@ namespace GettingStarted ## Placement of RadialMenu -You can place the SfRadialMenu based on its CenterButton axis by providing the [CenterButtonPlacement](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_CenterButtonPlacement) enum property with TopLeft and Center positions. - -`TopLeft`: Places the origin (0,0) of SfRadialMenu at the top-left corner. +You can configure the placement of the SfRadialMenu based on its center button axis using the [CenterButtonPlacement](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_CenterButtonPlacement) property with the following options: -`Center`: Places the origin (0,0) of SfRadialMenu at the center. +* **TopLeft**: Places the origin (0,0) of the SfRadialMenu at the top-left corner. +* **Center**: Places the origin (0,0) of the SfRadialMenu at the center. -N> The default value of the [CenterButtonPlacement](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_CenterButtonPlacement) property is center. +N> The default value of the [CenterButtonPlacement](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_CenterButtonPlacement) property is Center. {% tabs %} {% highlight c# %} @@ -198,9 +194,9 @@ namespace GettingStarted ![Image for placement](images/CenterButtonPlacement.png) -## Placing RadialMenu +## Positioning RadialMenu -You can place the radial menu anywhere on its parent layout using the [Point](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_Point) property. The position of Radial Menu is calculated based on the center point of parent layout. +You can position the RadialMenu at a specific location within its parent layout using the [Point](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_Point) property. The position is calculated based on the coordinate system of the parent layout. {% tabs %} {% highlight c# %} diff --git a/xamarin-android/SfRadialMenu/PopulatingItems.md b/xamarin-android/SfRadialMenu/PopulatingItems.md index c61e432c6..df7207b06 100644 --- a/xamarin-android/SfRadialMenu/PopulatingItems.md +++ b/xamarin-android/SfRadialMenu/PopulatingItems.md @@ -1,6 +1,6 @@ --- layout: post -title: Data Binding in Syncfusion® RadialMenu control for Xamarin.Android +title: Data Binding in Syncfusion® RadialMenu control for Xamarin.Android description: Learn how to perform DataBinding, adding outer rim items, nested item, duration of the animation and other property usages in SfRadialMenu. platform: Xamarin.Android control: SfRadialMenu @@ -9,15 +9,15 @@ documentation: ug # Populating Items -This section explains how to populate items using the radial menu item and item source. +This section explains how to populate items using radial menu items and item sources. ## Using radial menu items -By passing a collection of [SfRadialMenuItems](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenuItem.html), you can get the view of the `SfRadialMenu` control. The radial menu item class provides various options such as custom views, font icons, and images to customize the items. You can also add radial menu items by hierarchy. +By passing a collection of [SfRadialMenuItems](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenuItem.html), you can configure the view of the `SfRadialMenu` control. The radial menu item class provides various options such as custom views, font icons, and images to customize the items. You can also add radial menu items hierarchically. ### Adding outer rim items of the radial menu -The following code sample shows how to add the outer rim items of the radial menu. +The following code sample demonstrates how to add outer rim items to the radial menu: {% tabs %} {% highlight c# %} @@ -60,9 +60,9 @@ namespace GettingStarted ### Adding nested items of a radial menu -You can populate the nested levels of items within a menu to group similar actions. For example, you can group the clipboard operations by adding clipboard as the main menu and cut, copy, and paste as its children. +You can populate nested levels of items within a menu to group similar actions. For example, you can group clipboard operations by adding "Clipboard" as the main menu and "Cut", "Copy", and "Paste" as its children. -The following code sample shows how to add the nested items of the radial menu. +The following code sample demonstrates how to add nested items to the radial menu: {% tabs %} @@ -128,7 +128,7 @@ namespace GettingStarted ## Animation duration -The duration of animation in the radial menu can be changed using the [AnimationDuration](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_AnimationDuration) property. It is used to change the speed of opening and closing the radial menu. +The duration of animation in the radial menu can be customized using the [AnimationDuration](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_AnimationDuration) property. This property controls the speed of opening and closing animations for the radial menu. {% tabs %} {% highlight c# %} @@ -335,7 +335,7 @@ namespace GettingStarted ## Separator thickness and color in the radial menu -The thickness of the strip between the two items can be changed using the [SeparatorThickness](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_SeparatorThickness) property, and the color of the strip can be changed using the [SeparatorColor](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_SeparatorColor) property. +The thickness of the separator between menu items can be customized using the [SeparatorThickness](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_SeparatorThickness) property, and the color of the separator can be customized using the [SeparatorColor](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_SeparatorColor) property. {% tabs %} {% highlight c# %} @@ -382,7 +382,7 @@ namespace GettingStarted ## Rim color and rim radius in radial menu -The radius of the rim can be changed using the [RimRadius](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_RimRadius) property, and the color of the rim can be changed using the [RimColor](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_RimColor) property. +The radius of the rim can be customized using the [RimRadius](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_RimRadius) property, and the color of the rim can be customized using the [RimColor](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_RimColor) property. {% tabs %} {% highlight c# %} diff --git a/xamarin-android/SfRadialMenu/SegmentingAndPlacingItem.md b/xamarin-android/SfRadialMenu/SegmentingAndPlacingItem.md index c782a57bf..2d2e91e29 100644 --- a/xamarin-android/SfRadialMenu/SegmentingAndPlacingItem.md +++ b/xamarin-android/SfRadialMenu/SegmentingAndPlacingItem.md @@ -11,14 +11,13 @@ documentation: ug The two different [LayoutTypes](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_LayoutType) available in the radial menu are: -* Default -* Custom - -Both the layout types divide the available space equally among all the children in the circular panel. +* **Default**: Segments are determined by the number of child items +* **Custom**: Segments are determined by the VisibleSegmentsCount property +Both layout types divide the available space equally among all the children in the circular panel. ## Default -The number of segments in the panel is determined by the children count in a level. As the segment count in each hierarchical level differs, radial menu items are arranged in a sequential order as added to the radial menu. +The number of segments in the panel is determined by the children count at each level. Since the segment count in each hierarchical level may differ, radial menu items are arranged in sequential order as they are added to the radial menu. {% tabs %} {% highlight c# %} @@ -81,7 +80,7 @@ namespace GettingStarted ## Custom -The number of segments in the panel is determined using the [VisibleSegmentsCount](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_VisibleSegmentsCount) property. As the segment count in all the hierarchical levels is the same, radial menu items are arranged in any order based on the [SegmentIndex](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenuItem.html#Syncfusion_SfRadialMenu_Android_SfRadialMenuItem_SegmentIndex) property. +The number of segments in the panel is determined using the [VisibleSegmentsCount](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_VisibleSegmentsCount) property. Since the segment count is consistent across all hierarchical levels, radial menu items can be arranged in any order based on the [SegmentIndex](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenuItem.html#Syncfusion_SfRadialMenu_Android_SfRadialMenuItem_SegmentIndex) property. {% tabs %} {% highlight c# %} @@ -144,7 +143,7 @@ namespace GettingStarted ## VisibleSegmentsCount -The [VisibleSegmentsCount](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_VisibleSegmentsCount) property is used to specify the number of segments available in the circular panel. When the children count is greater than the value given in the VisibleSegmentsCount property, the overflowing children are not arranged in the panel. When children count is lesser than the VisibleSegmentsCount property, the remaining segments are left free. +The [VisibleSegmentsCount](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_VisibleSegmentsCount) property specifies the number of segments available in the circular panel. When the children count exceeds the value specified in the VisibleSegmentsCount property, the overflowing children are not arranged in the panel. When the children count is less than the VisibleSegmentsCount property value, the remaining segments are left empty. {% tabs %} {% highlight c# %} @@ -210,7 +209,7 @@ namespace GettingStarted ## SegmentIndex -The [SegmentIndex](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenuItem.html#Syncfusion_SfRadialMenu_Android_SfRadialMenuItem_SegmentIndex) property is used to specify the index of the radial menu item in circular panel. Based on the index, the radial menu items are inserted in the segment. When the SegmentIndex is not specified for a RadialMenuItem, the menu item is arranged in the next available free segment. +The [SegmentIndex](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenuItem.html#Syncfusion_SfRadialMenu_Android_SfRadialMenuItem_SegmentIndex) property specifies the index position of the radial menu item in the circular panel. Based on this index, radial menu items are inserted into the corresponding segment. When the SegmentIndex is not specified for a RadialMenuItem, the menu item is arranged in the next available segment. {% tabs %} {% highlight c#%} @@ -263,12 +262,11 @@ namespace GettingStarted {% endhighlight %} {% endtabs %} -N> It is necessary to set the VisibleSegmentsCount for the SegmentIndex API to be set. +N> It is necessary to set the VisibleSegmentsCount property for the SegmentIndex property to function properly. ## StartAngle -The `StartAngle` property is used to set the angle from which the arrangement of radial menu items should start. - +The [StartAngle](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_StartAngle) property sets the angle from which the arrangement of radial menu items should begin. {% tabs %} {% highlight c#%} diff --git a/xamarin-android/SfRadialMenu/SfRadialMenuItemCustomization.md b/xamarin-android/SfRadialMenu/SfRadialMenuItemCustomization.md index a4d059b52..f3b3fac41 100644 --- a/xamarin-android/SfRadialMenu/SfRadialMenuItemCustomization.md +++ b/xamarin-android/SfRadialMenu/SfRadialMenuItemCustomization.md @@ -9,7 +9,7 @@ documentation: ug # SfRadialMenuItem Customization -The [SfRadialMenuItem](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenuItem.html) class provides various options such as `Custom Views`, `FontIcons`, and `Images` to customize the items. You can add radial menu items by hierarchy. To add a SfRadialMenuItem with SfRadialMenu, create an instance of SfRadialMenuItem, and add it to the [Items](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_Items) property that is available in SfRadialMenu. +The [SfRadialMenuItem](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenuItem.html) class provides various options such as `Custom Views`, `FontIcons`, and `Images` to customize the items. You can add radial menu items hierarchically. To add a SfRadialMenuItem to SfRadialMenu, create an instance of SfRadialMenuItem and add it to the [Items](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenu.html#Syncfusion_SfRadialMenu_Android_SfRadialMenu_Items) property that is available in SfRadialMenu. ## Items @@ -53,7 +53,7 @@ namespace GettingStarted ## Text -The [Text](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenuItem.html#Syncfusion_SfRadialMenu_Android_SfRadialMenuItem_Text) property provides text to the [SfRadialMenuItem](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenuItem.html). +The [Text](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenuItem.html#Syncfusion_SfRadialMenu_Android_SfRadialMenuItem_Text) property provides text content to the [SfRadialMenuItem](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenuItem.html). {% tabs %} {% highlight C# %} @@ -93,7 +93,7 @@ namespace GettingStarted ## ItemHeight -The [ItemHeight](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenuItem.html#Syncfusion_SfRadialMenu_Android_SfRadialMenuItem_ItemHeight) changes the height of the [SfRadialMenuItem](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenuItem.html). +The [ItemHeight](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenuItem.html#Syncfusion_SfRadialMenu_Android_SfRadialMenuItem_ItemHeight) property changes the height of the [SfRadialMenuItem](https://help.syncfusion.com/cr/xamarin-android/Syncfusion.SfRadialMenu.Android.SfRadialMenuItem.html). {% tabs %} {% highlight C# %} @@ -580,3 +580,4 @@ namespace GettingStarted {% endtabs %} ![SfRadialMenu with Items](images/Customization.png) +