এই পৃষ্ঠাটি আপনাকে দেখায় কিভাবে আপনার UI-তে একটি QuickContactBadge
যোগ করতে হয় এবং কীভাবে এটিতে ডেটা আবদ্ধ করতে হয়। একটি QuickContactBadge
হল একটি উইজেট যা প্রাথমিকভাবে একটি থাম্বনেইল চিত্র হিসাবে প্রদর্শিত হয়৷ যদিও আপনি থাম্বনেইল ছবির জন্য যেকোনো Bitmap
ব্যবহার করতে পারেন, আপনি সাধারণত পরিচিতির ছবির থাম্বনেইল ছবি থেকে ডিকোড করা একটি Bitmap
ব্যবহার করেন।
ছোট ইমেজ একটি নিয়ন্ত্রণ হিসাবে কাজ করে; যখন ব্যবহারকারীরা ছবিটিতে ট্যাপ করেন, QuickContactBadge
নিম্নলিখিতগুলি সম্বলিত একটি ডায়ালগে প্রসারিত হয়:
- একটি বড় ইমেজ
- পরিচিতির সাথে যুক্ত বড় ছবি বা, যদি কোনো ছবি উপলব্ধ না হয়, তাহলে একটি স্থানধারক গ্রাফিক৷
- অ্যাপ আইকন
- প্রতিটি বিশদ ডেটার জন্য একটি অ্যাপ আইকন যা একটি অন্তর্নির্মিত অ্যাপ দ্বারা পরিচালনা করা যেতে পারে। উদাহরণস্বরূপ, যদি পরিচিতির বিশদ বিবরণে এক বা একাধিক ইমেল ঠিকানা অন্তর্ভুক্ত থাকে, একটি ইমেল আইকন প্রদর্শিত হবে। যখন ব্যবহারকারীরা আইকনে আলতো চাপেন, তখন সমস্ত পরিচিতির ইমেল ঠিকানাগুলি উপস্থিত হয়৷ ব্যবহারকারীরা যখন ঠিকানাগুলির একটিতে ট্যাপ করেন, তখন ইমেল অ্যাপটি নির্বাচিত ইমেল ঠিকানায় একটি বার্তা রচনা করার জন্য একটি স্ক্রীন প্রদর্শন করে।
QuickContactBadge
ভিউ একটি পরিচিতির বিবরণে তাত্ক্ষণিক অ্যাক্সেস এবং পরিচিতির সাথে যোগাযোগ করার একটি দ্রুত উপায় প্রদান করে৷ ব্যবহারকারীদের একটি পরিচিতি খুঁজতে হবে না, তথ্য খুঁজে বের করতে হবে এবং অনুলিপি করতে হবে, এবং তারপর উপযুক্ত অ্যাপে পেস্ট করতে হবে। পরিবর্তে, তারা QuickContactBadge
ট্যাপ করতে পারে, তারা যে যোগাযোগের পদ্ধতি ব্যবহার করতে চায় তা বেছে নিতে পারে এবং সেই পদ্ধতির তথ্য সরাসরি উপযুক্ত অ্যাপে পাঠাতে পারে।
একটি QuickContactBadge ভিউ যোগ করুন
একটি QuickContactBadge
যোগ করতে, আপনার লেআউটে একটি <QuickContactBadge>
উপাদান সন্নিবেশ করুন, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:
<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>
প্রদানকারীর ডেটা পুনরুদ্ধার করুন
QuickContactBadge
এ একটি পরিচিতি প্রদর্শন করতে, আপনার পরিচিতির জন্য একটি বিষয়বস্তু URI এবং ছোট ছবির জন্য একটি Bitmap
প্রয়োজন৷ আপনি পরিচিতি প্রদানকারী থেকে পুনরুদ্ধার করা কলাম থেকে সামগ্রী URI এবং Bitmap
উভয়ই তৈরি করেন। আপনার Cursor
ডেটা লোড করতে আপনি যে অভিক্ষেপ ব্যবহার করেন তার অংশ হিসাবে এই কলামগুলি নির্দিষ্ট করুন।
Android 3.0 (API স্তর 11) এবং উচ্চতর জন্য, আপনার অভিক্ষেপে নিম্নলিখিত কলামগুলি অন্তর্ভুক্ত করুন:
Android 2.3.3 (API লেভেল 10) এবং তার নিচের জন্য, নিম্নলিখিত কলামগুলি ব্যবহার করুন:
এই পৃষ্ঠার উদাহরণগুলি অনুমান করে যে একটি Cursor
যাতে এই কলামগুলি এবং অন্য কোন নির্বাচিত কলামগুলি লোড করা হয়েছে৷ কিভাবে একটি Cursor
কলাম পুনরুদ্ধার করতে হয় তা জানতে, পরিচিতিগুলির একটি তালিকা পুনরুদ্ধার দেখুন।
যোগাযোগের URI এবং থাম্বনেল সেট করুন
আপনার প্রয়োজনীয় কলামগুলি হয়ে গেলে, আপনি QuickContactBadge
এ ডেটা আবদ্ধ করতে পারেন।
যোগাযোগের URI সেট করুন
পরিচিতির জন্য সামগ্রী URI সেট করতে, একটি CONTENT_LOOKUP_URI
পেতে getLookupUri(id,lookupKey)
কল করুন, তারপর পরিচিতি সেট করতে assignContactUri()
এ কল করুন। এটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:
কোটলিন
// 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) }
জাভা
// 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);
যখন ব্যবহারকারীরা QuickContactBadge
আইকনে ট্যাপ করে, তখন পরিচিতির বিবরণ ডায়ালগে উপস্থিত হয়।
ছবির থাম্বনেইল সেট করুন
QuickContactBadge
জন্য যোগাযোগের URI সেট করা স্বয়ংক্রিয়ভাবে পরিচিতির থাম্বনেইল ফটো লোড করে না। ফটো লোড করতে, পরিচিতির Cursor
সারি থেকে ছবির জন্য একটি URI পান, সংকুচিত থাম্বনেইল ফটো ধারণকারী ফাইলটি খুলতে এটি ব্যবহার করুন এবং ফাইলটিকে একটি Bitmap
পড়ুন।
দ্রষ্টব্য: PHOTO_THUMBNAIL_URI
কলামটি 3.0-এর আগের প্ল্যাটফর্ম সংস্করণগুলিতে উপলব্ধ নয়৷ এই সংস্করণগুলির জন্য, আপনাকে অবশ্যই Contacts.Photo
সাবটেবিল থেকে URI পুনরুদ্ধার করতে হবে।
প্রথমে, Contacts._ID
ID এবং Contacts.LOOKUP_KEY
কলাম ধারণকারী Cursor
অ্যাক্সেস করতে ভেরিয়েবল সেট আপ করুন:
কোটলিন
// 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) }
জাভা
// 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); ...
একটি পদ্ধতি সংজ্ঞায়িত করুন যা গন্তব্য দৃশ্যের জন্য যোগাযোগ এবং মাত্রার জন্য ফটো-সম্পর্কিত ডেটা নেয় এবং একটি Bitmap
সঠিকভাবে আকারের থাম্বনেইল প্রদান করে। থাম্বনেইলের দিকে নির্দেশ করে এমন একটি URI তৈরি করে শুরু করুন:
কোটলিন
/** * 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) { } } }
জাভা
/** * 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; }
থাম্বনেইল Bitmap
পেতে আপনার কোডে loadContactPhotoThumbnail()
পদ্ধতিতে কল করুন এবং আপনার QuickContactBadge
এ ছবির থাম্বনেইল সেট করতে ফলাফলটি ব্যবহার করুন:
কোটলিন
... /* * 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) } }
জাভা
... /* * Decodes the thumbnail file to a Bitmap */ Bitmap mThumbnail = loadContactPhotoThumbnail(thumbnailUri); /* * Sets the image in the QuickContactBadge. * QuickContactBadge inherits from ImageView. */ badge.setImageBitmap(mThumbnail);
একটি ListView এ একটি QuickContactBadge যোগ করুন
একটি QuickContactBadge
হল একটি ListView
এর একটি দরকারী সংযোজন যা পরিচিতিগুলির একটি তালিকা প্রদর্শন করে৷ প্রতিটি পরিচিতির জন্য একটি থাম্বনেইল ছবি প্রদর্শন করতে QuickContactBadge
ব্যবহার করুন; ব্যবহারকারীরা থাম্বনেইলে ট্যাপ করলে, QuickContactBadge
ডায়ালগ দেখা যায়।
QuickContactBadge উপাদান যোগ করুন
শুরু করতে, আপনার আইটেম লেআউটে একটি QuickContactBadge
ভিউ উপাদান যোগ করুন উদাহরণস্বরূপ, আপনি যদি একটি QuickContactBadge
এবং আপনার পুনরুদ্ধার করা প্রতিটি পরিচিতির জন্য একটি নাম প্রদর্শন করতে চান, তাহলে নিম্নলিখিত XMLটিকে একটি লেআউট ফাইলে রাখুন:
<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>
নিম্নলিখিত বিভাগে, এই ফাইলটিকে contact_item_layout.xml
হিসাবে উল্লেখ করা হয়েছে।
একটি কাস্টম কার্সার অ্যাডাপ্টার সেট আপ করুন৷
একটি QuickContactBadge
সম্বলিত একটি ListView
এর সাথে একটি CursorAdapter
আবদ্ধ করতে, একটি কাস্টম অ্যাডাপ্টার সংজ্ঞায়িত করুন যা CursorAdapter
প্রসারিত করে। এই পদ্ধতি আপনাকে QuickContactBadge
এ আবদ্ধ করার আগে Cursor
থাকা ডেটা প্রক্রিয়া করতে দেয়। এই পদ্ধতিটি আপনাকে QuickContactBadge
এ একাধিক Cursor
কলাম আবদ্ধ করতে দেয়। নিয়মিত CursorAdapter
এই অপারেশনগুলির কোনটিই সম্ভব নয়।
CursorAdapter
এর সাবক্লাস যা আপনি সংজ্ঞায়িত করেছেন তা অবশ্যই নিম্নলিখিত পদ্ধতিগুলিকে ওভাররাইড করবে:
-
CursorAdapter.newView()
- আইটেম লেআউট ধরে রাখতে একটি নতুন
View
অবজেক্টকে স্ফীত করে। এই পদ্ধতির ওভাররাইডে, চাইল্ডQuickContactBadge
সহ লেআউটের অবজেক্টView
চাইল্ডের কাছে হ্যান্ডলগুলি সঞ্চয় করুন। এই পন্থা অবলম্বন করার মাধ্যমে, আপনি প্রতিবার একটি নতুন লেআউট স্ফীত করার সময় শিশুর কাছে হ্যান্ডেলগুলিView
এড়িয়ে যান।আপনাকে অবশ্যই এই পদ্ধতিটি ওভাররাইড করতে হবে যাতে আপনি পৃথক চাইল্ড
View
অবজেক্টের কাছে হ্যান্ডেল পেতে পারেন। এই কৌশলটি আপনাকেCursorAdapter.bindView()
এ তাদের বাঁধাই নিয়ন্ত্রণ করতে দেয়। -
CursorAdapter.bindView()
- বর্তমান
Cursor
সারি থেকে চাইল্ডে ডেটা স্থানান্তর করে আইটেম লেআউটের অবজেক্টView
। আপনাকে অবশ্যই এই পদ্ধতিটি ওভাররাইড করতে হবে যাতে আপনি পরিচিতির URI এবং থাম্বনেইল উভয়কেইQuickContactBadge
এ আবদ্ধ করতে পারেন। ডিফল্ট বাস্তবায়ন শুধুমাত্র একটি কলাম এবং একটিView
মধ্যে ওয়ান-টু-ওয়ান ম্যাপিংয়ের অনুমতি দেয়।
নিম্নলিখিত কোড স্নিপেটে CursorAdapter
একটি কাস্টম সাবক্লাসের উদাহরণ রয়েছে:
কাস্টম তালিকা অ্যাডাপ্টার সংজ্ঞায়িত করুন
CursorAdapter
এর কন্সট্রাকটর সহ এর সাবক্লাস সংজ্ঞায়িত করুন এবং newView()
এবং bindView()
ওভাররাইড করুন :
কোটলিন
/** * 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) } } } } } }
জাভা
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); }
ভেরিয়েবল সেট আপ করুন
আপনার কোডে, একটি Cursor
প্রজেকশন সহ ভেরিয়েবল সেট আপ করুন যাতে প্রয়োজনীয় কলামগুলি অন্তর্ভুক্ত থাকে, যেমনটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে।
দ্রষ্টব্য: নিম্নলিখিত কোড স্নিপেটগুলি loadContactPhotoThumbnail()
পদ্ধতি ব্যবহার করে, যা যোগাযোগের URI এবং থাম্বনেইল সেট করুন বিভাগে সংজ্ঞায়িত করা হয়েছে।
কোটলিন
/* * 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 ...
জাভা
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; ...
লিস্টভিউ সেট আপ করুন
Fragment.onCreate()
এ, কাস্টম কার্সার অ্যাডাপ্টারটি ইনস্ট্যান্টিয়েট করুন এবং ListView
এ একটি হ্যান্ডেল পান:
কোটলিন
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 } ...
জাভা
@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); } ... } ...
onViewCreated()
এ, ContactsAdapter
টিকে ListView
এ আবদ্ধ করুন:
কোটলিন
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 } } }
জাভা
@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); } ... } ...
যখন আপনি পরিচিতি ডেটা সম্বলিত একটি Cursor
ফেরত পান, সাধারণত onLoadFinished()
তে, swapCursor()
ListView
এ Cursor
ডেটা সরাতে কল করুন। এটি পরিচিতির তালিকায় প্রতিটি এন্ট্রির জন্য QuickContactBadge
প্রদর্শন করে।
কোটলিন
override fun onLoadFinished(loader: Loader<Cursor>, cursor: Cursor) { // When the loader has completed, swap the cursor into the adapter mAdapter?.swapCursor(cursor) }
জাভা
public void onLoadFinished(Loader<Cursor> loader, Cursor cursor) { // When the loader has completed, swap the cursor into the adapter mAdapter.swapCursor(cursor); }
আপনি যখন একটি CursorAdapter
(বা সাবক্লাস) দিয়ে একটি ListView
সাথে Cursor
আবদ্ধ করেন এবং Cursor
লোড করার জন্য একটি CursorLoader
ব্যবহার করেন, তখন আপনার onLoaderReset()
বাস্তবায়নে Cursor
রেফারেন্স পরিষ্কার করুন। এটি নিম্নলিখিত উদাহরণে দেখানো হয়েছে:
কোটলিন
override fun onLoaderReset(loader: Loader<Cursor>) { // Removes remaining reference to the previous Cursor adapter?.swapCursor(null) }
জাভা
@Override public void onLoaderReset(Loader<Cursor> loader) { // Removes remaining reference to the previous Cursor adapter.swapCursor(null); }