AutoCompleteColumn.LoadingProgressMode Property

Gets or sets whether a wait indicator is displayed automatically or manually.

Namespace: DevExpress.XamarinForms.DataGrid

Assembly: DevExpress.XamarinForms.Grid.dll

NuGet Package: DevExpress.XamarinForms.Grid

Declaration

[XtraSerializableProperty]
public LoadingProgressMode LoadingProgressMode { get; set; }

Property Value

Type	Description
LoadingProgressMode	Auto if a wait indicator is displayed automatically; Manual if a wait indicator is displayed manually.

Available values:

Name	Description
Auto	A wait indicator is displayed when the text in the edit box changes and hidden when the collection of suggestions is updated.
Manual	A wait indicator is displayed and hidden based on the IsLoadingInProgress property value.

Remarks

In Auto mode, the editor automatically displays a wait indicator in the drop-down window when the text in the edit box changes and automatically hides it when the editor’s ItemsSource collection is updated.

To show and hide the wait indicator manually, set LoadingProgressMode to Manual and use the editor’s IsLoadingInProgress property. To obtain the editor, use the TextChanged event’s AutoCompleteEdit argument.

Example

The example below handles the TextChanged event to supply suggestions for the AutoCompleteColumn. Use the AutoCompleteEdit event argument to obtain the cell’s editor.

XAML

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:dxg="http://schemas.devexpress.com/xamarin/2014/forms/datagrid">
    <ContentPage.Content>
        <dxg:DataGridView ItemsSource="{Binding Path=Employees}">
            <dxg:DataGridView.Columns>
                <dxg:AutoCompleteColumn FieldName="JobTitle"
                                        LoadingProgressMode="Manual"
                                        TextChanged="AutoCompleteColumn_TextChanged">                
                </dxg:AutoCompleteColumn>
            </dxg:DataGridView.Columns>
        </dxg:DataGridView>
    </ContentPage.Content>
</ContentPage>

C#

using System.ComponentModel;
using System.Collections.Generic;
using Xamarin.Forms;

namespace DemoCenter.Forms.Views {
    public partial class FirstLookView : ContentPage {
        public FirstLookView() {
            InitializeComponent();
            BindingContext = new EmployeesRepository();
        }
        private void AutoCompleteColumn_TextChanged(object sender, AutoCompleteColumnTextChangedEventArgs e) {
            AutoCompleteEdit edit = e.AutoCompleteEdit;
            EmployeesRepository employeesRepository = dataGridView.BindingContext as EmployeesRepository;
            if (e.Reason == AutoCompleteEditTextChangeReason.UserInput) {
                edit.IsLoadingInProgress = true;
                Task.Factory.StartNew(new Action(() => {
                    Thread.Sleep(3000);
                    Dispatcher.BeginInvokeOnMainThread(new Action(() => {
                        edit.ItemsSource = employeesRepository.JobTitles
                        .Where(i => i.Title
                        .StartsWith(edit.Text, StringComparison.CurrentCultureIgnoreCase)).ToList();
                        edit.IsLoadingInProgress = false;
                    }));
                }));
            }
        }
    }
    public class EmployeesRepository {
        public IList<Employee> Employees { get; set; }
        public IList<string> Jobs { get; set; }
    }
    public class Employee {
        public string JobTitle { get; set; }
    }
}