AdaptiveDimmingOptions Class

Definition

Namespace:

Windows.Devices.Sensors

Provides the ability to manage the dimming behavior of the PC screen based on whether a user is detected by the human presence sensor.

public ref class AdaptiveDimmingOptions sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 983040)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class AdaptiveDimmingOptions final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 983040)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class AdaptiveDimmingOptions

Public NotInheritable Class AdaptiveDimmingOptions

Inheritance

Object Platform::Object IInspectable AdaptiveDimmingOptions

Attributes

ContractVersionAttribute MarshalingBehaviorAttribute

Windows requirements

Device family	Windows 11 Insider Preview (introduced in 10.0.23504.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v15.0)

Remarks

Introduced in the May Moment update for Windows 11, Version 22H2, Build 22621.

We recommend using the AdaptiveDimming APIs instead of the AttentionAwareDimming APIs (IsAttentionAwareDimmingSupported, IsAttentionAwareDimmingEnabled), which are now obsolete.

The user can specify their preferred dimming behavior in the System settings (see Launch the Windows Settings app).

Properties

AllowWhenExternalDisplayConnected

Gets or sets whether screen dimming behavior, based on the user engagement state reported by the human presence sensor, is enabled when a user has connected an external monitor.

See also

• IsAdaptiveDimmingSupported
• IsAdaptiveDimmingEnabled