Metodo IDirectManipulationCompositor2::AddContentWithCrossProcessChaining (directmanipulation.h)

Articolo
08/23/2023

Associa il contenuto (di proprietà dell'host del componente) al compositore, assegna un dispositivo di composizione al contenuto e specifica la posizione del contenuto nell'albero di composizione rispetto ad altri oggetti visivi di composizione. Rappresenta un oggetto compositore che associa contenuto manipolato alle superfici di disegno tra più processi.

Sintassi

HRESULT AddContentWithCrossProcessChaining(
  [in] IDirectManipulationPrimaryContent *content,
  [in] IUnknown                          *device,
  [in] IUnknown                          *parentVisual,
  [in] IUnknown                          *childVisual
);

Parametri

[in] content

Contenuto da aggiungere all'albero di composizione.

il contenuto viene inserito tra parentVisual e childVisual nell'albero della composizione.

Solo il contenuto primario, creato contemporaneamente al viewport, è valido.

[in] device

Dispositivo usato per comporre il contenuto.

Si noti che il dispositivo viene creato dall'applicazione.

[in] parentVisual

Gli oggetti visivi padre nell'albero di composizione del contenuto aggiunto.

parentVisual deve essere anche un padre di childVisual nell'albero della composizione.

[in] childVisual

Gli oggetti visivi figlio nell'albero di composizione del contenuto aggiunto.

parentVisual deve essere anche un padre di childVisual nell'albero della composizione.

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo inserisce un piccolo albero visivo (di proprietà del dispositivo Direct Manipulation ) tra padreVisual e figlioVisual. Le trasformazioni possono quindi essere applicate al contenuto inserito.

Tutti i contenuti, indipendentemente dal tipo, devono essere aggiunti al compositore.

Se l'applicazione usa un IDirectManipulationCompositor fornito dal sistema:

il dispositivo deve essere un oggetto IDCompositionDevice e gli oggetti visivi padre e figlio devono essere oggetti IDCompositionVisual .
device, parentVisual e childVisual non possono essere NULL.
gli oggetti device, parentVisual e childVisual vengono creati e di proprietà dell'applicazione.
Quando il contenuto viene aggiunto all'albero di composizione usando questo metodo, i nuovi oggetti visivi di composizione vengono inseriti tra padreVisual e childVisual. I nuovi oggetti visivi non devono essere eliminati fino a quando non vengono disassociati dal compositore con RemoveContent.

Se l'applicazione usa un'implementazione personalizzata di IDirectManipulationCompositor:

device, parentVisual e childVisual devono essere un tipo valido per il compositore. Non devono essere oggetti IDCompositionDevice o IDCompositionVisual .
device, parentVisual e childVisual possono essere NULL, a seconda del compositore.