DistantLight Класс

Определение

Пространство имен:

Windows.UI.Composition

Бесконечно большой удаленный источник света, излучающий свет в одном направлении. Например, для представления солнечного света можно использовать далекий свет.

public ref class DistantLight sealed : CompositionLight

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DistantLight final : CompositionLight

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DistantLight : CompositionLight

Public NotInheritable Class DistantLight
Inherits CompositionLight

Наследование

Object Platform::Object IInspectable CompositionObject CompositionLight DistantLight

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v3.0)

Примеры

_distantLight = _compositor.CreateDistantLight(); 
_distantLight.Color = Colors.Yellow; 
_distantLight.Direction = new Vector3(0,-1, 0); 
_distantLight.CoordinateSpace = root; 
_distantLight.Targets.Add(root);          

Комментарии

Направление поддержки DistantLightи SpotLight.

DistantLight является одним из четырех типов света, производных от CompositionLight.

Светлая	Описание
AmbientLight	Источник света, излучающий ненаправленный свет, который, как представляется, отражается всем в сцене.
DistantLight	Бесконечно большой удаленный источник света, излучающий свет в одном направлении.
PointLight	Точечный источник света, излучающий свет во всех направлениях.
Прожектор	Источник света, излучающий внутренние и внешние конусы света.

Примечание

Визуальный элемент не может быть нацелен более чем на два внешних света (PointLight, SpotLight или DistantLight).

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1709	16299	Интенсивность

Свойства

Color	Цвет излучаемого объекта DistantLight.
Comment	Строка, связанная с CompositionObject. (Унаследовано от CompositionObject)
Compositor	Составитель, используемый для создания этого объекта CompositionObject. (Унаследовано от CompositionObject)
CoordinateSpace	Визуальный элемент, используемый для определения направления света. Свойство направления света относительно координатного пространства этого визуального элемента. **CoordinateSpace** является обязательным свойством. Если значение CoordinateSpace не задано, функция DistantLight не будет отображаться.
Direction	Направление, в котором указывает свет, указанное относительно его визуального элемента CoordinateSpace .
Dispatcher	Диспетчер для CompositionObject. (Унаследовано от CompositionObject)
DispatcherQueue	Возвращает dispatcherQueue для объекта CompostionObject. (Унаследовано от CompositionObject)
ExclusionsFromTargets	Возвращает коллекцию визуальных элементов, не предназначенных для света. (Унаследовано от CompositionLight)
ImplicitAnimations	Коллекция неявных анимаций, присоединенных к этому объекту. (Унаследовано от CompositionObject)
Intensity	Возвращает или задает интенсивность света.
IsEnabled	Возвращает или задает значение, определяющее, включен ли индикатор композиции. (Унаследовано от CompositionLight)
Properties	Коллекция свойств, связанных с CompositionObject. (Унаследовано от CompositionObject)
Targets	Коллекция визуальных элементов, предназначенных для света. (Унаследовано от CompositionLight)

Методы

Close()	Закрывает объект CompositionObject и освобождает системные ресурсы. (Унаследовано от CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Соединения и анимация. (Унаследовано от CompositionObject)
DisconnectAnimation(String)	Отключает анимацию. (Унаследовано от CompositionObject)
Dispose()	Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от CompositionObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Определяет свойство, которое можно анимировать. (Унаследовано от CompositionObject)
StartAnimation(String, CompositionAnimation)	Подключает анимацию к указанному свойству объекта и запускает анимацию. (Унаследовано от CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Подключает анимацию к указанному свойству объекта и запускает анимацию. (Унаследовано от CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Запускает группу анимации. Метод StartAnimationGroup в CompositionObject позволяет запустить CompositionAnimationGroup. Все анимации в группе будут запущены одновременно для объекта . (Унаследовано от CompositionObject)
StopAnimation(String)	Отключает анимацию от указанного свойства и останавливает анимацию. (Унаследовано от CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Останавливает группу анимации. (Унаследовано от CompositionObject)
TryGetAnimationController(String)	Возвращает AnimationController для анимации, выполняемой с указанным свойством. (Унаследовано от CompositionObject)

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

• CompositionLight
• Targets
• CreateDistantLight()