Propriedade Module.ProcStartLine (Access)

A propriedade ProcStartLine retorna um valor que identifica a linha na qual um procedimento especificado começa em um módulo padrão ou em um módulo de classe. Long somente leitura.

Sintaxe

expressão. ProcStartLine (ProcName, ProcKind)

Expressão Uma variável que representa um objeto Module .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Procname Obrigatório String O nome de um procedimento no módulo.
ProcKind Obrigatório vbext_ProcKind O tipo de procedimento. Consulte a seção Comentários para obter as configurações possíveis.

Comentários

O argumento ProcKind pode ser uma das constantes vbext_ProcKind a seguir.

Constante Descrição
vbext_pk_Get Um procedimento Property Get.
vbext_pk_Let Um procedimento Property Let.
vbext_pk_Proc Um procedimento Sub ou Function.
vbext_pk_Set Um procedimento Property Se t.

Um procedimento começa com qualquer comentário e constante de compilação que esteja imediatamente antes da definição do procedimento, indicado por uma das instruções a seguir:

  • Uma instrução Sub
  • Uma instrução Function
  • Uma instrução Obter Propriedade
  • Uma instrução Property Let
  • Uma instrução Conjunto de Propriedades

A propriedade ProcStartLine retorna o número da linha de início do procedimento especificado. O início do procedimento pode incluir comentários ou constantes de compilação que precedam a definição do procedimento.

Para determinar a linha na qual a definição do procedimento começa, use a propriedade ProcBodyLine . Essa propriedade retorna o número da linha que inicia com uma instrução Sub, Function, Property Get, Property Let ou Property Set.

As propriedades ProcStartLine e ProcBodyLine podem ter o mesmo valor se a definição do procedimento for a primeira linha do procedimento. Se a definição do procedimento não for a primeira linha do procedimento, a propriedade ProcBodyLine terá um valor maior que a propriedade ProcStartLine.

Talvez seja mais fácil determinar o início de um procedimento se você tiver a opção Separador de Procedimento selecionada. Com essa opção selecionada, haverá uma linha entre o fim de um procedimento e o início do próximo procedimento. A primeira linha de código (ou linha em branco), abaixo do separador de procedimento, equivale à primeira linha do procedimento seguinte, que é a linha retornada pela propriedade ProcStartLine. A opção Separador de Procedimento está localizada na guia Editor da caixa de diálogo Opções , disponível escolhendo Opções no menu Ferramentas .

Observação

A propriedade ProcStartLine trata os procedimentos Sub e Function da mesma forma, mas distingue entre cada tipo de procedimento de propriedade.

Exemplo

O exemplo a seguir exibe uma mensagem que informa o local de início de um determinado procedimento em um módulo de formulário específico.

Dim strForm As String 
Dim strProc As String 
 
strForm = "Products" 
strProc = "Form_Activate" 
 
MsgBox "The procedure " & strProc & " starts on line " & _ 
 Forms(strForm).Module.ProcStartLine(strProc, vbext_pk_Proc) & "."

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.