ApplicationSettings.SnapStrengthPointsX property (Visio)

Specifies the distance in pixels along the x-axis that points pull when snapping is enabled. Read/write.

Syntax

expression.SnapStrengthPointsX

expression A variable that represents an ApplicationSettings object.

Return value

Long

Remarks

Setting the SnapStrengthPointsX property is equivalent to setting the Points option under Snap strength on the Advanced tab in the Snap & Glue dialog box (click the Visual Aids arrow on the View tab). Setting snap strength in the UI sets both x and y values to the same value.

The minimum allowable value for the SnapStrengthPointsX property is 0 (zero), and the maximum is 999. Attempting to set a value outside that range returns an error. The default value is 10.

Example

This Microsoft Visual Basic for Applications (VBA) macro shows how to use the SnapStrengthPointsX property to print the current snap strength points x -axis setting in the Immediate window. It also shows how to get an ApplicationSettings object from the Visio Application object.

Public Sub SnapStrengthPointsX_Example() 
 
 Dim vsoApplicationSettings As Visio.ApplicationSettings 
 Dim lngSnapStrength As Long 
 
 Set vsoApplicationSettings = Visio.Application.Settings 
 lngSnapStrength = vsoApplicationSettings.SnapStrengthPointsX 
 
 Debug.Print lngSnapStrength 
 
End Sub

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.