Na tej stronie dowiesz się, jak dodać obiekt QuickContactBadge do interfejsu użytkownika i jak powiązać z nim dane. QuickContactBadge to widżet, który początkowo wyświetla się jako obraz miniatury. Jako obrazu miniatury możesz użyć dowolnego parametru Bitmap, ale zazwyczaj używasz parametru Bitmap odkodowanego z obrazu miniatury zdjęcia kontaktu.
Mały obraz pełni funkcję elementu sterującego. Gdy użytkownik go kliknie, QuickContactBadge rozwinie się do okna zawierającego:
- Duży obraz
- Duży obraz powiązany z kontaktem lub, jeśli zdjęcie jest niedostępne, grafika zastępcza.
- ikony aplikacji;
- Ikona aplikacji dla każdego fragmentu danych szczegółowych, które mogą być obsługiwane przez wbudowaną aplikację. Jeśli na przykład szczegóły kontaktu zawierają co najmniej 1 adres e-mail, pojawi się ikona e-maila. Gdy użytkownik dotknie tej ikony, wyświetlą się wszystkie adresy e-mail kontaktu. Gdy użytkownik kliknie jeden z adresów, aplikacja do poczty e-mail wyświetli ekran, aby utworzyć wiadomość na wybrany adres.
Widok QuickContactBadge zapewnia natychmiastowy dostęp do szczegółów kontaktu i umożliwia szybką komunikację z nim. Użytkownicy nie muszą wyszukiwać kontaktu, znajdować i kopiować informacji oraz wklejać je do odpowiedniej aplikacji. Zamiast tego mogą kliknąć QuickContactBadge, wybrać metodę komunikacji, której chcą użyć, i wysłać informacje związane z tą metodą bezpośrednio do odpowiedniej aplikacji.
Dodaj widok plakietki QuickContact
Aby dodać QuickContactBadge, wstaw element <QuickContactBadge> w układzie zgodnie z tym przykładem:
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent">
...
<QuickContactBadge
android:id=@+id/quickbadge
android:layout_height="wrap_content"
android:layout_width="wrap_content"
android:scaleType="centerCrop"/>
...
</RelativeLayout>
Pobieranie danych dostawcy
Aby wyświetlić kontakt w polu QuickContactBadge, potrzebujesz identyfikatora URI treści dla kontaktu i Bitmap dla małego obrazu. Zarówno identyfikator URI treści, jak i Bitmap są generowane na podstawie kolumn pobranych od dostawcy kontaktów. Określ te kolumny w ramach prognozy, której używasz do wczytywania danych do: Cursor.
W przypadku Androida w wersji 3.0 (poziom interfejsu API 11) lub nowszej uwzględnij w prognozie te kolumny:
W przypadku Androida 2.3.3 (poziom interfejsu API 10) lub starszych wersji użyj tych kolumn:
W przykładach na tej stronie założono, że komponent Cursor zawierający te kolumny i pozostałe wybrane kolumny został wczytany. Aby dowiedzieć się, jak pobierać kolumny z tabeli Cursor, przeczytaj sekcję Pobieranie listy kontaktów.
Ustawianie identyfikatora URI kontaktu i miniatury
Gdy uzyskasz niezbędne kolumny, możesz powiązać dane z: QuickContactBadge.
Ustawianie identyfikatora URI kontaktu
Aby ustawić identyfikator URI treści dla kontaktu, wywołaj getLookupUri(id,lookupKey), aby uzyskać CONTENT_LOOKUP_URI, a następnie wybierz assignContactUri(), aby ustawić kontakt. Widać to w tym przykładzie:
Kotlin
// The Cursor that contains contact rows
var cursor: Cursor? = null
// The index of the _ID column in the Cursor
var idColumn: Int = 0
// The index of the LOOKUP_KEY column in the Cursor
var lookupKeyColumn: Int = 0
// A content URI for the desired contact
var contactUri: Uri? = null
// A handle to the QuickContactBadge view
...
cursor?.let { cursor ->
/*
* Insert code here to move to the desired cursor row
*/
// Gets the _ID column index
idColumn = cursor.getColumnIndex(ContactsContract.Contacts._ID)
// Gets the LOOKUP_KEY index
lookupKeyColumn = cursor.getColumnIndex(ContactsContract.Contacts.LOOKUP_KEY)
// Gets a content URI for the contact
contactUri = ContactsContract.Contacts.getLookupUri(
cursor.getLong(idColumn),
cursor.getString(lookupKeyColumn)
)
binding.badge.assignContactUri(contactUri)
}
Java
// The Cursor that contains contact rows
Cursor cursor;
// The index of the _ID column in the Cursor
int idColumn;
// The index of the LOOKUP_KEY column in the Cursor
int lookupKeyColumn;
// A content URI for the desired contact
Uri contactUri;
...
/*
* Insert code here to move to the desired cursor row
*/
// Gets the _ID column index
idColumn = cursor.getColumnIndex(ContactsContract.Contacts._ID);
// Gets the LOOKUP_KEY index
lookupKeyColumn = cursor.getColumnIndex(ContactsContract.Contacts.LOOKUP_KEY);
// Gets a content URI for the contact
contactUri =
Contacts.getLookupUri(
cursor.getLong(idColumn),
cursor.getString(lookupKeyColumn)
);
binding.badge.assignContactUri(contactUri);
Gdy użytkownik kliknie ikonę QuickContactBadge, w oknie pojawią się szczegóły kontaktu.
Ustaw miniaturę zdjęcia
Ustawienie identyfikatora URI kontaktu dla elementu QuickContactBadge nie powoduje automatycznego wczytywania miniatury kontaktu. Aby wczytać zdjęcie, pobierz jego identyfikator URI z wiersza Cursor kontaktu, otwórz plik zawierający skompresowane zdjęcie miniatury i zapisz plik w: Bitmap.
Uwaga: kolumna PHOTO_THUMBNAIL_URI jest niedostępna na platformie w wersjach starszych niż 3.0. W przypadku tych wersji musisz pobrać identyfikator URI z podtabeli Contacts.Photo.
Najpierw skonfiguruj zmienne, aby uzyskać dostęp do sekcji Cursor zawierającej kolumny Contacts._ID i Contacts.LOOKUP_KEY:
Kotlin
// The column in which to find the thumbnail ID
var thumbnailColumn: Int = 0
/*
* The thumbnail URI, expressed as a String.
* Contacts Provider stores URIs as String values.
*/
var thumbnailUri: String? = null
...
cursor?.let { cursor ->
/*
* Gets the photo thumbnail column index if
* platform version >= Honeycomb
*/
thumbnailColumn = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
cursor.getColumnIndex(ContactsContract.Contacts.PHOTO_THUMBNAIL_URI)
// Otherwise, sets the thumbnail column to the _ID column
} else {
idColumn
}
/*
* Assuming the current Cursor position is the contact you want,
* gets the thumbnail ID
*/
thumbnailUri = cursor.getString(thumbnailColumn)
}
Java
// The column in which to find the thumbnail ID
int thumbnailColumn;
/*
* The thumbnail URI, expressed as a String.
* Contacts Provider stores URIs as String values.
*/
String thumbnailUri;
...
/*
* Gets the photo thumbnail column index if
* platform version >= Honeycomb
*/
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
thumbnailColumn =
cursor.getColumnIndex(ContactsContract.Contacts.PHOTO_THUMBNAIL_URI);
// Otherwise, sets the thumbnail column to the _ID column
} else {
thumbnailColumn = idColumn;
}
/*
* Assuming the current Cursor position is the contact you want,
* gets the thumbnail ID
*/
thumbnailUri = cursor.getString(thumbnailColumn);
...
Zdefiniuj metodę, która pobiera dane związane ze zdjęciem dla kontaktu i wymiary w widoku docelowym i zwraca miniaturę o prawidłowym rozmiarze w funkcji Bitmap. Zacznij od utworzenia identyfikatora URI wskazującego miniaturę:
Kotlin
/**
* Load a contact photo thumbnail and return it as a Bitmap,
* resizing the image to the provided image dimensions as needed.
* @param photoData photo ID Prior to Honeycomb, the contact's _ID value.
* For Honeycomb and later, the value of PHOTO_THUMBNAIL_URI.
* @return A thumbnail Bitmap, sized to the provided width and height.
* Returns null if the thumbnail is not found.
*/
private fun loadContactPhotoThumbnail(photoData: String): Bitmap? {
// Creates an asset file descriptor for the thumbnail file
var afd: AssetFileDescriptor? = null
// try-catch block for file not found
try {
// Creates a holder for the URI
val thumbUri: Uri = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
// If Android 3.0 or later,
// sets the URI from the incoming PHOTO_THUMBNAIL_URI
Uri.parse(photoData)
} else {
// Prior to Android 3.0, constructs a photo Uri using _ID
/*
* Creates a contact URI from the Contacts content URI
* incoming photoData (_ID)
*/
val contactUri: Uri =
Uri.withAppendedPath(ContactsContract.Contacts.CONTENT_URI, photoData)
/*
* Creates a photo URI by appending the content URI of
* Contacts.Photo
*/
Uri.withAppendedPath(contactUri, ContactsContract.Contacts.Photo.CONTENT_DIRECTORY)
}
/*
* Retrieves an AssetFileDescriptor object for the thumbnail URI
* using ContentResolver.openAssetFileDescriptor
*/
afd = activity?.contentResolver?.openAssetFileDescriptor(thumbUri, "r")
/*
* Gets a file descriptor from the asset file descriptor.
* This object can be used across processes.
*/
return afd?.fileDescriptor?.let {fileDescriptor ->
// Decodes the photo file and returns the result as a Bitmap
// if the file descriptor is valid
BitmapFactory.decodeFileDescriptor(fileDescriptor, null, null)
}
} catch (e: FileNotFoundException) {
/*
* Handle file not found errors
*/
null
} finally {
// In all cases, close the asset file descriptor
try {
afd?.close()
} catch (e: IOException) {
}
}
}
Java
/**
* Load a contact photo thumbnail and return it as a Bitmap,
* resizing the image to the provided image dimensions as needed.
* @param photoData photo ID Prior to Honeycomb, the contact's _ID value.
* For Honeycomb and later, the value of PHOTO_THUMBNAIL_URI.
* @return A thumbnail Bitmap, sized to the provided width and height.
* Returns null if the thumbnail is not found.
*/
private Bitmap loadContactPhotoThumbnail(String photoData) {
// Creates an asset file descriptor for the thumbnail file
AssetFileDescriptor afd = null;
// try-catch block for file not found
try {
// Creates a holder for the URI
Uri thumbUri;
// If Android 3.0 or later
if (Build.VERSION.SDK_INT
>=
Build.VERSION_CODES.HONEYCOMB) {
// Sets the URI from the incoming PHOTO_THUMBNAIL_URI
thumbUri = Uri.parse(photoData);
} else {
// Prior to Android 3.0, constructs a photo Uri using _ID
/*
* Creates a contact URI from the Contacts content URI
* incoming photoData (_ID)
*/
final Uri contactUri = Uri.withAppendedPath(
ContactsContract.Contacts.CONTENT_URI, photoData);
/*
* Creates a photo URI by appending the content URI of
* Contacts.Photo
*/
thumbUri =
Uri.withAppendedPath(
contactUri, ContactsContract.Contacts.Photo.CONTENT_DIRECTORY);
}
/*
* Retrieves an AssetFileDescriptor object for the thumbnail URI
* using ContentResolver.openAssetFileDescriptor
*/
afd = getActivity().getContentResolver().
openAssetFileDescriptor(thumbUri, "r");
/*
* Gets a file descriptor from the asset file descriptor.
* This object can be used across processes.
*/
FileDescriptor fileDescriptor = afd.getFileDescriptor();
// Decodes the photo file and returns the result as a Bitmap
// if the file descriptor is valid
if (fileDescriptor != null) {
// Decodes the bitmap
return BitmapFactory.decodeFileDescriptor(
fileDescriptor, null, null);
}
// If the file isn't found
} catch (FileNotFoundException e) {
/*
* Handle file not found errors
*/
// In all cases, close the asset file descriptor
} finally {
if (afd != null) {
try {
afd.close();
} catch (IOException e) {}
}
}
return null;
}
Wywołaj w kodzie metodę loadContactPhotoThumbnail(), aby uzyskać miniaturę Bitmap, i użyj wyniku do ustawienia miniatury zdjęcia w QuickContactBadge:
Kotlin
...
/*
* Decodes the thumbnail file to a Bitmap
*/
mThumbnailUri?.also { thumbnailUri ->
loadContactPhotoThumbnail(thumbnailUri).also { thumbnail ->
/*
* Sets the image in the QuickContactBadge.
* QuickContactBadge inherits from ImageView.
*/
badge.setImageBitmap(thumbnail)
}
}
Java
...
/*
* Decodes the thumbnail file to a Bitmap
*/
Bitmap mThumbnail =
loadContactPhotoThumbnail(thumbnailUri);
/*
* Sets the image in the QuickContactBadge.
* QuickContactBadge inherits from ImageView.
*/
badge.setImageBitmap(mThumbnail);
Dodawanie plakietki QuickContact do elementu ListView
QuickContactBadge to przydatny dodatek do ListView, który wyświetla listę kontaktów. Kliknij QuickContactBadge, aby wyświetlić miniaturę każdego kontaktu. Gdy użytkownik kliknie miniaturę, wyświetli się okno QuickContactBadge.
Dodaj element QuickContactBadge
Na początek dodaj do układu elementu element widoku QuickContactBadge. Jeśli na przykład chcesz wyświetlać QuickContactBadge i nazwę każdego pobieranego kontaktu, umieść ten kod XML w pliku układu:
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<QuickContactBadge
android:id="@+id/quickcontact"
android:layout_height="wrap_content"
android:layout_width="wrap_content"
android:scaleType="centerCrop"/>
<TextView android:id="@+id/displayname"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_toRightOf="@+id/quickcontact"
android:gravity="center_vertical"
android:layout_alignParentRight="true"
android:layout_alignParentTop="true"/>
</RelativeLayout>
W kolejnych sekcjach ten plik jest nazywany contact_item_layout.xml.
Konfigurowanie niestandardowego elementu CursorAdapter
Aby powiązać CursorAdapter z ListView, który zawiera QuickContactBadge, zdefiniuj niestandardowy adapter rozszerzający CursorAdapter. Ta metoda umożliwia przetwarzanie danych w obiekcie Cursor przed powiązaniem ich z QuickContactBadge. Ta metoda umożliwia też powiązanie wielu kolumn Cursor z kolumną QuickContactBadge. Żadna z tych operacji nie jest możliwa w zwykłym elemencie CursorAdapter.
Zdefiniowana przez Ciebie podklasa obiektu CursorAdapter musi zastąpić te metody:
CursorAdapter.newView()- Nadmiaruje nowy obiekt
View, aby przechowywać układ elementu. W zastąpieniu tej metody zapisz uchwyty podrzędnych obiektówViewukładu, w tym obiektów podrzędnychQuickContactBadge. Dzięki temu unikniesz konieczności przekazywania nicków do podrzędnych obiektówViewza każdym razem, gdy tworzysz nowy układ.Musisz zastąpić tę metodę, aby uzyskać nicki do poszczególnych podrzędnych obiektów
View. Ta metoda pozwala kontrolować ich powiązanie wCursorAdapter.bindView(). CursorAdapter.bindView()- Przenosi dane z bieżącego wiersza
Cursordo podrzędnych obiektówViewukładu elementu. Musisz zastąpić tę metodę, aby powiązać identyfikator URI i miniaturę kontaktu z zasobemQuickContactBadge. Domyślna implementacja zezwala tylko na mapowanie 1:1 między kolumną a elementemView.
Ten fragment kodu zawiera przykład niestandardowej podklasy CursorAdapter:
Zdefiniuj adapter listy niestandardowej
Zdefiniuj podklasę klasy CursorAdapter, w tym jej konstruktor, i zastąp newView() oraz bindView():
Kotlin
/**
* Defines a class that holds resource IDs of each item layout
* row to prevent having to look them up each time data is
* bound to a row
*/
private data class ViewHolder(
internal var displayname: TextView? = null,
internal var quickcontact: QuickContactBadge? = null
)
/**
*
*
*/
private inner class ContactsAdapter(
context: Context,
val inflater: LayoutInflater = LayoutInflater.from(context)
) : CursorAdapter(context, null, 0) {
...
override fun newView(
context: Context,
cursor: Cursor,
viewGroup: ViewGroup
): View {
/* Inflates the item layout. Stores view references
* in a ViewHolder class to prevent having to look
* them up each time bindView() is called.
*/
return ContactListLayoutBinding.inflate(inflater,
viewGroup,
false).also { binding ->
view.tag = ViewHolder().apply {
displayname = binding.displayname
quickcontact = binding.quickcontact
}
}.root
}
...
override fun bindView(view: View?, context: Context?, cursor: Cursor?) {
(view?.tag as? ViewHolder)?.also { holder ->
cursor?.apply {
...
// Sets the display name in the layout
holder.displayname?.text = getString(displayNameIndex)
...
/*
* Generates a contact URI for the QuickContactBadge
*/
ContactsContract.Contacts.getLookupUri(
getLong(idIndex),
cursor.getString(lookupKeyIndex)
).also { contactUri ->
holder.quickcontact?.assignContactUri(contactUri)
}
getString(photoDataIndex)?.also {photoData ->
/*
* Decodes the thumbnail file to a Bitmap.
* The method loadContactPhotoThumbnail() is defined
* in the section "Set the contact URI and thumbnail."
*/
loadContactPhotoThumbnail(photoData)?.also { thumbnailBitmap ->
/*
* Sets the image in the QuickContactBadge.
* QuickContactBadge inherits from ImageView.
*/
holder.quickcontact?.setImageBitmap(thumbnailBitmap)
}
}
}
}
}
}
Java
private class ContactsAdapter extends CursorAdapter {
private LayoutInflater inflater;
...
public ContactsAdapter(Context context) {
super(context, null, 0);
/*
* Gets an inflater that can instantiate
* the ListView layout from the file
*/
inflater = LayoutInflater.from(context);
...
}
...
/**
* Defines a class that holds resource IDs of each item layout
* row to prevent having to look them up each time data is
* bound to a row
*/
private class ViewHolder {
TextView displayname;
QuickContactBadge quickcontact;
}
...
@Override
public View newView(
Context context,
Cursor cursor,
ViewGroup viewGroup) {
/* Inflates the item layout. Stores view references
* in a ViewHolder class to prevent having to look
* them up each time bindView() is called.
*/
final ContactListLayoutBinding binding =
ContactListLayoutBinding.inflate(inflater,
viewGroup,
false);
final ViewHolder holder = new ViewHolder();
holder.displayname =
binding.displayName;
holder.quickcontact =
binding.quickContact;
view.setTag(holder);
return binding.root;
}
...
@Override
public void bindView(
View view,
Context context,
Cursor cursor) {
final ViewHolder holder = (ViewHolder) view.getTag();
final String photoData =
cursor.getString(photoDataIndex);
final String displayName =
cursor.getString(displayNameIndex);
...
// Sets the display name in the layout
holder.displayname = cursor.getString(displayNameIndex);
...
/*
* Generates a contact URI for the QuickContactBadge
*/
final Uri contactUri = Contacts.getLookupUri(
cursor.getLong(idIndex),
cursor.getString(lookupKeyIndex));
holder.quickcontact.assignContactUri(contactUri);
String photoData = cursor.getString(photoDataIndex);
/*
* Decodes the thumbnail file to a Bitmap.
* The method loadContactPhotoThumbnail() is defined
* in the section "Set the contact URI and thumbnail."
*/
Bitmap thumbnailBitmap =
loadContactPhotoThumbnail(photoData);
/*
* Sets the image in the QuickContactBadge.
* QuickContactBadge inherits from ImageView.
*/
holder.quickcontact.setImageBitmap(thumbnailBitmap);
}
Konfigurowanie zmiennych
Skonfiguruj w kodzie zmienne obejmujące rzut Cursor, który obejmuje niezbędne kolumny, tak jak w tym przykładzie.
Uwaga: te fragmenty kodu używają metody loadContactPhotoThumbnail(), która jest zdefiniowana w sekcji Ustawianie identyfikatora URI i miniatury kontaktu.
Kotlin
/*
* Defines a projection based on platform version. This ensures
* that you retrieve the correct columns.
*/
private val PROJECTION: Array<out String> = arrayOf(
ContactsContract.Contacts._ID,
ContactsContract.Contacts.LOOKUP_KEY,
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
ContactsContract.Contacts.DISPLAY_NAME_PRIMARY
} else {
ContactsContract.Contacts.DISPLAY_NAME
},
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
ContactsContract.Contacts.PHOTO_FILE_ID
} else {
/*
* Although it's not necessary to include the
* column twice, this keeps the number of
* columns the same regardless of version
*/
ContactsContract.Contacts._ID
}
)
...
class ContactsFragment : Fragment(), LoaderManager.LoaderCallbacks<Cursor> {
...
// Defines a ListView
private val listView: ListView? = null
// Defines a ContactsAdapter
private val adapter: ContactsAdapter? = null
...
// Defines a Cursor to contain the retrieved data
private val cursor: Cursor? = null
/*
* As a shortcut, defines constants for the
* column indexes in the Cursor. The index is
* 0-based and always matches the column order
* in the projection.
*/
// Column index of the _ID column
private val idIndex = 0
// Column index of the LOOKUP_KEY column
private val lookupKeyIndex = 1
// Column index of the display name column
private val displayNameIndex = 3
/*
* Column index of the photo data column.
* It's PHOTO_THUMBNAIL_URI for Honeycomb and later,
* and _ID for previous versions.
*/
private val photoDataIndex: Int =
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) 3 else 0
...
Java
public class ContactsFragment extends Fragment implements
LoaderManager.LoaderCallbacks<Cursor> {
...
// Defines a ListView
private ListView listView;
// Defines a ContactsAdapter
private ContactsAdapter adapter;
...
// Defines a Cursor to contain the retrieved data
private Cursor cursor;
/*
* Defines a projection based on platform version. This ensures
* that you retrieve the correct columns.
*/
private static final String[] PROJECTION =
{
ContactsContract.Contacts._ID,
ContactsContract.Contacts.LOOKUP_KEY,
(Build.VERSION.SDK_INT >=
Build.VERSION_CODES.HONEYCOMB) ?
ContactsContract.Contacts.DISPLAY_NAME_PRIMARY :
ContactsContract.Contacts.DISPLAY_NAME
(Build.VERSION.SDK_INT >=
Build.VERSION_CODES.HONEYCOMB) ?
ContactsContract.Contacts.PHOTO_FILE_ID :
/*
* Although it's not necessary to include the
* column twice, this keeps the number of
* columns the same regardless of version
*/
ContactsContract.Contacts._ID
};
/*
* As a shortcut, defines constants for the
* column indexes in the Cursor. The index is
* 0-based and always matches the column order
* in the projection.
*/
// Column index of the _ID column
private int idIndex = 0;
// Column index of the LOOKUP_KEY column
private int lookupKeyIndex = 1;
// Column index of the display name column
private int displayNameIndex = 3;
/*
* Column index of the photo data column.
* It's PHOTO_THUMBNAIL_URI for Honeycomb and later,
* and _ID for previous versions.
*/
private int photoDataIndex =
Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB ?
3 :
0;
...
Konfigurowanie obiektu ListView
W Fragment.onCreate() utwórz instancję niestandardowego adaptera kursora i uzyskaj uchwyt do ListView:
Kotlin
override fun onCreateView(
inflater: LayoutInflater,
container: ViewGroup?,
savedInstanceState: Bundle?
): View? {
return FragmentListViewBinding.inflate(...).let { binding ->
...
/*
* Gets a handle to the ListView in the file
* contact_list_layout.xml
*/
listView = binding.contactList
mAdapter?.also {
listView?.adapter = it
}
...
}.root
}
...
Java
@Override
public View onCreateView(LayoutInflater inflater,
ViewGroup container, Bundle savedInstanceState) {
FragmentListViewBinding binding = FragmentListViewBinding.inflate(...)
...
/*
* Gets a handle to the ListView in the file
* contact_list_layout.xml
*/
if (binding.contactListView != null && adapter != null) {
binding.contactListView.setAdapter(adapter);
}
...
}
...
W onViewCreated() powiąż ContactsAdapter z ListView:
Kotlin
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
super.onViewCreated(view, savedInstanceState)
/*
* Instantiates the subclass of
* CursorAdapter
*/
mAdapter = activity?.let {
ContactsAdapter(it).also { adapter ->
// Sets up the adapter for the ListView
listView?.adapter = adapter
}
}
}
Java
@Override
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
...
/*
* Instantiates the subclass of
* CursorAdapter
*/
mAdapter = new ContactsAdapter(getActivity());
// Sets up the adapter for the ListView
if (listView != null && mAdapter != null) {
listView.setAdapter(mAdapter);
}
...
}
...
Gdy otrzymasz polecenie Cursor z danymi kontaktów (zwykle onLoadFinished()), zadzwoń pod numer swapCursor(), aby przenieść dane z Cursor do: ListView. Wyświetlane są QuickContactBadge dla każdego wpisu na liście kontaktów.
Kotlin
override fun onLoadFinished(loader: Loader<Cursor>, cursor: Cursor) {
// When the loader has completed, swap the cursor into the adapter
mAdapter?.swapCursor(cursor)
}
Java
public void onLoadFinished(Loader<Cursor> loader, Cursor cursor) {
// When the loader has completed, swap the cursor into the adapter
mAdapter.swapCursor(cursor);
}
Jeśli powiążesz obiekt Cursor z klasą ListView za pomocą CursorAdapter (lub podklasy) i załadujesz Cursor za pomocą klasy CursorLoader, w implementacji onLoaderReset() zawsze będziesz mieć jasne odniesienia do Cursor.
Widać to w tym przykładzie:
Kotlin
override fun onLoaderReset(loader: Loader<Cursor>) {
// Removes remaining reference to the previous Cursor
adapter?.swapCursor(null)
}
Java
@Override
public void onLoaderReset(Loader<Cursor> loader) {
// Removes remaining reference to the previous Cursor
adapter.swapCursor(null);
}