Naming Conventions 1.0


Name: Naming Conventions
Author: Burt Abreu
Date: August 10, 1998

Description: A list of some of the more frequently used prefixes. Adhering to a formal naming convention assists in improving code clarity. Remember, although the code you write today may be easy to understand; if someone else reads it or you need to modify it a year from now could you remember what each of those controls and variables was used for?
Controls needed: N/A
Level: All Levels.


    Pre    Object                        Example      
    ---    ------                        ------- 
    cbo    Combobox & dropdown Listbox   cboChoice  
    chk    Checkbox                      chkEnable
    cls	   Class Module                  clsMultimedia
    cmd    Command Button                cmdQuit
    dat    Data                          datInformation
    dbc    Data-bound combo box          dbcEnglish
    dbl    Data-bound list box           dblPolicy
    des	   Designer                      desCustom
    dir    Directory List Box            dirSource
    dlg    Common Dialog                 dlgOpen
    drv    Drive List Box                drvTarget
    fil    File List Box                 filSource
    fra    Frame                         fraLanguage
    frm    Form                          frmSplash
    hsb    Horizontal Scroll Bar         hsbVolume
    img    Image Control                 imgLogo
    imgcbo ImageCombo	                 imgcboControl**
    ils    ImageList                     ilsProgramIcons
    lbl    Label                         lblComment
    lin    Line                          linUnderline
    lst    Listbox                       lstItems
    mdi    MDI Child Form                mdiChild
    mnu    Menu                          mnuFileOpen
    mod    Module                        modTestProcedures
    ole    OLE	                         oleObject1
    opt    Option Button                 optEnglish
    pic    Picture                       picProduct
    pnl    Panel                         pnlGroup1
    prg    ProgressBar                   prgFileDownload
    prp	   Property Page                 prpUserControl
    res	   Resource File                 resMessages
    shp    Shape                         shpBlock 
    sld    Slider                        sldVolumeLevel
    sta    StatusBar                     staConnectionStatus
    tab    TabStrip                      tabUserChoices
    tre    TreeView                      treDriveContents	
    txt    TextBox                       txtInfoBlock
    tmr    Timer                         tmrUpdateClock
    tlb    ToolBar	                 tlbMainControls
    usr	   User Control                  usrMyNoteControl
    vsb    Vertical Scroll Bar           vsbTemperature


** This is longer than the 'ideal' three letter prefix -but it is clear. You could certainly create your own prefix for this (like imc)-or any other control. Just remember that another programmer who views your code will probably understand something like txtDescription but may not understand your custom prefix of zqeDescription -be sensible.

You can find additional information by searching the Help files, Microsoft MSDN Online or the Knowledge Base for Object Coding Conventions.