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


BrightnessOverride Класс

Определение

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
Атрибуты

Требования к 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 .

Применяется к