Preference 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
代表由 以 PreferenceActivityListViewa 顯示的基本偏好設定 UI 建構區塊。
[Android.Runtime.Register("android/preference/Preference", DoNotGenerateAcw=true)]
public class Preference : Java.Lang.Object, IDisposable, Java.Lang.IComparable[<Android.Runtime.Register("android/preference/Preference", DoNotGenerateAcw=true)>]
type Preference = class
inherit Object
interface IComparable
interface IJavaObject
interface IDisposable
interface IJavaPeerable- 繼承
- 衍生
- 屬性
- 實作
備註
代表由 以 PreferenceActivityListViewa 顯示的基本偏好設定 UI 建構區塊。 此類別提供活動中顯示的 ， View 並與 關聯 SharedPreferences 以儲存/檢索偏好資料。
在 XML 中指定偏好階層時，每個元素可以指向 的 Preference子類別，類似於檢視階層與版面配置。
此類別包含 ， key 將用作進入 SharedPreferences的鍵。 如何儲存價值由子類別決定。
<div class=“特殊參考”><h3>開發者指南</h3>
關於如何用偏好設定建立設定介面的資訊，請閱讀 設定 指南。
</div>
此會員已被棄用。 使用 AndroidX 偏好函式庫 ，讓所有裝置的行為一致。 欲了解更多使用 AndroidX 偏好函式庫的資訊，請參閱設定。
Java 文件 android.preference.Preference。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| Preference(Context, IAttributeSet, Int32, Int32) |
從 XML 進行膨脹，並套用類別特定的基底樣式。 |
| Preference(Context, IAttributeSet, Int32) |
從 XML 進行膨脹，並套用類別特定的基底樣式。 |
| Preference(Context, IAttributeSet) |
從 XML 膨脹偏好設定時所呼叫的建構子。 |
| Preference(Context) |
建構子來建立偏好。 |
| Preference(IntPtr, JniHandleOwnership) |
用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。 |
欄位
| 名稱 | Description |
|---|---|
| DefaultOrder |
如果不需要特定訂單，請明確說明 |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| Context |
返回 |
| Dependency |
回傳依賴該偏好的鍵值。 -或- 設定該偏好將依賴的偏好鍵。 |
| Editor |
回傳 和 |
| Enabled |
檢查列表中是否應啟用此偏好。 -或- 設定是否啟用此偏好。 |
| Extras |
回傳與此偏好設定相關的額外 Bundle 物件，如果目前沒有 Bundle，就建立新的 Bundle。 |
| Fragment |
回傳與此偏好相關聯的片段類別名稱。 -或- 設定片段的類別名稱，當點擊此偏好設定時會顯示。 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| HasKey |
檢查此偏好是否有有效的金鑰。 |
| Icon |
回傳此偏好的圖示。 -或- 用可繪製圖示設定此偏好。 |
| IconSpaceReserved |
判斷這個偏好圖示視圖是否保留了空間。 -或- 設定當未提供圖示時，是否保留此偏好圖示的空間。 |
| Intent |
回覆與此偏好相關的資料 |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
代表由 以 |
| JniPeerMembers |
代表由 以 |
| Key |
取得此偏好的鍵，同時也是用來將值儲存為 |
| LayoutResource |
取得會顯示為 |
| OnPreferenceChangeListener |
當使用者更改此偏好時（但在內部狀態尚未更新之前），會回傳回調呼叫。 -或- 設定回調在使用者更改此偏好時（但在內部狀態更新前）被呼叫。 |
| OnPreferenceClickListener |
當點擊此偏好設定時，會回傳回調呼。 -或- 設定回撥在點擊此偏好時被喚起。 |
| Order |
取得此偏好相對於同一層級其他偏好物件的順序。 -或- 設定此偏好相對於同一層級其他偏好物件的順序。 |
| Parent |
回傳 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| Persistent |
檢查此偏好是否持續存在。 -或- 設定此偏好是否為持久性。 |
| PreferenceDataStore |
此偏好所用的退貨 |
| PreferenceManager |
取得管理該偏好物件樹狀結構的系統 |
| RecycleEnabled |
檢查此偏好設定是否允許其檢視在列表檢視中使用時被回收。 -或- 設定此偏好設定是否啟用了在列表視圖中使用時的循環視圖。 |
| Selectable |
檢查該偏好是否應該在列表中被選擇。 -或- 設定此偏好是否可選擇。 |
| SharedPreferences |
回傳 ， |
| ShouldDisableView |
檢查當該偏好設定的動作被停用時，是否應該關閉其檢視。 -或- 設定此偏好設定在關閉時是否應停用其視圖。 |
| SingleLineTitle |
判斷此偏好的標題是否限制在單一行內。 -或- 設定是否將此偏好的標題限制為單一行，而非讓它繞行多行。 |
| Summary |
代表由 以 |
| SummaryFormatted |
回傳此偏好的摘要。 -或- 用 CharSequence 設定此偏好的摘要。 |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| Title |
代表由 以 |
| TitleFormatted |
返回此偏好的標題。 -或- 用 CharSequence 設定此偏好的標題。 |
| TitleRes |
回傳此偏好設定的標題資源 ID。 |
| WidgetLayoutResource |
取得此偏好設定中可控小工具部分的版面資源。 -或- 設定此偏好設定中可控小工具部分的配置。 |
方法
| 名稱 | Description |
|---|---|
| CallChangeListener(Object) |
在使用者更改偏好設定後、內部狀態尚未設定之前呼叫此方法。 |
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| CompareTo(Preference) |
根據順序（若設定）比較偏好物件，否則依標題字母順序比較。 |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
代表由 以 |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
代表由 以 |
| Equals(Object) |
代表由 以 |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| FindPreferenceInHierarchy(String) |
用給定的鍵在這個層級結構中找到偏好（整個系統，甚至在螢幕 |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| GetPersistedBoolean(Boolean) |
嘗試取得持久的布林值（若此偏好為持久）。 |
| GetPersistedFloat(Single) |
嘗試取得持久浮點數（若此偏好為持久）。 |
| GetPersistedInt(Int32) |
如果偏好是持久的，嘗試取得持久的整數。 |
| GetPersistedLong(Int64) |
如果這個偏好持續存在，則會嘗試獲得持久的多頭。 |
| GetPersistedString(String) |
如果這個偏好是持久的，則嘗試取得持久的字串。 |
| GetPersistedStringSet(ICollection<String>) |
如果偏好是持久的，嘗試取得持久的字串集合。 |
| GetView(View, ViewGroup) |
取得將在 |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| NotifyChanged() |
當資料 |
| NotifyDependencyChange(Boolean) |
通知任何聆聽的依賴者有關影響依賴性的變更。 |
| NotifyHierarchyChanged() |
當偏好被新增或移除時，應該先打電話，或重新評估排序。 |
| OnAttachedToActivity() |
當偏好層級已附加於 |
| OnAttachedToHierarchy(PreferenceManager) |
當此偏好被附加到偏好階層時，會被呼叫。 |
| OnBindView(View) |
將建立的檢視綁定到此偏好設定的資料。 |
| OnClick() |
處理點擊偏好。 |
| OnCreateView(ViewGroup) |
建立該偏好 |
| OnDependencyChanged(Preference, Boolean) |
當依賴性改變時會打電話給我。 |
| OnGetDefaultValue(TypedArray, Int32) |
當偏好設定被膨脹且需要讀取預設值屬性時，會被呼叫。 |
| OnParentChanged(Preference, Boolean) |
當隱含的父依賴性改變時被呼叫。 |
| OnPrepareForRemoval() |
當這個偏好從階層中移除時，會被召喚。 |
| OnRestoreInstanceState(IParcelable) |
Hook 允許偏好重新套用先前由 |
| OnSaveInstanceState() |
Hook 允許偏好設定產生其內部狀態的表示，之後可用來建立具有相同狀態的新實例。 |
| OnSetInitialValue(Boolean, Object) |
實作此設定偏好設定的初始值。 |
| PeekExtras() |
回傳與此偏好設定相關的額外 Bundle 物件，若目前沒有則回 |
| PersistBoolean(Boolean) |
嘗試持久化一個布林值，前提是此偏好是持久的。 |
| PersistFloat(Single) |
如果這個偏好持續，會嘗試長期持續。 |
| PersistInt(Int32) |
若偏好為持久，則嘗試持久化一個智力。 |
| PersistLong(Int64) |
如果這個偏好持續，會嘗試長期持續。 |
| PersistString(String) |
嘗試持久化字串（若偏好為持久）。 |
| PersistStringSet(ICollection<String>) |
若此偏好為持久性，則嘗試持久化一組字串。 |
| RestoreHierarchyState(Bundle) |
還原該偏好階層先前從該容器儲存的狀態。 |
| SaveHierarchyState(Bundle) |
將這個偏好階層的凍結狀態儲存在給定的容器中。 |
| SetDefaultValue(Object) |
設定此偏好設定的預設值，若持久化關閉或持久化開啟且偏好設定未在持久儲存中，偏好設定將被設定。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetIcon(Int32) |
用資源 ID 設定此偏好設定圖示。 |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
代表由 以 |
| SetSummary(Int32) |
透過資源 ID 設定此偏好的摘要。 |
| SetTitle(Int32) |
會用資源 ID 設定此偏好設定的標題。 |
| ShouldCommit() |
回傳是否 |
| ShouldDisableDependents() |
檢查該偏好的受扶養人是否應該目前被停用。 |
| ShouldPersist() |
檢查在呼叫此方法時，該偏好設定是否應將其值儲存或還原到（若指派後）中 |
| 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 |
代表由 以 |
| PreferenceClick |
代表由 以 |
明確介面實作
| 名稱 | Description |
|---|---|
| IComparable.CompareTo(Object) |
將此物件與指定的物件比較排序。 |
| IJavaPeerable.Disposed() |
代表由 以 |
| IJavaPeerable.Finalized() |
代表由 以 |
| IJavaPeerable.JniObjectReferenceControlBlock |
代表由 以 |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
代表由 以 |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
代表由 以 |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
代表由 以 |
| IJavaPeerable.UnregisterFromRuntime() |
代表由 以 |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
代表由 以 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |