مواصفات نموذج إنشاء كود دلفي الغرض من هذه المواصفات: إعطاء الكود الخاص بك مظهرًا موحدًا ومعياريًا وتعزيزه
سهولة القراءة وسهولة الفهم وقابلية الصيانة
مبدأ هذه المواصفات: الاسم يعكس المعنى، والشكل يعكس البنية
1. نمط الوحدة
2. نمط كل منطقة
3. أسلوب البيان
4. قواعد التسمية
المرجع: دليل بورلاند الرسمي لأسلوب Object Pascal
دليل مبرمج Delphi5 لمعايير الترميز
{ }
{اسم المشروع}
{ }
{حقوق الطبع والنشر (C) لعام 2000،2001 لاسم الشركة}
{ }
{****************************************************** ***** ******}
اسم الوحدة الوحدة؛
{****************************************************** ***** ******
مشروع:
الوحدة:
يصف:
إصدار:
تاريخ:
مؤلف:
تجديد:
المهام:
*************************************************************************************************************************************************************************** * *****}
واجهة
الاستخدامات
----,----,----,----,----,----,----,----,----,-----,----,----, ----،
----,----, ----,----,----,----;
ثابت
------------------;
------------------;
------------------;
يكتب
------------------;
------------------;
------------------;
------------------;
------------------;
------------------;
فار
------------------;
------------------;
------------------;
تطبيق
الاستخدامات
----,----,----,----;
{$R *.RES}
{$R *.DFM}
--------------------------------;
--------------------------------;
--------------------------------;
--------------------------------;
--------------------------------;
--------------------------------;
--------------------------------;
--------------------------------;
--------------------------------;
--------------------------------;
--------------------------------;
--------------------------------;
end.return
تعليقات الموضوع، ووصف الغرض من إجراءات الوظيفة، وتعليقات البيان
الأسطر الفارغة: كتل حقوق النشر، بين الفئات، بين الطرق - (سطرين) الكتل الداخلية للطرق (سطر واحد)
الفضاء: يستخدم لتعزيز الوضوح
المسافة البادئة: مسافتان
----- = ----;
----- = ----;
----- = ----;
----- = ----;امتداد
البادئة: عدد قليل مثل C_---؛ ما يصل إلى بادئة واحدة لكل موضوع
ثابت
{ الموضوع 1 }
C_--- = ----;
C_--- = ----;
C_--- = ----;
C_--- = ----;
{ الموضوع 2 }
----- = ----;
----- = ----;
----- = ----;
----- = ----; سلسلة الموارد، توضع بعد المنطقة المتغيرة
سلسلة الموارد
ثابت
S_--- = '----';
S_--- = '----';
S_--- = '----';
مثال: CM_BASE = $B000؛
CM_ACTIVATE = CM_BASE + 0;
CM_DEACTIVATE = CM_BASE + 1;
CM_GOTFOCUS = CM_BASE + 2;
CM_LOSTFOCUS = CM_BASE + 3;
NumPaletteEntries = 20;
BoxPoints: الصفيف [0..5، 0..2] من GLfloat =
((-1، 0، 0)،
(0، 1، 0)،
(1، 0، 0)،
(0، -1، 0)،
(0، 0، 1)،
(0، 0، -1))؛
{ رموز النوع المتغير (wtypes.h) }
varEmpty = $0000; { vt_empty }
varNull = $0001 { vt_null }
varSmallint = $0002 { vt_i2 }
GIFVersions: الصفيف[gv87a..gv89a] الخاص بـ TGIFVersionRec = ('87a', '89a');
ت---- = ---------
نوع الكائن-->الكيان ذو الحالة ويقدم الخدمات
ت---- = الفئة(----)
خاص
--------
--------
محمي
--------
--------
عام
--------
--------
نشرت
--------
--------
النهاية؛ الترتيب الأبجدي خاص
1. يتم وضع جميع البيانات في المنطقة الخاصة، بدءًا من F
2. يتم وضع مؤشرات الطريقة المقابلة لجميع سمات الحدث في المنطقة الخاصة، بدءًا من F.
3. يتم وضع أساليب الحصول على السمات وتعيينها في المنطقة الخاصة --> ليست جاهزة للتوريث.
4. يتم وضع طريقة الرد على الرسالة في المنطقة الخاصة.
محمي
1. الطرق والسمات التي يتم استدعاؤها بواسطة الفئات الفرعية ولكن لا يمكن للعالم الخارجي استدعائها
2. طرق زيادة التحميل الظاهري للفئات الفرعية؛
عام
1. بناء طريقة المدمرة
2. طرق المكالمات الخارجية
3. سمات للمكالمات الخارجية
نشرت
1. الخصائص التي تظهر في Object Inspector لاستخدامها في التصميم
2. مثال على استجابة الحدث الذي يظهر في Object Inspector لوقت التصميم: TGIFVersion = (gvUnknown, gv87a, gv89a);
TGIFVersionRec = array[0..2] من char;
PInterfaceTable = ^TInterfaceTable;
TInterfaceTable = سجل معبأ
EntryCount: عدد صحيح؛
الإدخالات: الصفيف [0..9999] من TInterfaceEntry؛
{إعلان forWord}
TGIFImage = class;
TGIFSubImage = class;
{--------------------------
TGIFItem
-------------------------- }
TGIFItem = فئة (TPersistent)
خاص
FGIFImage: TGIFImage;
.............
نهاية؛
احرص على عدم وجود متغيرات كائن فئة افتراضية، قم بإعلانها في المتصل!
فار
-----------: -------;
-----------: -------;
مثال:
GIFDelayExp: عدد صحيح = 10 {مضاعف التأخير بالميلي ثانية.}
GIFDelayExp: عدد صحيح = 12؛
سمة
-------------------------------------------------- --------}
{الغرض من الطريقة}
إجراء ----------------------------
يبدأ
--------;
--------;
نهاية؛
{الغرض من الطريقة}
وظيفة-----------------------------
يبدأ
--------؛
--------;
نهاية؛
عودة التنسيق