言語

Preference クラス

定義

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 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
継承
Preference
派生
属性
実装

注釈

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。 このクラスは、アクティビティに表示する View を提供し、基本設定データを格納または取得するための SharedPreferences に関連付けます。

XML で基本設定階層を指定する場合、各要素はビュー階層やレイアウトと同様に、 Preferenceのサブクラスを指すことができます。

このクラスには、keyのキーとして使用されるSharedPreferencesが含まれています。 値の格納方法を決定するのはサブクラスです。

<div class="special reference"><h3>Developer Guides</h3>

基本設定を使用して設定 UI を構築する方法については、 設定 ガイドを参照してください。

</部>

このメンバーは非推奨です。 すべてのデバイスで一貫した動作を行うには、 AndroidX 基本設定ライブラリ を使用します。 AndroidX 環境設定ライブラリの使用方法の詳細については、「 設定」を参照してください。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

コンストラクター

名前 説明
Preference(Context, IAttributeSet, Int32, Int32)

XML からインフレーションを実行し、クラス固有の基本スタイルを適用します。

Preference(Context, IAttributeSet, Int32)

XML からインフレーションを実行し、クラス固有の基本スタイルを適用します。

Preference(Context, IAttributeSet)

XML から Preference を拡張するときに呼び出されるコンストラクター。

Preference(Context)

基本設定を作成するコンストラクター。

Preference(IntPtr, JniHandleOwnership)

JNI オブジェクトのマネージド表現を作成するときに使用されるコンストラクター。ランタイムによって呼び出されます。

フィールド

名前 説明
DefaultOrder

特定の注文が不要な場合は、 #setOrder(int) に指定します。

プロパティ

名前 説明
Class

この Objectのランタイム クラスを返します。

(継承元 Object)
Context

この基本設定の android.content.Context を返します。

Dependency

この基本設定に対する依存関係のキーを返します。 または、この基本設定が依存する基本設定のキーを設定します。

Editor

このユーザー設定で値を保存できる SharedPreferences.Editor を返します。

Enabled

この基本設定を一覧で有効にする必要があるかどうかを確認します。 または、この基本設定を有効にするかどうかを設定します。

Extras

この基本設定に関連付けられている extras Bundle オブジェクトを返し、現在存在しない場合は新しいバンドルを作成します。

Fragment

この Preference に関連付けられているフラグメント クラス名を返します。 または、この基本設定をクリックしたときに表示されるフラグメントのクラス名を設定します。

Handle

基になる Android インスタンスへのハンドル。

(継承元 Object)
HasKey

この基本設定に有効なキーがあるかどうかを確認します。

Icon

この基本設定のアイコンを返します。 または、Drawable を使用してこの基本設定のアイコンを設定します。

IconSpaceReserved

この基本設定アイコン ビューの領域が予約されているかどうかを取得します。 または、アイコンが指定されていないときに、この基本設定アイコン ビューの領域を予約するかどうかを設定します。

Intent

この基本設定に関連付けられている Intent を返します。 または、この環境設定をクリックしたときにIntentに使用するContext#startActivity(Intent)を設定します。

JniIdentityHashCode

相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュ コードを取得します。

(継承元 Object)
JniManagedPeerState

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

(継承元 JavaObject)
JniPeerMembers

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

Key

この基本設定のキーを取得します。これは、値を SharedPreferences または PreferenceDataStoreに格納するために使用されるキーでもあります。 または、 SharedPreferences または PreferenceDataStoreのキーとして使用される、この基本設定のキーを設定します。

LayoutResource

この基本設定の View として表示されるレイアウト リソースを取得します。 または、この基本設定に表示する View として拡張されるレイアウト リソースを設定します。

OnPreferenceChangeListener

この基本設定がユーザーによって変更されたときに呼び出されるコールバックを返します (ただし、内部状態が更新される前)。 または、この基本設定がユーザーによって変更されたときに呼び出されるコールバックを設定します (ただし、内部状態が更新される前)。

OnPreferenceClickListener

この基本設定がクリックされたときに呼び出されるコールバックを返します。 または、この基本設定がクリックされたときに呼び出されるコールバックを設定します。

Order

同じレベルの他の Preference オブジェクトに関するこの基本設定の順序を取得します。 または、同じレベルの他の基本設定オブジェクトに対して、この基本設定の順序を設定します。

Parent

この基本設定がグループに割り当てられないか、ルート基本設定の場合は、この基本設定が割り当てられている PreferenceGroup または null を返します。

PeerReference

このJava ピアの JNI オブジェクト参照を取得します。

(継承元 Object)
Persistent

この基本設定が永続的かどうかを確認します。 または、この基本設定が永続的かどうかを設定します。

PreferenceDataStore

この基本設定で使用 PreferenceDataStore を返します。 または、PreferenceDataStoreを使用するのではなく、この基本設定で使用するandroid.content.SharedPreferencesを設定します。

PreferenceManager

この Preference オブジェクトのツリーを管理する PreferenceManager を取得します。

RecycleEnabled

リスト ビューで使用するときに、このユーザー設定でビューのリサイクルが有効になっているかどうかを確認します。 または、リスト ビューで使用する場合に、この基本設定でビューのリサイクルを有効にするかどうかを設定します。

Selectable

この基本設定を一覧で選択できるかどうかを確認します。 または、この基本設定を選択可能にするかどうかを設定します。

SharedPreferences

このユーザー設定が値を読み取ることができる SharedPreferences を返します。

ShouldDisableView

アクションが無効になっているときに、このユーザー設定でビューを無効にするかどうかを確認します。 または、このユーザー設定が無効になったときにビューを無効にするかどうかを設定します。

SingleLineTitle

この基本設定のタイトルが 1 行に制限されているかどうかを取得します。 または、この基本設定のタイトルを複数の行に折り返すのではなく、1 行に制限するかどうかを設定します。

Summary

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

SummaryFormatted

この基本設定の概要を返します。 または、CharSequence を使用してこの基本設定の概要を設定します。

ThresholdClass

この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

ThresholdType

この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。

Title

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

TitleFormatted

この基本設定のタイトルを返します。 または、CharSequence を使用してこの基本設定のタイトルを設定します。

TitleRes

この基本設定のタイトル リソース ID を返します。

WidgetLayoutResource

この基本設定の制御可能なウィジェット部分のレイアウト リソースを取得します。 または、この基本設定の制御可能なウィジェット部分のレイアウトを設定します。

メソッド

名前 説明
CallChangeListener(Object)

ユーザーが基本設定を変更した後、内部状態が設定される前に、このメソッドを呼び出します。

Clone()

このオブジェクトのコピーを作成して返します。

(継承元 Object)
CompareTo(Preference)

順序 (設定されている場合) に基づいて基本設定オブジェクトを比較します。それ以外の場合はタイトルのアルファベット順に比較します。

Construct(JniObjectReference, JniObjectReferenceOptions)

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

(継承元 JavaObject)
Dispose()

このJava ピアによって保持されているリソースを解放します。

(継承元 Object)
Dispose(Boolean)

このJava ピアによって保持されているリソースを解放します。

(継承元 Object)
DisposeUnlessReferenced()

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

(継承元 JavaObject)
Equals(Object)

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

(継承元 JavaObject)
Equals(Object)

他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。

(継承元 Object)
FindPreferenceInHierarchy(String)

特定のキーを使用して、この階層内の基本設定 ( PreferenceScreen の画面中断の上/下でもすべて) を検索します。

GetHashCode()

オブジェクトのハッシュ コード値を返します。

(継承元 Object)
GetPersistedBoolean(Boolean)

この基本設定が永続的な場合は、永続化されたブール値の取得を試みます。

GetPersistedFloat(Single)

この基本設定が永続的な場合は、永続化された float の取得を試みます。

GetPersistedInt(Int32)

この基本設定が永続的な場合は、永続化された int の取得を試みます。

GetPersistedLong(Int64)

この基本設定が永続的な場合は、永続化された長い時間を取得しようとします。

GetPersistedString(String)

この基本設定が永続的な場合は、永続化された文字列の取得を試みます。

GetPersistedStringSet(ICollection<String>)

この基本設定が永続的な場合は、永続化された文字列のセットの取得を試みます。

GetView(View, ViewGroup)

PreferenceActivityに表示されるビューを取得します。

JavaFinalize()

オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。

(継承元 Object)
Notify()

このオブジェクトのモニターで待機している 1 つのスレッドを起動します。

(継承元 Object)
NotifyAll()

このオブジェクトのモニターで待機しているすべてのスレッドを起動します。

(継承元 Object)
NotifyChanged()

この Preference のデータが変更されたときに呼び出す必要があります。

NotifyDependencyChange(Boolean)

依存関係に影響を与える変更をリッスンしている依存ユーザーに通知します。

NotifyHierarchyChanged()

ユーザー設定がこのグループに追加または削除された場合、または順序を再評価する必要がある場合に呼び出す必要があります。

OnAttachedToActivity()

基本設定階層が PreferenceActivityにアタッチされたときに呼び出されます。

OnAttachedToHierarchy(PreferenceManager)

この基本設定が基本設定階層にアタッチされている場合に呼び出されます。

OnBindView(View)

作成したビューをこの基本設定のデータにバインドします。

OnClick()

ユーザー設定のクリックを処理します。

OnCreateView(ViewGroup)

PreferenceActivityでこの基本設定に表示するビューを作成します。

OnDependencyChanged(Preference, Boolean)

依存関係が変更されたときに呼び出されます。

OnGetDefaultValue(TypedArray, Int32)

Preference が拡張され、既定値の属性を読み取る必要がある場合に呼び出されます。

OnParentChanged(Preference, Boolean)

暗黙的な親依存関係が変更されたときに呼び出されます。

OnPrepareForRemoval()

この基本設定が階層から削除されるときに呼び出されます。

OnRestoreInstanceState(IParcelable)

フックを使用すると、 #onSaveInstanceStateによって以前に生成された内部状態の表現を再適用できます。

OnSaveInstanceState()

フックを使用すると、その内部状態の表現を生成できます。これは、後で同じ状態の新しいインスタンスを作成するために使用できます。

OnSetInitialValue(Boolean, Object)

これを実装して、基本設定の初期値を設定します。

PeekExtras()

この基本設定に関連付けられている extras Bundle オブジェクトを返し、現在存在しない場合は null を返します。

PersistBoolean(Boolean)

この基本設定が永続的な場合は、ブール値の永続化を試みます。

PersistFloat(Single)

この基本設定が永続的な場合は、長い期間の永続化を試みます。

PersistInt(Int32)

この基本設定が永続的な場合は、int の永続化を試みます。

PersistLong(Int64)

この基本設定が永続的な場合は、長い期間の永続化を試みます。

PersistString(String)

この基本設定が永続的な場合は、文字列の永続化を試みます。

PersistStringSet(ICollection<String>)

この基本設定が永続的な場合は、文字列のセットを保持しようとします。

RestoreHierarchyState(Bundle)

この基本設定階層の以前に保存した状態を、指定されたコンテナーから復元します。

SaveHierarchyState(Bundle)

この基本設定階層の固定状態を、指定されたコンテナーに格納します。

SetDefaultValue(Object)

この基本設定の既定値を設定します。永続化がオフの場合、または永続化がオンで、永続ストレージに基本設定が見つからない場合に設定されます。

SetHandle(IntPtr, JniHandleOwnership)

Handle プロパティを設定します。

(継承元 Object)
SetIcon(Int32)

リソース ID を使用して、この基本設定のアイコンを設定します。

SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

(継承元 JavaObject)
SetSummary(Int32)

リソース ID を使用して、この基本設定の概要を設定します。

SetTitle(Int32)

リソース ID を使用して、この基本設定のタイトルを設定します。

ShouldCommit()

Preferenceが保存された値を#getEditor()にコミットする必要があるかどうかを返します。

ShouldDisableDependents()

この基本設定の依存を現在無効にするかどうかを確認します。

ShouldPersist()

このメソッドが呼び出された時点で、この Preference の値を SharedPreferences に格納するか、割り当てられている場合は PreferenceDataStore に復元するかを確認します。

ToArray<T>()

このJava配列ラッパーからマネージド配列を作成します。

(継承元 Object)
ToString()

オブジェクトの文字列形式を返します。

(継承元 Object)
UnregisterFromRuntime()

相互運用ランタイムからこのJava ピアの登録を解除します。

(継承元 Object)
Wait()

現在のスレッドが起動するまで待機します。通常は、 <em>notified</em> または <em>interrupted</em>。

(継承元 Object)
Wait(Int64, Int32)

現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。

(継承元 Object)
Wait(Int64)

現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。

(継承元 Object)

イベント

名前 説明
PreferenceChange

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

PreferenceClick

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

明示的なインターフェイスの実装

名前 説明
IComparable.CompareTo(Object)

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

IJavaPeerable.Disposed()

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

(継承元 JavaObject)
IJavaPeerable.Finalized()

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

(継承元 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

(継承元 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

(継承元 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

(継承元 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

(継承元 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

拡張メソッド

名前 説明
GetJniTypeName(IJavaPeerable)

インスタンス selfの型の JNI 名を取得します。

JavaAs<TResult>(IJavaPeerable)

selfを強制的にTResult入力し、強制型がJava側で有効であることを確認します。

JavaCast<TResult>(IJavaObject)

Android ランタイムチェック型変換を実行します。

JavaCast<TResult>(IJavaObject)

PreferenceActivityの形式でListViewによって表示される基本的なユーザー設定 UI の構成要素を表します。

TryJavaCast<TResult>(IJavaPeerable, TResult)

selfを強制的にTResult入力し、強制型がJava側で有効であることを確認します。

適用対象