Conventions d'affectation de noms aux objets

Les noms d'objets doivent comporter un préfixe cohérent, permettant d'identifier facilement leur type. Vous trouverez ci-dessous la liste des conventions relatives à certains objets pris en charge par Visual Basic.

Suggestions de préfixes de contrôles

Type de contrôle

Préfixe

Affichage d'arborescence (TreeView)

tre

Affichage de listes (ListView)

lvw

Barre de défilement (UpDown)

upd

Barre de défilement horizontale (HScrollBar)

hsb

Barre de défilement horizontale allégée (Lightweight horizontal scroll bar)

lwhsb

Barre de défilement plate (FlatScrollbar)

fsb

Barre de défilement verticale (VScrollBar)

vsb

Barre de défilement verticale allégée (Lightweight vertical scroll bar)

lwvsb

Barre de progression (ProgressBar)

prg

Barre d'état (StatusBar)

sta

Barre d'onglets (TabStrip)

tab

Barre d'outils (Toolbar)

tlb

Boite de dialogue commune (CommonDialog)

dlg

Bouton animé (AniPushButton)

ani

Bouton de commande (CommandButton)

cmd

Bouton de commande allégé (Lightweight command button)

lwcmd

Cadre (Frame)

fra

Cadre allégé (Lightweight frame)

lwfra

Case à cocher (CheckBox)

chk

Case à cocher allégée (Lightweight check box)

lwchk

Case d'option allégée (Lightweight option button)

lwopt

Communications

com

Compteur (Spin)

spn

Conteneur OLE

ole

Contrôle (utilisé lorsque le type spécifique est inconnu)

ctr

Contrôle de données (Data)

dat

Curseur (Slider)

sld

DataCombo

dbc

DataGrid

dgd

DataList

dbl

Données ADO (ADO Data)

ado

Données distantes (Remote Data)

rd

Éditeur RTF (RichTextBox)

rtf

Étiquette (Label)

lbl

Feuille (Form)

frm

Forme (Shape)

shp

Graphique (Graph)

gra

Grille (Grid)

grd

Grille (MS Flex grid)

msg

Grille dépendante (DataGrid)

dbgrd

Grille hiérarchique (Hierarchical flexgrid)

flex

Image

img

Indicateur (Gauge)

gau

Infos système (SysInfo)

sys

Jeu d'images (PictureClip)

clp

Ligne (Line)

lin

Liste de dossiers (DirListBox)

dir

Liste de fichiers (FileListBox)

fil

Liste de lecteurs (DriveList Box)

drv

Liste déroulante d'images (ImageCombo)

imgcbo

Liste d'images (ImageList)

ils

Liste modifiable allégée (Lightweight combo box)

lwcbo

Liste modifiable dépendante (DataCombo)

dbcbo

Menu

mnu

Message MAPI

mpm

Minuterie (Timer)

tmr

Month view

mvw

MS Chart

ch

Multimédia MCI

mci

Onglet (MSTab)

mst

Option button

opt

Panneau 3D (3D Panel)

pnl

Répétition de données (Data Repeater)

drp

Sélecteur de dates (DatePicker)

dtp

Session MAPI

mps

Zone de liste (ListBox)

lst

Zone de liste allégée (Lightweight ListBox)

lwlst

Zone de liste dépendante (Datalist)

dblst

Zone de liste modifiable, zone de liste déroulante (ComboBox)

cbo

Zone de texte (TextBox)

txt

Zone de texte allégée (Lightweight TextBox)

lwtxt

Zone Image (Picture box)

pic

Suggestions de préfixes d'objets d'accès aux données (DAO)

Utilisez les préfixes suivants pour signaler des objets d'accès aux données.

Objet de base de données

Préfixe

Container

con

Database

db

DBEngine

dbe

Document

doc

Field

fld

Group

grp

Index

idx

Parameter

prm

QueryDef

qry

Recordset

rec

Relation

rel

TableDef

tbd

User

usr

Workspace

wsp

Exemples :

Dim dbBiblio As Database
Dim recPubsInNY As Recordset, strSQLStmt As String
Const DB_READONLY = 4            ' Définit la constante.

' Ouvre la base de données.
Set dbBiblio = OpenDatabase("BIBLIO.MDB")

' Définit le texte de l'instruction SQL.
strSQLStmt = "SELECT * FROM Publishers WHERE State = 'NY'"

' Crée l'objet Recordset.
Set recPubsInNY = db.OpenRecordset(strSQLStmt, dbReadOnly)

Suggestions de préfixes de menus

Les applications utilisent généralement de nombreux contrôles de menus ; il est donc utile d'adopter pour ces contrôles un ensemble unique de conventions d'affectation de noms.

Nous vous conseillons d'ajouter à l'étiquette initiale " mnu " des préfixes de contrôles de menus un préfixe supplémentaire pour chaque niveau d'imbrication, le libellé de menu final figurant à la fin de la chaîne de nom. Le tableau suivant fournit quelques exemples.

Séquence de libellés de menu

Nom du gestionnaire de menu

Fichier Ouvrir

mnuFichierOuvrir

Fichier Envoyer Email

mnuFichierEnvoyerEmail

Fichier Envoyer télécopie

mnuFichierEnvoyerFax

Format caractère

mnuFormatCaractère

Index d'Aide

mnuAideIndex

Si vous utilisez cette convention d'affectation de noms, tous les membres d'un menu donné figurent les uns à côté des autres dans la fenêtre Propriétés de Visual Basic. De plus, les noms de contrôles de menus permettent d'identifier facilement les éléments de menu auxquels ils sont associés.

 

Choix de préfixes pour les autres contrôles

Pour les contrôles qui ne figurent pas ci-dessus, utilisez un préfixe standard, constitué de deux ou trois caractères. Utilisez plus de trois caractères uniquement si cela s'impose pour des raisons de clarté.

Pour les contrôles dérivés ou modifiés, par exemple, ajoutez des lettres aux préfixes ci-dessus afin d'éviter toute confusion quant au contrôle réellement utilisé. Pour les contrôles provenant de fournisseurs tiers, ajoutez au préfixe une abréviation en minuscules du nom du fournisseur. Par exemple, une instance d'un contrôle créé à l'aide du cadre 3D Visual Basic Édition Professionnelle peut être signalée par le préfixe fra3d afin d'éviter toute confusion quant au contrôle réellement utilisé.