SurfaceImageSource Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des surfaces partagées Microsoft DirectX pour dessiner et composer les bits dans le contenu de l’application.
/// [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
- Héritage
- Dérivé
- Attributs
Remarques
Cette classe est une zone d’affichage pour l’interopérabilité De Microsoft DirectX, où le contenu Microsoft DirectX peut dessiner dans une interface utilisateur composée par ailleurs de XAML. Une considération pour une SurfaceImageSource est que, bien qu’elle puisse incorporer le contenu Microsoft DirectX, le cycle de rendu est toujours centré sur XAML. Un trop grand nombre d’utilisations de Microsoft DirectX dans ce modèle de rendu peut entraîner une latence ou une faible réactivité. Si vous prévoyez un grand nombre de redessinations pour votre contenu Microsoft DirectX et que vous avez l’intention d’afficher ce contenu en plein écran sans aucune interface utilisateur XAML environnante, vous devez probablement utiliser la technique SwapChainBackgroundPanel à la place. Une autre alternative pour le contenu non plein écran consiste à effectuer un rendu sur une surface de travail distincte sur un thread d’arrière-plan, puis à copier son contenu sur la surface renvoyée par BeginDraw sur le thread d’interface utilisateur. Cela peut débloquer le thread d’interface utilisateur au prix d’une utilisation plus élevée de la mémoire.
Pour plus d’informations sur la façon de dessiner vers une SurfaceImageSource, y compris un exemple de code, consultez DirectX et l’interopérabilité XAML.
Cette classe a des API supplémentaires, mais ces API sont destinées à l’interopérabilité Microsoft DirectX et ne font pas partie du modèle de programmation d’application général décrit dans cette documentation. Par exemple, du côté de Microsoft DirectX, vous pouvez appeler BeginDraw.
Classes dérivées de SurfaceImageSource
SurfaceImageSource est la classe parente de VirtualSurfaceImageSource.
Constructeurs
SurfaceImageSource(Int32, Int32) |
Initialise une nouvelle instance de la classe SurfaceImageSource, en spécifiant la taille de la zone de dessin. |
SurfaceImageSource(Int32, Int32, Boolean) |
Initialise une nouvelle instance de la classe SurfaceImageSource, en spécifiant la taille de la zone de dessin et si l’opacité est censée être toujours une opacité totale. Utilisez cette option avec |
Propriétés
Dispatcher |
Retourne |
DispatcherQueue |
Obtient le |
Méthodes
ClearValue(DependencyProperty) |
Efface la valeur locale d’une propriété de dépendance. (Hérité de DependencyObject) |
GetAnimationBaseValue(DependencyProperty) |
Retourne toute valeur de base établie pour une propriété de dépendance, qui s’applique dans les cas où une animation n’est pas active. (Hérité de DependencyObject) |
GetValue(DependencyProperty) |
Retourne la valeur effective actuelle d’une propriété de dépendance à partir d’un objet DependencyObject. (Hérité de DependencyObject) |
ReadLocalValue(DependencyProperty) |
Retourne la valeur locale d’une propriété de dépendance, si une valeur locale est définie. (Hérité de DependencyObject) |
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback) |
Inscrit une fonction de notification pour écouter les modifications apportées à un DependencyProperty spécifique sur ce instance DependencyObject. (Hérité de DependencyObject) |
SetValue(DependencyProperty, Object) |
Définit la valeur locale d’une propriété de dépendance sur un DependencyObject. (Hérité de DependencyObject) |
UnregisterPropertyChangedCallback(DependencyProperty, Int64) |
Annule une notification de modification précédemment inscrite en appelant RegisterPropertyChangedCallback. (Hérité de DependencyObject) |