API

أن البرمجة يتقنية API ليست قاصرة عـلى Visual Basic فقط ، حيث يمكن استخدامها مع لغات برمجة أخرى مثل ++C ولكن بشكل مختلف قليلا في طريقة أستدعائها ، وكلمة API هي أختصار للعبارة Application Programming Interface وترجمتها " واجهة برمجة التطبيقات " ، وهي عبارة عن مجموعة من الدوال التي يكثر استخدامها من قبل كثير من البرنامج التى تعمل مع الويندوز ، وبدا ل من ان يقوم كل مبرمج بكتابة عدة اسطر داخل برنامجة لقيام بمهمة تتكرر مع كثير من البرنامج بما فيها كثير من برامج Windoes تم وضع هذة الدوال الجاهزة داخل ملفات ديناميكية DLLS .

كيف تستخدم إجراءات واجهة البرمجة :

عندما تستخدم أي من أوامر Visual Basic فانت تفعل ذلك مباشرة ، وتمرر للأمر ما يحتاج من متغيرات مثلا الأمر Line يمكنك استخدامة مباشرة كالتالي :

Line (10, 10)-(1500, 1500), vbRed, BF

واستخدام الإجراءات الموجودة في واجهة البرمجة يشبة إستخدام أوامر Visual Basic مع خطوة إضافية هي الإعلان عن اي جراء تود استخدامة قبل استخدامك لة ، وذلك لان تلك الإجراءات ليست جزاء Visual Basic بل هي جزء من بيئة Windows .

ألأعلان عن لإجراء ت :

هناك برنامج ياتي مع Visual Basic يسمى API Text Viewer تجدة ضمن المجوعة البرمجية الخاصة بـ Visual Basic يحتوي على الإعلانات الخاصة بكثير من إجراءت واجهة البرمجة ، قم بتشغيلة الأن ثم أختر File ثم Load Text File ، سيظهر صندوق حوار ليس بغريب عليك أختر الملف Win32api.txt من تحت المسار vb\winapi\... وهذا الملف يحوي كثيرا من ألإجراءات .

كما يمكنك تشغيل البرنامج من داخل Visual Basic بشرط أن تكون منتقاة ، ويمكنك أنتقائها من داخل برنامج Visual Basic بأختيارك لـ Add-Ins ثم Add-In Manager ثم من داخل صندوق الحوار أنتقي VB API Viewer . عند ذلك يمكنك تشغيلها مباشرة من بإختيار Add-Ins ثم API Viewer .

وأجزاء هذا البرنامج كالتالي :

API Type : من هذة القائمة المنسدلة يمكنك الأختيار بين ( قائمة الثوابت Constants ) أو ( أسماء الإجراءات Declares ) أو ( تعريف المتغيرات Types ) .

ِAvailable Items : هنا وعند أختيارك لـ ( أسماء الإجراءات Declares ) من القائمة المنسدلة API Type ستجد أسماء الإجراءت المتاحة لتختار منها الإجراء الذي تريد التعرف على الطريقة الصحيحة للإعلان عن أجراء ما .

Selected Items : هنا ستظهر لك الطريقة الصحيحة للإعلان عن الإجراء الذي أخترة بالنقر علية نقرا مزدوجا ، أو بالإشارة الية ثم النقر على الزر Add .

Searth : هذا الزر يمكنك من البحث ضمن Available Items عن أسماء الإجراءات أو الثوابت او المتغيرات ولو بجزء من اسمها ، وهذا يعني انة ليس عليك حفظ اسم الإجراء بالكامل فالبعض منها طويل جدا .

Add : هذا الزر سيظهر الطريقة الصحيحة للإعلان عن الإجراء المنتقي من Available Items في Selected Items .

Remove : لإزالة ما تنقية أنت من القائمة Selected Items .

Copy : لنسخ الجزء المعلم من القائمة Selected Items ، أو نسخ كل ما بها أن لم تعلم جزء محدداً .

أين تضع الإعلان عن ألإجراءات :

عند حصولك على الطريقة الصحيحة للإعلان عن الإجراء ونسخة ، يبقى السوال اين يجب وضعة داخل البرنامج فلنفرض ان لدينا اجراء ما فإين نضعة

ـ إذا كنت تريد استخدام الإجراء في أكثر من نافذة في البرنامج فيجب عليك أن تكتبة أو تلصقة في قسم الإعلانات في ملف برمجة Module كما بالشكل المجاور.

ـ لإضافة ملف برمجة لمشروعك أختر من قائمة برنامج Visual Basic اختر Project ثم اختر AddModule .

http://www.vb4arab.com/vb/attachment...1&d=1180702400

ملاحظة : يمكنك أضافة الأعلان في اماكن أخرى ولكن هذا الموضع هو افضلها .

الآن وبعـد أن اضفت الإعلان عن الإجراء فبإمكانك استخادمة متى شئت لنرى الصيغـتين العامة للإعلان عن الإجراءات :

ملاحظة : يمكنك أضافة الأعلان في اماكن أخرى ولكن هذا الموضع هو افضلها .

أنقر على الإيقونة لتحميل مثال بسيط أرجو أن يساعدك على فهم المقصود .

الآن وبعـد أن اضفت الإعلان عن الإجراء فبإمكانك استخادمة متى شئت لنرى الصيغـتين العامة للإعلان عن الإجراءات :

[Public | Private] Declare Sub name Lib "libname" [Alias "aliasname"] [([arglist])]
[Public | Private] Declare Function name Lib "libname" [Alias "aliasname"] [([arglist])] [As type]

Public

تعني أن الإجراء يمكن استخدامة في أي مكان داخل مشروعك

Private

ـ تعني أن الإجراء لايمكن استخدامة إلا ضمن الإطار أو ملف البرمجة الذي يحتوي الإعلان عن الإجراء

Declareـ

وهي خاصة بالإعلان عن الإجراءات الخارجية ، ستجدها دائما ضمن أي أعلان لإي إجراء

Function

ـ وهي تشير إلى أن الإجراء سيعود بقيمة لبرنامجك ويجب عليك أن تستقبل تلك القيمة في متغير

Sub

ـ تشير إلى أن الإجراء لن يعود لك بقيمة لك بعد أن ينتهي أو

name

ـ أسم الإجراء المستخدم

Lib

وهي إختصار لـ Library وياتي بعدها اسم المكتبة التي بها الإجراء .

"libname"

اسم المكتبة التي بها الإجراء مثل User32 وهي من مكتبات ويندوز المشهورة .

Alias

ـ ياتي بعدها الإسم المستعار للإجراء

"aliasname"

ـ الأسم المستعار للإجراء

arglistـ مجموعة المتغيرات المطلوبة من قبل الإجراء ملحق بكل متغير نوعة

As type

ـ توضح لك نوع القيمة التي يعود بها الإجراء في حال كونة يعود بإجراء

منقول

ألا بذكر الله تطمئن القلوب

#145 يونيو 2007 في 19:08

فكرة ممتازة

كلنا نجمع من بعض ونرح نزور صاحب الموضوع فى بيته ومعانا كيس جوافة ونشجعه انه يكمل الموضوع

ايى بى اى ايه وبتاع ايه ما فى برامج غطت الدوال دى كلها والنت مليان بيها بس انت حدد انت عاوز ايه من النظام( محدش يقول يعنى عايز دالة بتقشر بطيخ ) يعنى لازم حاجة ببتعمل فى النظام زى التحكم فى الماوس واغلاق الجهاز

وابحث بالمواقع الاجنبية وهتلاقى كتيسر

وعندك برامج Api viwer و api guide مغطيين الدوال دى

موقع البرنامج

مبارك لشعب تونس