GeoGebra 3.0 - Persian

8.1.7 ارتباط اپلت هاي ژئوجبرا با جاوا اسكريپت

با استفاده از متدهاي مطرح شده در اين قسمت مي توان بين اپلت و جاوا اسكريپت ارتباط برقرار كرد. زماني كه شما هر يك از اين متدها را بكار مي بريد، بايد گزينه MYSCRIPT را به انتهاي اولين خط تگ اپلت اضافه نماييد. براي مثال:

<applet name="ggbApplet" code="geogebra.GeoGebraApplet" codebase="." archive="geogebra.jar" width="500" height="250" MAYSCRIPT>

گزينه MYSCRIPT تنها براي ارتباط اپلت با جاوا اسكريپت كاربرد دارد ولي براي دسترسي جاوا اسكريپت به اپلت نيازي به آن نيست.

براي مثال اين متدها را مي توان براي

·         مشاهده كردن اعمال كاربر

·         برقراري ارتباط بين دو اپلت ژئوجبرا

مورد استفاده قرار داد.

 

 

 

توضيح

قالب متد

يك تابع جاوا اسكريپت را تعيين مي كند تا در صورت اتفاق افتادن رويداد add در مورد اپلت مربوط به يك ترسيم اجرا شود. هر زمان يك شيء به ترسيم اضافه شود تابع جاوا اسكريپت JSFunctionName صدا زده مي شود و نام شيء جديد به عنوان تنها آرگومان تابع در نظر گرفته مي شود.

مثال: ابتدا يك تابع جاوا اسكريپت را معين كنيد تا به رويداد ايجاد شيء جديد پاسخ دهد:

ggbApplet.registerAddListener("myAddListenerFunction");

در صورت ايجاد شيء “A”، اپلت ژئوجبرا تابع جاوا اسكريپت زير را فراخواني مي كند:

myAddListenerFunction("A")

void registerAddListener(String JSFunctionName)

تابع ثبت شده قبلي را حذف مي كند،

قسمت registerAddListener() را ببينيد.

void unregisterAddListener(String objName)

يك تابع جاوا اسكريپت را تعيين مي كند تا در صورت اتفاق افتادن رويداد remove در مورد اپلت مربوط به يك ترسيم اجرا شود. هر زمان يك شيء از ترسيم حذف شود تابع جاوا اسكريپت JSFunctionName صدا زده مي شود و نام شيء حذف شده به عنوان تنها آرگومان تابع در نظر گرفته مي شود.

توجه: زماني كه ترسيم كلاً حذف شود، رويداد remove براي تك تك اشياء اتفاق نمي افتد، براي اطلاعات بيشتر قسمت registerClearListener() را ببينيد.

مثال: ابتدا يك تابع جاوا اسكريپت را معين كنيد تا به رويداد ايجاد شيء جديد پاسخ دهد:

ggbApplet.registerRemoveListener("myRemoveListenerFunction");

در صورت حذف شيء “A”، اپلت ژئوجبرا تابع جاوا اسكريپت زير را فراخواني مي كند:

myRemoveListenerFunction("A");

void registerRemoveListener(String JSFunctionName)

تابع ثبت شده قبلي را حذف مي كند،

قسمت registerRemoveListener() را ببينيد.

void unregisterRemoveListener(String objName)

يك تابع جاوا اسكريپت را تعيين مي كند تا در صورت اتفاق افتادن رويداد update در مورد اپلت مربوط به يك ترسيم اجرا شود. هر زمان يك شيء در ترسيم تغيير كند تابع جاوا اسكريپت JSFunctionName صدا زده مي شود و نام شيء تغيير كرده به عنوان تنها آرگومان تابع در نظر گرفته مي شود.

توجه: اگر مي خواهيد تنها به تغييرات يك شيء خاص پاسخ داده شود از registerObjectUpdateListener() استفاده نماييد.

مثال: ابتدا يك تابع جاوا اسكريپت را معين كنيد تا به رويداد تغيير شيء پاسخ دهد:

ggbApplet.registerUpdateListener("myUpdateListenerFunction")

در صورت تغيير شيء “A”، اپلت ژئوجبرا تابع جاوا اسكريپت زير را فراخواني مي كند:

myAddListenerFunction("A");

void registerUpdateListener(String JSFunctionName)

تابع ثبت شده قبلي را حذف مي كند، قسمت
registerUpdateListener() را ببينيد.

void unregisterUpdateListener(String objName)

يك تابع جاوا اسكريپت را تعيين ميكند تا در صورت اتفاق افتادن رويداد update براي يك شيء خاص اجرا شود. هر زمان شيء با نام تعيين شده تغييركند تابع جاوا اسكريپت JSFunctionName صدا زده مي شود و نام شيء تغيير كرده به عنوان تنها آرگومان تابع در نظر گرفته مي شود.

توجه: تمام توابع پاسخ دهنده به تغيير اشياء زماني كه شيء مورد نظر حذف يا ترسيم به کلی پاك شود، غير فعال مي گردند.

قسمت (registerRemoveListener(

و registerClearListener() را ببينيد.

مثال: ابتدا يك تابع جاوا اسكريپت را معين كنيد تا به رويداد تغيير شيء پاسخ دهد:

ggbApplet.registerObjectUpdateListener("A", "myAupdateListenerFunction");

در صورت تغيير شيء “A”، اپلت ژئوجبرا تابع جاوا اسكريپت زير را فراخواني مي كند:

myAupdateListenerFunction("A");

توجه: در صورتيكه نام شيء مورد نظر تغيير داده شود، باز هم تابع تعريف شده در صورت تغيير ديگري در شيء عمل خواهد كرد.

void registerObjectUpdateListener(String objName, String JSFunctionName)

تابع ثبت شده قبلي را حذف مي كند، قسمت registerObjectUpdateListener() را ببينيد.

void unregisterObjectUpdateListener(String objName)

يك تابع جاوا اسكريپت را تعيين ميكند تا در صورت اتفاق افتادن رويداد rename در مورد اپلت مربوط به يك ترسيم اجرا شود. هر زمان نام يك شيء در ترسيم تغييركند تابع جاوا اسكريپت JSFunctionName صدا زده مي شود و نام قديم و جديد شيء تغيير كرده به عنوان دو آرگومان تابع در نظر گرفته مي شود.

مثال: ابتدا يك تابع جاوا اسكريپت را معين كنيد تا به رويداد تغيير نام شيء پاسخ دهد:

ggbApplet.registerRenameListener("myRenameListenerFunction");

در صورت تغيير نام شيء  “A”به “B”، اپلت ژئوجبرا تابع جاوا اسكريپت زير را فراخواني مي كند:

call the Javascript function

myRenameListenerFunction("A", "B");

void registerRenameListener(String JSFunctionName)

تابع ثبت شده قبلي را حذف مي كند،

قسمت registerRenameListener() را ببينيد.

void unregisterRenameListener(String objName)

يك تابع جاوا اسكريپت را تعيين مي كند تا در صورت اتفاق افتادن رويداد clear در مورد اپلت مربوط به يك ترسيم اجرا شود. هر زمان ترسيم پاك شود (يعني تمام اشياء موجود در آن حذف شود) تابع جاوا اسكريپت JSFunctionName بدون آرگومان صدا زده مي شود.

توجه: تمام توابع پاسخ دهنده به رويداد update غير فعال مي شوند.

قسمت registerUpdateListener()

و registerRemoveListener() را ببينيد.

مثال: ابتدا يك تابع جاوا اسكريپت را معين كنيد تا به رويداد پاك شدن ترسيم پاسخ دهد:

ggbApplet.registerClearListener("myClearListenerFunction");

در صورت تغييرنام شيء    “A”به “B”، اپلت ژئوجبرا تابع جاوا اسكريپت زير را فراخواني مي كند:

myClearListenerFunction();

void registerClearListener(String JSFunctionName)

تابع ثبت شده قبلي را حذف مي كند،

قسمت registerClearListener() را ببينيد.

void unregisterClearListener(String JSFunctionName)

 

 

 

 


Related Topics

8.1 متدهاي قابل استفاده
مشاهده كردن اعمال كاربر
برقراري ارتباط بين دو اپلت ژئوجبرا

www.geogebra.org