Função CallByName

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

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

Sintaxe

CallByName ( objeto , procname, calltype [, ( argumentos)])

A sintaxe da função CallByName possui os seguintes argumentos:

Argumento

Descrição

objeto

Necessário. Variant (Objeto). O nome do objeto no qual a função será executada.

procname

Necessário. Variant (Cadeia). Uma expressão de cadeia de caracteres contendo o nome de uma propriedade ou método do objeto.

CallType

Necessário. Constante. Uma constante de tipo vbCallType representando o tipo de procedimento sendo chamado.

argumentos ()

Opcional. Variant (Matriz).


Comentários

A função CallByName é usada para obter ou definir uma propriedade ou chamar um método em tempo de execução usando um nome de cadeia de caracteres.

No exemplo a seguir, a primeira linha usa CallByName para definir a propriedade MousePointer de uma caixa de texto, a segunda linha obtém o valor da propriedade MousePointer e a terceira linha chama o método Mover para mover a caixa de texto:

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

Exemplo

Observação : Exemplos a seguir demonstram o uso dessa função em um Visual Basic para módulo Applications (VBA). Para obter mais informações sobre como trabalhar com o VBA, selecione a Referência do desenvolvedor na lista suspensa ao lado de pesquisa e insira um ou mais termos na caixa de pesquisa.

Este exemplo usa a função CallByName para chamar o método Mover de um botão de comando.

O exemplo também usa um formulário (Form1) com um botão (Command1) e um rótulo (Label1). Quando o formulário é carregado, a propriedade legenda do rótulo é definida para o nome do método para invocar, nesse caso, "Mover". Quando você clica no botão, a função CallByName chama o método para alterar o local 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

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×