Delphi 程序员代码编写标准指南 (六）

 

七、构件

 

7.1 用户自定义构件

 

在标准构件中命名出来的构件的名称同在“类类型”部分定义中的一样定义成一个类类型，不同的是它们有一个3字符的指示前缀，这个前缀可以表示公司、个人或其它实体。例如，一个为Delphi 4开发者指南编写的时钟构件的名称定义为：

      TddgClock = class(TComponent)

注意，那三个前缀字符是小写的。

 

7.2 构件单元

 

构件单元应只包含一个主要的构件，一个主要的构件是指出现在构件栏中的构件。主要构件的辅助构件/对象应放入到同一个单元中。

 

7.3 使用注册单元

 

构件的注册过程应从构件本身的单元中剔除，并放入到一个独立的单元中。这个注册单元可以用来注册任何构件、属性编辑器、构件编辑器、专家器等。

 

构件的注册只应在设计时刻包中进行，注册单元应包含在设计时刻包中而不应放在运行时刻包中。

 

推荐使用的注册单元的名称是：

XxxReg.pas

上面的3个前缀字符“Xxx”用来表示一个公司、个人或任何其它的实体。例如，在Delphi 4 开发者指南中的注册单元的名称应为 DdgReg.pas。

 

7.4 构件实例命名约定

 

所有的构件都应取个描述性的名称。由Delphi创建的缺省名的构件不会被遗弃。在设计构件类型时应设计一个小写的前缀。使用前缀而不使用后缀的原因是在搜寻时，在对象检查器和代码探索器中搜寻构件的名字比搜寻构件的类型更容易实现。

 

7.5 构件的前缀

 

以下构件的前缀可以用来设计Delphi 4中的标准构件。请在此列表中加入第三方构件的前缀。

 

7.6 Standard页

前缀      构件

mm        TMainMenu

pm        TPopupMenu

mmi       TMainMenuItem

pmi       TPopupMenuItem

前缀      构件

lbl       TLabel

edt       TEdit

mem       TMemo

btn       TButton

cb        TCheckBox

rb        TRadioBox

lb        TListBox

cb        TComboBox

scb       TScrollBar

gb        TGroupBox

rg        TRadioGroup

pnl       TPanel

cl        TCommandList

7.7 Additional页

bbtn      TBitBtn

sb        TSpeedButton

me        TMaskEdit

sg        TStringGrid

dg        TDrawGrid

img       TImage

shp       TShape

bvl       TBevel

sbx       TScrollBox

clb       TCheckListbox

spl       TSplitter

stx       TStaticText

cht       TChart

7.8 Win32页

tbc       TTabControl

pgc       TPageControl

il        TImageList

re        TRichEdit

thr       TTrackBar

prb       TProgressBar

ud        TUpDown

hk        THotKey

ani       TAnimate

dtp       TDateTimePicker

tv        TTreeView

lv        TListView

hdr       THeaderControl

前缀      构件

stb       TStatusBar

tlb       TToolBar

clb       TCoolBar

7.9 System页

tm        TTimer

pb        TPaintBox

mp        TMediaPlayer

olec      TOleContainer

ddcc      TDDEClientItem

ddci      TDDEClientItem

ddsc      TDDEServerConv

ddsi      TDDEServerItem

7.10 Internet页

csk       TClientSocket

ssk       TServerSocket

wbd       TWebDispatcher

pp        TPageProducer

tp        TQueryTableProducer

dstp      TDataSetTableProducer

nmdt      TNMDayTime

nec       TNMEcho

nf        TNMFinger

nftp      TNMFtp

nhttp     TNMHttp

nMsg      TNMMsg

nmsg      TNMMSGServ

nntp      TNMNNTP

npop      TNMPop3

nuup      TNMUUProcessor

smtp      TNMSMTP

nst       TNMStrm

nsts      TNMStrmServ

ntm       TNMTime

nudp      TNMUdp

psk       TPowerSock

ngs       TNMGeneralServer

html      THtml

url       TNMUrl

sml       TSimpleMail

 

 

7.11 Data Access页

前缀      构件

ds        TDataSource

tbl       TTable

qry       TQuery

sp        TStoredProc

db        TDataBase

ssn       TSession

bm        TBatchMove

usql      TUpdateSQL

7.12 Data Controls页

dbg       TDBGrid

dbn       TDBNavigator

dbt       TDBText

dbe       TDBEdit

dbm       TDBMemo

dbi       TDBImage

dblb      TDBListBox

dbcb      TDBComboBox

dbch      TDBCheckBox

dbrg      TDBRadioGroup

dbll      TDBLookupListBox

dblc      TDBLookupComboBox

dbre      TDBRichEdit

dbcg      TDBCtrlGrid

dbch      TDBChart

7.13 Decision Cube页

dcb       TDecisionCube

dcq       TDecisionQuery

dcs       TDecisionSource

dcp       TDecisionPivot

dcg       TDecisionGrid

dcgr      TDecisionGraph

7.14 QReport页

qr        TQuickReport

qrsd      TQRSubDetail

qrb       TQRBand

qrcb      TQRChildBand

qrg       TQRGroup

qrl       TQRLabel

前缀      构件

qrt       TQRText

qre       TQRExpr

qrs       TQRSysData

qrm       TQRMemo

qrrt      TQRRichText

qrdr      TQRDBRichText

qrsh      TQRShape

qri       TQRImage

qrdi      TQRDBMImage

qrcr      TQRCompositeReport

qrp       TQRPreview

qrch      TQRChart

7.15 Dialogs页

对话框构件是由构件封装的真正的窗体，因此，它们应遵循窗体的命名约定。类型已由构件的名称定义。它的实例的名称是Delphi自动生成的类型实例名字去掉数字后缀。举例如下：

      类型                    实例名字

    TOpenDialog             OpenDialog

    TSaveDialog             SaveDialog

    TOpenPictureDialog     OpenPictureDialog

    TSavePictureDialog     SavePictureDialog

    TFontDialog             FontDialog

    TColorDialog            ColorDialog

    TPrintSetupDialog      PrintSetupDialog

    TFindDialog             FindDialog

    TReplaceDialog         ReplaceDialog

7.16 Win3.1页

dbll      TDBLookupList

dblc      TDBLookupCombo

ts        TTabSet

ol        TOutline

tnb       TTabbedNoteBook

nb        TNoteBook

hdr       THeader

flb       TFileListBox

dlb       TDirectoryListBox

dcb       TDriveComboBox

fcb       TFliterComboBox

7.17 Samples页

gg        TGauge

前缀      构件

cg        TColorGrid

spb       TSpinEdit

spe       TSpinEdit

dol       TDirectoryOutline

cal       TCalendar

ibea      TIBEventAlerter

7.18 ActiveX页

cfx       TChartFX

vsp       TVSSpell

f1b       TF1Book

vtc       TVTChart

grp       TGraph

7.19 Midas页

prv       TProvider

cds       TClientDataSet

qcds      TQueryClientDataSet

dcom      TDCOMConnection

olee      TOleEnterpriseConnection

sck       TSocketConnection

rms       TRemoteServer

mid       TMidasConnection