Share via

ApplicationSettings.SnapStrengthGridX Property

  • Article
Visio Automation Reference

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

Version Information
 Version Added:  Visio 2003

Syntax

expression.SnapStrengthGridX

expression   A variable that represents a ApplicationSettings object.

Return Value
Long

Remarks

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

Example

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

Visual Basic for Applications 
  
    
      

        

          Visual Basic for Applications
        

        

          

            
              Public Sub SnapStrengthGridX_Example()

Dim vsoApplicationSettings As Visio.ApplicationSettings
Dim lngSnapStrength As Long

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

Debug.Print lngSnapStrength



End Sub
Visual Basic for Applications 
  Public Sub SnapStrengthGridX_Example()

Dim vsoApplicationSettings As Visio.ApplicationSettings
Dim lngSnapStrength As Long

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

Debug.Print lngSnapStrength



End Sub

See Also