Sdílet prostřednictvím

Xamarin.Android ListView

  • Článek

ListView je důležitou součástí uživatelského rozhraní aplikací pro Android; používá se všude z krátkých seznamů možností nabídky až po dlouhé seznamy kontaktů nebo oblíbených internetových položek. Poskytuje jednoduchý způsob, jak prezentovat posuvný seznam řádků, které lze buď formátovat pomocí předdefinovaného stylu, nebo přizpůsobit široce.

Přehled

Zobrazení seznamů a adaptéry jsou součástí nejzákladnějších stavebních bloků aplikací pro Android. Třída ListView poskytuje flexibilní způsob prezentace dat, ať už je to krátká nabídka nebo dlouhý seznam posouvání. Poskytuje funkce použitelnosti, jako je rychlé posouvání, indexy a jeden nebo více výběrů, které vám pomůžou vytvářet uživatelská rozhraní pro vaše aplikace přívětivá pro mobilní zařízení. ListView Instance vyžaduje, aby adaptér nasílil data obsažená v zobrazení řádků.

Tato příručka vysvětluje, jak implementovat ListView různé Adapter třídy v Xamarin.Android. Ukazuje také, jak přizpůsobit vzhled a ListViewpopisuje důležitost opětovného použití řádku ke snížení spotřeby paměti. Existuje také několik diskuzí o tom, jak životní cyklus aktivity ovlivňuje ListView a Adapter používá. Pokud pracujete na multiplatformních aplikacích s Xamarin.iOS, ListView je ovládací prvek strukturálně podobný iOSu UITableView (a Android Adapter je podobný UITableViewSource).

Nejprve krátký kurz představuje ListView základní příklad kódu. Dále jsou k dispozici odkazy na pokročilejší témata, která vám pomůžou používat ListView v reálných aplikacích.

Poznámka:

Widget RecyclerView je pokročilejší a flexibilnější verze ListView. Vzhledem k tomu RecyclerView , že je navržen jako následník ListView (a GridView), doporučujeme místo vývoje nových aplikací používat RecyclerView ListView . Další informace naleznete v části RecyclerView.

Kurz k objektu ListView

ListView je ViewGroup vytvoří seznam posouvatelných položek. Položky seznamu se automaticky vloží do seznamu pomocí .IListAdapter

V tomto kurzu vytvoříte posuvný seznam názvů zemí a oblastí, které se čtou z pole řetězců. Když je vybrána položka seznamu, zobrazí se v seznamu informační zpráva umístění položky.

Spusťte nový projekt s názvem HelloListView.

Vytvořte soubor XML s názvem list_item.xml a uložte ho do složky Resources/Layout/ . Vložte následující:

<?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">
</TextView>

Tento soubor definuje rozložení pro každou položku, která bude umístěna v souboru ListView.

Otevřete MainActivity.cs a upravte třídu tak, aby se rozšířila ListActivity (místo Activity):

public class MainActivity : ListActivity
{

Vložte následující kód pro metodu OnCreate()):

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

    ListAdapter = new ArrayAdapter<string> (this, Resource.Layout.list_item, countries);

    ListView.TextFilterEnabled = true;

    ListView.ItemClick += delegate (object sender, AdapterView.ItemClickEventArgs args)
    {
        Toast.MakeText(Application, ((TextView)args.View).Text, ToastLength.Short).Show();
    };
}

Všimněte si, že se nenačte soubor rozložení pro aktivitu (kterou obvykle používáte SetContentView(int))). Místo toho nastavujte ListAdapter vlastnost automaticky přidá ListView vyplnit celou obrazovku ListActivity. Tato metoda přebírá ArrayAdapter<T>, který spravuje pole položek seznamu, které budou umístěny do ListView. ArrayAdapter<T>konstruktor přebírá aplikaci Context, popis rozložení pro každou položku seznamu (vytvořenou v předchozím kroku) a nebo T[]Java.Util.IList<T> pole objektů, které se mají vložit do ListView (definováno dále).

TextFilterEnabled vlastnost zapne filtrování textu pro ListView, takže když uživatel začne psát, seznam bude filtrován.

ItemClick Událost lze použít k odběru obslužných rutin pro kliknutí. Když je položka v ListView je kliknuta, obslužná rutina je volána a Toast zobrazí se zpráva s použitím textu z klikané položky.

Místo definování vlastního souboru rozložení pro danou platformu můžete použít návrhy položek seznamu poskytované platformou ListAdapter. Zkuste například použít místo Android.Resource.Layout.SimpleListItem1 Resource.Layout.list_item.

Přidejte následující using příkaz:

using System;

Dále přidejte následující pole řetězců jako člena MainActivity:

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

Toto je pole řetězců, které budou umístěny do ListView.

Aplikaci spusťte. Seznam můžete posouvat nebo ho můžete filtrovat tak, že kliknete na položku a zobrazí se zpráva. Měli byste vidět přibližně toto:

Ukázkový snímek obrazovky ListView s názvy zemí a oblastí

Všimněte si, že použití pevně zakódovaného pole řetězců není osvědčeným postupem návrhu. Jeden se používá v tomto kurzu pro zjednodušení, aby ukázal ListView Widget. Lepším postupem je odkazovat na pole řetězců definované externím zdrojem, například s prostředkem string-array v souboru Zdroje/Hodnoty/Strings.xml projektu. Příklad:

<?xml version="1.0" encoding="utf-8"?>
<resources>
  <string name="app_name">HelloListView</string>
  <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>

Chcete-li použít tyto řetězce prostředků pro položku ArrayAdapter, nahraďte původní ListAdapter řádek s následujícími informacemi:

string[] countries = Resources.GetStringArray (Resource.Array.countries_array);
ListAdapter = new ArrayAdapter<string> (this, Resource.Layout.list_item, countries);

Aplikaci spusťte. Měli byste vidět přibližně toto:

Ukázkový snímek obrazovky ListView s menším seznamem názvů

Další přechod s ListView

Zbývající témata (propojená níže) se komplexně podíváme na práci s ListView třídou a různými typy typů adaptérů, které s ní můžete použít. Struktura je následující:

  • Vizuální vzhled – části ListView ovládacího prvku a jejich fungování

  • Třídy – přehled tříd použitých k zobrazení ListView.

  • Zobrazení dat v ListView – Jak zobrazit jednoduchý seznam dat, jak implementovat ListView's funkce použitelnosti, jak používat různá předdefinovaná rozložení řádků a jak adaptéry šetří paměť opětovným použitím zobrazení řádků.

  • Vlastní vzhled – Změna stylu vlastního ListView rozložení, písem a barev

  • Použití SQLite – jak zobrazit data z databáze SQLite pomocí .CursorAdapter

  • Životní cyklus aktivity – Aspekty návrhu při implementaci ListView aktivit, včetně toho, kde v životním cyklu byste měli naplnit data a kdy uvolnit prostředky.

Diskuze (rozdělená do šesti částí) začíná přehledem ListView samotné třídy před zavedením postupně složitějších příkladů jeho použití.

Shrnutí

Tato sada témat představila ListView a poskytla několik příkladů, jak používat integrované funkce ListActivityrozhraní . Probírala vlastní implementace ListView , které umožňovaly barevné rozložení a použití databáze SQLite, a stručně se dotkla relevance životního cyklu aktivity ve vaší ListView implementaci.