Metodo IDirectManipulationCompositor::AddContent (directmanipulation.h)

Associa il contenuto (di proprietà del chiamante) 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.

Sintassi

HRESULT AddContent(
  [in]           IDirectManipulationContent *content,
  [in, optional] 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.

[in, optional] device

Dispositivo usato per comporre il contenuto.

[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. Questo può essere contenuto primario, ottenuto dal viewport chiamando GetPrimaryContent o contenuto secondario, ad esempio un indicatore di panoramica, creato chiamando CreateContent.

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.

• 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.

Requisiti

Vedi anche

IDirectManipulationCompositor