CompositionTarget Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет составную поверхность отображения для приложения. Этот класс предоставляет события отрисовки на уровне приложения.
public ref class CompositionTarget sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CompositionTarget final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CompositionTargetPublic NotInheritable Class CompositionTarget- Наследование
- Атрибуты
Требования к Windows
| Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Комментарии
События CompositionTarget полезны для сценариев отрисовки, таких как:
синхронизация отрисовки взаимодействия DirectX с помощью события Rendering
измерение времени отрисовки кадра с помощью события Rendered
повторное создание пользовательского визуального содержимого на экране в ответ на событие SurfaceContentsLost , например повторное создание содержимого взаимодействия RenderTargetBitmap или DirectX в SurfaceImageSource
Для сценариев, не связанных с пользовательской отрисовкой или измерением времени кадра, скорее всего, не потребуется CompositionTarget, и вы можете просто полагаться на систему отрисовки XAML, выполняющую всю композицию и макет.
Журнал версий
| Версия Windows | Версия пакета SDK | Добавленная стоимость |
|---|---|---|
| 1803 | 17134 | Отображение |
События
| Rendered |
Происходит сразу после того, как основной процесс отрисовки отрисовывает кадр. Это событие позволяет определить, сколько времени занимает отрисовка каждого кадра. |
| Rendering |
Происходит, когда основной процесс отрисовки отрисовывает кадр. |
| SurfaceContentsLost |
Происходит при возникновении основного изменения, например при изменении устройства DirectX. Обычно приложение должно повторно создавать содержимое своей поверхности при уведомлении об этом событии. |