Preference 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示 表單中顯示的 ListView 基本喜好設定 UI 建置組塊 PreferenceActivity 。
[Android.Runtime.Register("android/preference/Preference", DoNotGenerateAcw=true)]
public class Preference : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.Lang.IComparable[<Android.Runtime.Register("android/preference/Preference", DoNotGenerateAcw=true)>]
type Preference = class
inherit Object
interface IComparable
interface IJavaObject
interface IDisposable
interface IJavaPeerable- 繼承
- 衍生
- 屬性
- 實作
備註
表示 表單中顯示的 ListView 基本喜好設定 UI 建置組塊 PreferenceActivity 。 這個類別提供 View 要顯示在活動中，並與 建立關聯 SharedPreferences 以儲存/擷取喜好設定資料的 。
在 XML 中指定喜好設定階層時，每個元素都可以指向 的 Preference 子類別，類似于檢視階層和版面配置。
這個類別包含 key 的 ，將當做 中的 SharedPreferences 索引鍵使用。 子類別可決定如何儲存值。
<div class=「special reference」 >< h3 > Developer Guides < /h3>
如需使用喜好設定建置設定 UI 的相關資訊，請參閱 設定 指南。
</Div>
已取代這個成員。 使用AndroidX喜好設定程式庫在所有裝置上保持一致的行為。 如需使用 AndroidX 喜好設定程式庫的詳細資訊，請參閱 設定。
的 android.preference.Preference JAVA 檔。
此頁面的部分是根據 原始碼專案所建立和共用的工作進行修改，並根據中所述的詞彙使用。
建構函式
| Preference(Context) |
建立喜好設定的建構函式。 |
| Preference(Context, IAttributeSet) |
從 XML 擴充喜好設定時所呼叫的建構函式。 |
| Preference(Context, IAttributeSet, Int32) |
從 XML 執行擴大，並套用類別特定的基底樣式。 |
| Preference(Context, IAttributeSet, Int32, Int32) |
從 XML 執行擴大，並套用類別特定的基底樣式。 |
| Preference(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 標記法時使用的建構函式;由執行時間呼叫。 |
欄位
| DefaultOrder |
如果不需要特定順序，請指定 |
屬性
| Class |
傳回這個 |
| Context |
傳 |
| Dependency |
傳回相依于這個喜好設定的索引鍵。 -或- 設定此喜好設定將相依的喜好設定索引鍵。 |
| Editor |
傳回 ， |
| Enabled |
檢查清單中是否應該啟用此喜好設定。 -或- 設定是否啟用此喜好設定。 |
| Extras |
傳回與此喜好設定相關聯的額外套件組合物件，如果目前沒有一個套件組合，請建立新的套件組合。 |
| Fragment |
傳回與此喜好設定相關聯的片段類別名稱。 -或- 設定按一下此喜好設定時要顯示的片段類別名稱。 |
| Handle |
基礎 Android 實例的控制碼。 (繼承來源 Object) |
| HasKey |
檢查此喜好設定是否有有效的金鑰。 |
| Icon |
傳回此喜好設定的圖示。 -或- 使用可繪製來設定此喜好設定的圖示。 |
| IconSpaceReserved |
取得這個喜好設定圖示檢視是否保留的空間。 -或- 設定是否要在未提供任何圖示時保留此喜好設定圖示檢視的空間。 |
| Intent |
|
| JniIdentityHashCode |
表示 表單中顯示的 |
| JniPeerMembers |
表示 表單中顯示的 |
| Key |
取得這個喜好設定的索引鍵，這也是用來將值儲存至 |
| LayoutResource |
取得配置資源，此配置資源會顯示為此 |
| OnPreferenceChangeListener |
傳回當使用者變更此喜好設定時要叫用的回呼 (，但在內部狀態更新) 之前。 -或- 設定當使用者變更此喜好設定時要叫用的回呼 (，但在內部狀態更新) 之前。 |
| OnPreferenceClickListener |
傳回在按一下此喜好設定時要叫用的回呼。 -或- 設定按一下此喜好設定時要叫用的回呼。 |
| Order |
取得這個喜好設定的順序，相對於相同層級上的其他喜好設定物件。 -或- 根據相同層級的其他喜好設定物件，設定此喜好設定的順序。 |
| Parent |
傳回指派給 這個喜好 |
| PeerReference |
表示 表單中顯示的 |
| Persistent |
檢查此喜好設定是否持續。 -或- 設定此喜好設定是否為持續性。 |
| PreferenceDataStore |
|
| PreferenceManager |
|
| RecycleEnabled |
檢查此喜好設定是否已啟用在清單檢視中使用時回收其檢視。 -或- 設定此喜好設定是否已啟用在清單檢視中使用時回收其檢視。 |
| Selectable |
檢查此喜好設定是否應該在清單中選取。 -或- 設定此喜好設定是否可選取。 |
| SharedPreferences |
傳 |
| ShouldDisableView |
檢查此喜好設定在停用動作時是否應該停用其檢視。 -或- 設定此喜好設定在停用時是否應該停用其檢視。 |
| SingleLineTitle |
取得這個喜好設定的標題是否受限於單行。 -或- 設定是否要將此喜好設定的標題限制為單行，而不是讓它換行到多行。 |
| Summary |
表示 表單中顯示的 |
| SummaryFormatted |
傳回此喜好設定的摘要。 -或- 使用 CharSequence 設定此喜好設定的摘要。 |
| ThresholdClass |
此 API 支援適用于 Android 的 Mono 基礎結構，並不適合直接從您的程式碼使用。 |
| ThresholdType |
此 API 支援適用于 Android 的 Mono 基礎結構，並不適合直接從您的程式碼使用。 |
| Title |
表示 表單中顯示的 |
| TitleFormatted |
傳回此喜好設定的標題。 -或- 使用 CharSequence 設定此喜好設定的標題。 |
| TitleRes |
傳回此喜好設定的標題資源識別碼。 |
| WidgetLayoutResource |
取得此喜好設定之可控制小工具部分的配置資源。 -或- 設定此喜好設定之可控制小工具部分的配置。 |
方法
| CallChangeListener(Object) |
在使用者變更喜好設定之後呼叫這個方法，但在設定內部狀態之前。 |
| Clone() |
建立並傳回這個 物件的複本。 (繼承來源 Object) |
| CompareTo(Preference) |
如果) 設定，則根據順序比較喜好設定物件 (，否則會依字母順序在標題上設定。 |
| Dispose() |
表示 表單中顯示的 |
| Dispose(Boolean) |
表示 表單中顯示的 |
| Equals(Object) |
指出其他物件是否「等於」這個物件。 (繼承來源 Object) |
| FindPreferenceInHierarchy(String) |
尋找此階層中的喜好設定 (整個專案，即使在螢幕 |
| GetHashCode() |
傳回此物件的雜湊碼值。 (繼承來源 Object) |
| GetPersistedBoolean(Boolean) |
如果此喜好設定是持續性的，則嘗試取得保存的布林值。 |
| GetPersistedFloat(Single) |
如果此喜好設定持續存在，就會嘗試取得保存的浮點數。 |
| GetPersistedInt(Int32) |
如果此喜好設定持續存在，就會嘗試取得保存的 int。 |
| GetPersistedLong(Int64) |
如果此喜好設定持續存在，就會嘗試取得保存的時間長度。 |
| GetPersistedString(String) |
如果此喜好設定持續存在，就會嘗試取得保存的字串。 |
| GetPersistedStringSet(ICollection<String>) |
如果此喜好設定持續存在，就會嘗試取得一組保存的 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) |
允許喜好設定重新套用其先前由 |
| OnSaveInstanceState() |
允許喜好設定產生其內部狀態的標記法，稍後可用來建立具有相同狀態的新實例。 |
| OnSetInitialValue(Boolean, Object) |
實作此專案以設定喜好設定的初始值。 |
| PeekExtras() |
傳回與此喜好設定相關聯的 extras Bundle 物件，如果目前沒有一個，則會傳 |
| PersistBoolean(Boolean) |
如果此喜好設定是持續性的，則嘗試保存布林值。 |
| PersistFloat(Single) |
如果此喜好設定是持續性的，則嘗試保存 long。 |
| PersistInt(Int32) |
如果此喜好設定是持續性的，則嘗試保存 int。 |
| PersistLong(Int64) |
如果此喜好設定是持續性的，則嘗試保存 long。 |
| PersistString(String) |
如果此喜好設定是持續性的，則嘗試保存字串。 |
| PersistStringSet(ICollection<String>) |
如果此喜好設定是持續性的，則嘗試保存一組字串。 |
| RestoreHierarchyState(Bundle) |
從指定的容器還原此喜好設定階層先前儲存的狀態。 |
| SaveHierarchyState(Bundle) |
將此喜好設定階層的凍結狀態儲存到指定的容器中。 |
| SetDefaultValue(Object) |
設定此喜好設定的預設值，如果持續性已關閉或持續性開啟，而且持續性儲存體中找不到喜好設定，則會設定此值。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetIcon(Int32) |
使用資源識別碼來設定此喜好設定的圖示。 |
| SetSummary(Int32) |
使用資源識別碼來設定此喜好設定的摘要。 |
| SetTitle(Int32) |
使用資源識別碼設定此喜好設定的標題。 |
| ShouldCommit() |
傳回 是否 |
| ShouldDisableDependents() |
檢查此喜好設定的相依專案目前是否應該停用。 |
| ShouldPersist() |
檢查在指定時間呼叫這個方法時，這個喜好設定應該儲存/還原其值， (s) 指派時儲存 |
| ToArray<T>() |
表示 表單中顯示的 |
| ToString() |
傳回物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
表示 表單中顯示的 |
| 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) |
事件
| PreferenceChange |
表示 表單中顯示的 |
| PreferenceClick |
表示 表單中顯示的 |
明確介面實作
| IComparable.CompareTo(Object) |
表示 表單中顯示的 |
| IJavaPeerable.Disposed() |
表示 表單中顯示的 |
| IJavaPeerable.DisposeUnlessReferenced() |
表示 表單中顯示的 |
| IJavaPeerable.Finalized() |
表示 表單中顯示的 |
| IJavaPeerable.JniManagedPeerState |
表示 表單中顯示的 |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
表示 表單中顯示的 |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
表示 表單中顯示的 |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
表示 表單中顯示的 |
擴充方法
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時間檢查的類型轉換。 |
| JavaCast<TResult>(IJavaObject) |
表示 表單中顯示的 |
| GetJniTypeName(IJavaPeerable) |
表示 表單中顯示的 |