Поделиться через

Метод IDirectManipulationCompositor::AddContent (directmanipulation.h)

  • Статья

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

Синтаксис

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

Параметры

[in] content

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

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

[in, optional] device

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

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

[in] parentVisual

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

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

[in] childVisual

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

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

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

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

Комментарии

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

Все содержимое, независимо от типа, должно быть добавлено в составитель. Это может быть основное содержимое, полученное из окна просмотра путем вызова Метода GetPrimaryContent, или дополнительное содержимое, например индикатор сдвига, созданное путем вызова Метода CreateContent.

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

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

Требования

   
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header directmanipulation.h

См. также раздел

IDirectManipulationCompositor