DisplayManager.CreateVirtualDisplay 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
CreateVirtualDisplay(VirtualDisplayConfig)
建立虛擬顯示。
[Android.Runtime.Register("createVirtualDisplay", "(Landroid/hardware/display/VirtualDisplayConfig;)Landroid/hardware/display/VirtualDisplay;", "", ApiSince=34)]
public Android.Hardware.Display.VirtualDisplay? CreateVirtualDisplay(Android.Hardware.Display.VirtualDisplayConfig config);[<Android.Runtime.Register("createVirtualDisplay", "(Landroid/hardware/display/VirtualDisplayConfig;)Landroid/hardware/display/VirtualDisplay;", "", ApiSince=34)>]
member this.CreateVirtualDisplay : Android.Hardware.Display.VirtualDisplayConfig -> Android.Hardware.Display.VirtualDisplay參數
- config
- VirtualDisplayConfig
傳回
- 屬性
備註
建立虛擬顯示。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
CreateVirtualDisplay(VirtualDisplayConfig, Handler, VirtualDisplay+Callback)
建立虛擬顯示。
[Android.Runtime.Register("createVirtualDisplay", "(Landroid/hardware/display/VirtualDisplayConfig;Landroid/os/Handler;Landroid/hardware/display/VirtualDisplay$Callback;)Landroid/hardware/display/VirtualDisplay;", "", ApiSince=34)]
public Android.Hardware.Display.VirtualDisplay? CreateVirtualDisplay(Android.Hardware.Display.VirtualDisplayConfig config, Android.OS.Handler? handler, Android.Hardware.Display.VirtualDisplay.Callback? callback);[<Android.Runtime.Register("createVirtualDisplay", "(Landroid/hardware/display/VirtualDisplayConfig;Landroid/os/Handler;Landroid/hardware/display/VirtualDisplay$Callback;)Landroid/hardware/display/VirtualDisplay;", "", ApiSince=34)>]
member this.CreateVirtualDisplay : Android.Hardware.Display.VirtualDisplayConfig * Android.OS.Handler * Android.Hardware.Display.VirtualDisplay.Callback -> Android.Hardware.Display.VirtualDisplay參數
- config
- VirtualDisplayConfig
虛擬顯示的配置必須是非空的。
- handler
- Handler
應呼叫監聽器的處理程序，或是 null 處理程序（若應在呼叫執行緒的迴圈器中呼叫監聽器）。
- callback
- VirtualDisplay.Callback
當 VirtualDisplay 狀態改變時，回調以呼叫。 這個值可能是 Null。
傳回
新建立的虛擬顯示，或若應用程式無法建立該虛擬顯示，則為空。
- 屬性
備註
建立虛擬顯示。
虛擬顯示的內容會被渲染成應用程式提供的 Surface。
虛擬顯示應在不再需要時釋放。 由於虛擬顯示渲染到應用程式提供的表面，當程序結束時，該顯示會自動釋放，且所有剩餘視窗將被強制移除。
虛擬顯示器的行為取決於此方法所提供的旗標。 預設情況下，虛擬顯示器設計為私密、非展示且不安全。 使用特定旗標可能需要權限。
截至Build.VERSION_CODES年。KITKAT_WATCH，表面可透過 VirtualDisplay.setSurface 動態連接或分離。 過去，當呼叫 createVirtualDisplay（VirtualDisplayConfig） 時，表面必須保持非空狀態，且在顯示器的整個生命週期內無法更改。
拆除虛擬顯示器背面的表面，效果類似於關閉螢幕。
Android 參考資料。android.hardware.display.DisplayManager.createVirtualDisplay
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
CreateVirtualDisplay(String, Int32, Int32, Int32, Surface, VirtualDisplayFlags)
建立虛擬顯示。
[Android.Runtime.Register("createVirtualDisplay", "(Ljava/lang/String;IIILandroid/view/Surface;I)Landroid/hardware/display/VirtualDisplay;", "")]
public Android.Hardware.Display.VirtualDisplay? CreateVirtualDisplay(string name, int width, int height, int densityDpi, Android.Views.Surface? surface, Android.Hardware.Display.VirtualDisplayFlags flags);[<Android.Runtime.Register("createVirtualDisplay", "(Ljava/lang/String;IIILandroid/view/Surface;I)Landroid/hardware/display/VirtualDisplay;", "")>]
member this.CreateVirtualDisplay : string * int * int * int * Android.Views.Surface * Android.Hardware.Display.VirtualDisplayFlags -> Android.Hardware.Display.VirtualDisplay參數
- name
- String
- width
- Int32
值為1或以上
- height
- Int32
值為1或以上
- densityDpi
- Int32
值為1或以上
- surface
- Surface
- flags
- VirtualDisplayFlags
值為 0 或以下組合：VIRTUAL_DISPLAY_FLAG_PUBLIC;VIRTUAL_DISPLAY_FLAG_PRESENTATION;VIRTUAL_DISPLAY_FLAG_SECURE;VIRTUAL_DISPLAY_FLAG_OWN_CONTENT_ONLY;VIRTUAL_DISPLAY_FLAG_AUTO_MIRROR
傳回
- 屬性
備註
建立虛擬顯示。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
另請參閱
- <xref:Android.Hardware.Display.DisplayManager.CreateVirtualDisplay(System.String%2c+System.Int32%2c+System.Int32%2c+System.Int32%2c+System.Int32%2c+System.Int32%2c+System.Int32%2c+System.Int32)>
適用於
CreateVirtualDisplay(String, Int32, Int32, Int32, Surface, VirtualDisplayFlags, VirtualDisplay+Callback, Handler)
建立虛擬顯示。
[Android.Runtime.Register("createVirtualDisplay", "(Ljava/lang/String;IIILandroid/view/Surface;ILandroid/hardware/display/VirtualDisplay$Callback;Landroid/os/Handler;)Landroid/hardware/display/VirtualDisplay;", "")]
public Android.Hardware.Display.VirtualDisplay? CreateVirtualDisplay(string name, int width, int height, int densityDpi, Android.Views.Surface? surface, Android.Hardware.Display.VirtualDisplayFlags flags, Android.Hardware.Display.VirtualDisplay.Callback? callback, Android.OS.Handler? handler);[<Android.Runtime.Register("createVirtualDisplay", "(Ljava/lang/String;IIILandroid/view/Surface;ILandroid/hardware/display/VirtualDisplay$Callback;Landroid/os/Handler;)Landroid/hardware/display/VirtualDisplay;", "")>]
member this.CreateVirtualDisplay : string * int * int * int * Android.Views.Surface * Android.Hardware.Display.VirtualDisplayFlags * Android.Hardware.Display.VirtualDisplay.Callback * Android.OS.Handler -> Android.Hardware.Display.VirtualDisplay參數
- name
- String
虛擬顯示的名稱必須非空。
- width
- Int32
虛擬顯示器的寬度（像素）必須大於0。
- height
- Int32
虛擬顯示器的高度（像素）必須大於 0。
- densityDpi
- Int32
虛擬顯示的密度（dpi）必須大於0。
- surface
- Surface
虛擬顯示內容應被渲染的表面，若初始無內容則為空。
- flags
- VirtualDisplayFlags
虛擬顯示旗標的組合：VirtualDisplayFlagPublic、VirtualDisplayFlagPresentationVirtualDisplayFlagSecureVirtualDisplayFlagOwnContentOnly或。VirtualDisplayFlagAutoMirror
- callback
- VirtualDisplay.Callback
當狀態 VirtualDisplay 改變時回撥回撥
- handler
- Handler
應呼叫監聽器的處理程序，或是 null 處理程序（若應在呼叫執行緒的迴圈器中呼叫監聽器）。
傳回
新建立的虛擬顯示，或若應用程式無法建立該虛擬顯示，則為空。
- 屬性
例外狀況
如果呼叫者沒有權限建立帶有指定標誌的虛擬顯示。
備註
建立虛擬顯示。
虛擬顯示的內容會被渲染成應用程式提供的 Surface。
虛擬顯示應在不再需要時釋放。 由於虛擬顯示渲染到應用程式提供的表面，當程序結束時，該顯示會自動釋放，且所有剩餘視窗將被強制移除。
虛擬顯示器的行為取決於此方法所提供的旗標。 預設情況下，虛擬顯示器設計為私密、非展示且不安全。 使用特定旗標可能需要權限。
截至Build.VERSION_CODES年。KITKAT_WATCH，表面可透過 VirtualDisplay.setSurface 動態連接或分離。 過去，當呼叫 createVirtualDisplay（VirtualDisplayConfig） 時，表面必須保持非空狀態，且在顯示器的整個生命週期內無法更改。
拆除虛擬顯示器背面的表面，效果類似於關閉螢幕。
Android 參考資料。android.hardware.display.DisplayManager.createVirtualDisplay
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。