ListFragment 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。
[Android.Runtime.Register("android/app/ListFragment", DoNotGenerateAcw=true)]
public class ListFragment : Android.App.Fragment[<Android.Runtime.Register("android/app/ListFragment", DoNotGenerateAcw=true)>]
type ListFragment = class
inherit Fragment- 繼承
- 屬性
備註
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。
ListFragment 裝載可 android.widget.ListView ListView 系結至不同數據源的物件，通常是陣列或數據指標保存查詢結果。 下列各節將討論系結、畫面配置和數據列配置。
<強>螢幕配置</強式>
ListFragment 的預設版面配置是由單一列表檢視所組成。 不過，如有需要，您可以從 傳回自己的檢視階層 #onCreateView，以自定義片段配置。 若要這樣做，您的檢視階層 <em>必須</em> 包含標識符為 “ 的 ListView 物件
已取代這個成員。 使用支持連結庫androidx.fragment.app.ListFragment在所有裝置上保持一致的行為，以及存取生命週期。
的 android.app.ListFragmentJava 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
建構函式
| ListFragment() | |
| ListFragment(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。 |
屬性
| Activity |
傳回此片段目前相關聯的活動。 (繼承來源 Fragment) |
| AllowEnterTransitionOverlap |
傳回結束轉換和輸入轉換是否重疊。 -或- 設定結束轉換和輸入轉換是否重疊。 (繼承來源 Fragment) |
| AllowReturnTransitionOverlap |
傳回傳回轉換和重新輸入轉換是否重疊。 -或- 設定傳回轉換和重新輸入轉換是否重疊。 (繼承來源 Fragment) |
| Arguments |
傳回提供給 |
| ChildFragmentManager |
傳回私人 FragmentManager，以便在此片段內放置和管理片段。 (繼承來源 Fragment) |
| Class |
傳回這個 |
| Context |
|
| EnterTransition |
傳回轉換，用來將檢視移至初始場景。 -或- 設定將用來將檢視移至初始場景的轉換。 (繼承來源 Fragment) |
| ExitTransition |
會傳回轉換，當片段移除、隱藏或中斷連結時，將檢視移出場景。 -或- 設定轉換，在移除、隱藏或中斷連結片段時，用來將檢視移出場景。 (繼承來源 Fragment) |
| FragmentManager |
傳回 FragmentManager，以便與與此片段活動相關聯的片段互動。 (繼承來源 Fragment) |
| Handle |
基礎Android實例的句柄。 (繼承來源 Object) |
| Host |
傳回這個片段的主機物件。 (繼承來源 Fragment) |
| Id |
傳回這個片段所知道的標識碼。 (繼承來源 Fragment) |
| IsAdded |
如果片段目前已新增至其活動，則傳回 true。 (繼承來源 Fragment) |
| IsDetached |
如果片段已從UI明確中斷連結，則傳回 true。 (繼承來源 Fragment) |
| IsHidden |
如果片段已隱藏，則傳回 true。 (繼承來源 Fragment) |
| IsInLayout |
如果配置是透過 < 納入活動檢視階層的一部分，則傳回 true;fragment>標記。 (繼承來源 Fragment) |
| IsRemoving |
如果此片段目前正在從其活動中移除，則傳回 true。 (繼承來源 Fragment) |
| IsResumed |
如果片段處於繼續狀態，則傳回 true。 (繼承來源 Fragment) |
| IsStateSaved |
如果新增此片段，且其狀態已由其主機儲存，則傳回 true。 (繼承來源 Fragment) |
| IsVisible |
如果使用者目前可以看到片段，則傳回 true。 (繼承來源 Fragment) |
| JniIdentityHashCode |
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。 (繼承來源 Object) |
| JniPeerMembers |
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。 |
| LayoutInflater |
傳回用來擴充此片段檢視的快取 LayoutInflater。 (繼承來源 Fragment) |
| ListAdapter |
取得與此片段的 ListView 相關聯的 ListAdapter。 -或- 提供清單檢視的數據指標。 |
| ListView |
取得片段的清單檢視小工具。 |
| LoaderManager |
傳回此片段的LoaderManager，並視需要建立它。 (繼承來源 Fragment) |
| ParentFragment |
傳回包含此片段的父片段。 (繼承來源 Fragment) |
| PeerReference |
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。 (繼承來源 Object) |
| ReenterTransition |
會傳回轉換，當傳回時，會因為快顯返回堆疊而用來將檢視移至場景。 -或- 設定轉換，這個轉換將用來在返回時將檢視移至場景，因為快顯返回堆棧。 (繼承來源 Fragment) |
| Resources |
傳回 |
| RetainInstance |
控制是否在活動重新建立之間保留片段實例（例如從組態變更）。 (繼承來源 Fragment) |
| ReturnTransition |
傳回轉換，當片段正準備移除、隱藏或中斷連結時，轉換將用來將檢視移出場景，因為快顯返回堆疊。 -或- 設定轉換，在片段準備移除、隱藏或中斷連結時，用來將檢視移出場景，因為彈出返回堆疊。 (繼承來源 Fragment) |
| SelectedItemId |
取得目前選取清單項目的數據指標數據列標識碼。 |
| SelectedItemPosition |
取得目前選取清單專案的位置。 |
| SharedElementEnterTransition |
傳回轉換，用於傳輸至內容場景的共享元素。 -或- 設定轉換，用於傳輸至內容場景的共享元素。 (繼承來源 Fragment) |
| SharedElementReturnTransition |
傳回轉換，此轉換將用於在返回堆疊快顯期間傳回的共享元素。 -或- 設定轉換，用於在返回堆疊快顯期間傳輸回的共享元素。 (繼承來源 Fragment) |
| Tag |
如果指定，請取得片段的標籤名稱。 (繼承來源 Fragment) |
| TargetFragment |
傳回 所 |
| TargetRequestCode |
傳回 所 |
| ThresholdClass |
此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。 |
| ThresholdType |
此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。 |
| UserVisibleHint |
將提示設定給系統，說明此片段的UI目前是否對用戶可見。 (繼承來源 Fragment) |
| View |
如果提供 ，請取得片段版面設定的根檢視（所 |
方法
| Clone() |
建立並傳回這個 對象的複本。 (繼承來源 Object) |
| Dispose() |
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。 (繼承來源 Object) |
| Dispose(Boolean) |
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。 (繼承來源 Object) |
| Dump(String, FileDescriptor, PrintWriter, String[]) |
將片段的狀態列印到指定的數據流中。 (繼承來源 Fragment) |
| Equals(Object) |
已淘汰.
子類別無法覆寫 equals（）。 (繼承來源 Fragment) |
| GetHashCode() |
已淘汰.
子類別無法覆寫hashCode（）。 (繼承來源 Fragment) |
| GetString(Int32) |
從應用程式套件的預設字串數據表傳回本地化的字串。 (繼承來源 Fragment) |
| GetString(Int32, Object[]) |
從應用程式套件的預設字串數據表傳回本地化的字串。 (繼承來源 Fragment) |
| GetText(Int32) |
從應用程式套件的預設字串數據表傳回本地化樣式的 CharSequence。 (繼承來源 Fragment) |
| GetTextFormatted(Int32) |
從應用程式套件的預設字串數據表傳回本地化樣式的 CharSequence。 (繼承來源 Fragment) |
| JavaFinalize() |
當垃圾收集決定不再參考物件時，垃圾收集行程在 物件上呼叫。 (繼承來源 Object) |
| Notify() |
喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object) |
| NotifyAll() |
喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object) |
| OnActivityCreated(Bundle) |
建立片段的活動並具現化此片段的檢視階層時呼叫。 (繼承來源 Fragment) |
| OnActivityResult(Int32, Result, Intent) |
從先前對的呼叫 |
| OnAttach(Activity) |
已取代這個成員。 (繼承來源 Fragment) |
| OnAttach(Context) |
當片段第一次附加至其內容時呼叫。 (繼承來源 Fragment) |
| OnAttachFragment(Fragment) |
當片段附加為此片段的子系時呼叫。 (繼承來源 Fragment) |
| OnConfigurationChanged(Configuration) |
當元件執行時裝置組態變更時，由系統呼叫。 (繼承來源 Fragment) |
| OnContextItemSelected(IMenuItem) |
每當選取操作功能表中的專案時，就會呼叫此勾點。 (繼承來源 Fragment) |
| OnCreate(Bundle) |
呼叫 以執行片段的初始建立。 (繼承來源 Fragment) |
| OnCreateAnimator(FragmentTransit, Boolean, Int32) |
當片段載入動畫時呼叫。 (繼承來源 Fragment) |
| OnCreateContextMenu(IContextMenu, View, IContextMenuContextMenuInfo) |
即將顯示 的內容功能表 |
| OnCreateOptionsMenu(IMenu, MenuInflater) |
初始化活動標準選項功能表的內容。 (繼承來源 Fragment) |
| OnCreateView(LayoutInflater, ViewGroup, Bundle) |
呼叫 以讓片段具現化其使用者介面檢視。 (繼承來源 Fragment) |
| OnDestroy() |
當片段不再使用時呼叫。 (繼承來源 Fragment) |
| OnDestroyOptionsMenu() |
當這個片段的選項功能表項不再包含在整體選項功能表中時呼叫。 (繼承來源 Fragment) |
| OnDestroyView() |
當先前建立的 |
| OnDetach() |
當片段不再附加至其活動時呼叫。 (繼承來源 Fragment) |
| OnGetLayoutInflater(Bundle) |
傳回用來擴充此片段檢視的 LayoutInflater。 (繼承來源 Fragment) |
| OnHiddenChanged(Boolean) |
當隱藏狀態 （由 片段傳 |
| OnInflate(Activity, IAttributeSet, Bundle) |
已取代這個成員。 (繼承來源 Fragment) |
| OnInflate(Context, IAttributeSet, Bundle) |
當片段建立為檢視版面配置通貨膨脹的一部分時呼叫，通常是從設定活動的內容檢視。 (繼承來源 Fragment) |
| OnInflate(IAttributeSet, Bundle) |
已淘汰.
已取代這個成員。 (繼承來源 Fragment) |
| OnListItemClick(ListView, View, Int32, Int64) |
選取清單中的專案時，將會呼叫這個方法。 |
| OnLowMemory() |
當整體系統在記憶體不足時呼叫，且主動執行的進程應該會修剪其記憶體使用量。 (繼承來源 Fragment) |
| OnMultiWindowModeChanged(Boolean) |
當片段的活動從全螢幕模式變更為多視窗模式，反之亦然時呼叫。 (繼承來源 Fragment) |
| OnMultiWindowModeChanged(Boolean, Configuration) |
當片段的活動從全螢幕模式變更為多視窗模式，反之亦然時呼叫。 (繼承來源 Fragment) |
| OnOptionsItemSelected(IMenuItem) |
每當選取選項功能表中的專案時，就會呼叫此勾點。 (繼承來源 Fragment) |
| OnOptionsMenuClosed(IMenu) |
每當選項功能表關閉時，就會呼叫這個勾點（使用者取消具有上一頁/功能表按鈕的功能表，或選取專案時）。 (繼承來源 Fragment) |
| OnPause() |
當片段不再繼續時呼叫。 (繼承來源 Fragment) |
| OnPictureInPictureModeChanged(Boolean) |
當活動變更為圖片中的圖片模式時，由系統呼叫。 (繼承來源 Fragment) |
| OnPictureInPictureModeChanged(Boolean, Configuration) |
當活動變更為圖片中的圖片模式時，由系統呼叫。 (繼承來源 Fragment) |
| OnPrepareOptionsMenu(IMenu) |
準備要顯示的畫面標準選項功能表。 (繼承來源 Fragment) |
| OnRequestPermissionsResult(Int32, String[], Permission[]) |
要求許可權的結果回呼。 (繼承來源 Fragment) |
| OnResume() |
當使用者看到片段且正在執行時呼叫。 (繼承來源 Fragment) |
| OnSaveInstanceState(Bundle) |
呼叫 以要求片段儲存其目前的動態狀態，以便稍後在進程的新實例中重新建構它。 (繼承來源 Fragment) |
| OnStart() |
當使用者看到片段時呼叫。 (繼承來源 Fragment) |
| OnStop() |
當片段不再啟動時呼叫。 (繼承來源 Fragment) |
| OnTrimMemory(TrimMemory) |
當作業系統判斷行程從其行程修剪不需要的記憶體時，就會呼叫 。 (繼承來源 Fragment) |
| OnViewCreated(View, Bundle) |
在傳回之後 |
| OnViewStateRestored(Bundle) |
當所有儲存的狀態都還原到片段的檢視階層時呼叫。 (繼承來源 Fragment) |
| PostponeEnterTransition() |
延後進入片段轉換，直到 |
| RegisterForContextMenu(View) |
註冊要針對指定檢視顯示的內容功能表（多個檢視可以顯示操作功能表）。 (繼承來源 Fragment) |
| RequestPermissions(String[], Int32) |
要求授與此應用程式的許可權。 (繼承來源 Fragment) |
| SetEmptyText(ICharSequence) |
ListFragment 的預設內容具有 TextView，可在清單空白時顯示。 |
| SetEmptyText(String) |
ListFragment 的預設內容具有 TextView，可在清單空白時顯示。 |
| SetEnterSharedElementCallback(SharedElementCallback) |
當自定義轉換與片段搭配使用時，當未快顯返回堆疊時，就會呼叫輸入轉換回呼。 (繼承來源 Fragment) |
| SetExitSharedElementCallback(SharedElementCallback) |
當自定義轉換與片段搭配使用時，會在快顯返回堆疊時附加或中斷連結此片段時呼叫結束轉換回呼。 (繼承來源 Fragment) |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetHasOptionsMenu(Boolean) |
報告此片段想要藉由接收 呼叫 |
| SetInitialSavedState(Fragment+SavedState) |
設定此片段應該從第一次建構時自行還原的初始儲存狀態，如所 |
| SetListShown(Boolean) |
控制是否要顯示清單。 |
| SetListShownNoAnimation(Boolean) |
如同 |
| SetMenuVisibility(Boolean) |
設定是否應該顯示此片段功能表的提示。 (繼承來源 Fragment) |
| SetSelection(Int32) |
使用配接器的數據，將目前選取的清單項目設定為指定的位置 |
| SetTargetFragment(Fragment, Int32) |
此片段的選擇性目標。 (繼承來源 Fragment) |
| ShouldShowRequestPermissionRationale(String) |
取得在要求許可權之前，是否應該以理由顯示UI。 (繼承來源 Fragment) |
| StartActivity(Intent) |
從片段包含 Activity 的 呼叫 |
| StartActivity(Intent, Bundle) |
從片段包含 Activity 的 呼叫 |
| StartActivityForResult(Intent, Int32) |
從片段包含 Activity 的 呼叫 |
| StartActivityForResult(Intent, Int32, Bundle) |
從片段包含 Activity 的 呼叫 |
| StartIntentSenderForResult(IntentSender, Int32, Intent, ActivityFlags, ActivityFlags, Int32, Bundle) |
從片段包含 Activity 的 呼叫 |
| StartPostponedEnterTransition() |
呼叫 之後 |
| ToArray<T>() |
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。 (繼承來源 Object) |
| ToString() |
傳回物件的字串表示。 (繼承來源 Object) |
| UnregisterForContextMenu(View) |
防止顯示給定檢視的操作功能表。 (繼承來源 Fragment) |
| UnregisterFromRuntime() |
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。 (繼承來源 Object) |
| Wait() |
讓目前線程等候直到喚醒為止，通常是藉由em <notified/em>或<em>interrupted</em> 來喚醒它。<> (繼承來源 Object) |
| Wait(Int64) |
讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object) |
| Wait(Int64, Int32) |
讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object) |
明確介面實作
| IJavaPeerable.Disposed() |
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。 (繼承來源 Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。 (繼承來源 Object) |
| IJavaPeerable.Finalized() |
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。 (繼承來源 Object) |
| IJavaPeerable.JniManagedPeerState |
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。 (繼承來源 Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。 (繼承來源 Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。 (繼承來源 Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。 (繼承來源 Object) |
擴充方法
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時間檢查的類型轉換。 |
| JavaCast<TResult>(IJavaObject) |
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。 |
| GetJniTypeName(IJavaPeerable) |
片段，透過系結至陣列或 Cursor 等數據源來顯示項目清單，並在用戶選取專案時公開事件處理程式。 |