SnapStrengthGeometryX Property [Visio 2003 SDK Documentation]

Specifies the distance in pixels along the x-axis that shape geometry pulls when snapping is enabled.

longRet = object.SnapStrengthGeometryX

object.SnapStrengthGeometryX = longVal

longRet    Long. Current x-axis snap strength for shape geometry.

object    Required. An expression that returns an ApplicationSettings object.

longVal   Required Long. New x-axis snap strength for shape geometry.

Version added

2003

Remarks

Setting the SnapStrengthGeometryX property is equivalent to setting the Geometry option under Snap strength on the Advanced tab in the Snap & Glue dialog box (Tools menu). Setting snap strength in the UI sets both x and y values to the same value.

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

Example

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

Public Sub SnapStrengthGeometryX_Example()

    Dim vsoApplicationSettings As Visio.ApplicationSettings
    Dim lngSnapStrength As Long

    Set vsoApplicationSettings = Visio.Application.Settings
    lngSnapStrength = vsoApplicationSettings.SnapStrengthGeometryX

    Debug.Print lngSnapStrength

End Sub

Applies to | ApplicationSettings object

See Also | SnapStrengthExtensionsX property | SnapStrengthExtensionsY property