IDirectManipulationCompositor::AddContent-Methode (directmanipulation.h)

Artikel
08/23/2023

Ordnet inhalte (im Besitz des Aufrufers) dem Compositor zu, weist dem Inhalt ein Kompositionsgerät zu und gibt die Position des Inhalts in der Kompositionsstruktur relativ zu anderen Kompositionsvisuals an.

Syntax

HRESULT AddContent(
  [in]           IDirectManipulationContent *content,
  [in, optional] IUnknown                   *device,
  [in]           IUnknown                   *parentVisual,
  [in]           IUnknown                   *childVisual
);

Parameter

[in] content

Der Inhalt, der der Kompositionsstruktur hinzugefügt werden soll.

Inhalt wird zwischen parentVisual und childVisual in der Kompositionsstruktur platziert.

[in, optional] device

Das Gerät, das zum Verfassen des Inhalts verwendet wird.

Beachten Sie, dass das Gerät von der Anwendung erstellt wird.

[in] parentVisual

Die übergeordneten Visuals in der Kompositionsstruktur des hinzugefügten Inhalts.

parentVisual muss auch ein übergeordnetes Element von childVisual in der Kompositionsstruktur sein.

[in] childVisual

Die untergeordneten Visuals in der Kompositionsstruktur des hinzugefügten Inhalts.

parentVisual muss auch ein übergeordnetes Element von childVisual in der Kompositionsstruktur sein.

Rückgabewert

Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode fügt eine kleine visuelle Struktur (im Besitz des Direct Manipulation-Geräts ) zwischen parentVisual und childVisual ein. Transformationen können dann auf den eingefügten Inhalt angewendet werden.

Alle Inhalte, unabhängig vom Typ, müssen dem Compositor hinzugefügt werden. Dies kann primärer Inhalt sein, der aus dem Viewport durch Aufrufen von GetPrimaryContent abgerufen wird, oder sekundärer Inhalt, z. B. ein Verschiebungsindikator, der durch Aufrufen von CreateContent erstellt wird.

Wenn die Anwendung einen vom System bereitgestellten IDirectManipulationCompositor verwendet:

device muss ein IDCompositionDevice-Objekt sein, und übergeordnete und untergeordnete Visuals müssen IDCompositionVisual-Objekte sein.
device, parentVisual und childVisual darf nicht NULL sein.
device, parentVisual und childVisual-Objekte werden erstellt und gehören der Anwendung.
Wenn inhalte mit dieser Methode der Kompositionsstruktur hinzugefügt werden, werden die neuen Kompositionsvisuals zwischen parentVisual und childVisual eingefügt. Die neuen Visuals sollten erst zerstört werden, wenn sie dem Compositor mit RemoveContent zugeordnet werden.

Wenn die Anwendung eine benutzerdefinierte Implementierung von IDirectManipulationCompositor verwendet:

device, parentVisual und childVisual müssen ein gültiger Typ für den Compositor sein. Sie müssen keine IDCompositionDevice - oder IDCompositionVisual-Objekte sein.
device, parentVisual und childVisual können je nach Compositor NULL sein.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	directmanipulation.h

Weitere Informationen

IDirectManipulationCompositor

Freigeben über