VisualTreeHelper.GetXSnappingGuidelines(Visual) Method

Reference

Definition

Namespace:: System.Windows.Media

Assembly:: PresentationCore.dll

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.

Returns an X-coordinate (vertical) guideline collection.

public:
 static System::Windows::Media::DoubleCollection ^ GetXSnappingGuidelines(System::Windows::Media::Visual ^ reference);

public static System.Windows.Media.DoubleCollection GetXSnappingGuidelines (System.Windows.Media.Visual reference);

static member GetXSnappingGuidelines : System.Windows.Media.Visual -> System.Windows.Media.DoubleCollection

Public Shared Function GetXSnappingGuidelines (reference As Visual) As DoubleCollection

Parameters

reference: Visual

The Visual whose X-coordinate guideline collection is returned.

Returns

DoubleCollection

The X-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

Sdílet prostřednictvím