SurfaceImageSource Classe

Référence

Définition

Espace de noms:: Windows.UI.Xaml.Media.Imaging

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.

Modifier

Fournit des surfaces partagées Microsoft DirectX dans laquelle dessiner, puis compose les bits dans le contenu de l’application.

/// [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 : ImageSource

Public Class SurfaceImageSource
Inherits ImageSource

Héritage: Object IInspectable DependencyObject ImageSource SurfaceImageSource

Dérivé: Windows.UI.Xaml.Media.Imaging.VirtualSurfaceImageSource

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

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 autrement en XAML. L’un des points à prendre en compte 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 de dessins Microsoft DirectX dans ce modèle de rendu peut entraîner une latence ou une réactivité médiocre. Si vous prévoyez un grand nombre de redessinations pour votre contenu Microsoft DirectX et que vous envisagez 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 le rendu sur une surface de travail distincte sur un thread d’arrière-plan, puis à copier son contenu sur la surface retourné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 dans une SurfaceImageSource, y compris un exemple de code, consultez Interopérabilité DirectX et XAML.

Cette classe a une API supplémentaire, 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é 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é complète. Utilisez cette option avec `isOpaque=true` si SurfaceImageSource ne doit pas prendre en charge la transparence; cela peut augmenter les performances.

Propriétés

Dispatcher

Obtient le CoreDispatcher auquel cet objet est associé. CoreDispatcher représente une fonctionnalité qui peut accéder à DependencyObject sur le thread d’interface utilisateur, même si le code est initié par un thread autre que l’interface utilisateur.

(Hérité de DependencyObject)

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’appliquerait 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 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)

S’applique à