Share via

IDCompositionVisual::SetContent-Methode (dcomp.h)

  • Artikel

Legt die Content-Eigenschaft dieses Visuals auf die angegebene Bitmap oder den angegebenen Fensterwrapper fest.

Syntax

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

Parameter

[in, optional] content

Typ: IUnknown*

Das Objekt, das der neue Inhalt dieses Visuals ist. Dieser Parameter kann NULL sein.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter DirectComposition-Fehlercodes .

Hinweise

Der content-Parameter muss auf eine der folgenden Punkte verweisen:

Der neue Inhalt ersetzt alle Inhalte, die zuvor dem Visual zugeordnet waren. Wenn der content-Parameter NULL ist, verfügt das Visual über keinen zugeordneten Inhalt.

Ein Visual kann einem Bitmapobjekt oder einem Fensterwrapper zugeordnet werden. Eine Bitmap ist entweder eine Microsoft DirectX-Swapchain oder eine Microsoft DirectComposition-Oberfläche.

Ein Fensterwrapper wird mit der CreateSurfaceFromHwnd-Methode erstellt und ist ein Stand-In für die Rasterung eines anderen Fensters, bei dem es sich um ein Fenster der obersten Ebene oder ein mehrstufiges untergeordnetes Fenster handelt. Ein Fensterwrapper entspricht vom Konzept her einer Bitmap, die der Größe des Zielfensters entspricht, auf dem der Inhalt des Fensters gezeichnet wird. Der Inhalt umfasst die untergeordneten Fenster des Zielfensters (mehrstufige oder andere) und alle DirectComposition-Inhalte, die in den untergeordneten Fenstern gezeichnet werden.

Ein DirectComposition Surface Wrapper wird mit der CreateSurfaceFromHandle-Methode erstellt und ist ein Verweis auf eine Swapchain. Eine Anwendung kann einen Oberflächenwrapper in einem prozessübergreifenden Szenario verwenden, in dem ein Prozess die Swapchain erstellt und ein anderer Prozess die Bitmap einem Visual zuordnet.

Die Bitmap wird immer an der Position (0,0) relativ zum Koordinatensystem des Visuals gezeichnet, obwohl das Koordinatensystem direkt von den Eigenschaften OffsetX, OffsetY und Transform sowie indirekt von den Transformationen in Vorgängervisuals beeinflusst wird. Die Bitmap eines Visuals wird immer hinter den untergeordneten Elementen dieses Visuals gezeichnet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile dcomp.h
Bibliothek Dcomp.lib
DLL Dcomp.dll

Weitere Informationen

IDCompositionVisual

IDXGIFactory2::CreateSwapChain1