DpiAwareControl Class

Namespace:: ActiproSoftware.UI.WinForms.Controls.Primitives

Assembly:: ActiproSoftware.Shared.WinForms.dll

A Control that listens for changes in DPI of per-monitor DPI aware applications to enable DPI awareness in versions of .NET Framework where it is not natively supported.

public class DpiAwareControl : Control, IDisposable, IDpiAwareElement

Inheritance:: object MarshalByRefObject Component Control object

Derived:: StandardColorPicker NavigableSymbolSelector IntelliPromptParameterInfo IntelliPromptQuickInfo

Implements:: IDisposable IDpiAwareElement

Remarks

For internal use only.

Constructors

DpiAwareControl()

Initializes a new instance of the DpiAwareControl class.

public DpiAwareControl()

Properties

DpiScaleFactor

Gets the current DPI-based scale factor to be applied when rendering the element, where Width is applied to the x-axis, and Height is applied to the y-axis.

[Browsable(false)]
public SizeF DpiScaleFactor { get; }

Property Value

SizeF:: A SizeF where Width is applied to the x-axis, and Height is applied to the y-axis.

Methods

DpiScaleChanged(SizeF)

Called when the DPI-based scale factor of the element changes.

protected virtual void DpiScaleChanged(SizeF scaleFactor)

Parameter	Type	Description
scaleFactor	SizeF	The new scale factor where Width is applied to the x-axis, and Height is applied to the y-axis.

OnDpiChangedAfterParent(EventArgs)

Raises the DpiChangedAfterParent event.

protected override void OnDpiChangedAfterParent(EventArgs e)

Parameter	Type	Description
e	EventArgs	An DpiChangedEventArgs that contains the event data.

In This Article