Share via


Comprendre la syntaxe Visual Basic

La syntaxe dans une rubrique d’aide de Visual Basic pour une méthode, fonction ou instruction indique tous les éléments nécessaires pour utiliser la méthode, fonction ou instruction correctement. Les exemples présentés dans cette rubrique expliquent comment interpréter les éléments de syntaxe courants.

Syntaxe de la méthode Activate

objet.Activate

Dans la syntaxe de la méthodeActivate, le mot « objet » en italique est un espace réservé pour les informations que vous fournissez ; dans ce cas, un code qui renvoie un objet. Les mots en gras doivent être tapés exactement tels qu’ils apparaissent. Par exemple, laprocédure suivante active une seconde fenêtre dans le document actif.

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

Syntaxe de la fonction MsgBox

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

Dans la syntaxe de la fonction MsgBox, le texte en italique correspond aux arguments nommés de la fonction. LesArguments placés entre crochets sont facultatifs. (Ne tapez pas les parenthèses dans votre code Visual Basic.) Pour la fonction MsgBox, l’unique argument que vous devez fournir est le texte de l’invite.

Vous pouvez spécifier les arguments des fonctions et des méthodes en entrant du code, par position ou par nom. Pour spécifier les arguments par position, suivez l’ordre indiqué dans la syntaxe, en séparant chaque argument par une virgule, par exemple :

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

Pour spécifier un argument par nom, utilisez le nom de l’argument suivi de deux-points et un signe égal (: =) et la valeur de l’argument. Vous pouvez spécifier des arguments nommés dans n’importe quel ordre, par exemple :

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

Dans la syntaxe des fonctions et de certaines méthodes, les arguments sont affichés entre parenthèses. Comme ces fonctions et méthodes renvoient des valeurs, vous devez mettre les arguments entre parenthèses pour affecter la valeur à une variable. Si vous ignorez la valeur renvoyée ou si vous ne passez aucun argument, n'utilisez pas de parenthèses. Les méthodes qui ne retournent pas de valeurs n’ont pas besoin de leurs arguments entre parenthèses. Ces instructions s’appliquent si vous utilisez des arguments de position ou arguments nommés.

Dans l’exemple suivant, la valeur de retour à partir de la fonctionMsgBox est un nombre indiquant le bouton sélectionné stocké dans la variable myVar. Étant donné que la valeur de retour est utilisée, des parenthèses sont requises. Une autre zone de message affiche ensuite la valeur de la variable.

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

Syntaxe de l’instruction Option Compare

Option Compare { Binary | Text | Database }

Dans la syntaxe de l’instruction Option Compare, les accolades et barres verticales indiquent un choix obligatoire entre trois éléments. (Ne tapez pas les accolades dans l’instruction Visual Basic). Par exemple, l’instruction suivante indique qu’au sein dumodule, les chaînes seront comparées dans un ordre de tri qui n’est pas sensible à la casse.

Option Compare Text 

Syntaxe de l’instruction Dim

Dimvarname [([ indices ])] [ Astype, ] [ varname [([ subscripts ])] [ Astype ]] . . . .

Dans la syntaxe de l’instruction Dim, le mot Dim est un mot clé obligatoire. Le seul élément requis est varname (le nom de la variable).

Par exemple, l’instruction suivante crée trois variables : myVar, nextVar et thirdVar. Celles-ci sont automatiquement déclarées comme variables Variante.

Dim myVar, nextVar, thirdVar 

L’exemple suivant déclare une variable comme une Chaîne. L'utilisation d'un type de données permet d'économiser de la mémoire et peut vous aider à trouver des erreurs dans votre code.

Dim myAnswer As String 

Pour déclarer plusieurs variables dans une instruction, incluez le type de données pour chaque variable. Les variables déclarées sans type de données sont automatiquement déclarées comme Variante.

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

Dans l’instruction suivante, x et y sont attribués au type de données Variante. Uniquement z est affecté au type de donnéesEntier.

Dim x, y, z As Integer 

Le raccourci de la déclaration de x et de y sous la forme d’un nombre entier dans l’instruction ci-dessus est :

Dim x%, y%, z as Integer

Le raccourci pour les types est le suivant : % -Integer ; & -long ; @ -devise ; # -double ; ! -unique; $ -chaîne

Si vous déclarez une variable matrice, vous devez inclure des parenthèses. Les indices sont facultatifs. L’instruction suivante dimensionne un tableau dynamique myArray.

Dim myArray() 

Voir aussi

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.