Metodo IDCompositionVisual::SetContent (dcomp.h)
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:
- Oggetto che implementa l'interfaccia IDCompositionSurface .
- Oggetto che implementa l'interfaccia IDXGISwapChain1 .
- Oggetto wrapper restituito dal metodo CreateSurfaceFromHandle o CreateSurfaceFromHwnd .
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
IDXGIFactory2::CreateSwapChain1