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
기본 설정을 표시하기 위해 이 클래스의 instance 가리킵니다. 이 클래스를 인스턴스화하려면 를 사용합니다 PreferenceManager#createPreferenceScreen(Context)
. <ul> 이 클래스는 두 위치에 나타날 수 있습니다. <li> 이 PreferenceActivity
클래스를 가리키면 루트로 사용되며 표시되지 않습니다(포함된 기본 설정만 표시됨). <li> 다른 기본 설정 계층 내에 나타나면 이 계층이 표시되고 기본 설정의 다른 화면으로 게이트웨이 역할을 합니다(다른 기본 설정 Dialog
화면을 로 표시하거나 에서 Preference#getIntent()
을 Context#startActivity(android.content.Intent)
통해 ). 이 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 기본 설정 라이브러리 사용에 대한 자세한 내용은 설정을 참조하세요.
에 대한 Java 설명서입니다 android.preference.PreferenceScreen
.
이 페이지의 일부는 만들고 공유하며 에 설명된 용어에 따라 사용되는 작업을 기반으로 수정됩니다.
필드
DefaultOrder |
|
속성
Class |
이 |
Context |
이 기본 설정의 를 |
Dependency |
이 기본 설정에 대한 종속성의 키를 반환합니다. -또는- 이 기본 설정에 따라 달라지는 기본 설정의 키를 설정합니다. (다음에서 상속됨 Preference) |
Dialog |
대화 상자에 대한 핸들을 가져오는 데 사용됩니다. |
Editor |
|
Enabled |
목록에서 이 기본 설정을 사용하도록 설정해야 하는지 여부를 확인합니다. -또는- 이 기본 설정을 사용할지 여부를 설정합니다. (다음에서 상속됨 Preference) |
Extras |
이 기본 설정과 연결된 extras Bundle 개체를 반환하여 현재 번들이 없는 경우 새 번들을 만듭니다. (다음에서 상속됨 Preference) |
Fragment |
이 기본 설정과 연결된 조각 클래스 이름을 반환합니다. -또는- 이 기본 설정을 클릭할 때 표시할 조각의 클래스 이름을 설정합니다. (다음에서 상속됨 Preference) |
Handle |
기본 Android instance 대한 핸들입니다. (다음에서 상속됨 Object) |
HasKey |
이 기본 설정에 유효한 키가 있는지 확인합니다. (다음에서 상속됨 Preference) |
Icon |
이 기본 설정의 아이콘을 반환합니다. -또는- 이 기본 설정의 아이콘을 그리기 가능으로 설정합니다. (다음에서 상속됨 Preference) |
IconSpaceReserved |
이 기본 설정 아이콘 보기의 공간이 예약되어 있는지 여부를 가져옵니다. -또는- 아이콘이 제공되지 않을 때 이 기본 설정 아이콘 보기의 공간을 예약할지 여부를 설정합니다. (다음에서 상속됨 Preference) |
Intent |
|
IsOnSameScreenAsChildren |
이 기본 설정 그룹을 포함된 기본 설정과 동일한 화면에 표시해야 하는지 여부입니다. (다음에서 상속됨 PreferenceGroup) |
JniIdentityHashCode |
기본 설정 계층의 루트인 최상위 수준을 |
JniPeerMembers |
기본 설정 계층의 루트인 최상위 수준을 |
Key |
또는 |
LayoutResource |
이 기본 설정의 로 |
OnPreferenceChangeListener |
사용자가 이 기본 설정을 변경할 때 호출할 콜백을 반환합니다(내부 상태가 업데이트되기 전). -또는- 사용자가 이 기본 설정을 변경할 때 호출할 콜백을 설정합니다(내부 상태가 업데이트되기 전). (다음에서 상속됨 Preference) |
OnPreferenceClickListener |
이 기본 설정을 클릭할 때 호출할 콜백을 반환합니다. -또는- 이 기본 설정을 클릭할 때 호출할 콜백을 설정합니다. (다음에서 상속됨 Preference) |
Order |
동일한 수준의 다른 Preference 개체와 관련하여 이 기본 설정의 순서를 가져옵니다. -또는- 동일한 수준의 다른 기본 설정 개체와 관련하여 이 기본 설정의 순서를 설정합니다. (다음에서 상속됨 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 |
이 기본 설정의 타이틀 리소스 ID를 반환합니다. (다음에서 상속됨 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) |
이 기본 설정 및 해당 자식에 대한 instance 저장하기 위해 에 의해 SaveHierarchyState(Bundle) 호출됩니다. (다음에서 상속됨 PreferenceGroup) |
Dispose() |
기본 설정 계층의 루트인 최상위 수준을 |
Dispose(Boolean) |
기본 설정 계층의 루트인 최상위 수준을 |
Equals(Object) |
다른 개체가 이 개체와 "같음"인지 여부를 나타냅니다. (다음에서 상속됨 Object) |
FindPreference(ICharSequence) |
키를 기반으로 을 |
FindPreference(String) |
키를 기반으로 을 |
FindPreferenceInHierarchy(String) |
지정된 키를 사용하여 이 계층 구조(화면 나누기 위/아래 |
GetHashCode() |
개체의 해시 코드 값을 반환합니다. (다음에서 상속됨 Object) |
GetPersistedBoolean(Boolean) |
이 기본 설정이 영구적이면 지속형 부울을 가져오려고 시도합니다. (다음에서 상속됨 Preference) |
GetPersistedFloat(Single) |
이 기본 설정이 영구적이면 지속형 float를 가져오려고 시도합니다. (다음에서 상속됨 Preference) |
GetPersistedInt(Int32) |
이 기본 설정이 영구적이면 지속형 int를 가져오려고 시도합니다. (다음에서 상속됨 Preference) |
GetPersistedLong(Int64) |
이 기본 설정이 영구인 경우 지속된 기간을 가져오려고 시도합니다. (다음에서 상속됨 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() |
후크를 사용하면 기본 설정이 나중에 동일한 상태의 새 instance 만드는 데 사용할 수 있는 내부 상태의 표현을 생성할 수 있습니다. (다음에서 상속됨 Preference) |
OnSetInitialValue(Boolean, Object) |
이를 구현하여 기본 설정의 초기 값을 설정합니다. (다음에서 상속됨 Preference) |
PeekExtras() |
이 기본 설정과 연결된 extras Bundle 개체를 반환하고 |
PersistBoolean(Boolean) |
이 기본 설정이 영구적이면 부울을 유지하려고 시도합니다. (다음에서 상속됨 Preference) |
PersistFloat(Single) |
이 기본 설정이 지속적이면 오래 유지하려고 시도합니다. (다음에서 상속됨 Preference) |
PersistInt(Int32) |
이 기본 설정이 영구적이면 int를 유지하려고 시도합니다. (다음에서 상속됨 Preference) |
PersistLong(Int64) |
이 기본 설정이 지속적이면 오래 유지하려고 시도합니다. (다음에서 상속됨 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) |
리소스 ID를 사용하여 이 기본 설정의 아이콘을 설정합니다. (다음에서 상속됨 Preference) |
SetSummary(Int32) |
리소스 ID를 사용하여 이 기본 설정에 대한 요약을 설정합니다. (다음에서 상속됨 Preference) |
SetTitle(Int32) |
리소스 ID를 사용하여 이 기본 설정의 제목을 설정합니다. (다음에서 상속됨 Preference) |
ShouldCommit() |
에서 |
ShouldDisableDependents() |
이 기본 설정의 종속을 현재 사용하지 않도록 설정해야 하는지 여부를 확인합니다. (다음에서 상속됨 Preference) |
ShouldPersist() |
지정된 시간에 이 메서드가 호출되면 이 기본 설정이 값을 저장/복원해야 하는지 여부를 확인합니다( 할당된 경우) |
ToArray<T>() |
기본 설정 계층의 루트인 최상위 수준을 |
ToString() |
개체의 문자열 표현을 반환합니다. (다음에서 상속됨 Object) |
UnregisterFromRuntime() |
기본 설정 계층의 루트인 최상위 수준을 |
Wait() |
현재 스레드가 각성될 때까지 대기하도록 합니다. 일반적으로 <알림을<> 받>거나<<> 중단/em>합니다. (다음에서 상속됨 Object) |
Wait(Int64) |
현재 스레드가 깨어날 때까지 대기하게 하며, 일반적으로 <알림을 받<>거나 중단</>em>>을 받거나 <일정량의 실시간이 경과할 때까지 대기합니다. (다음에서 상속됨 Object) |
Wait(Int64, Int32) |
현재 스레드가 깨어날 때까지 대기하게 하며, 일반적으로 <알림을 받<>거나 중단</>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) |
기본 설정 계층의 루트인 최상위 수준을 |