PreferenceScreen 類別

定義

命名空間:: Android.Preferences

組件:: Mono.Android.dll

重要

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

代表一個頂層 Preference ，作為偏好階層的根源。

[Android.Runtime.Register("android/preference/PreferenceScreen", DoNotGenerateAcw=true)]
public sealed class PreferenceScreen : Android.Preferences.PreferenceGroup, Android.Content.IDialogInterfaceOnDismissListener, Android.Widget.AdapterView.IOnItemClickListener, IDisposable

[<Android.Runtime.Register("android/preference/PreferenceScreen", DoNotGenerateAcw=true)>]
type PreferenceScreen = class
    inherit PreferenceGroup
    interface IDialogInterfaceOnDismissListener
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface AdapterView.IOnItemClickListener

繼承: Object

JavaObject

Object

Preference

PreferenceGroup
PreferenceScreen

屬性: RegisterAttribute

實作: IDialogInterfaceOnDismissListener IJavaObject AdapterView.IOnItemClickListener IJavaPeerable IDisposable

備註

代表一個頂層 Preference ，作為偏好階層的根源。 A PreferenceActivity 會指向此類別的一個實例以顯示偏好。要實例化此類別，請使用 PreferenceManager#createPreferenceScreen(Context)。 <ul> 此類別可出現於兩個位置： <li> 。當 a PreferenceActivity 指向此時，該類別作為根，且不顯示（僅顯示包含的偏好）。 <當>它出現在另一個偏好階層中時，會顯示並作為通往另一個偏好畫面的入口（透過顯示另一個偏好設定畫面為 a Dialog 或透過 a Context#startActivity(android.content.Intent) ）。Preference#getIntent() 這個 PreferenceScreen 孩子並不會在 PreferenceScreen 畫面中出現。相反地，點擊此偏好時會顯示獨立畫面。 </ul>

以下是 PreferenceScreen 的 XML 範例配置：

&lt;PreferenceScreen
                    xmlns:android="http://schemas.android.com/apk/res/android"
                    android:key="first_preferencescreen"&gt;
                &lt;CheckBoxPreference
                        android:key="wifi enabled"
                        android:title="WiFi" /&gt;
                &lt;PreferenceScreen
                        android:key="second_preferencescreen"
                        android:title="WiFi settings"&gt;
                    &lt;CheckBoxPreference
                            android:key="prefer wifi"
                            android:title="Prefer WiFi" /&gt;
                    ... other preferences here ...
                &lt;/PreferenceScreen&gt;
            &lt;/PreferenceScreen&gt;

在此範例中，「first_preferencescreen」將作為階層的根節點，並賦予一個 PreferenceActivity。第一個畫面會顯示偏好設定「WiFi」（可用來快速啟用或停用 WiFi）和「WiFi 設定」。「WiFi 設定」是「second_preferencescreen」，點擊後會顯示另一個偏好設定畫面，例如「偏好 WiFi」（以及其他屬於「second_preferencescreen」標籤子選項的偏好設定）。

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

關於如何用偏好設定建立設定介面的資訊，請閱讀設定指南。

</div>

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

Java 文件 android.preference.PreferenceScreen。

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

欄位

名稱	Description
DefaultOrder	如果不需要特定訂單，請明確說明 `#setOrder(int)` 。 (繼承來源 Preference)

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Context	返回 `android.content.Context` 此偏好。 (繼承來源 Preference)
Dependency	回傳依賴該偏好的鍵值。 -或- 設定該偏好將依賴的偏好鍵。 (繼承來源 Preference)
Dialog	用來掌握對話的節奏。
Editor	回傳和 `SharedPreferences.Editor` ，此偏好可儲存其值。 (繼承來源 Preference)
Enabled	檢查列表中是否應啟用此偏好。 -或- 設定是否啟用此偏好。 (繼承來源 Preference)
Extras	回傳與此偏好設定相關的額外 Bundle 物件，如果目前沒有 Bundle，就建立新的 Bundle。 (繼承來源 Preference)
Fragment	回傳與此偏好相關聯的片段類別名稱。 -或- 設定片段的類別名稱，當點擊此偏好設定時會顯示。 (繼承來源 Preference)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
HasKey	檢查此偏好是否有有效的金鑰。 (繼承來源 Preference)
Icon	回傳此偏好的圖示。 -或- 用可繪製圖示設定此偏好。 (繼承來源 Preference)
IconSpaceReserved	判斷這個偏好圖示視圖是否保留了空間。 -或- 設定當未提供圖示時，是否保留此偏好圖示的空間。 (繼承來源 Preference)
Intent	回覆與此偏好相關的資料 `Intent` 。 -或- 設定， `Intent` 當點擊此偏好設定時 `Context#startActivity(Intent)` 使用。 (繼承來源 Preference)
IsOnSameScreenAsChildren	是否應該將此偏好群組顯示在其所包含的偏好設定中顯示在同一螢幕上。 (繼承來源 PreferenceGroup)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	代表一個頂層 `Preference` ，作為偏好階層的根源。 (繼承來源 JavaObject)
JniPeerMembers	代表一個頂層 `Preference` ，作為偏好階層的根源。
Key	取得此偏好的鍵，同時也是用來將值儲存為 `SharedPreferences` 或 `PreferenceDataStore`的鍵。 -or- 設定此偏好的鍵，作為或 `SharedPreferences`的鍵`PreferenceDataStore`。 (繼承來源 Preference)
LayoutResource	取得會顯示為 `View` 此偏好的版面資源。 -或- 設定膨脹後的配置資源為 `View` 此偏好設定的。 (繼承來源 Preference)
OnPreferenceChangeListener	當使用者更改此偏好時（但在內部狀態尚未更新之前），會回傳回調呼叫。 -或- 設定回調在使用者更改此偏好時（但在內部狀態更新前）被呼叫。 (繼承來源 Preference)
OnPreferenceClickListener	當點擊此偏好設定時，會回傳回調呼。 -或- 設定回撥在點擊此偏好時被喚起。 (繼承來源 Preference)
Order	取得此偏好相對於同一層級其他偏好物件的順序。 -或- 設定此偏好相對於同一層級其他偏好物件的順序。 (繼承來源 Preference)
OrderingAsAdded	這個群組是否依照相加順序排序偏好。 -或者- 是否要依序排序 `Preference` 這個群體的子女。 (繼承來源 PreferenceGroup)
Parent	回傳 `PreferenceGroup` 該偏好是否被指派至某個群組，或 `null` 是否為根偏好。 (繼承來源 Preference)
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
Persistent	檢查此偏好是否持續存在。 -或- 設定此偏好是否為持久性。 (繼承來源 Preference)
PreferenceCount	返回子節點 `Preference`數量。 (繼承來源 PreferenceGroup)
PreferenceDataStore	此偏好所用的退貨 `PreferenceDataStore` 。 -或- 設定 a `PreferenceDataStore` 讓此偏好使用，而非使用 `android.content.SharedPreferences`。 (繼承來源 Preference)
PreferenceManager	取得管理該偏好物件樹狀結構的系統 `PreferenceManager` 。 (繼承來源 Preference)
RecycleEnabled	檢查此偏好設定是否允許其檢視在列表檢視中使用時被回收。 -或- 設定此偏好設定是否啟用了在列表視圖中使用時的循環視圖。 (繼承來源 Preference)
RootAdapter	回傳一個可連接至或 `PreferenceActivityPreferenceFragment` 的轉接器，以顯示此 `PreferenceScreen`中所包含的偏好設定。
Selectable	檢查該偏好是否應該在列表中被選擇。 -或- 設定此偏好是否可選擇。 (繼承來源 Preference)
SharedPreferences	回傳， `SharedPreferences` 該偏好可讀取其值。 (繼承來源 Preference)
ShouldDisableView	檢查當該偏好設定的動作被停用時，是否應該關閉其檢視。 -或- 設定此偏好設定在關閉時是否應停用其視圖。 (繼承來源 Preference)
SingleLineTitle	判斷此偏好的標題是否限制在單一行內。 -或- 設定是否將此偏好的標題限制為單一行，而非讓它繞行多行。 (繼承來源 Preference)
Summary	代表一個頂層 `Preference` ，作為偏好階層的根源。 (繼承來源 Preference)
SummaryFormatted	回傳此偏好的摘要。 -或- 用 CharSequence 設定此偏好的摘要。 (繼承來源 Preference)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 PreferenceGroup)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 PreferenceGroup)
Title	代表一個頂層 `Preference` ，作為偏好階層的根源。 (繼承來源 Preference)
TitleFormatted	返回此偏好的標題。 -或- 用 CharSequence 設定此偏好的標題。 (繼承來源 Preference)
TitleRes	回傳此偏好設定的標題資源 ID。 (繼承來源 Preference)
WidgetLayoutResource	取得此偏好設定中可控小工具部分的版面資源。 -或- 設定此偏好設定中可控小工具部分的配置。 (繼承來源 Preference)

方法

名稱	Description
AddItemFromInflater(Preference)	被inflater召喚，將物品加入這個群組。 (繼承來源 PreferenceGroup)
AddPreference(Preference)	根據偏好順序在正確位置加上 a `Preference` 。 (繼承來源 PreferenceGroup)
Bind(ListView)	透過將 a `ListView` 綁定於此`PreferenceScreen#getRootAdapter()`中所含的偏好。
CallChangeListener(Object)	在使用者更改偏好設定後、內部狀態尚未設定之前呼叫此方法。 (繼承來源 Preference)
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
CompareTo(Preference)	根據順序（若設定）比較偏好物件，否則依標題字母順序比較。 (繼承來源 Preference)
Construct(JniObjectReference, JniObjectReferenceOptions)	代表一個頂層 `Preference` ，作為偏好階層的根源。 (繼承來源 JavaObject)
DispatchRestoreInstanceState(Bundle)	被呼叫 RestoreHierarchyState(Bundle) 來取回這個偏好及其子選項的儲存狀態。 (繼承來源 PreferenceGroup)
DispatchSaveInstanceState(Bundle)	被呼叫 SaveHierarchyState(Bundle) 來儲存此偏好及其子節點的實例。 (繼承來源 PreferenceGroup)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	代表一個頂層 `Preference` ，作為偏好階層的根源。 (繼承來源 JavaObject)
Equals(Object)	代表一個頂層 `Preference` ，作為偏好階層的根源。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
FindPreference(ICharSequence)	根據鑰匙找到 a `Preference` 。 (繼承來源 PreferenceGroup)
FindPreference(String)	根據鑰匙找到 a `Preference` 。 (繼承來源 PreferenceGroup)
FindPreferenceInHierarchy(String)	用給定的鍵在這個層級結構中找到偏好（整個系統，甚至在螢幕 `PreferenceScreen` 斷線的上方或下方）。 (繼承來源 Preference)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetPersistedBoolean(Boolean)	嘗試取得持久的布林值（若此偏好為持久）。 (繼承來源 Preference)
GetPersistedFloat(Single)	嘗試取得持久浮點數（若此偏好為持久）。 (繼承來源 Preference)
GetPersistedInt(Int32)	如果偏好是持久的，嘗試取得持久的整數。 (繼承來源 Preference)
GetPersistedLong(Int64)	如果這個偏好持續存在，則會嘗試獲得持久的多頭。 (繼承來源 Preference)
GetPersistedString(String)	如果這個偏好是持久的，則嘗試取得持久的字串。 (繼承來源 Preference)
GetPersistedStringSet(ICollection<String>)	如果偏好是持久的，嘗試取得持久的字串集合。 (繼承來源 Preference)
GetPreference(Int32)	在特定索引回傳。`Preference` (繼承來源 PreferenceGroup)
GetView(View, ViewGroup)	取得將在 `PreferenceActivity`. (繼承來源 Preference)
JavaFinalize()	當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
NotifyChanged()	當資料 `Preference` 變更時，應該會被打電話。 (繼承來源 Preference)
NotifyDependencyChange(Boolean)	通知任何聆聽的依賴者有關影響依賴性的變更。 (繼承來源 Preference)
NotifyHierarchyChanged()	當偏好被新增或移除時，應該先打電話，或重新評估排序。 (繼承來源 Preference)
OnAttachedToActivity()	當偏好層級已附加於 `PreferenceActivity`時呼叫。 (繼承來源 Preference)
OnAttachedToHierarchy(PreferenceManager)	當此偏好被附加到偏好階層時，會被呼叫。 (繼承來源 Preference)
OnBindView(View)	將建立的檢視綁定到此偏好設定的資料。 (繼承來源 Preference)
OnClick()	處理點擊偏好。 (繼承來源 Preference)
OnCreateView(ViewGroup)	建立該偏好 `PreferenceActivity`設定的檢視圖。 (繼承來源 Preference)
OnDependencyChanged(Preference, Boolean)	當依賴性改變時會打電話給我。 (繼承來源 Preference)
OnDismiss(IDialogInterface)	當對話被關閉時，會啟動此方法。
OnGetDefaultValue(TypedArray, Int32)	當偏好設定被膨脹且需要讀取預設值屬性時，會被呼叫。 (繼承來源 Preference)
OnItemClick(AdapterView, View, Int32, Int64)
OnParentChanged(Preference, Boolean)	當隱含的父依賴性改變時被呼叫。 (繼承來源 Preference)
OnPrepareAddPreference(Preference)	準備 `Preference` 加入該群組。 (繼承來源 PreferenceGroup)
OnPrepareForRemoval()	當這個偏好從階層中移除時，會被召喚。 (繼承來源 Preference)
OnRestoreInstanceState(IParcelable)	Hook 允許偏好重新套用先前由 `#onSaveInstanceState`產生的內部狀態表示。 (繼承來源 Preference)
OnSaveInstanceState()	Hook 允許偏好設定產生其內部狀態的表示，之後可用來建立具有相同狀態的新實例。 (繼承來源 Preference)
OnSetInitialValue(Boolean, Object)	實作此設定偏好設定的初始值。 (繼承來源 Preference)
PeekExtras()	回傳與此偏好設定相關的額外 Bundle 物件，若目前沒有則回 `null` 傳。 (繼承來源 Preference)
PersistBoolean(Boolean)	嘗試持久化一個布林值，前提是此偏好是持久的。 (繼承來源 Preference)
PersistFloat(Single)	如果這個偏好持續，會嘗試長期持續。 (繼承來源 Preference)
PersistInt(Int32)	若偏好為持久，則嘗試持久化一個智力。 (繼承來源 Preference)
PersistLong(Int64)	如果這個偏好持續，會嘗試長期持續。 (繼承來源 Preference)
PersistString(String)	嘗試持久化字串（若偏好為持久）。 (繼承來源 Preference)
PersistStringSet(ICollection<String>)	若此偏好為持久性，則嘗試持久化一組字串。 (繼承來源 Preference)
RemoveAll()	移除此群組中的所有人 `Preference Preferences` 。 (繼承來源 PreferenceGroup)
RemovePreference(Preference)	從這組中移除 a `Preference` 。 (繼承來源 PreferenceGroup)
RestoreHierarchyState(Bundle)	還原該偏好階層先前從該容器儲存的狀態。 (繼承來源 Preference)
SaveHierarchyState(Bundle)	將這個偏好階層的凍結狀態儲存在給定的容器中。 (繼承來源 Preference)
SetDefaultValue(Object)	設定此偏好設定的預設值，若持久化關閉或持久化開啟且偏好設定未在持久儲存中，偏好設定將被設定。 (繼承來源 Preference)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetIcon(Int32)	用資源 ID 設定此偏好設定圖示。 (繼承來源 Preference)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	代表一個頂層 `Preference` ，作為偏好階層的根源。 (繼承來源 JavaObject)
SetSummary(Int32)	透過資源 ID 設定此偏好的摘要。 (繼承來源 Preference)
SetTitle(Int32)	會用資源 ID 設定此偏好設定的標題。 (繼承來源 Preference)
ShouldCommit()	回傳是否 `Preference` 應該將儲存值提交於 `#getEditor()`。 (繼承來源 Preference)
ShouldDisableDependents()	檢查該偏好的受扶養人是否應該目前被停用。 (繼承來源 Preference)
ShouldPersist()	檢查在呼叫此方法時，該偏好設定是否應將其值儲存或還原到（若指派後）中`SharedPreferencesPreferenceDataStore`。 (繼承來源 Preference)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
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
PreferenceChange	代表一個頂層 `Preference` ，作為偏好階層的根源。 (繼承來源 Preference)
PreferenceClick	代表一個頂層 `Preference` ，作為偏好階層的根源。 (繼承來源 Preference)

明確介面實作

名稱	Description
IComparable.CompareTo(Object)	代表一個頂層 `Preference` ，作為偏好階層的根源。 (繼承來源 Preference)
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` ，作為偏好階層的根源。

擴充方法

名稱	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 端是否有效。

適用於