Langage

SurfaceImageSource Classe

Définition

Fournit Microsoft surfaces partagées 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

Remarques

Cette classe est une zone d’affichage pour Microsoft l’interopérabilité DirectX, dans laquelle Microsoft contenu DirectX peut dessiner dans une interface utilisateur composée par XAML. L’un des points à prendre en compte pour une SurfaceImageSource est qu’il peut incorporer le contenu direct Microsoft, le cycle de rendu est toujours centré sur XAML. Trop de Microsoft DirectX dessine 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 DirectX Microsoft 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 sur une SurfaceImageSource, y compris un exemple de code, consultez DirectX et l’interopérabilité XAML.

Cette classe a une API supplémentaire, mais ces API sont destinées à Microsoft l’interopérabilité 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 de VirtualSurfaceImageSource.

Constructeurs

Nom Description
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 toute opacité. Utilisez cette option 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

Nom Description
Dispatcher

Retourne null toujours dans une application du Kit de développement logiciel (SDK) d’application Windows. Utilisez DispatcherQueue à la place.

(Hérité de DependencyObject)
DispatcherQueue

Obtient le DispatcherQueue résultat auquel cet objet est associé. Représente DispatcherQueue une installation qui peut accéder au DependencyObject thread d’interface utilisateur même si le code est initié par un thread non-interface utilisateur.

(Hérité de DependencyObject)

Méthodes

Nom Description
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 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 à une 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 qui a été précédemment inscrite en appelant RegisterPropertyChangedCallback.

(Hérité de DependencyObject)

S’applique à

Voir aussi