PreferenceScreen 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 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, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("android/preference/PreferenceScreen", DoNotGenerateAcw=true)>]
type PreferenceScreen = class
inherit PreferenceGroup
interface IDialogInterfaceOnDismissListener
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface AdapterView.IOnItemClickListener
- 繼承
- 屬性
- 實作
備註
表示最上層 Preference
,這是喜好設定階層的根目錄。 指向 PreferenceActivity
這個類別的實例,以顯示喜好設定。 若要具現化這個類別,請使用 PreferenceManager#createPreferenceScreen(Context)
。 <ul > 這個類別可以出現在兩個 PreferenceActivity
位置: < li > 當指向此點時,它會當做根目錄使用,而且不會顯示在 (只會顯示包含的喜好設定) 。 <li > 當它出現在另一個喜好設定階層內時,會顯示它,並作為另一個喜好設定畫面的閘道, (另一個喜好設定畫面顯示為 , Dialog
或透過 Context#startActivity(android.content.Intent)
從) 顯示 Preference#getIntent()
。 這 PreferenceScreen
的子系不會顯示在畫面中 PreferenceScreen
。 相反地,按一下此喜好設定時,會顯示個別畫面。 </ul>
以下是 PreferenceScreen 的範例 XML 配置:
<PreferenceScreen
xmlns:android="http://schemas.android.com/apk/res/android"
android:key="first_preferencescreen">
<CheckBoxPreference
android:key="wifi enabled"
android:title="WiFi" />
<PreferenceScreen
android:key="second_preferencescreen"
android:title="WiFi settings">
<CheckBoxPreference
android:key="prefer wifi"
android:title="Prefer WiFi" />
... other preferences here ...
</PreferenceScreen>
</PreferenceScreen>
在此範例中,「first_preferencescreen」 會作為階層的根目錄,並提供給 PreferenceActivity
。 第一個畫面會顯示喜好設定 「WiFi」 (,可用來快速啟用/停用 WiFi) 和 「WiFi 設定」。 「WiFi 設定」是「second_preferencescreen」,按下時會顯示另一個喜好設定畫面,例如「偏好 WiFi」 (和其他屬於「second_preferencescreen」標籤子系的喜好設定) 。
<div class=「special reference」 >< h3 > Developer Guides < /h3>
如需使用喜好設定建置設定 UI 的相關資訊,請參閱 設定 指南。
</Div>
已取代這個成員。 使用AndroidX喜好設定程式庫在所有裝置上保持一致的行為。 如需使用 AndroidX 喜好設定程式庫的詳細資訊,請參閱 設定。
的 android.preference.PreferenceScreen
JAVA 檔。
此頁面的部分是根據所建立和共用的工作進行修改,並根據 2.5 屬性授權中所述的詞彙來使用。
欄位
DefaultOrder |
如果不需要特定訂單,請指定 |
屬性
Class |
傳回這個 |
Context |
傳回這個喜好設定 |
Dependency |
傳回此喜好設定相依性索引鍵。 -或- 設定此喜好設定將相依的喜好設定索引鍵。 (繼承來源 Preference) |
Dialog |
用來取得對話方塊的控制碼。 |
Editor |
傳回 , |
Enabled |
檢查清單中是否應該啟用此喜好設定。 -或- 設定是否啟用此喜好設定。 (繼承來源 Preference) |
Extras |
傳回與此喜好設定相關聯的額外 Bundle 物件,如果目前沒有一個套件組合,請建立新的套件組合。 (繼承來源 Preference) |
Fragment |
傳回與此喜好設定相關聯的片段類別名稱。 -或- 設定按一下此喜好設定時要顯示的片段類別名稱。 (繼承來源 Preference) |
Handle |
基礎 Android 實例的控制碼。 (繼承來源 Object) |
HasKey |
檢查此喜好設定是否有有效的金鑰。 (繼承來源 Preference) |
Icon |
傳回此喜好設定的圖示。 -或- 使用可繪製來設定此喜好設定的圖示。 (繼承來源 Preference) |
IconSpaceReserved |
取得是否保留此喜好設定圖示檢視的空間。 -或- 設定是否要在未提供任何圖示時保留此喜好設定圖示檢視的空間。 (繼承來源 Preference) |
Intent |
|
IsOnSameScreenAsChildren |
此喜好設定群組是否應該顯示在與其內含喜好設定相同的畫面上。 (繼承來源 PreferenceGroup) |
JniIdentityHashCode |
表示最上層 |
JniPeerMembers |
表示最上層 |
Key |
取得此喜好設定的索引鍵,這也是用來將值儲存至 |
LayoutResource |
取得配置資源,此配置資源會顯示為此 |
OnPreferenceChangeListener |
傳回當使用者變更此喜好設定時要叫用的回呼 (,但在內部狀態更新) 之前。 -或- 設定當使用者變更此喜好設定時要叫用的回呼 (,但在內部狀態更新) 之前。 (繼承來源 Preference) |
OnPreferenceClickListener |
傳回按一下此喜好設定時要叫用的回呼。 -或- 設定按一下此喜好設定時要叫用的回呼。 (繼承來源 Preference) |
Order |
取得與相同層級上其他喜好設定物件相關的此喜好設定順序。 -或- 根據相同層級的其他喜好設定物件,設定此喜好設定的順序。 (繼承來源 Preference) |
OrderingAsAdded |
此群組是否依新增的順序排序喜好設定。 -或- 是否要在新增時排序 |
Parent |
傳回此喜好設定指派給 的 |
PeerReference |
表示最上層 |
Persistent |
檢查此喜好設定是否持續。 -或- 設定此喜好設定是否持續。 (繼承來源 Preference) |
PreferenceCount |
傳回子 |
PreferenceDataStore |
此喜好設定 |
PreferenceManager |
|
RecycleEnabled |
檢查此喜好設定是否已啟用在清單檢視中使用時回收其檢視。 -或- 設定此喜好設定是否已啟用在清單檢視中使用時回收其檢視。 (繼承來源 Preference) |
RootAdapter |
傳回可附加至 |
Selectable |
檢查清單中是否應該選取此喜好設定。 -或- 設定此喜好設定是否可選取。 (繼承來源 Preference) |
SharedPreferences |
傳回這個喜好設定 |
ShouldDisableView |
檢查此喜好設定是否應該在停用動作時停用其檢視。 -或- 設定此喜好設定是否應該在停用時停用其檢視。 (繼承來源 Preference) |
SingleLineTitle |
取得此喜好設定的標題是否限制為單行。 -或- 設定是否要將此喜好設定的標題限制為單一行,而不是讓它換行到多行。 (繼承來源 Preference) |
Summary |
表示最上層 |
SummaryFormatted |
傳回此喜好設定的摘要。 -或- 使用 CharSequence 設定此喜好設定的摘要。 (繼承來源 Preference) |
ThresholdClass |
此 API 支援適用于 Android 的 Mono 基礎結構,並不適合直接從您的程式碼使用。 (繼承來源 PreferenceGroup) |
ThresholdType |
此 API 支援適用于 Android 的 Mono 基礎結構,並不適合直接從您的程式碼使用。 (繼承來源 PreferenceGroup) |
Title |
表示最上層 |
TitleFormatted |
傳回此喜好設定的標題。 -或- 使用 CharSequence 設定此喜好設定的標題。 (繼承來源 Preference) |
TitleRes |
傳回此喜好設定的標題資源識別碼。 (繼承來源 Preference) |
WidgetLayoutResource |
取得這個喜好設定之可控制小工具部分的配置資源。 -或- 設定此喜好設定之可控制小工具部分的配置。 (繼承來源 Preference) |
方法
AddItemFromInflater(Preference) |
由擴充器呼叫,將專案新增至此群組。 (繼承來源 PreferenceGroup) |
AddPreference(Preference) |
|
Bind(ListView) |
透過 |
CallChangeListener(Object) |
在使用者變更喜好設定之後呼叫這個方法,但在設定內部狀態之前。 (繼承來源 Preference) |
Clone() |
建立並傳回這個 物件的複本。 (繼承來源 Object) |
CompareTo(Preference) |
根據順序比較喜好設定物件 (如果設定) ,否則會依字母順序在標題上設定。 (繼承來源 Preference) |
DispatchRestoreInstanceState(Bundle) |
呼叫 者 RestoreHierarchyState(Bundle) ,以擷取此喜好設定及其子系的已儲存狀態。 (繼承來源 PreferenceGroup) |
DispatchSaveInstanceState(Bundle) |
呼叫 者 SaveHierarchyState(Bundle) ,以儲存這個喜好設定及其子系的實例。 (繼承來源 PreferenceGroup) |
Dispose() |
表示最上層 |
Dispose(Boolean) |
表示最上層 |
Equals(Object) |
指出其他物件是否「等於」這個物件。 (繼承來源 Object) |
FindPreference(ICharSequence) |
|
FindPreference(String) |
|
FindPreferenceInHierarchy(String) |
在此階層中尋找喜好設定, (整個專案,即使在螢幕 |
GetHashCode() |
傳回此物件的雜湊碼值。 (繼承來源 Object) |
GetPersistedBoolean(Boolean) |
如果這個喜好設定是持續性的,則嘗試取得保存的布林值。 (繼承來源 Preference) |
GetPersistedFloat(Single) |
如果這個喜好設定是持續性的,則嘗試取得保存的浮點數。 (繼承來源 Preference) |
GetPersistedInt(Int32) |
如果這個喜好設定是持續性的,則嘗試取得保存的 int。 (繼承來源 Preference) |
GetPersistedLong(Int64) |
如果此喜好設定是持續性的,則嘗試取得保存的 long。 (繼承來源 Preference) |
GetPersistedString(String) |
如果這個喜好設定是持續性的,則嘗試取得保存的字串。 (繼承來源 Preference) |
GetPersistedStringSet(ICollection<String>) |
如果這個喜好設定持續存在,則嘗試取得一組保存的字串。 (繼承來源 Preference) |
GetPreference(Int32) |
傳 |
GetView(View, ViewGroup) |
取得 將顯示在 中的 |
JavaFinalize() |
當垃圾收集判斷物件不再參考物件時,垃圾收集行程會在物件上呼叫。 (繼承來源 Object) |
Notify() |
喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object) |
NotifyAll() |
喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object) |
NotifyChanged() |
當這個 |
NotifyDependencyChange(Boolean) |
通知會影響相依性之變更的任何接聽相依專案。 (繼承來源 Preference) |
NotifyHierarchyChanged() |
應該在此群組中新增/移除喜好設定時呼叫,或重新評估排序。 (繼承來源 Preference) |
OnAttachedToActivity() |
當喜好設定階層已附加至 |
OnAttachedToHierarchy(PreferenceManager) |
當此喜好設定已附加至喜好設定階層時呼叫。 (繼承來源 Preference) |
OnBindView(View) |
將建立的檢視系結至此喜好設定的資料。 (繼承來源 Preference) |
OnClick() |
處理喜好設定的按一下。 (繼承來源 Preference) |
OnCreateView(ViewGroup) |
在 中 |
OnDependencyChanged(Preference, Boolean) |
相依性變更時呼叫。 (繼承來源 Preference) |
OnDismiss(IDialogInterface) |
當對話方塊關閉時,將會叫用這個方法。 |
OnGetDefaultValue(TypedArray, Int32) |
當喜好設定擴大且需要讀取預設值屬性時呼叫。 (繼承來源 Preference) |
OnItemClick(AdapterView, View, Int32, Int64) | |
OnParentChanged(Preference, Boolean) |
當隱含父相依性變更時呼叫。 (繼承來源 Preference) |
OnPrepareAddPreference(Preference) |
|
OnPrepareForRemoval() |
從階層中移除此喜好設定時呼叫。 (繼承來源 Preference) |
OnRestoreInstanceState(IParcelable) |
允許喜好設定重新套用其先前產生 |
OnSaveInstanceState() |
允許喜好設定產生其內部狀態的標記法,稍後可用來建立具有相同狀態的新實例。 (繼承來源 Preference) |
OnSetInitialValue(Boolean, Object) |
實作此選項以設定喜好設定的初始值。 (繼承來源 Preference) |
PeekExtras() |
傳回與此喜好設定相關聯的 Extras Bundle 物件,如果目前沒有此喜好設定,則會傳 |
PersistBoolean(Boolean) |
如果這個喜好設定是持續性的,則嘗試保存布林值。 (繼承來源 Preference) |
PersistFloat(Single) |
如果此喜好設定是持續性的,則嘗試保存 long。 (繼承來源 Preference) |
PersistInt(Int32) |
如果這個喜好設定是持續性的,則嘗試保存 int。 (繼承來源 Preference) |
PersistLong(Int64) |
如果此喜好設定是持續性的,則嘗試保存 long。 (繼承來源 Preference) |
PersistString(String) |
如果這個喜好設定是持續性的,則嘗試保存字串。 (繼承來源 Preference) |
PersistStringSet(ICollection<String>) |
如果此喜好設定是持續性的,則嘗試保存一組字串。 (繼承來源 Preference) |
RemoveAll() |
從此群組中移除所有 |
RemovePreference(Preference) |
|
RestoreHierarchyState(Bundle) |
從指定的容器還原此喜好設定階層先前儲存的狀態。 (繼承來源 Preference) |
SaveHierarchyState(Bundle) |
將此喜好設定階層的凍結狀態儲存到指定的容器中。 (繼承來源 Preference) |
SetDefaultValue(Object) |
設定此喜好設定的預設值,如果持續性已關閉或持續性開啟,且永續性儲存體中找不到喜好設定,則會設定預設值。 (繼承來源 Preference) |
SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
SetIcon(Int32) |
使用資源識別碼設定此喜好設定的圖示。 (繼承來源 Preference) |
SetSummary(Int32) |
使用資源識別碼設定此喜好設定的摘要。 (繼承來源 Preference) |
SetTitle(Int32) |
使用資源識別碼設定此喜好設定的標題。 (繼承來源 Preference) |
ShouldCommit() |
傳回 是否 |
ShouldDisableDependents() |
檢查此喜好設定的相依專案目前是否應該停用。 (繼承來源 Preference) |
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) |
表示最上層 |