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 en las que dibujar y, a continuación, compone los bits en el contenido de la aplicación.
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 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(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class SurfaceImageSource : ImageSourcePublic Class SurfaceImageSource
Inherits ImageSource- Herencia
- Derivado
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
|
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 por XAML de otro modo. Una consideración para 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 una capacidad de respuesta deficiente. Si prevé un gran número de redibujos para el contenido de Microsoft DirectX y tiene previsto mostrar ese contenido en pantalla completa sin ninguna interfaz de usuario XAML circundante, probablemente debería usar la técnica SwapChainBackgroundPanel en su lugar. Otra alternativa para el contenido que no es de pantalla completa consiste en representarse 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 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 Interoperabilidad xaml y DirectX.
Esta clase tiene API adicional, pero esas API son para la interoperación de Microsoft DirectX y no forman parte del modelo de programación de aplicaciones generales 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) |
Inicializa una nueva instancia de la clase SurfaceImageSource , especificando el tamaño del área de dibujo. |
| 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 |
Propiedades
| Dispatcher |
Obtiene el CoreDispatcher al que está asociado este objeto. CoreDispatcher representa una instalación que puede tener acceso a DependencyObject en el subproceso de interfaz de usuario incluso si un subproceso que no es de interfaz de usuario inicia el código. (Heredado de DependencyObject) |
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 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 dependencyProperty específica en esta instancia de DependencyObject . (Heredado de DependencyObject) |
| SetValue(DependencyProperty, Object) |
Establece el valor local de una propiedad de dependencia en dependencyObject. (Heredado de DependencyObject) |
| UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Cancela una notificación de cambio registrada anteriormente llamando a RegisterPropertyChangedCallback. (Heredado de DependencyObject) |