SnapStrengthExtensionsY Property
TOC
Collapse the table of content
Expand the table of content

ApplicationSettings.SnapStrengthExtensionsY Property (Visio)

Office 2013 and later
GitHub-Mark-64px

Contribute to this content

Use GitHub to suggest and submit changes. See our guidelines for contributing to VBA documentation.

Specifies the distance in pixels along the y-axis that shape extension lines pull when snapping is enabled. Read/write.

expression .SnapStrengthExtensionsY

expression A variable that represents a ApplicationSettings object.

Return Value

Long

Setting the SnapStrengthExtensionsY property is equivalent to setting the Extensions 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 SnapStrengthExtensionsY property is 0 (zero), and the maximum is 999. Attempting to set a value outside that range returns an error. The default value is 13.

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

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

Show:
© 2016 Microsoft