Información sobre la sintaxis de Visual Basic

La sintaxis de un tema de Ayuda de Visual Basic para un método, instrucción o función muestra todos los elementos necesarios para usar la función, instrucción o método correctamente. Los ejemplos de este tema explican cómo interpretar los elementos de sintaxis más comunes.

Activar la sintaxis del método

objeto.Activar

En la sintaxis del método activar, la palabra cursiva "objeto" es un marcador de posición para la información que suministre, en este caso, el código que devuelve un objeto. Deben escribirse las palabras que están en negrita exactamente tal y como aparecen. Por ejemplo, el siguiente procedimiento activa la segunda ventana del documento activo.

Sub MakeActive() 
    Windows(2).Activate 
End Sub

Sintaxis de la función MsgBox

MsgBox(prompt, [ buttons ], [ title ], [ helpfile, context ])

En la sintaxis de la función MsgBox, las palabras en cursiva son argumentos con nombre de la función. Los argumentos entre corchetes son opcionales. (No escriba los corchetes en el código de Visual Basic). Para la función CuadroMsj, el argumento que solo necesita especificar es el texto para el aviso.

Puede especificarse argumentos de funciones y métodos de código por posición o por nombre. Para especificar los argumentos por posición, siga el orden indicado en la sintaxis, separando cada argumento con una coma, por ejemplo:

MsgBox "Your answer is correct!",0,"Answer Box" 

Para especificar un argumento por nombre, use el nombre del argumento seguido de dos puntos y un signo igual (: =) y el valor del argumento. Puede especificar los argumentos en cualquier orden, por ejemplo:

MsgBox Title:="Answer Box", Prompt:="Your answer is correct!" 

La sintaxis de las funciones y algunos métodos muestran los argumentos entre paréntesis. Estos métodos y funciones devuelven valores, por lo que debe incluir los argumentos en paréntesis para asignar el valor a una variable. Si omite el valor devuelto o si no pasa argumentos, no se incluyen los paréntesis. Los métodos que no devuelven valores no necesitan sus argumentos entre paréntesis. Estas instrucciones se aplican si usa argumentos posicionales o argumentos con nombre.

En el ejemplo siguiente, el valor devuelto de la función MsgBox es un número que indica el botón seleccionado que se almacena en la variable myVar. Ya que se usa el valor devuelto, los paréntesis son necesarios. Otro cuadro de mensaje, a continuación, muestra el valor de la variable.

Sub Question() 
    myVar = MsgBox(Prompt:="I enjoy my job.", _ 
        Title:="Answer Box", Buttons:="4") 
    MsgBox myVar 
End Sub

Sintaxis de la instrucción Option Compare

Option Compare { Binario | Texto | Base de datos }

En la sintaxis de la instrucción Option Compare, las llaves y la barra vertical indican una elección obligatoria entre tres elementos. (No escriba las llaves en la instrucción de Visual Basic). Por ejemplo, la siguiente instrucción especifica que en el módulo, se comparará cadenas en un criterio de ordenación que no distingue mayúsculas de minúsculas.

Option Compare Text 

Sintaxis de la instrucción Dim

Dimvarname [([ subíndices ])] [ Astype, ] [ varname [([ subíndices ])] [ Astype ]] . . .

En la sintaxis de instrucción de Dim, la palabra Dim es una palabra clave obligatoria. El único elemento obligatorio es varname (el nombre de la variable).

Por ejemplo, la siguiente instrucción crea tres variables: myVar, nextVar y thirdVar. Estos se declaran automáticamente como variables Variant.

Dim myVar, nextVar, thirdVar 

El ejemplo siguiente declara una variable como una cadena. Incluir un tipo de datos ahorra memoria y puede ayudarle a encontrar errores en el código.

Dim myAnswer As String 

Para declarar varias variables en una instrucción, incluya el tipo de datos para cada variable. Las variables declaradas sin un tipo de datos se consideran automáticamente Variant.

Dim x As Integer, y As Integer, z As Integer 

En la siguiente instrucción, x y y se asignan a los tipos de datos Variant. Solo se asigna el tipo de datos entero a z.

Dim x, y, z As Integer 

La forma abreviada para declarar x y y como Integer en la instrucción anterior es la siguiente:

Dim x%, y%, z as Integer

El atajo para los tipos es:%-Integer; & largo; @-Currency; #-Double;! -cadena; $ -cadena

Si va a declarar una variable matriz, debe incluir paréntesis. Los subíndices son opcionales. La siguiente instrucción dimensiona una matriz dinámica, myArray.

Dim myArray() 

Vea también

Soporte técnico y comentarios

¿Tiene preguntas o comentarios sobre VBA para Office o esta documentación? Vea Soporte técnico y comentarios sobre VBA para Office para obtener ayuda sobre las formas en las que puede recibir soporte técnico y enviar comentarios.