Android Api Listview

Android API ListView: Kapsamlı Bir Rehber

ListView, Android’de sıklıkla kullanılan bir bileşendir. Liste verilerini görüntülemek için kullanılır ve kullanıcıların liste öğelerini kaydırarak veya dokunarak seçmelerine olanak tanır. Bu makalede, ListView’in nasıl kullanılacağını ayrıntılı olarak ele alacağız.

ListView’in Temelleri

ListView, bir dizi öğeyi dikey olarak listeleyen bir bileşendir. Her öğe, bir metin, resim veya diğer öğelerden oluşan bir satırdır. Kullanıcılar, liste öğelerini kaydırarak veya dokunarak seçebilirler.

ListView’i kullanmak için öncelikle bir ListView nesnesi oluşturmanız gerekir. Bunu, XML düzen dosyanızda veya Java kodunuzda yapabilirsiniz. XML düzen dosyasında bir ListView oluşturmak için aşağıdaki kodu kullanabilirsiniz:

xml <ListView android:id="@+id/list_view" android:layout_width="match_parent" android:layout_height="match_parent" />

Java kodunda bir ListView oluşturmak için aşağıdaki kodu kullanabilirsiniz:

java ListView listView = new ListView(this);

ListView nesnesini oluşturduktan sonra, ona bir veri kaynağı atamanız gerekir. Veri kaynağı, ListView’in görüntüleyeceği öğeleri içeren bir nesnedir. Veri kaynağı olarak bir dizi, bir ArrayList veya bir Cursor kullanabilirsiniz.

Veri kaynağını ListView’e atamak için aşağıdaki kodu kullanabilirsiniz:

java listView.setAdapter(new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, items));

Bu kod, ListView’e bir dizi öğe atamaktadır. ArrayAdapter, ListView’in öğeleri nasıl görüntüleyeceğini belirleyen bir nesnedir.

ListView’in Özellikleri

ListView, çeşitli özelliklere sahiptir. Bu özellikler, ListView’in görünümünü ve davranışını özelleştirmenizi sağlar. ListView’in en önemli özellikleri şunlardır:

android:id: ListView’in kimliğini belirleyen bir değerdir. Bu değer, ListView’e erişmek için kullanılır.
android:layout_width: ListView’in genişliğini belirleyen bir değerdir.
android:layout_height: ListView’in yüksekliğini belirleyen bir değerdir.
android:divider: ListView’in öğeleri arasında görüntülenen ayırıcı çizginin rengini belirleyen bir değerdir.
android:dividerHeight: ListView’in öğeleri arasında görüntülenen ayırıcı çizginin yüksekliğini belirleyen bir değerdir.
android:choiceMode: ListView’in seçim modunu belirleyen bir değerdir. Seçim modu, kullanıcıların bir veya daha fazla öğeyi seçebilmesini belirler.
android:stackFromBottom: ListView’in öğelerini alttan üste doğru mı yoksa üstten alta doğru mu görüntüleyeceğini belirleyen bir değerdir.

ListView’in Metotları

ListView, çeşitli metotlar içerir. Bu metotlar, ListView’in öğelerini yönetmenizi ve ListView’in görünümünü ve davranışını özelleştirmenizi sağlar. ListView’in en önemli metotları şunlardır:

getAdapter(): ListView’e atanmış olan veri kaynağını döndürür.
setAdapter(Adapter adapter): ListView’e bir veri kaynağı atar.
getCount(): ListView’deki öğe sayısını döndürür.
getItem(int position): Belirtilen konumdaki öğeyi döndürür.
getItemId(int position): Belirtilen konumdaki öğenin kimliğini döndürür.
getView(int position, View convertView, ViewGroup parent): Belirtilen konumdaki öğenin görünümünü döndürür.
setSelection(int position): Belirtilen konumdaki öğeyi seçer.
getSelectedItemId(): Seçili öğenin kimliğini döndürür.
getSelectedView(): Seçili öğenin görünümünü döndürür.

ListView’in Örnekleri

ListView, çeşitli uygulamalarda kullanılabilir. Örneğin, bir ListView kullanarak bir alışveriş listesi, bir görev listesi veya bir kişi listesi görüntüleyebilirsiniz.

Aşağıdaki örnek, bir ListView kullanarak bir alışveriş listesi görüntüleyen bir Android uygulamasıdır:

xml <ListView android:id="@+id/list_view" android:layout_width="match_parent" android:layout_height="match_parent" />

“`java
public class ShoppingListActivity extends Activity {

private ListView listView;
private ArrayList<String> items;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_shopping_list);

    listView = (ListView) findViewById(R.id.list_view);

    items = new ArrayList<>();
    items.add("Elma");
    items.add("Armut");
    items.add("Muz");
    items.add("Portakal");
    items.add("Üzüm");

    ArrayAdapter<String> adapter = new ArrayAdapter<>(this, android.R.layout.simple_list_item_1, items);
    listView.setAdapter(adapter);
}

}
“`

Bu örnekte, ListView’i XML düzen dosyasında tanımladık ve Java kodunda ListView nesnesini oluşturduk. Daha sonra, ListView’e bir veri kaynağı atadık. Veri kaynağı, bir dizi öğe içeren bir ArrayList nesnesidir. Son olarak, ListView’e bir ArrayAdapter nesnesi atadık. ArrayAdapter, ListView’in öğeleri nasıl görüntüleyeceğini belirleyen bir nesnedir.