Автоматическое заполнение для Xamarin. AndroidAuto Complete for Xamarin.Android

AutoCompleteTextView— Это редактируемый элемент текстового представления, который автоматически показывает варианты завершения при вводе пользователем.AutoCompleteTextView is an editable text view element that shows completion suggestions automatically while the user is typing. Список предложений отображается в раскрывающемся меню, из которого пользователь может выбрать элемент для замены содержимого поля ввода на.The list of suggestions is displayed in a drop down menu from which the user can choose an item to replace the content of the edit box with.

Пример автоматического завершения

ОбзорOverview

Чтобы создать мини-приложение ввода текста, предоставляющее варианты автозавершения, используйтеAutoCompleteTextViewTo create a text entry widget that provides auto-complete suggestions, use the AutoCompleteTextView ».widget. Предложения принимаются из коллекции строк, связанных с мини-приложением, ArrayAdapterчерез.Suggestions are received from a collection of strings associated with the widget through an ArrayAdapter.

В этом руководстве вы создадите элементAutoCompleteTextViewIn this tutorial, you will create a AutoCompleteTextView Мини-приложение, содержащее предложения по названию страны.widget that provides suggestions for a country name.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="horizontal"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:padding="5dp">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Country" />
    <AutoCompleteTextView android:id="@+id/autocomplete_country"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_marginLeft="5dp"/>
</LinearLayout>

TextView — Это метка, представляющая собойAutoCompleteTextViewThe TextView is a label that introduces the AutoCompleteTextView ».widget.

УчебникTutorial

Запустите новый проект с именем хеллоаутокомплете.Start a new project named HelloAutoComplete.

Создайте XML-файл с list_item.xml именем и сохраните его в папке ресурсов или макета .Create an XML file named list_item.xml and save it inside the Resources/Layout folder. Задайте для AndroidResourceдействия сборки этого файла значение.Set the Build Action of this file to AndroidResource. Измените файл, чтобы он выглядел следующим образом:Edit the file to look like this:

<?xml version="1.0" encoding="utf-8"?>

<TextView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:padding="10dp"
    android:textSize="16sp"
    android:textColor="#000">
</TextView> 

Этот файл определяет простой TextView , который будет использоваться для каждого элемента, отображаемого в списке предложений.This file defines a simple TextView that will be used for each item that appears in the list of suggestions.

Откройте ресурсы/макет/Main. axml и вставьте следующее:Open Resources/Layout/Main.axml and insert the following:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="horizontal"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:padding="5dp">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Country" />
    <AutoCompleteTextView android:id="@+id/autocomplete_country"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:layout_marginLeft="5dp"/>
</LinearLayout>

Откройте MainActivity.CS и вставьте следующий код дляOnCreate()Open MainActivity.cs and insert the following code for the OnCreate() Methodmethod:

protected override void OnCreate (Bundle bundle)
{
    base.OnCreate (bundle);

    // Set our view from the "Main" layout resource
    SetContentView (Resource.Layout.Main);

    AutoCompleteTextView textView = FindViewById<AutoCompleteTextView> (Resource.Id.autocomplete_country);
    var adapter = new ArrayAdapter<String> (this, Resource.Layout.list_item, COUNTRIES);

    textView.Adapter = adapter;
}

После того как для main.xml представления содержимого задан макет, элементAutoCompleteTextViewAfter the content view is set to the main.xml layout, the AutoCompleteTextView Мини-приложение записывается из FindViewByIdмакета с помощью.widget is captured from the layout with FindViewById. Затем инициализируется для list_item.xml привязки макета к COUNTRIES каждому элементу списка в массиве строк (определяется на следующем шаге). ArrayAdapterA new ArrayAdapter is then initialized to bind the list_item.xml layout to each list item in the COUNTRIES string array (defined in the next step). Наконец, SetAdapter() вызывается метод, чтобы ArrayAdapter связать сAutoCompleteTextViewFinally, SetAdapter() is called to associate the ArrayAdapter with the AutoCompleteTextView мини-приложения, чтобы массив строк заполнил список предложений.widget so that the string array will populate the list of suggestions.

MainActivity Внутри класса добавьте массив строк:Inside the MainActivity class, add the string array:

static string[] COUNTRIES = new string[] {
  "Afghanistan", "Albania", "Algeria", "American Samoa", "Andorra",
  "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina",
  "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan",
  "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium",
  "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia",
  "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory",
  "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Burundi",
  "Cote d'Ivoire", "Cambodia", "Cameroon", "Canada", "Cape Verde",
  "Cayman Islands", "Central African Republic", "Chad", "Chile", "China",
  "Christmas Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo",
  "Cook Islands", "Costa Rica", "Croatia", "Cuba", "Cyprus", "Czech Republic",
  "Democratic Republic of the Congo", "Denmark", "Djibouti", "Dominica", "Dominican Republic",
  "East Timor", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea",
  "Estonia", "Ethiopia", "Faeroe Islands", "Falkland Islands", "Fiji", "Finland",
  "Former Yugoslav Republic of Macedonia", "France", "French Guiana", "French Polynesia",
  "French Southern Territories", "Gabon", "Georgia", "Germany", "Ghana", "Gibraltar",
  "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guinea", "Guinea-Bissau",
  "Guyana", "Haiti", "Heard Island and McDonald Islands", "Honduras", "Hong Kong", "Hungary",
  "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Israel", "Italy", "Jamaica",
  "Japan", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kuwait", "Kyrgyzstan", "Laos",
  "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg",
  "Macau", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands",
  "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia", "Moldova",
  "Monaco", "Mongolia", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia",
  "Nauru", "Nepal", "Netherlands", "Netherlands Antilles", "New Caledonia", "New Zealand",
  "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "North Korea", "Northern Marianas",
  "Norway", "Oman", "Pakistan", "Palau", "Panama", "Papua New Guinea", "Paraguay", "Peru",
  "Philippines", "Pitcairn Islands", "Poland", "Portugal", "Puerto Rico", "Qatar",
  "Reunion", "Romania", "Russia", "Rwanda", "Sqo Tome and Principe", "Saint Helena",
  "Saint Kitts and Nevis", "Saint Lucia", "Saint Pierre and Miquelon",
  "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Saudi Arabia", "Senegal",
  "Seychelles", "Sierra Leone", "Singapore", "Slovakia", "Slovenia", "Solomon Islands",
  "Somalia", "South Africa", "South Georgia and the South Sandwich Islands", "South Korea",
  "Spain", "Sri Lanka", "Sudan", "Suriname", "Svalbard and Jan Mayen", "Swaziland", "Sweden",
  "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "The Bahamas",
  "The Gambia", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey",
  "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "Virgin Islands", "Uganda",
  "Ukraine", "United Arab Emirates", "United Kingdom",
  "United States", "United States Minor Outlying Islands", "Uruguay", "Uzbekistan",
  "Vanuatu", "Vatican City", "Venezuela", "Vietnam", "Wallis and Futuna", "Western Sahara",
  "Yemen", "Yugoslavia", "Zambia", "Zimbabwe"
};

Это список предложений, которые будут предоставлены в раскрывающемся списке, когда пользователь вводит вAutoCompleteTextViewThis is the list of suggestions that will be provided in a drop-down list when the user types into the AutoCompleteTextView ».widget.

Запустите приложение.Run the application. По мере ввода вы увидите нечто вроде:As you type, you should see something like this:

Пример автозаполнения снимок экрана со списком имен, содержащих "CA"Example auto-complete screenshot listing names that contain "ca"

Дополнительные сведенияMore Information

Обратите внимание, что использование жестко закодированного массива строк не является рекомендуемым подходом к проектированию, поскольку код приложения должен сосредоточиться на поведении, а не на содержимом.Note that using a hard-coded string array is not a recommended design practice because your application code should focus on behavior, not content. Содержимое приложения, например строки, должно быть внешним из кода для упрощения и упрощения локализации содержимого.Application content such as strings should be externalized from the code to make modifications to the content easier and facilitate localization of the content. Жестко запрограммированные строки используются в этом учебнике только для того, чтобы сделать его простым и сосредоточиться наAutoCompleteTextViewThe hard-coded strings are used in this tutorial only to make it simple and focus on the AutoCompleteTextView ».widget. Вместо этого приложение должно объявлять такие строковые массивы в XML-файле.Instead, your application should declare such string arrays in an XML file. Это можно сделать с помощью <string-array> ресурса в файле проекта. res/values/strings.xmlThis can be done with a <string-array> resource in your project res/values/strings.xml file. Например:For example:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string-array name="countries_array">
        <item>Bahrain</item>
        <item>Bangladesh</item>
        <item>Barbados</item>
        <item>Belarus</item>
        <item>Belgium</item>
        <item>Belize</item>
        <item>Benin</item>
    </string-array>
</resources>

Чтобы использовать эти строки ресурсов для ArrayAdapter, замените исходный элементArrayAdapterTo use these resource strings for the ArrayAdapter, replace the original ArrayAdapter строка конструктора со следующим:constructor line with the following:

string[] countries = Resources.GetStringArray (Resource.array.countries_array);
var adapter = new ArrayAdapter<String> (this, Resource.layout.list_item, countries);

СсылкиReferences

Части этой страницы являются изменениями на основе работы, созданной и совместно используемой проектом Android с открытым кодом, и используются в соответствии с терминами, описанными в лицензии Creative commons attribution 2,5. Это руководство основано на руководстве по автоматическому заполнению Android *.Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License. This tutorial is based on the Android Auto Complete tutorial*.