Window 類別

定義

命名空間:: Android.Views

組件:: Mono.Android.dll

重要

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

頂層視窗外觀與行為策略的抽象基底類別。

[Android.Runtime.Register("android/view/Window", DoNotGenerateAcw=true)]
public abstract class Window : Java.Lang.Object

[<Android.Runtime.Register("android/view/Window", DoNotGenerateAcw=true)>]
type Window = class
    inherit Object

繼承: Object

JavaObject

Object
Window

屬性: RegisterAttribute

備註

頂層視窗外觀與行為策略的抽象基底類別。此類別的實例應作為新增視窗管理器的頂層視圖。它提供標準的 UI 政策，例如背景、標題區、預設鍵處理等。

框架會代表應用程式實例化此類別的實作。

Java 文件 android.view.Window。

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

建構函式

名稱	Description
Window(Context)	初始化一個新的 Windows 實例。
Window(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

欄位

名稱	Description
DecorCaptionShadeAuto	已淘汰. 因為讓主題主導視窗字幕控制的顏色而被標記。
DecorCaptionShadeDark	已淘汰. 在視窗字幕上設定深色控制的旗標。
DecorCaptionShadeLight	已淘汰. 在窗戶說明上設定光色控制的旗標。
IdAndroidContent	XML 版面檔案中主版面應該有的 ID。
NavigationBarBackgroundTransitionName	當使用自訂背景時，導覽欄背景的 transitionName 表示 View 的轉換名稱。
ProgressEnd	已淘汰. （主要）進度的終值。
ProgressIndeterminateOff	已淘汰. 標記顯示關閉進度條的不確定模式。
ProgressIndeterminateOn	已淘汰. 開啟進度條不確定模式的標記。
ProgressSecondaryEnd	已淘汰. 次要進度的最高值。
ProgressSecondaryStart	已淘汰. 次要進度的最低價值。
ProgressStart	已淘汰. （主要）進度的起始值。
ProgressVisibilityOff	已淘汰. 標記為將進度條的可見性設為消失。
ProgressVisibilityOn	已淘汰. 將進度條的可見度設為可視性標記。
StatusBarBackgroundTransitionName	當使用自訂背景時，狀態列背景的 transitionName 顯示。

屬性

名稱	Description
AllowEnterTransitionOverlap	回傳在的 `#setEnterTransition(android.transition.Transition)` 轉換設定與呼叫 Activity 的退出轉換重疊。 -或- 控制在的 `#setEnterTransition(android.transition.Transition)` 轉換設定如何與呼叫活動的退出轉換重疊。
AllowReturnTransitionOverlap	回傳 if 結束後重新進入時，設定的 `#setExitTransition(android.transition.Transition)` 轉換與被叫做的活動的退出轉換重疊。 -或- 控制在重新進入後，設定的 `#setExitTransition(android.transition.Transition)` 轉換如何與被呼叫活動的退出轉換重疊。
Attributes	取得與此面板相關的目前視窗屬性;指定自訂視窗屬性。
Callback	回傳此視窗目前的回調介面;為此視窗設定回調介面，用於攔截視窗中的關鍵事件及其他動態操作。
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
ColorMode	回傳視窗的請求色彩模式，其中之一 `ActivityInfo#COLOR_MODE_DEFAULT`， `ActivityInfo#COLOR_MODE_WIDE_COLOR_GAMUT` 或 `ActivityInfo#COLOR_MODE_HDR`。 -或- 設定視窗的指定色彩模式。
Container	把這個視窗的容器還回去。 -或者- 把容器設定在這個窗戶上。
ContentScene	取回代表此視窗目前內容的。`Scene`
Context	回傳此視窗政策正在執行的上下文，用於擷取資源及其他資訊。
CurrentFocus	回傳這個視窗中目前有焦點的視圖，若沒有則為空視角。
DecorView	取得頂層的窗戶裝飾視圖（包含標準窗框/裝飾及其內的客戶內容），可以作為視窗加入視窗管理器。
DesiredHdrHeadroom	取得所需的 HDR 餘量，如 `#setDesiredHdrHeadroom(float)` -或- 設定渲染時所需的 HDR 餘量，並以 targetHdrPeakBrightnessInNits / targetSdrWhitePointInNits 的比例來設定。
EnterTransition	回傳用來將視圖移入初始場景的過渡。 -或- 設定將用於將視圖移動到初始場景的過渡。
ExitTransition	回傳用於在啟動新活動時將視圖移出場景的轉換。 -或- 設定將用於在啟動新活動時將視圖移出場景的轉換。
Features	回傳已啟用的功能位元。
ForcedWindowFlags	回傳由客戶端明確設定的視窗旗標，因此不會被 `#getDecorView`修改。
FrameRateBoostOnTouchEnabled	查看是否啟用 `#setFrameRateBoostOnTouchEnabled(boolean)` 了幀率觸控提升 - 或 - 設定此視窗是否啟用了幀率觸控提升。
FrameRatePowerSavingsBalanced	看看這個視窗是否啟用了 frameratepowersavingsbalance。 -或- 設定此視窗是否啟用 frameratepowersavingsbalance。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
HasChildren	表示此視窗是否有子視窗。
HasSoftInputMode	應用程式有指定自己的軟輸入模式嗎？
InsetsController	與此視窗相關聯的 WindowInsetsController。此值可能是零值。
IsActive	指示此視窗是否為活動視窗。
IsFloating	回傳此視窗是否以浮動樣式顯示（基於 WindowIsFloating 樣式/主題的屬性）。
IsWideColorGamut	若此視窗的色彩模式為 `ActivityInfo#COLOR_MODE_WIDE_COLOR_GAMUT`，則回傳為真，顯示器擁有寬色域，且此裝置支援寬色域渲染。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	頂層視窗外觀與行為策略的抽象基底類別。 (繼承來源 JavaObject)
JniPeerMembers	取得 .NET 用於 Android 綁定執行時的 JNI 節點元資料。
LayoutInflater	快速存取 LayoutInflater 此視窗從其上下文中取得的實例。
LocalFeatures	回傳由此視窗實作的功能位元。
MediaController	取得 `MediaController` 先前設定好的條件。 -或- 設定 a `MediaController` 傳送媒體鍵與音量變更。
NavigationBarColor	會取得這個視窗導航列所用的顏色。
NavigationBarContrastEnforced	當請求完全透明背景時，系統是否確保導航列有足夠的對比度。 -或- 設定系統是否應確保導航列在要求完全透明背景時有足夠的對比度。
NavigationBarDividerColor	取得導航條分隔符的顏色。 -或- 顯示導航列與應用程式內容之間一條細線，符合指定顏色。
OnBackInvokedDispatcher	回傳 `OnBackInvokedDispatcher` 與此視窗相關聯的實例。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ReenterTransition	回傳將用於從先前啟動的活動返回時將視圖移入場景的轉換。 -或- 設定將用於從先前啟動的活動返回時將視圖移入場景的轉換。
ReturnTransition	回傳將用於在視窗準備關閉時將視圖移出場景的轉換，例如在呼叫 `android.app.Activity#finishAfterTransition()`之後。 -或- 設定轉換，當視窗準備關閉時，例如呼叫 `android.app.Activity#finishAfterTransition()`之後，將視圖移出場景。
RootSurfaceControl	在新增內容檢視前，這個選項會為空。
SharedElementEnterTransition	回傳用於轉移到內容場景的共享元素的轉換。 -或- 設定將用於傳輸到內容場景的共享元素的轉換。
SharedElementExitTransition	在轉移到啟動活動視窗前，將轉換回傳用於共享元素。 -或- 設定在啟動新活動後，共享元素轉移至被指定的活動前，將用於共享元素的轉換。
SharedElementReenterTransition	回傳將用於從已啟動活動回歸的共享元素重新進入的轉換。 -或- 設定將用於共享元素在已回傳至起始位置後，從已啟動活動重新進入的轉換。
SharedElementReturnTransition	回傳將用於將共享元素傳回呼叫活動的轉換。 -或- 設定將用於將共享元素傳回呼叫活動的轉換。
SharedElementsUseOverlay	當共享元素在共享元素轉換時應該使用覆蓋層，或`true`在正常檢視階層中動畫時，回傳此系統`false`。 -或- 設定共享元素在共享元素轉換時是否應使用覆蓋層。
StatusBarColor	會取得這個視窗狀態欄使用的顏色。
StatusBarContrastEnforced	回傳系統是否確保狀態列在請求完全透明背景時有足夠的對比度。 -或- 設定系統是否應確保在請求完全透明背景時，狀態列有足夠的對比度。
SystemGestureExclusionRects	取得此視窗座標空間內系統不應攔截觸控或其他指示裝置手勢的區域清單。 -或- 在此視窗的座標空間中列出系統不應攔截觸控或其他指向裝置手勢的區域。
ThresholdClass	取得 .NET 用於 Android 綁定執行時的 JNI 類別處理柄。
ThresholdType	取得 .NET 用於 Android 綁定執行時所使用的受管理型別。
TransitionBackgroundFadeDuration	當以活動轉換呼叫進入或離開活動時，回傳視窗背景淡出的毫秒持續時間。 -或- 設定在以活動轉換呼叫時，切換進入或離開活動時，視窗背景淡出的持續時間（以毫秒計）。
TransitionManager	在此視窗中取得 `TransitionManager` 預設轉換的負責者。 -或- 在此視窗中設定 `TransitionManager` 預設轉場使用。
VolumeControlStream	透過這個視窗的音量鍵來取得或設定音訊串流。
WindowManager	回傳視窗管理器，讓該視窗能顯示自己的視窗。
WindowStyle	回傳 `android.R.styleable#Window` 這個視窗主題中的屬性。

方法

名稱	Description
AddContentView(View, ViewGroup+LayoutParams)	變體 `#setContentView(View, android.view.ViewGroup.LayoutParams)` 為螢幕新增額外的內容檢視。
AddFlags(WindowManagerFlags)	方便函數可依照旗標中指定的方式設定旗標位元，如 `#setFlags`。
AddOnFrameMetricsAvailableListener(Window+IOnFrameMetricsAvailableListener, Handler)	設定一個觀察者來收集在這個視窗中渲染的每一幀的幀數值。
ClearFlags(WindowManagerFlags)	方便函數以清除旗標位元，依照標誌中規定 `#setFlags`。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
CloseAllPanels()	關閉這扇窗戶所有開啟的面板。
ClosePanel(Int32)	關閉以功能 ID 識別的面板。
Construct(JniObjectReference, JniObjectReferenceOptions)	頂層視窗外觀與行為策略的抽象基底類別。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	頂層視窗外觀與行為策略的抽象基底類別。 (繼承來源 JavaObject)
Equals(Object)	頂層視窗外觀與行為策略的抽象基底類別。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
FindViewById(Int32)	找到一個由 `android:id` XML 屬性識別的檢視，該屬性在 `android.app.Activity#onCreate`中被處理。
FindViewById<T>(Int32)	找到以指定 ID 作為請求型別的檢視。
GetDefaultFeatures(Context)	回傳預設設定在視窗的功能位元。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
HasFeature(WindowFeatures)	查詢某項功能的可用性。
InjectInputEvent(InputEvent)	在本地向視窗注入事件。
InvalidatePanelMenu(WindowFeatures)	請求重新建立面板選單。
IsShortcutKey(Keycode, KeyEvent)	按鍵是這個視窗定義的快捷鍵之一嗎？
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
MakeActive()	讓這個視窗成為啟用視窗。
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
OnActive()	此視窗啟用後才呼叫。
OnConfigurationChanged(Configuration)	設定變更時應該會被呼叫。
OpenPanel(Int32, KeyEvent)	打開以功能 ID 標示的面板。
PeekDecorView()	取得目前的裝飾視圖，但前提是它已經建立;否則會回傳 null。
PerformContextMenuIdentifierAction(Int32, MenuPerformFlags)	執行由項目 ID 識別的情境選單操作。
PerformPanelIdentifierAction(Int32, Int32, MenuPerformFlags)	執行以項目 ID 識別的面板選單操作。
PerformPanelShortcut(Int32, Keycode, KeyEvent, MenuPerformFlags)	執行與關鍵事件相關的面板捷徑。
RegisterScrollCaptureCallback(IScrollCaptureCallback)	用於提供任意視窗的捲動擷取支援。
RemoveOnFrameMetricsAvailableListener(Window+IOnFrameMetricsAvailableListener)	移除觀察者，並停止聽這個視窗的幀數。
RequestFeature(WindowFeatures)	啟用擴展螢幕功能。
RequireViewById(Int32)	尋找由 XML 屬性識別 `android:id` 的視圖，該屬性在中處理 `android.app.Activity#onCreate`，或若 ID 無效或階層中無匹配視圖，則拋出 IllegalArgumentException。
RestoreHierarchyState(Bundle)	從一個組合還原此視窗的階層狀態。
SaveHierarchyState()	將此視窗的階層狀態儲存為一個組合。
SetBackgroundBlurRadius(Int32)	在窗戶範圍內模糊了窗後的紗窗。
SetBackgroundDrawable(Drawable)	將此視窗的背景改成自訂繪製視窗。
SetBackgroundDrawableResource(Int32)	將此視窗的背景改為可繪製資源。
SetChildDrawable(Int32, Drawable)	將繪製物與視窗功能關聯起來。
SetChildInt(Int32, Int32)	將整數值與視窗功能關聯。
SetClipToOutline(Boolean)	設定視窗內容是否應該裁剪到視窗背景的輪廓。
SetContentView(Int32)	方便性 `#setContentView(View, android.view.ViewGroup.LayoutParams)` 從版面資源設定螢幕內容。
SetContentView(View, ViewGroup+LayoutParams)	方便性 `#setContentView(View, android.view.ViewGroup.LayoutParams)` 從版面資源設定螢幕內容。
SetContentView(View)	方便性 `#setContentView(View, android.view.ViewGroup.LayoutParams)` 將螢幕內容設為明確檢視。
SetDecorCaptionShade(DecorCaptionShade)	設定字幕控制應該是什麼顏色。
SetDecorFitsSystemWindows(Boolean)	設定裝飾視圖是否應適用於根層級的內容視圖。`WindowInsets`
SetDefaultWindowFormat(Int32)	根據 PixelFormat 類型設定視窗的預設格式。
SetDimAmount(Single)	使用 `WindowManager.LayoutParams#FLAG_DIM_BEHIND`時設定窗戶後方的暗度量。
SetDimColor(Int64)	使用 `WindowManager.LayoutParams#FLAG_DIM_BEHIND`時，設定窗戶後方調光燈的顏色。
SetElevation(Single)	設定窗戶高度。
SetFeatureDrawable(WindowFeatures, Drawable)	為此視窗的功能設定明確的可繪製值。
SetFeatureDrawableAlpha(WindowFeatures, Int32)	為可繪製特徵設定自訂 alpha 值，控制背景透過它可見的程度。
SetFeatureDrawableResource(WindowFeatures, Int32)	從資源識別碼設定此視窗可繪製特徵的值。
SetFeatureDrawableUri(WindowFeatures, Uri)	從 URI 設定這個視窗可繪製特徵的值。
SetFeatureInt(WindowFeatures, Int32)	設定特徵的整數值。
SetFlags(WindowManagerFlags, WindowManagerFlags)	按照 `WindowManager.LayoutParams WindowManager.LayoutParams` 旗幟。
SetFormat(Format)	根據 PixelFormat 類型設定視窗格式。
SetGravity(GravityFlags)	根據重力常數設定窗戶的重力。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetHideOverlayWindows(Boolean)	防止非系統覆蓋視窗被繪製在這個視窗上方。
SetIcon(Int32)	設定這個視窗的主圖示。
SetLayout(Int32, Int32)	設定視窗的寬度與高度配置參數。
SetLocalFocus(Boolean, Boolean)	把焦點放在當地。
SetLogo(Int32)	為這個窗戶設定標誌。
SetNavigationBarColor(Color)	將導航列的顏色設定為 `color`。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	頂層視窗外觀與行為策略的抽象基底類別。 (繼承來源 JavaObject)
SetPreferMinimalPostProcessing(Boolean)	若 `isPreferred` 為真，此方法要求連接的顯示器在該視窗顯示時進行最小的後製處理。
SetResizingCaptionDrawable(Drawable)	在調整尺寸時，將繪製的可繪圖放在說明下方。
SetRestrictedCaptionAreaListener(Window+IOnRestrictedCaptionAreaChangedListener)	設定回撥，以調整標題將呈現內容的區域。
SetSoftInputMode(SoftInput)	指定一個明確的軟輸入模式用於視窗，如 `WindowManager.LayoutParams#softInputMode WindowManager.LayoutParams.softInputMode`。
SetStatusBarColor(Color)	將狀態欄的顏色設定為 `color`。
SetSustainedPerformanceMode(Boolean)	設定呼叫視窗的持續效能要求。
SetTitle(ICharSequence)	為視窗設定使用者面向的標題。
SetTitle(String)	為視窗設定使用者面向的標題。
SetTitleColor(Color)	已淘汰. 設定此視窗標題文字的顏色。
SetType(WindowManagerTypes)	依照 WindowManager 設定視窗類型。
SetUiOptions(UiOptions, UiOptions)	設定額外選項，影響這個視窗的使用者介面。
SetUiOptions(UiOptions)	設定額外選項，影響這個視窗的使用者介面。
SetWindowAnimations(Int32)	請指定視窗的自訂動畫，依照 `WindowManager.LayoutParams#windowAnimations WindowManager.LayoutParams.windowAnimations`。
SetWindowManager(IWindowManager, IBinder, String, Boolean)	建立並設定視窗管理器，供此視窗使用，例如顯示面板。
SetWindowManager(IWindowManager, IBinder, String)	建立並設定視窗管理器，供此視窗使用，例如顯示面板。
SuperDispatchGenericMotionEvent(MotionEvent)	由自訂視窗（如 Dialog）用來將一般的動態事件在視圖階層中更往下傳遞。
SuperDispatchKeyEvent(KeyEvent)	自訂視窗（如 Dialog）用於將按鍵事件傳遞到視圖階層的更下方。
SuperDispatchKeyShortcutEvent(KeyEvent)	自訂視窗（如 Dialog）用於將快捷鍵 press event 傳遞到視圖階層的更下層。
SuperDispatchTouchEvent(MotionEvent)	自訂視窗（如 Dialog）用於將觸控螢幕事件傳遞到視圖階層的更下層。
SuperDispatchTrackballEvent(MotionEvent)	自訂視窗如 Dialog 用於將軌跡球事件傳遞到視圖階層的更下層。
TakeInputQueue(InputQueue+ICallback)	取得這個視窗的 InputQueue 所有權。
TakeKeyEvents(Boolean)	請求關鍵事件與此活動同時進行。
TakeSurface(ISurfaceHolderCallback2)	擁有這扇窗戶的表面。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
TogglePanel(Int32, KeyEvent)	切換由功能 ID 識別的面板可見性。
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
UnregisterScrollCaptureCallback(IScrollCaptureCallback)	取消註冊先前 `ScrollCaptureCallback` 在此視窗註冊的
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

事件

名稱	Description
FrameMetricsAvailable	當渲染後的影格有可用的度量時，會發生這種情況。
RestrictedCaptionArea	當限制字幕區域改變時會發生。

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	頂層視窗外觀與行為策略的抽象基底類別。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	頂層視窗外觀與行為策略的抽象基底類別。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	頂層視窗外觀與行為策略的抽象基底類別。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	頂層視窗外觀與行為策略的抽象基底類別。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	頂層視窗外觀與行為策略的抽象基底類別。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	頂層視窗外觀與行為策略的抽象基底類別。 (繼承來源 JavaObject)

擴充方法

名稱	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 端是否有效。

適用於