PreferenceFragment 類別

定義

命名空間:: Android.Preferences

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

以清單形式呈現物件階層 Preference 。

[Android.Runtime.Register("android/preference/PreferenceFragment", DoNotGenerateAcw=true)]
public abstract class PreferenceFragment : Android.App.Fragment

[<Android.Runtime.Register("android/preference/PreferenceFragment", DoNotGenerateAcw=true)>]
type PreferenceFragment = class
    inherit Fragment

繼承: Object

JavaObject

Object

Fragment
PreferenceFragment

屬性: RegisterAttribute

備註

以清單形式呈現物件階層 Preference 。這些偏好設定會在使用者互動時自動儲存到 SharedPreferences 。若要取得該片段中偏好階層會使用的實例 SharedPreferences ，請呼叫 PreferenceManager#getDefaultSharedPreferences(android.content.Context) 與該片段相同套件中的上下文。

此外，所顯示的偏好設定將遵循系統偏好的視覺風格。透過 XML 建立偏好設定的階層（可在多個螢幕顯示）非常容易。基於這些原因，建議使用此片段（作為超類別）來處理應用程式中的偏好。

物件 PreferenceScreen 應該位於偏好層級的最頂端。此外，階層中的後續 PreferenceScreen 代表螢幕斷開——也就是說後續 PreferenceScreen 偏好設定應該在另一個畫面顯示。偏好設定框架負責顯示偏好層級中這些其他畫面。

偏好階層可以透過多種方式形成：<li> 來自指定階層<結構的 XML 檔案 li> 來自不同 Activity Activities 透過元資料Activity在 XML 檔案<中指定偏好的不同來自以> 為根的物件階層PreferenceScreen

要從 XML 膨脹，請使用 #addPreferencesFromResource(int). 根元素應該是 PreferenceScreen。後續元素可指向實際子 Preference 類別。如前所述，層級結構的後續 PreferenceScreen 會出現畫面斷裂。

若要指定IntentActivity Activities一個查詢，讓每個查詢都有偏好，請使用 #addPreferencesFromIntent。每個 Activity API 都能在清單中指定（透過金鑰 PreferenceManager#METADATA_KEY_PREFERENCES）指向 XML 資源的元資料。這些 XML 資源會被放大成單一偏好階層，並以此片段顯示。

若要指定以為 PreferenceScreen根的物件階層，請使用 #setPreferenceScreen(PreferenceScreen)。

為了方便起見，此片段實作了點擊監聽器，可依目前階層中的任何偏好設定進行，詳見 #onPreferenceTreeClick(PreferenceScreen, Preference)。

<div class=“特殊參考”><h3>開發者指南</h3>

有關使用 PreferenceFragment資訊，請閱讀設定指南。

</div>

此會員已被棄用。使用 AndroidX 偏好函式庫，讓所有裝置的行為一致。欲了解更多使用 AndroidX 偏好函式庫的資訊，請參閱設定。

Java 文件 android.preference.PreferenceFragment。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
PreferenceFragment()
PreferenceFragment(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

屬性

名稱	Description
Activity	回歸該片段目前所關聯的活動。 (繼承來源 Fragment)
AllowEnterTransitionOverlap	無論退出轉換與進入轉換是否重疊，都會回傳。 -或- 設定出口轉換與進入轉換是否重疊。 (繼承來源 Fragment)
AllowReturnTransitionOverlap	無論返回轉換與再入轉換是否重疊，都會回傳。 -或- 設定返回轉換與再入轉換是否重疊。 (繼承來源 Fragment)
Arguments	將提供 `#setArguments`給的論證歸還給（如果有的話）。 -或者- 提供這個片段的建構論據。 (繼承來源 Fragment)
ChildFragmentManager	回傳一個私有的 FragmentManager，用於將碎片置入並管理該碎片。 (繼承來源 Fragment)
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Context	回歸 `Context` 這個片段目前所關聯的部分。 (繼承來源 Fragment)
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	如果該版面作為活動檢視階層的一部分，透過 <片段>捉人。 (繼承來源 Fragment)
IsRemoving	如果該片段目前正被移除，則返回 true。 (繼承來源 Fragment)
IsResumed	若片段處於恢復狀態，則回傳真。 (繼承來源 Fragment)
IsStateSaved	如果加入此片段且其狀態已被主機保存，則回傳為真。 (繼承來源 Fragment)
IsVisible	如果該片段目前對使用者可見，則回傳 true。 (繼承來源 Fragment)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	以清單形式呈現物件階層 `Preference` 。 (繼承來源 JavaObject)
JniPeerMembers	以清單形式呈現物件階層 `Preference` 。
LayoutInflater	回傳用於膨脹此片段視圖的快取 LayoutInflater。 (繼承來源 Fragment)
LoaderManager	回傳此片段的 LoaderManager，必要時建立它。 (繼承來源 Fragment)
ParentFragment	回傳包含該片段的父片段。 (繼承來源 Fragment)
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
PreferenceManager	還原 `PreferenceManager` 了這個片段所使用的。
PreferenceScreen	取得該片段所顯示的偏好階層的根源。 -或- 設定該片段所顯示的偏好階層的根節點。
ReenterTransition	回傳將用於在回放時將視圖移入場景的轉換，因為會彈出後方堆疊。 -或- 設定轉換，將用於在回傳時將視圖移入場景，因為彈出後堆疊。 (繼承來源 Fragment)
Resources	返回 `getActivity().getResources()`。 (繼承來源 Fragment)
RetainInstance	控制片段實例是否在活動重建過程中（例如設定變更後）被保留。 (繼承來源 Fragment)
ReturnTransition	回傳將用於在碎片準備被移除、隱藏或因後堆疊而分離時，將視圖移出場景的轉換。 -或- 設定轉換，當碎片準備被移除、隱藏或因後堆疊彈出而分離時，將視圖移出場景。 (繼承來源 Fragment)
SharedElementEnterTransition	回傳用於轉移到內容場景的共享元素的轉換。 -或- 設定將用於傳輸到內容場景的共享元素的轉換。 (繼承來源 Fragment)
SharedElementReturnTransition	回傳將用於後堆疊彈出時傳回的共享元素的轉換。 -或- 設定在後方堆疊彈出時，將用於傳回共享元素的轉換。 (繼承來源 Fragment)
Tag	如果有指定，請取得碎片的標籤名稱。 (繼承來源 Fragment)
TargetFragment	回傳由設定的 `#setTargetFragment`目標片段。 (繼承來源 Fragment)
TargetRequestCode	回傳由設定的 `#setTargetFragment`目標請求碼。 (繼承來源 Fragment)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
UserVisibleHint	向系統設定提示，告訴使用者是否可以看到這個片段的使用者介面。 (繼承來源 Fragment)
View	如果有提供，請取得片段配置的根視圖（由 `#onCreateView`回傳的那個）。 (繼承來源 Fragment)

方法

名稱	Description
AddPreferencesFromIntent(Intent)	新增符合所給活動 `Intent`的偏好。
AddPreferencesFromResource(Int32)	將給定的 XML 資源膨脹，並將偏好階層加入目前的偏好階層。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	以清單形式呈現物件階層 `Preference` 。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	以清單形式呈現物件階層 `Preference` 。 (繼承來源 JavaObject)
Dump(String, FileDescriptor, PrintWriter, String[])	將碎片的狀態印入給定的串流中。 (繼承來源 Fragment)
Equals(Object)	以清單形式呈現物件階層 `Preference` 。 (繼承來源 JavaObject)
Equals(Object)	已淘汰. 子類別無法覆蓋等值（）。 (繼承來源 Fragment)
FindPreference(ICharSequence)	根據鑰匙找到 a `Preference` 。
FindPreference(String)	根據鑰匙找到 a `Preference` 。
GetHashCode()	已淘汰. 子類別無法覆寫 hashCode（）。 (繼承來源 Fragment)
GetString(Int32, Object[])	從應用程式套件的預設字串表回傳一個本地化格式化的字串，並以 Formatter 和 String.format（String， Object）中定義的格式參數替換。 (繼承來源 Fragment)
GetString(Int32)	從應用程式套件預設字串表回傳一個在地字串。 (繼承來源 Fragment)
GetText(Int32)	從應用程式套件預設字串表回傳一個本地化且有樣式的 CharSequence。 (繼承來源 Fragment)
GetTextFormatted(Int32)	從應用程式套件預設字串表回傳一個本地化且有樣式的 CharSequence。 (繼承來源 Fragment)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
OnActivityCreated(Bundle)	當該片段的活動已建立且該片段的視圖階層實例化時，會被呼叫。 (繼承來源 Fragment)
OnActivityResult(Int32, Result, Intent)	接收先前呼叫的 `#startActivityForResult(Intent, int)`結果。 (繼承來源 Fragment)
OnAttach(Activity)	已淘汰. 此方法在 API 等級 23 中被棄用。 (繼承來源 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)	當視圖的右鍵選單即將顯示時會被呼叫。 (繼承來源 Fragment)
OnCreateOptionsMenu(IMenu, MenuInflater)	初始化活動標準選項選單的內容。 (繼承來源 Fragment)
OnCreateView(LayoutInflater, ViewGroup, Bundle)	被呼叫讓 fragment 實例化其使用者介面視圖。 (繼承來源 Fragment)
OnDestroy()	當該碎片不再使用時會被呼叫。 (繼承來源 Fragment)
OnDestroyOptionsMenu()	當該片段的選項選單項目不再包含在整體選項選單中時，會呼叫此訊息。 (繼承來源 Fragment)
OnDestroyView()	當先前由所 `#onCreateView` 創造的視角已從碎片中分離時，稱為此。 (繼承來源 Fragment)
OnDetach()	當碎片不再與其活動相連時，會被召喚。 (繼承來源 Fragment)
OnGetLayoutInflater(Bundle)	回傳用於膨脹此片段視圖的 LayoutInflater。 (繼承來源 Fragment)
OnHiddenChanged(Boolean)	當隱藏狀態（片段回傳的） `#isHidden()` 發生變化時呼叫。 (繼承來源 Fragment)
OnInflate(Activity, IAttributeSet, Bundle)	已淘汰. 此方法在 API 等級 23 中被棄用。 (繼承來源 Fragment)
OnInflate(Context, IAttributeSet, Bundle)	當片段作為檢視版面膨脹的一部分被建立時，通常是透過設定活動的內容檢視而呼叫。 (繼承來源 Fragment)
OnInflate(IAttributeSet, Bundle)	已淘汰. 此方法在 API 等級 15 中被棄用。 (繼承來源 Fragment)
OnLowMemory()	當整體系統記憶體不足時，當正在執行的程序應該會修剪記憶體使用時，就會呼叫這個動作。 (繼承來源 Fragment)
OnMultiWindowModeChanged(Boolean, Configuration)	當碎片的活動從全螢幕模式切換到多視窗模式，反之亦然時，會被呼叫。 (繼承來源 Fragment)
OnMultiWindowModeChanged(Boolean)	當碎片的活動從全螢幕模式切換到多視窗模式，反之亦然時，會被呼叫。 (繼承來源 Fragment)
OnOptionsItemSelected(IMenuItem)	每當你在選項選單中選取某項時，就會呼叫這個鉤子。 (繼承來源 Fragment)
OnOptionsMenuClosed(IMenu)	當選項選單關閉時（使用者用返回/選單按鈕取消選單，或選取項目時）會呼叫這個鉤子。 (繼承來源 Fragment)
OnPause()	當碎片不再恢復時會被召喚。 (繼承來源 Fragment)
OnPictureInPictureModeChanged(Boolean, Configuration)	系統在活動切換至畫中畫模式時呼叫。 (繼承來源 Fragment)
OnPictureInPictureModeChanged(Boolean)	系統在活動切換至畫中畫模式時呼叫。 (繼承來源 Fragment)
OnPreferenceTreeClick(PreferenceScreen, Preference)	待補充
OnPrepareOptionsMenu(IMenu)	請準備螢幕的標準選項選單顯示。 (繼承來源 Fragment)
OnRequestPermissionsResult(Int32, String[], Permission[])	請求權限後回撥結果。 (繼承來源 Fragment)
OnResume()	當該片段對使用者可見且正在執行時呼叫。 (繼承來源 Fragment)
OnSaveInstanceState(Bundle)	當被呼叫請求片段儲存其當前動態狀態，以便之後能在新的程序實例中重建時，該程序會重新啟動。 (繼承來源 Fragment)
OnStart()	當 Fragment 對使用者可見時，會被呼叫。 (繼承來源 Fragment)
OnStop()	當碎片不再啟動時呼叫。 (繼承來源 Fragment)
OnTrimMemory(TrimMemory)	當作業系統判斷程序是刪除其程序中不需要記憶體的好時機時，會被呼叫。 (繼承來源 Fragment)
OnViewCreated(View, Bundle)	在 Calling 立即回來後 `#onCreateView(LayoutInflater, ViewGroup, Bundle)` ，但尚未恢復任何儲存狀態進入檢視。 (繼承來源 Fragment)
OnViewStateRestored(Bundle)	當所有儲存狀態都已恢復到片段的視圖階層時，才會被呼叫。 (繼承來源 Fragment)
PostponeEnterTransition()	延後進入碎片的轉換，直到`#startPostponedEnterTransition()FragmentManager#executePendingTransactions()`或已被召喚。 (繼承來源 Fragment)
RegisterForContextMenu(View)	註冊一個右鍵選單，顯示給定視圖（多個視圖可顯示該右鍵選單）。 (繼承來源 Fragment)
RequestPermissions(String[], Int32)	請求授權給此應用程式。 (繼承來源 Fragment)
SetEnterSharedElementCallback(SharedElementCallback)	當使用自訂轉換時，當該片段連接或分離且未彈出後堆疊時，會呼叫 Enter 轉換回撥。 (繼承來源 Fragment)
SetExitSharedElementCallback(SharedElementCallback)	當使用自訂轉換時，當該片段在彈出後堆疊時被連接或分離時，會呼叫退出轉換回撥。 (繼承來源 Fragment)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetHasOptionsMenu(Boolean)	回報此片段希望透過接收及 `#onCreateOptionsMenu` 相關方法來參與填充選項選單。 (繼承來源 Fragment)
SetInitialSavedState(Fragment+SavedState)	設定初始儲存狀態，讓該碎片從建構時應自行恢復，該狀態由 FragmentManager.saveFragmentInstanceState 回傳。 (繼承來源 Fragment)
SetMenuVisibility(Boolean)	設定提示，判斷該片段選單是否應該顯示。 (繼承來源 Fragment)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	以清單形式呈現物件階層 `Preference` 。 (繼承來源 JavaObject)
SetTargetFragment(Fragment, Int32)	此片段的可選目標。 (繼承來源 Fragment)
ShouldShowRequestPermissionRationale(String)	判斷你是否應該在申請許可前先展示 UI。 (繼承來源 Fragment)
StartActivity(Intent, Bundle)	來自 `Activity#startActivity(Intent, Bundle)` 包含活動的碎片呼叫。 (繼承來源 Fragment)
StartActivity(Intent)	來自 `Activity#startActivity(Intent)` 包含活動的碎片呼叫。 (繼承來源 Fragment)
StartActivityForResult(Intent, Int32, Bundle)	來自 `Activity#startActivityForResult(Intent, int, Bundle)` 包含活動的碎片呼叫。 (繼承來源 Fragment)
StartActivityForResult(Intent, Int32)	來自 `Activity#startActivityForResult(Intent, int)` 包含活動的碎片呼叫。 (繼承來源 Fragment)
StartIntentSenderForResult(IntentSender, Int32, Intent, ActivityFlags, ActivityFlags, Int32, Bundle)	來自 `Activity#startIntentSenderForResult(IntentSender, int, Intent, int, int, int, Bundle)` 包含活動的碎片呼叫。 (繼承來源 Fragment)
StartPostponedEnterTransition()	接到通知後 `#postponeEnterTransition()` 開始延期的交接。 (繼承來源 Fragment)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterForContextMenu(View)	阻止顯示該視圖的右鍵選單。 (繼承來源 Fragment)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	以清單形式呈現物件階層 `Preference` 。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	以清單形式呈現物件階層 `Preference` 。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	以清單形式呈現物件階層 `Preference` 。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	以清單形式呈現物件階層 `Preference` 。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	以清單形式呈現物件階層 `Preference` 。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	以清單形式呈現物件階層 `Preference` 。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	以清單形式呈現物件階層 `Preference` 。 (繼承來源 Fragment)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	以清單形式呈現物件階層 `Preference` 。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於