BrightnessOverride Класс

Определение

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

Windows.Graphics.Display

BrightnessOverride позволяет приложению переопределить уровень яркости экрана, заданный для устройства. С помощью этого API можно использовать элементы управления яркостью для каждого приложения на устройствах, поддерживающих контролируемую яркость.

Вы можете использовать BrightnessOverride для переопределения параметров уровня яркости пользователя временно или постоянно.

Примечание

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

public ref class BrightnessOverride sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class BrightnessOverride final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class BrightnessOverride

Public NotInheritable Class BrightnessOverride

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

Object Platform::Object IInspectable BrightnessOverride

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

Семейство устройств	Windows 10 Creators Update (появилось в 10.0.15063.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v4.0)

Свойства

BrightnessLevel	Возвращает уровень яркости экрана для этого экземпляра BrightnessOverride (если вы ранее вызывали SetBrightnessLevel , чтобы задать уровень яркости). Примечание При первом получении инициализированного объекта BrightnessOverride из GetDefaultForSystem или GetForCurrentView значение свойства BrightnessLevel этого объекта не определено (например, значение не представляет текущий системный уровень яркости). Сначала необходимо вызвать SetBrightnessLevel , чтобы задать уровень яркости.
IsOverrideActive	Значение BOOLEAN, указывающее, активно ли переопределение яркости. Если задано значение TRUE, текущий уровень яркости соответствует уровню переопределения яркости. Если метод StartOverride() не вызывается, это свойство всегда будет иметь значение FALSE.
IsSupported	Указывает, имеет ли устройство хотя бы один управляемый дисплей яркости. Если задано значение TRUE, устройство имеет по крайней мере один управляемый дисплей яркости, поддерживающий переопределение яркости.

Методы

GetDefaultForSystem()	Возвращает объект переопределения яркости. Для этого метода не требуется CoreWindow , чтобы его можно было использовать приложениями, работающими в фоновом режиме.
GetForCurrentView()	Возвращает объект BrightnessOverride . Для этого метода требуется CoreWindow, поэтому его можно использовать только для приложений, которые в данный момент выполняются в окне. Возвращаемый объект переопределения яркости может отличаться от нескольких вызовов BrightnessOverride.GetForCurrentView в одном потоке. Необходимо вызвать BrightnessOverride.GetForCurrentView из потока пользовательского интерфейса main.
GetLevelForScenario(DisplayBrightnessScenario)	Возвращает уровень яркости, связанный с указанным сценарием.
SaveForSystemAsync(BrightnessOverride)	Сохраняет указанные параметры переопределения яркости, фиксируя эти значения в пользовательских параметрах. Используйте этот метод для сохранения параметров переопределения после остановки переопределения. Если null параметр передается для значения, система включает автоматическую яркость.
SetBrightnessLevel(Double, DisplayBrightnessOverrideOptions)	Задает уровень яркости и параметры переопределения. Когда приложение будет готово к изменению текущей яркости на то, что вы хотите переопределить, вызовите StartOverride.
SetBrightnessScenario(DisplayBrightnessScenario, DisplayBrightnessOverrideOptions)	Задает уровень яркости путем указания сценария с известным уровнем яркости и параметров переопределения яркости.
StartOverride()	Запрос на начало переопределения уровня яркости экрана. Запрос на начало переопределения не означает, что уровень яркости экрана всегда изменяется в соответствии с указанным уровнем яркости переопределения. Система по-прежнему решает, следует ли учитывать этот запрос переопределения. Используйте свойства IsOverrideActive и IsOverrideActiveChanged , чтобы определить, выполнила ли система запрос переопределения.
StopOverride()	Перестает переопределять уровень яркости.

События

BrightnessLevelChanged	Происходит при изменении уровня яркости экрана.
IsOverrideActiveChanged	Происходит, когда уровень яркости экрана либо начинает совпадать, либо останавливается в соответствии с уровнем переопределения яркости. Это событие возникает при изменении состояния свойства IsOverrideActive .
IsSupportedChanged	Происходит при обнаружении или удалении дисплея, управляемого яркостью. Это событие возникает при изменении свойства IsSupported .