Condividi tramite

Metodo IDCompositionVisual::SetContent (dcomp.h)

  • Articolo

Imposta la proprietà Content di questo oggetto visivo sulla bitmap o sul wrapper di finestra specificato.

Sintassi

HRESULT SetContent(
  [in, optional] IUnknown *content
);

Parametri

[in, optional] content

Tipo: IUnknown*

Oggetto che rappresenta il nuovo contenuto di questo oggetto visivo. Questo parametro può essere NULL.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT . Per un elenco di codici di errore, vedere Codici di errore directComposition .

Commenti

Il parametro content deve puntare a uno dei seguenti:

Il nuovo contenuto sostituisce qualsiasi contenuto precedentemente associato all'oggetto visivo. Se il parametro content è NULL, l'oggetto visivo non ha contenuto associato.

Un oggetto visivo può essere associato a un oggetto bitmap o a un wrapper di finestra. Una bitmap è una catena di scambio Microsoft DirectX o una superficie Microsoft DirectComposition.

Un wrapper finestra viene creato con il metodo CreateSurfaceFromHwnd ed è uno stand-in per la rasterizzazione di un'altra finestra, che deve essere una finestra di primo livello o una finestra figlio a più livelli. Un wrapper finestra è concettualmente equivalente a una bitmap che corrisponde alle dimensioni della finestra di destinazione in cui viene disegnato il contenuto della finestra. Il contenuto include le finestre figlio della finestra di destinazione (a più livelli o in altro modo) e qualsiasi contenuto DirectComposition disegnato nelle finestre figlio.

Un wrapper di superficie DirectComposition viene creato con il metodo CreateSurfaceFromHandle ed è un riferimento a una catena di scambio. Un'applicazione può usare un wrapper di superficie in uno scenario tra processi in cui un processo crea la catena di scambio e un altro processo associa la bitmap a un oggetto visivo.

La bitmap viene sempre disegnata in corrispondenza della posizione (0,0) rispetto al sistema di coordinate dell'oggetto visivo, anche se il sistema di coordinate è direttamente interessato dalle proprietà OffsetX, OffsetY e Transform, nonché indirettamente dalle trasformazioni negli oggetti visivi predecessori. La bitmap di un oggetto visivo viene sempre disegnata dietro gli elementi figlio di tale oggetto visivo.

Requisiti

Requisito Valore
Client minimo supportato Windows 8 [solo app desktop]
Server minimo supportato Windows Server 2012 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione dcomp.h
Libreria Dcomp.lib
DLL Dcomp.dll

Vedi anche

IDCompositionVisual

IDXGIFactory2::CreateSwapChain1