Função ChamarPorNome

Nota: Queremos fornecer-lhe os conteúdos de ajuda mais recentes o mais rapidamente possível e no seu idioma. Esta página foi traduzida automaticamente e pode conter erros gramaticais ou imprecisões. O nosso objetivo é que estes conteúdos lhe sejam úteis. Pode informar-nos se as informações foram úteis no final desta página? Eis o artigo em inglês para referência.

Executa um método de um objeto ou define ou devolve uma propriedade de um objeto.

Sintaxe

Chamarpornome ( objeto procname , calltype [, argumentos(-)])

A sintaxe da função Chamarpornome tem os seguintes argumentos:

Argumento

Descrição

objecto

Obrigatório. Variante (Objeto). O nome do objeto em que será executada a função.

procname

Obrigatório. Variante (Cadeia). Uma expressão de cadeia que contém o nome de uma propriedade ou método do objeto.

CallType

Obrigatório. Constante. Uma constante de tipo vbCallType , que representa o tipo de procedimento a ser chamado.

argumentos ()

Opcional. Variante (Matriz).


Observações

A função Chamarpornome é utilizada para obter ou definir uma propriedade de ou para invocar um método em tempo de execução utilizando um nome de cadeia.

No exemplo seguinte, a primeira linha utiliza Chamarpornome para definir a propriedade MousePointer de uma caixa de texto, a segunda linha obtém o valor da propriedade MousePointer e a terceira linha invoca o método de Mover para mover a caixa de texto :

CallByName Text1, "MousePointer", vbLet, vbCrosshair
Result = CallByName (Text1, "MousePointer", vbGet)
CallByName Text1, "Move", vbMethod, 100, 100

Exemplo

Nota: Os exemplos seguintes demonstram a utilização desta função no módulo VBA (Visual Basic for Applications). Para obter mais informações sobre trabalhar com o VBA, selecione Referência para Programadores na lista pendente junto a Procurar e introduza um ou mais termos na caixa de pesquisa.

Este exemplo utiliza a função Chamarpornome invocar o método Mover de um botão de comando.

O exemplo também utiliza um formulário (Form1) com um botão (Command1) e uma etiqueta (Label1). Quando é carregado o formulário, a propriedade legenda da etiqueta está definida para o nome do método para invocar, neste caso, "Mover". Quando clica no botão, a função Chamarpornome invoca o método para alterar a localização do botão.

Option Explicit
Private Sub Form_Load()
Label1.Caption = "Move"' Name of Move method.
End Sub
Private Sub Command1_Click()
If Command1.Left <> 0 Then
CallByName Command1, Label1.Caption, vbMethod, 0, 0
Else
CallByName Command1, Label1.Caption, vbMethod, 500, 500
End If
Aumente os seus conhecimentos do Office
Explore as formações
Seja o primeiro a obter novas funcionalidades
Adira ao Office Insider

As informações foram úteis?

Obrigado pelos seus comentários!

Obrigado pelo seu feedback! Parece que poderá ser benéfico reencaminhá-lo para um dos nossos agentes de suporte do Office.

×