Autouzupełnij dla platformy Xamarin.Android

Artykuł
03/05/2024

AutoCompleteTextView to edytowalny element widoku tekstu, który automatycznie wyświetla sugestie ukończenia podczas wpisywania przez użytkownika. Lista sugestii jest wyświetlana w menu rozwijanym, z którego użytkownik może wybrać element do zastąpienia zawartości pola edycji.

Example of Auto Complete

Omówienie

Aby utworzyć widżet wprowadzania tekstu, który udostępnia sugestie autouzupełnianiem, użyj elementu AutoCompleteTextView Widget. Sugestie są odbierane z kolekcji ciągów skojarzonych z widżetem za pośrednictwem elementu ArrayAdapter.

W tym samouczku utworzysz AutoCompleteTextView widżet zawierający sugestie dotyczące nazwy kraju.

<?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>

Jest TextView to etykieta, która wprowadza AutoCompleteTextView Widget.

Samouczek

Uruchom nowy projekt o nazwie HelloAutoComplete.

Utwórz plik XML o nazwie list_item.xml i zapisz go w folderze Resources/Layout . Ustaw akcję kompilacji tego pliku na AndroidResource. Edytuj plik, aby wyglądał następująco:

<?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>

Ten plik definiuje prosty element TextView , który będzie używany dla każdego elementu wyświetlanego na liście sugestii.

Otwórz plik Resources/Layout/Main.axml i wstaw następujące elementy:

<?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>

Otwórz MainActivity.cs i wstaw następujący kod dla elementu OnCreate() Metoda:

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;
}

Po ustawieniu widoku zawartości na main.xml układ AutoCompleteTextView widżet jest przechwytywany z układu za pomocą FindViewByIdpolecenia . Nowy ArrayAdapter element jest następnie inicjowany w celu powiązania list_item.xml układu z każdym elementem listy w COUNTRIES tablicy ciągów (zdefiniowanym w następnym kroku). Na koniec jest wywoływana, SetAdapter() aby skojarzyć element ArrayAdapter z AutoCompleteTextView widżet, aby tablica ciągów wypełniła listę sugestii.

MainActivity Wewnątrz klasy dodaj tablicę ciągów:

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"
};

Jest to lista sugestii, które zostaną podane na liście rozwijanej, gdy użytkownik wpisze je w AutoCompleteTextView Widget.

Uruchom aplikację. Podczas wpisywania powinny zostać wyświetlone następujące elementy:

Więcej informacji

Należy pamiętać, że używanie tablicy ciągów zakodowanych w kodzie nie jest zalecaną praktyką projektową, ponieważ kod aplikacji powinien skupić się na zachowaniu, a nie na zawartości. Zawartość aplikacji, taka jak ciągi, powinna być zewnętrzna od kodu, aby ułatwić modyfikowanie zawartości i ułatwić lokalizowanie zawartości. Zakodowane ciągi są używane w tym samouczku tylko w celu uproszczenia i skoncentrowania się na AutoCompleteTextView Widget. Zamiast tego aplikacja powinna zadeklarować takie tablice ciągów w pliku XML. Można to zrobić za pomocą <string-array> zasobu w pliku projektu res/values/strings.xml . Na przykład:

<?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>

Aby użyć tych ciągów zasobów dla ArrayAdapterelementu , zastąp oryginalny ciąg ArrayAdapter wiersz konstruktora z następującymi elementami:

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

Informacje

AutoCompleteTextView Przepis — przykładowy projekt platformy Xamarin.Android dla elementu AutoCompleteTextView
ArrayAdapter
AutoCompleteTextView

Części tej strony to modyfikacje oparte na pracy utworzonej i udostępnionej przez projekt open source systemu Android i używane zgodnie z warunkami opisanymi w licencji autorstwa Creative Commons 2.5. Ten samouczek jest oparty na samouczku autouzupełniania systemu Android*.

Udostępnij za pośrednictwem

Autouzupełnij dla platformy Xamarin.Android

Omówienie

Samouczek

Więcej informacji

Informacje

Dodatkowe zasoby