SurfaceImageSource Classe

  • Référence

Définition

Espace de noms:
Microsoft.UI.Xaml.Media.Imaging
Modifier

Fournit des surfaces partagées Microsoft DirectX à dessiner, puis compose 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
Object IInspectable DependencyObject ImageSource SurfaceImageSource
Dérivé
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Remarques

Cette classe est une zone d’affichage pour l’interopérabilité Microsoft DirectX, dans laquelle le contenu Microsoft DirectX peut dessiner dans une interface utilisateur composée par XAML. L’un des points à prendre en compte pour une SurfaceImageSource est que même s’il peut 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 redessins 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 un rendu sur une surface de travail distincte sur un thread d’arrière-plan, puis à copier son contenu dans l’aire retournée par BeginDraw sur le thread d’interface utilisateur. Cela peut débloquer le thread d’interface utilisateur au coût 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 l’exemple de code, consultez DirectX et XAML interop.

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 SurfaceImageSource

SurfaceImageSource est la classe parente pour VirtualSurfaceImageSource.

Constructeurs

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 d’opacité totale. Utilisez-le avec isOpaque=true si SurfaceImageSource ne doit pas prendre en charge la transparence ; cela peut augmenter les performances.
SurfaceImageSource(Int32, Int32)

Initialise une nouvelle instance de la classe SurfaceImageSource, en spécifiant la taille de la zone de dessin.

Propriétés

Dispatcher

Retourne toujours null dans une application sdk d’application Windows. Utilisez DispatcherQueue à la place.

(Hérité de DependencyObject)
DispatcherQueue

Obtient le DispatcherQueue auquel cet objet est associé. L'DispatcherQueue représente une installation qui peut accéder à l'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’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’une 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 cette 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 à

Voir aussi