Module.ProcOfLine Property

  • Article
Access Developer Reference

The ProcOfLine property returns the name of the procedure that contains a specified line in a standard module or a class module. Read-only string.

Syntax

expression.ProcOfLine(Line, pprockind)

expression   A variable that represents a Module object.

Parameters

Name Required/Optional Data Type Description
Line Required Long The number of a line in the module.
pprockind Required vbext_ProcKind The type of procedure. See the Remarks section for the possible settings.

Remarks

The ProcKind argument can be one of the following vbext_ProcKind constants:

Constant Description

vbext_pk_Get

A Property Get procedure.

vbext_pk_Let

A Property Let procedure.

vbext_pk_Proc

A Sub or Function procedure.

vbext_pk_Set

A Property Set procedure.

For any given line number, the ProcOfLine property returns the name of the procedure that contains that line. Since comments and compilation constants immediately preceding a procedure definition are considered part of that procedure, the ProcOfLine property may return the name of a procedure for a line that isn't within the body of the procedure. The ProcStartLine property indicates the line on which a procedure begins; the ProcBodyLine property indicates the line on which the procedure definition begins (the body of the procedure).

Note that the pprockind argument indicates whether the line belongs to a Sub or Function procedure, a Property Get procedure, a Property Let procedure, or a Property Set procedure. To determine what type of procedure a line is in, pass a variable of type Long to the ProcOfLine property, then check the value of that variable.

Bb237734.vs_note(en-us,office.12).gif  Note
The ProcBodyLine property treats Sub and Function procedures similarly, but distinguishes between each type of Property procedure.

Example

The following function procedure lists the names of all procedures in a specified module:

Visual Basic for Applications 
  Public Function AllProcs(ByVal strModuleName As String)

Dim mdl As Module
Dim lngCount As Long
Dim lngCountDecl As Long
Dim lngI As Long
Dim strProcName As String
Dim astrProcNames() As String
Dim intI As Integer
Dim strMsg As String
Dim lngR As Long

' Open specified Module object.
DoCmd.OpenModule strModuleName

' Return reference to Module object.
Set mdl = Modules(strModuleName)

' Count lines in module.
lngCount = mdl.CountOfLines

' Count lines in Declaration section in module.
lngCountDecl = mdl.CountOfDeclarationLines

' Determine name of first procedure.
strProcName = mdl.<strong class="bterm">ProcOfLine</strong>(lngCountDecl + 1, lngR)

' Initialize counter variable.
intI = 0

' Redimension array.
ReDim Preserve astrProcNames(intI)

' Store name of first procedure in array.
astrProcNames(intI) = strProcName

' Determine procedure name for each line after declarations.
For lngI = lngCountDecl + 1 To lngCount
    ' Compare procedure name with ProcOfLine property value.
    If strProcName &lt;&gt; mdl.<strong class="bterm">ProcOfLine</strong>(lngI, lngR) Then
        ' Increment counter.
        intI = intI + 1
        strProcName = mdl.<strong class="bterm">ProcOfLine</strong>(lngI, lngR)
        ReDim Preserve astrProcNames(intI)
        ' Assign unique procedure names to array.
        astrProcNames(intI) = strProcName
    End If
Next lngI

strMsg = "Procedures in module '" &amp; strModuleName &amp; "': " &amp; vbCrLf &amp; vbCrLf
For intI = 0 To UBound(astrProcNames)
    strMsg = strMsg &amp; astrProcNames(intI) &amp; vbCrLf
Next intI

' Message box listing all procedures in module.
MsgBox strMsg



End Function

See Also