Share via


AdaptiveDimmingOptions Class

Definition

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

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.

Applies to

See also