Метод IDirectManipulationCompositor2::AddContentWithCrossProcessChaining (directmanipulation.h)

Статья
03/05/2024

Связывает содержимое (принадлежащее ведущему компоненту) с композитатором, назначает устройству композиции содержимое и задает положение содержимого в дереве композиции относительно других визуальных элементов композиции. Представляет объект композитатора, который связывает манипулизированный контент с поверхностями рисования в нескольких процессах.

Синтаксис

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

Параметры

[in] content

Содержимое, добавляемое в дерево композиции.

содержимое помещается между parentVisual и childVisual в дереве композиции.

Допустимо только основное содержимое, созданное одновременно с окном просмотра.

[in] device

Устройство, используемое для создания содержимого.

Обратите внимание, что устройство создается приложением.

[in] parentVisual

Родительские визуальные элементы в дереве композиции добавляемого содержимого.

parentVisual также должен быть родительским элементом childVisual в дереве композиции.

[in] childVisual

Дочерние визуальные элементы в дереве композиции добавляемого содержимого.

parentVisual также должен быть родительским элементом childVisual в дереве композиции.

Возвращаемое значение

Если метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Этот метод вставляет небольшое визуальное дерево (принадлежающее устройству Direct Manipulation ) между parentVisual и childVisual. Затем преобразования можно применить к вставленным содержимым.

Все содержимое, независимо от типа, должно быть добавлено в составитель.

Если приложение использует предоставленный системой IDirectManipulationCompositor:

Device должен быть объектом IDCompositionDevice , а родительский и дочерний визуальные элементы должны быть объектами IDCompositionVisual .
device, parentVisual и childVisual не могут иметь значение NULL.
объекты device, parentVisual и childVisual создаются и принадлежат приложению.
При добавлении содержимого в дерево композиции с помощью этого метода новые визуальные элементы композиции вставляются между parentVisual и childVisual. Новые визуальные элементы не должны быть уничтожены, пока они не будут отсоединены от композитора с RemoveContent.

Если приложение использует пользовательскую реализацию IDirectManipulationCompositor:

device, parentVisual и childVisual должны быть допустимым типом для композитора. Они не должны быть объектами IDCompositionDevice или IDCompositionVisual .
Device, parentVisual и childVisual могут иметь значение NULL в зависимости от композитора.

События указателя между процессами (WM_POINTERROUTEDAWAY, WM_POINTERROUTEDRELEASED и WM_POINTERROUTEDTO) должны обрабатываться соответствующим образом.