DebugSettings.LayoutCycleDebugBreakLevel Property

Definition

Namespace:

Microsoft.UI.Xaml

Gets or sets a value that indicates the level of layout cycle tracing events that trigger a debugger breakpoint.

public:
 property LayoutCycleDebugBreakLevel LayoutCycleDebugBreakLevel { LayoutCycleDebugBreakLevel get(); void set(LayoutCycleDebugBreakLevel value); };

LayoutCycleDebugBreakLevel LayoutCycleDebugBreakLevel();

void LayoutCycleDebugBreakLevel(LayoutCycleDebugBreakLevel value);

public LayoutCycleDebugBreakLevel LayoutCycleDebugBreakLevel { get; set; }

var layoutCycleDebugBreakLevel = debugSettings.layoutCycleDebugBreakLevel;
debugSettings.layoutCycleDebugBreakLevel = layoutCycleDebugBreakLevel;

Public Property LayoutCycleDebugBreakLevel As LayoutCycleDebugBreakLevel

Property Value

LayoutCycleDebugBreakLevel

A value of the enumeration that indicates the level of layout cycle tracing events that trigger a debugger breakpoint. The default is None.

Examples

public App() { this.InitializeComponent();

#if DEBUG DebugSettings.LayoutCycleTracingLevel = LayoutCycleTracingLevel.High; DebugSettings.LayoutCycleDebugBreakLevel = LayoutCycleDebugBreakLevel.Low; #endif }

Remarks

This debug break level corresponds to the DebugSettings.LayoutCycleTracingLevel. The tracing and break levels can be set independently to enable the common scenario of wanting a higher tracing level than debug break level.

When a layout cycle crash appears imminent, this debug break level is used to determine when a native debugger breakpoint will be triggered for layout-related operations.

A debugger breakpoint will only be triggered if a native debugger is attached to the process to avoid crashing the process when not run under a debugger or when only attached with a managed debugger.

See also

• LayoutCycleTracingLevel