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
提供虚拟显示尺寸、输出图面和其他设置的非 null 配置。
返回
创建的虚拟显示器的包装器,或者 null 创建时不生成可用显示器。
- 特性
注解
创建虚拟显示。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
适用于
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
虚拟显示器的配置必须为非 null。
- handler
- Handler
应调用侦听器的处理程序;如果应在调用线程的循环器上调用侦听器,则为 null。
- callback
- VirtualDisplay.Callback
当 VirtualDisplay 状态发生更改时调用的回调。 此值可能为 null。
返回
新创建的虚拟显示;如果应用程序无法创建虚拟显示,则为 null。
- 特性
注解
创建虚拟显示。
虚拟显示器的内容呈现为应用程序提供的Surface。
不再需要时,应释放虚拟显示。 由于虚拟显示器呈现给应用程序提供的图面,因此当进程终止并且其上的所有剩余窗口将被强行删除时,它将自动释放。
虚拟显示的行为取决于提供给此方法的标志。 默认情况下,虚拟显示器创建为专用、非演示文稿和不安全。 使用某些标志可能需要权限。
截至Build.VERSION_CODES。KITKAT_WATCH,可以使用 VirtualDisplay.setSurface 动态附加或分离图面。 以前,在调用 createVirtualDisplay(VirtualDisplayConfig)时,图面必须是非 null 的,并且无法在显示生存期内更改。
分离支持虚拟显示器的图面与关闭屏幕的效果类似。
Android 参考。android.hardware.display.DisplayManager.createVirtualDisplay
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
适用于
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
用于标识虚拟显示器的非 null 无空名称。
- width
- Int32
值为 1 或更大
- height
- Int32
值为 1 或更大
- densityDpi
- Int32
值为 1 或更大
- surface
- Surface
接收显示呈现内容的图面,或 null 创建没有初始图面的显示器。
- flags
- VirtualDisplayFlags
值为 0 或以下组合: Public; Presentation; ; SecureOwnContentOnlyAutoMirror
返回
创建的虚拟显示器的包装器,或者 null 创建时不生成可用显示器。
- 特性
注解
创建虚拟显示。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
另请参阅
- <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
应呈现虚拟显示器内容的图面;如果最初没有,则为 null。
- flags
- VirtualDisplayFlags
虚拟显示标志的组合:VirtualDisplayFlagPublic、、VirtualDisplayFlagPresentationVirtualDisplayFlagSecure、VirtualDisplayFlagOwnContentOnly或VirtualDisplayFlagAutoMirror。
- callback
- VirtualDisplay.Callback
更改状态时调用的 VirtualDisplay 回调
- handler
- Handler
应调用侦听器的处理程序;如果应在调用线程的循环器上调用侦听器,则为 null。
返回
新创建的虚拟显示;如果应用程序无法创建虚拟显示,则为 null。
- 特性
例外
如果调用方无权使用指定的标志创建虚拟显示,则为 。
注解
创建虚拟显示。
虚拟显示器的内容呈现为应用程序提供的Surface。
不再需要时,应释放虚拟显示。 由于虚拟显示器呈现给应用程序提供的图面,因此当进程终止并且其上的所有剩余窗口将被强行删除时,它将自动释放。
虚拟显示的行为取决于提供给此方法的标志。 默认情况下,虚拟显示器创建为专用、非演示文稿和不安全。 使用某些标志可能需要权限。
截至Build.VERSION_CODES。KITKAT_WATCH,可以使用 VirtualDisplay.setSurface 动态附加或分离图面。 以前,在调用 createVirtualDisplay(VirtualDisplayConfig)时,图面必须是非 null 的,并且无法在显示生存期内更改。
分离支持虚拟显示器的图面与关闭屏幕的效果类似。
Android 参考。android.hardware.display.DisplayManager.createVirtualDisplay
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。