VisualTreeHelper.GetYSnappingGuidelines(Visual) Method

Definition

Returns a Y-coordinate (horizontal) guideline collection.

public:
 static System::Windows::Media::DoubleCollection ^ GetYSnappingGuidelines(System::Windows::Media::Visual ^ reference);
public static System.Windows.Media.DoubleCollection GetYSnappingGuidelines (System.Windows.Media.Visual reference);
static member GetYSnappingGuidelines : System.Windows.Media.Visual -> System.Windows.Media.DoubleCollection
Public Shared Function GetYSnappingGuidelines (reference As Visual) As DoubleCollection

Parameters

reference
Visual

The Visual whose Y-coordinate guideline collection is returned.

Returns

The Y-coordinate guideline collection of the Visual.

Remarks

Pixel snapping is the process in which content layout is fixed so that object edges are rendered on device-specific pixels. The WPF graphics system uses device-independent units to enable resolution and device independence. Each device independent pixel automatically scales with the system's dots per inch (dpi) setting. This provides WPF applications proper scaling for different dpi settings and makes the application automatically dpi-aware.

However, this dpi independence can create irregular edge rendering due to anti-aliasing. These artifacts, commonly seen as blurry, or "soft" edges, can occur when the location of an edge falls in the middle of a device pixel rather than between device pixels. To address this issue, WPF provides a way for object edges in a visual tree to "snap" to device pixels through pixel snapping, eliminating the soft edges produced by anti-aliasing.

Applies to

See also