UIElement.UseLayoutRounding Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets a value that determines whether rendering for the object and its visual subtree should use rounding behavior that aligns rendering to whole pixels.
public:
property bool UseLayoutRounding { bool get(); void set(bool value); };bool UseLayoutRounding();
void UseLayoutRounding(bool value);public bool UseLayoutRounding { get; set; }var boolean = uIElement.useLayoutRounding;
uIElement.useLayoutRounding = boolean;Public Property UseLayoutRounding As Boolean<uiElement UseLayoutRounding="bool" />
Property Value
bool
true if rendering and layout should use layout rounding to whole pixels; otherwise, false. The default is true.
Remarks
Various Windows Runtime properties of type Double are used to specify layout desired values or characteristics. The most obvious are Height and Width but there are many others. The default value of true for UseLayoutRounding will cause measurement and layout operations to round potential subpixel values from these layout properties to the nearest integer value, and render objects aligned to pixel boundaries. This behavior is intended to reduce the visual artifacts that can appear when a subpixel value renders and affects pixels on either side of the subpixel boundary. The most prominent example of such an artifact is when you intend to produce a crisp, thin line of a particular color. If your measurement for the line gave a subpixel value, and the layout behavior did not round to whole pixels, then the line can potentially appear blurry as well as appearing as a dimmer color shade than you intended.
Layout rounding affects aliasing as well as positioning.
Possible scenarios for setting UseLayoutRounding to false are not documented here. If you feel that there might be benefit in enabling subpixel rendering for your app, experiment with setting UseLayoutRounding to false, examine the visual results, and make sure that possible rendering artifacts from subpixel rendering do not outweigh the perceived benefits. If you do set UseLayoutRounding to false, it's common to do so on the root of your XAML page or object tree.