SurfaceImageSource Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona superficies compartidas de Microsoft DirectX para dibujar y, a continuación, compone los bits en el contenido de la aplicación.
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class SurfaceImageSource : ImageSource
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class SurfaceImageSource : ImageSource
Public Class SurfaceImageSource
Inherits ImageSource
- Herencia
- Derivado
- Atributos
Comentarios
Esta clase es un área de visualización para la interoperación de Microsoft DirectX en la que el contenido de Microsoft DirectX puede dibujar dentro de una interfaz de usuario compuesta de XAML de otro modo. Una consideración de SurfaceImageSource es que, aunque puede incorporar el contenido de Microsoft DirectX, el ciclo de representación sigue centrado en XAML. Demasiados dibujo de Microsoft DirectX en este modelo de representación pueden dar lugar a una latencia o a una capacidad de respuesta deficiente. Si prevés un gran número de redibujos para tu contenido de Microsoft DirectX, y piensas mostrar ese contenido en pantalla completa sin ninguna interfaz de usuario XAML circundante, probablemente deberías usar la técnica SwapChainBackgroundPanel en su lugar. Otra alternativa para el contenido que no es de pantalla completa es representar en una superficie temporal independiente en un subproceso de fondo y, a continuación, copiar su contenido en la superficie devuelta desde BeginDraw en el subproceso de la interfaz de usuario. Esto puede desbloquear el subproceso de la interfaz de usuario a costa de un mayor uso de memoria.
Para obtener más información sobre cómo dibujar en surfaceImageSource, incluido el código de ejemplo, consulta DirectX y la interoperabilidad XAML.
Esta clase tiene una API adicional, pero esas API son para la interoperación de Microsoft DirectX y no forman parte del modelo de programación de aplicaciones general que se describe en esta documentación. Por ejemplo, desde el lado de Microsoft DirectX, puede llamar a BeginDraw.
clases derivadas de SurfaceImageSource
SurfaceImageSource es la clase primaria de VirtualSurfaceImageSource.
Constructores
SurfaceImageSource(Int32, Int32, Boolean) |
Inicializa una nueva instancia de la clase SurfaceImageSource, especificando el tamaño del área de dibujo y si se espera que la opacidad sea siempre completa. Úselo con |
SurfaceImageSource(Int32, Int32) |
Inicializa una nueva instancia de la clase SurfaceImageSource, especificando el tamaño del área de dibujo. |
Propiedades
Dispatcher |
Siempre devuelve |
DispatcherQueue |
Obtiene el |
Métodos
ClearValue(DependencyProperty) |
Borra el valor local de una propiedad de dependencia. (Heredado de DependencyObject) |
GetAnimationBaseValue(DependencyProperty) |
Devuelve cualquier valor base establecido para una propiedad de dependencia, que se aplicaría en los casos en los que una animación no está activa. (Heredado de DependencyObject) |
GetValue(DependencyProperty) |
Devuelve el valor efectivo actual de una propiedad de dependencia de un DependencyObject. (Heredado de DependencyObject) |
ReadLocalValue(DependencyProperty) |
Devuelve el valor local de una propiedad de dependencia, si se establece un valor local. (Heredado de DependencyObject) |
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Registra una función de notificación para escuchar los cambios en una |
SetValue(DependencyProperty, Object) |
Establece el valor local de una propiedad de dependencia en un DependencyObject. (Heredado de DependencyObject) |
UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Cancela una notificación de cambio registrada anteriormente llamando a RegisterPropertyChangedCallback. (Heredado de DependencyObject) |
Se aplica a
Consulte también
- VirtualSurfaceImageSource
- SwapChainBackgroundPanel
- de interoperabilidad xaml y DirectX
- de ejemplo de SurfaceImageSource de