SurfaceImageSource Classe

Definizione

Spazio dei nomi:: Microsoft.UI.Xaml.Media.Imaging

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Fornisce Microsoft superfici condivise DirectX da disegnare e quindi compone i bit nel contenuto dell'app.

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

Ereditarietà: Object IInspectable DependencyObject ImageSource SurfaceImageSource

Derivato: Microsoft.UI.Xaml.Media.Imaging.VirtualSurfaceImageSource

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Commenti

Questa classe è un'area di visualizzazione per Microsoft'interoperabilità DirectX in cui Microsoft contenuto DirectX può disegnare all'interno di un'interfaccia utente composta da XAML in altro modo. Una considerazione per SurfaceImageSource è che, mentre può incorporare il contenuto DirectX Microsoft, il ciclo di rendering è ancora incentrato su XAML. Troppi Microsoft disegni DirectX in questo modello di rendering possono causare una latenza o una scarsa velocità di risposta. Se prevedi un numero elevato di ridisegni per il tuo contenuto DirectX Microsoft e intendi visualizzare tale contenuto a schermo intero senza alcuna interfaccia utente XAML circostante, probabilmente dovresti usare la tecnica SwapChainBackgroundPanel. Un'altra alternativa per il contenuto non a schermo intero consiste nel eseguire il rendering in una superficie di lavoro separata su un thread di sfondo, quindi copiarne il contenuto nella superficie restituita da BeginDraw nel thread dell'interfaccia utente. Questo può sbloccare il thread dell'interfaccia utente a un costo maggiore dell'utilizzo della memoria.

Per altre info su come disegnare in SurfaceImageSource, incluso il codice di esempio, vedi Interoperabilità DirectX e XAML.

Questa classe include API aggiuntive, ma queste API sono per Microsoft l'interoperabilità DirectX e non fanno parte del modello di programmazione delle app generale descritto in questa documentazione. Ad esempio, dal lato Microsoft DirectX, è possibile chiamare BeginDraw.

Classi derivate di SurfaceImageSource

SurfaceImageSource è la classe padre per VirtualSurfaceImageSource.

Costruttori

Nome	Descrizione
SurfaceImageSource(Int32, Int32, Boolean)	Inizializza una nuova istanza della classe SurfaceImageSource , specificando le dimensioni dell'area di disegno e se l'opacità deve essere sempre completa. Usa questa opzione con `isOpaque=true` se SurfaceImageSource non deve supportare la trasparenza. Ciò può migliorare le prestazioni.
SurfaceImageSource(Int32, Int32)	Inizializza una nuova istanza della classe SurfaceImageSource , specificando le dimensioni dell'area di disegno.

Proprietà

Nome	Descrizione
Dispatcher	Restituisce `null` sempre in un'app di SDK per app di Windows. Usare invece DispatcherQueue . (Ereditato da DependencyObject)
DispatcherQueue	Ottiene l'oggetto `DispatcherQueue` a cui è associato questo oggetto. Rappresenta `DispatcherQueue` una funzionalità che può accedere al nel thread dell'interfaccia `DependencyObject` utente anche se il codice viene avviato da un thread non dell'interfaccia utente. (Ereditato da DependencyObject)

Metodi

Nome	Descrizione
ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà di dipendenza. (Ereditato da DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Restituisce qualsiasi valore di base stabilito per una proprietà di dipendenza, che si applica nei casi in cui un'animazione non è attiva. (Ereditato da DependencyObject)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza da dependencyObject. (Ereditato da DependencyObject)
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se è impostato un valore locale. (Ereditato da DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Registra una funzione di notifica per l'ascolto delle modifiche a una dipendenza specifica in questa istanza dependencyObject . (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza in un Oggetto DependencyObject. (Ereditato da DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Annulla una notifica di modifica registrata in precedenza chiamando RegisterPropertyChangedCallback. (Ereditato da DependencyObject)

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?