IDirectManipulationCompositor2::AddContentWithCrossProcessChaining-Methode (directmanipulation.h)

Artikel
02/28/2024

Ordnet Inhalte (im Besitz des Komponentenhosts) dem Compositor zu, weist dem Inhalt ein Kompositionsgerät zu und gibt die Position des Inhalts in der Kompositionsstruktur relativ zu anderen Kompositionsvisuals an. Stellt ein Compositorobjekt dar, das bearbeitete Inhalte mit Zeichnungsflächen über mehrere Prozesse hinweg ordnet.

Syntax

HRESULT AddContentWithCrossProcessChaining(
  [in] IDirectManipulationPrimaryContent *content,
  [in] 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.

Nur primärer Inhalt, der gleichzeitig mit dem Viewport erstellt wird, ist gültig.

[in] 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.

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.

Die prozessübergreifenden Zeigerereignisse (WM_POINTERROUTEDAWAY, WM_POINTERROUTEDRELEASED und WM_POINTERROUTEDTO) sollten entsprechend behandelt werden.