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 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
- 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 |
| 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 |
| DispatcherQueue |
Obtient le |
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) |