StencilLinesPerMaster Property [Visio 2003 SDK Documentation]

For shapes on stencils in Microsoft Office Visio, determines how many lines of text of each shape's name can appear below the shape before the text is truncated and "..." is appended.

longRet = object.StencilLinesPerMaster

object.StencilLinesPerMaster = longVal

longRet    Long. Current number of stencil lines per master.

object    Required. An expression that returns an ApplicationSettings object.

longVal   Required Long. New number of stencil lines per master.

Version added

2003

Remarks

Setting the StencilLinesPerMaster property is equivalent to setting the Lines per master option under Stencil spacing on the View tab in the Options dialog box (Tools menu).

The minimum value for StencilLinesPerMaster is 1 line per master and the maximum is 4. By default, Visio displays 2 lines per master.

This property affects the overall spacing of shapes on a stencil, which affects how many shapes users can see without scrolling.

Example

This Microsoft Visual Basic for Applications (VBA) macro shows how to use the StencilCharactersPerLine property to print the current number of stencil lines per master in the Immediate window. It also shows how to get an ApplicationSettings object from the Visio Application object.

Public Sub StencilLinesPerMaster_Example()

    Dim vsoApplicationSettings As Visio.ApplicationSettings
    Dim lngLinesPerMaster As Long

    Set vsoApplicationSettings = Visio.Application.Settings
    lngLinesPerMaster = vsoApplicationSettings.StencilLinesPerMaster

    Debug.Print lngLinesPerMaster

End Sub

Applies to | ApplicationSettings object

See Also | Application object | Settings property