Configuration 類別

定義

命名空間:: Android.Content.Res

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

此類別描述所有可能影響應用程式所取得資源的裝置配置資訊。

[Android.Runtime.Register("android/content/res/Configuration", DoNotGenerateAcw=true)]
public sealed class Configuration : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Lang.IComparable

[<Android.Runtime.Register("android/content/res/Configuration", DoNotGenerateAcw=true)>]
type Configuration = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IComparable

繼承: Object

JavaObject

Object
Configuration

屬性: RegisterAttribute

實作: IParcelable IJavaObject IJavaPeerable IComparable IDisposable

備註

此類別描述所有可能影響應用程式所取得資源的裝置配置資訊。這包括使用者自訂的設定選項（區域列表與縮放）以及裝置設定（如輸入模式、螢幕大小與螢幕方向）。

你可以用 Resources從 Resources#getConfiguration取得這個物件。因此，從一個活動中，你可以透過串接請求與 android.app.Activity#getResources來取得：

Configuration config = getResources().getConfiguration();

Java 文件 android.content.res.Configuration。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
Configuration()	建構一個無效的配置。
Configuration(Configuration)	能做出適合修改的深度複製。

欄位

名稱	Description
ColorModeHdrMask	已淘汰. 對於 `#colorMode`編碼螢幕動態範圍的位元，常數。
ColorModeHdrNo	已淘汰. 對於 `#colorMode`：表示 `#COLOR_MODE_HDR_MASK` 螢幕不是 HDR（低/標準動態範圍）的數值。
ColorModeHdrShift	已淘汰. 恆定值： `#colorMode`位元移動以取得螢幕動態範圍。
ColorModeHdrUndefined	已淘汰. 對 `#colorMode`為常數：表示 `#COLOR_MODE_HDR_MASK` 螢幕是否為 HDR 尚不明朗。
ColorModeHdrYes	已淘汰. 對 `#colorMode`為常數：表示 `#COLOR_MODE_HDR_MASK` 螢幕為 HDR（動態範圍）的值。
ColorModeUndefined	已淘汰. 對 `#colorMode`為常數：表示色彩模式未定義
ColorModeWideColorGamutMask	已淘汰. 對於：的位元，編碼 `#colorMode`螢幕是否為寬色域。
ColorModeWideColorGamutNo	已淘汰. 對 `#colorMode`為常數：表示 `#COLOR_MODE_WIDE_COLOR_GAMUT_MASK` 螢幕非寬色域。
ColorModeWideColorGamutUndefined	已淘汰. 對 `#colorMode`為常數：表示 `#COLOR_MODE_WIDE_COLOR_GAMUT_MASK` 螢幕是否為寬色域尚不明。
ColorModeWideColorGamutYes	已淘汰. 對 `#colorMode`為常數：表示 `#COLOR_MODE_WIDE_COLOR_GAMUT_MASK` 螢幕為寬色域。
DensityDpiUndefined	預設值表示 `#densityDpi` 未指定寬度。
FontWeightAdjustmentUndefined	一個未定義的字體WeightAdjustment。
GrammaticalGenderFeminine	已淘汰. 文法性別的恆定數：用來表示使用者在應用程式中偏好的稱呼詞彙，該稱呼為陰性。
GrammaticalGenderMasculine	已淘汰. 文法性別的常數：用來表示使用者在應用程式中偏好的稱呼詞彙，該稱呼為陽性。
GrammaticalGenderNeutral	已淘汰. 文法性別的恆定值：用以表示使用者在應用程式中偏好的稱呼詞彙，為中性。
GrammaticalGenderNotSpecified	已淘汰. 文法性別為常數：表示使用者未指定應用程式的地址條件。
MncZero	常數用來表示行動網路代碼（MNC）零。
ScreenHeightDpUndefined	已淘汰. 預設值表示 `#screenHeightDp` 未指定寬度。
ScreenWidthDpUndefined	已淘汰. 預設值表示 `#screenWidthDp` 未指定寬度。
SmallestScreenWidthDpUndefined	預設值表示 `#smallestScreenWidthDp` 未指定寬度。
UiModeNightMask	已淘汰. 對於編碼夜間模式的位元，為常數 `#uiMode`。
UiModeNightNo	已淘汰. 對 `#uiMode`為常數：對 `#UI_MODE_NIGHT_MASK` 應 notnight 資源限定符的值。
UiModeNightUndefined	已淘汰. 常數對 `#uiMode`：表示 `#UI_MODE_NIGHT_MASK` 尚未設定任何模式型別。
UiModeNightYes	已淘汰. 對 `#uiMode`的常數：對 `#UI_MODE_NIGHT_MASK` 應夜晚資源限定符的值。
UiModeTypeAppliance	已淘汰. 對 `#uiMode`為常數：對 `#UI_MODE_TYPE_MASK` 應設備資源限定符的值。
UiModeTypeCar	已淘汰. 常數： `#uiMode`對應 `#UI_MODE_TYPE_MASK` 於汽車資源限定符的值。
UiModeTypeDesk	已淘汰. 常數對`#uiMode#UI_MODE_TYPE_MASK`應於桌面資源限定符。
UiModeTypeMask	已淘汰. 常數，表示 `#uiMode`：編碼模式類型的位元。
UiModeTypeNormal	已淘汰. 常數為 `#uiMode`： `#UI_MODE_TYPE_MASK` 對應未指定 UI 模式資源限定符的值。
UiModeTypeTelevision	已淘汰. 對 `#uiMode`為常數：對應 `#UI_MODE_TYPE_MASK` 電視資源限定條件。
UiModeTypeUndefined	已淘汰. 常數對 `#uiMode`：表示 `#UI_MODE_TYPE_MASK` 尚未設定任何模式型別。
UiModeTypeVrHeadset	已淘汰. 對 `#uiMode`為常數：對 `#UI_MODE_TYPE_MASK` 應 vrheadset 資源限定符的值。
UiModeTypeWatch	已淘汰. 常數對`#uiMode#UI_MODE_TYPE_MASK`應於監視資源限定符的值。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
ColorMode	螢幕色彩功能的位元遮罩。
Creator
DensityDpi	被渲染的目標螢幕密度，對應於密度資源限定符。
FontScale	目前使用者偏好字型縮放因子相較於基礎密度縮放。
FontWeightAdjustment	調整文字字體粗細。
GrammaticalGender	回傳使用者對語法性別的偏好。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
HardKeyboardHidden	一個標示顯示硬鍵盤是否被隱藏。
IsNightModeActive	重新判斷設定是否處於夜間模式
IsScreenHdr	回傳螢幕是否有高動態範圍。
IsScreenRound	回傳螢幕是否為圓形。
IsScreenWideColorGamut	回傳螢幕是否具備寬色域，且此裝置支援寬色域渲染。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	此類別描述所有可能影響應用程式所取得資源的裝置配置資訊。 (繼承來源 JavaObject)
JniPeerMembers	取得用於調用此 Java 節點成員的 JNI 元資料。
Keyboard	裝置上附著的鍵盤類型。
KeyboardHidden	一個標記顯示是否有鍵盤可用。
LayoutDirection	回傳版面方向。
Locale	已淘汰. 目前使用者對區域的偏好，對應區域資源限定詞。
Locales	取得地點清單。 -或者- 設定地點清單。
Mcc	IMSI MCC（行動國家代碼），對應於 MCC 資源限定符。
Mnc	IMSI MNC（行動網路代碼），對應 mnc 資源限定符。
Navigation	裝置上可用的導航方式。
NavigationHidden	一個旗幟顯示是否有可用的五向或方向鍵盤導航。
Orientation	螢幕整體的方向。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ScreenHeightDp	可用螢幕空間的高度（以 dp 單位計）。
ScreenLayout	螢幕整體佈局的位元遮罩。
ScreenWidthDp	可用螢幕空間的寬度（以 dp 單位計算）。
SmallestScreenWidthDp	應用程式在正常運作中能看到的最小螢幕尺寸。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
Touchscreen	就是裝置上那種觸控螢幕。
UiMode	UI 模式的位元遮罩。

方法

名稱	Description
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
CompareTo(Configuration)
Construct(JniObjectReference, JniObjectReferenceOptions)	此類別描述所有可能影響應用程式所取得資源的裝置配置資訊。 (繼承來源 JavaObject)
DescribeContents()	可分區方法
Diff(Configuration)	回傳一個位元遮罩，顯示此配置物件與給定物件之間的差異。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	此類別描述所有可能影響應用程式所取得資源的裝置配置資訊。 (繼承來源 JavaObject)
Equals(Configuration)
Equals(Object)	此類別描述所有可能影響應用程式所取得資源的裝置配置資訊。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GenerateDelta(Configuration, Configuration)	產生一個介於 `base` 和 `change`之間的 delta 配置。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
IsLayoutSizeAtLeast(Int32)	檢查配置的電流 `#screenLayout` 是否至少是給定大小。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
NeedNewResources(ConfigChanges, ConfigChanges)	判斷是否需要從由返回 `#updateFrom(Configuration)`的配置變更位元集中載入新資源。
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
ReadFromParcel(Parcel)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetLayoutDirection(Locale)	從 Locale 設定版面方向。
SetLocale(Locale)	將區域列表設為只包含一個區域的清單。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	此類別描述所有可能影響應用程式所取得資源的裝置配置資訊。 (繼承來源 JavaObject)
SetTo(Configuration)	將此物件中的欄位設為給定配置下的欄位。
SetToDefaults()	將此物件設為系統預設值。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
UpdateFrom(Configuration)	將 delta 的欄位複製到這個配置物件中，並追蹤哪些欄位被更改。
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	把這個物體壓扁成一個包裹。

明確介面實作

名稱	Description
IComparable.CompareTo(Object)	將此配置與其他物件比較。
IJavaPeerable.Disposed()	此類別描述所有可能影響應用程式所取得資源的裝置配置資訊。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	此類別描述所有可能影響應用程式所取得資源的裝置配置資訊。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	此類別描述所有可能影響應用程式所取得資源的裝置配置資訊。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	此類別描述所有可能影響應用程式所取得資源的裝置配置資訊。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	此類別描述所有可能影響應用程式所取得資源的裝置配置資訊。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	此類別描述所有可能影響應用程式所取得資源的裝置配置資訊。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	此類別描述所有可能影響應用程式所取得資源的裝置配置資訊。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	此類別描述所有可能影響應用程式所取得資源的裝置配置資訊。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於