قاموس أوامر الأكشن سكريبت Action Script

**hacks** · 09-20-2007, 06:52

بسم الله و الصلاة والسلام على رسول الله و على أهل بيته الطيبين الطاهرين ... أما بعد

لأنني أحب الأكشن ، وهو الذي سيجعلنا حقاً مبرمجين!!! فقررت أن أؤجل مشاركاتي في مواضيع أخرى، وأن أشارك وبقوة في هذا الموضوع ، وجئت لكم بهذه الفكرة :

إنشاء قاموس خاص بأوامر الأكشن سكريبت .. فحينما يضع الأخوان أي درس أو شرح عن أمر جديد في الأكشن سكريبت يخصص له مشاركة هنا، يعرض فيه الآتي:

- شرح البرنامج لهذه الأمر باللغة الأنجليزية .
- الترجمة العربية ( بالمعنى و ليست الترجمة الحرفية ) لهذا الشرح .
- المواضيع في واحتنا هذه التي تكلمت أو ذكر فيها هذا الأكشن .
- مثال مبسط عن هذا الأكشن .
- أي أسئلة يضيفها الأعضاء ، و أكيد الأجوبة عليها.
- ملفات المصدر fla الخاصة بهذ الأكشن أن تطلب الأمر.

لإظهار نافذة الأكشن اضغط F9 من لوحة المفاتيح أو Window > Actions ..

تستطيع إدراج أي أمر بالنقر المزدوج عليه من يسار النافذة
لنسخ أي كود مذكور في الغدير انسخه ثم اذهب إلي يمين النافذة وأنقر بزر الفأرة الأيمن واختر Paste

ولعرض شرح البرنامج لأي أمر حدده ثم اضغط على الزر.
======================
hacks

**hacks** · 09-20-2007, 06:59

Availability

Flash 2.

Usage

play()

Parameters

None.

Returns

Nothing.

Description

Action; moves the playhead forward in the Timeline

Example

The following code uses an if statement to check the value of a name the user enters. If the user enters Steve, the play action is called and the playhead moves forward in the Timeline. If the user enters anything other than Steve, the movie does not play and a text field with the variable name alert is displayed

كود PHP:

  stop(); 

if (name == "Steve") { 

    play(); 

} else { 

    alert="You are not Steve!"; 

}

الترجمة العربية:

متاح هذا الأكشن من الأصدار

Flash 2

الصيغة

play()

العوامل

لا يوجد .

ما يرجع به الأكشن

لا شيء .

الوصف

نوعه حدث Action ، يحرك رأس القراءة للأمام على خط الزمن .

مثال

الكود التالي يستخدم جملة if لاختبار قيمة أسم المستخدم المدخل .
أذا أدخل المستخدم stave ، يستدعى الحدث play و يتحرك رأس القراءة للأمام على خط الزمن .

إذا ادخل المستخدم أي شيء آخر غير stave ، مقطع الفيديو لن يشتغل / يعرض و حقل النص الممثل بالمتغير alert سيعرض النص التالي "You are not Steve!"

كود PHP:

  stop(); 

if (name == "Steve") { 

    play(); 

} else { 

    alert="You are not Steve!"; 

}

بواسطة الأخ الأستاذ : الطرماح

**hacks** · 09-20-2007, 07:00

متاح هذا الأكشن من الأصدار

Flash 2

الصيغة

stop

العوامل

لا يوجد .

ما يرجع به الأكشن

لا شيء .

الوصف

نوعه حدث Action ، يوقف الفلم الذي يعرض (يشتغل) حالياً .
أعظم الاستخدام الشائع لهذا الحدث هو لتحكم في مقطع فيديو و يكون هذا الحدث على زر .

بواسطة الأخ الأستاذ : الطرماح

**hacks** · 09-20-2007, 07:01

متاح هذا الأكشن من الأصدار

Flash 2

الصيغة

gotoAndPlay(scene, frame)

العوامل

scene المشهد ....... أسم المشهد الذي سيرسل رأس القراءة إليه .

frame إطار ....... رقم الإطار أو عنوانه الذي سيرسل رأس القراءة إليه .

ما يرجع به الأكشن

لا شيء .

الوصف

نوعه حدث Action ، يرسل رأس القراءة إلى الإطار المعين في مشهد و يعرض (يشغل) ذلك المشهد من ذلك الإطار .
إذا لم يعين المشهد ، فأن رأس القراءة سيتجه إلى الإطار المعين في نفس المشهد الحالي .

مثال

إذا ضغط المستخدم الزر الموجود بداخله الحدث gotoAndPlay ، سيتجه رأس القراءة إلى إطار رقم 16 و سوف يبدأ العرض .

كود PHP:

  on(release) { 

    gotoAndPlay(16); 

}

بواسطة الأخ الأستاذ : الطرماح

**hacks** · 09-20-2007, 07:03

متاح هذا الأكشن من الأصدار

Flash 2

الصيغة

gotoAndStop(scene, frame)

العوامل

scene المشهد ....... أسم المشهد الذي سيرسل رأس القراءة إليه .

frame إطار ....... رقم الإطار أو عنوانه الذي سيرسل رأس القراءة إليه .

ما يرجع به الأكشن

لا شيء .

الوصف

نوعه حدث Action ، يرسل رأس القراءة إلى الإطار المعين في مشهد و يوقف ذلك المشهد من ذلك الإطار .
إذا لم يعين المشهد ، فأن رأس القراءة سيتجه إلى الإطار المعين في نفس المشهد الحالي .

مثال

إذا ضغط المستخدم الزر الموجود بداخله الحدث gotoAndStop ، سيتجه رأس القراءة إلى إطار رقم 5 و سوف يتوقف العرض .

كود PHP:

  on(release) { 

    gotoAndStop(5); 

}

بواسطة الأخ الأستاذ : الطرماح

**hacks** · 09-20-2007, 07:04

متاح هذا الأكشن من الأصدار

Flash 2 ، و لكن ليس كل الأحداث events مدعومة في Flash 2

الصيغة

on(mouseEvent) {
statement(s);
}

العوامل

statement(s) جملة …… تعليمات تنفذ عندما أحداث الموس mouseEvent تقع (تحدث) .

mouseEvent حدث الفأرة .......هو تنبيه أو تغير الذي نسميه بالحدث"event."
عندما يقع الحدث ، سوف تنفذ الجمل التالية المحاطة بين قوسين { }

أي من القيم التالية يمكن أن يكون هو عامل mouseEvent :

• press الضغط ...... ضغط زر الفأرة بينما يكون المؤشر فوق الزر .
.
• release التحرير ...... تحرير ( إطلاق) زر الفأرة بينما يكون المؤشر فوق الزر .
.
• releaseOutside التحرير خارجا ...... تحرير ( إطلاق) زر الفأرة بينما يكون المؤشر خارج الزر ، بعد ضغط الزر ( بينما المؤشر داخله )ٍ.
.
• rollOut التمرير خارجاً ...... تمرير المؤشر خارج الزر(طبعاً بعد دخول المؤشر فوق الزر ) .
.
• rollOver التمرير فوق ...... تمرير المؤشر فوق الزر(أي بمجرد دخول المؤشر فوق الزر ) .
.
• dragOut السحب خارجاً ...... عندما يكون المؤشر فوق الزر ، تضغط زر الفأرة و تسحب للخارج .
.
• dragOver السحب فوق ...... عندما يكون المؤشر فوق الزر ، تضغط زر الفأرة و تسحب للخارج ثم تعود و تمرر مؤشر الفأرة مرة أخرى فوق الزر .

• keyPress ("key")ضغط مفتاح ...... ضغط مفتاح يتم تعينه من لوحة المفاتيح

.......... يوجد كلام لم أفهمه .........
أدخل إلى تعليمات البرنامج ( أضغط F1) ثم إلى التقسيم " Using Flash " ثم إلى الموضوع "Keyboard Keys and Key Code Values" ستجد قائمة بمواضيع خاصة بـ الكائن Key object

الوصف

نوعه حدث تحكم Action handler ، يعين حدث الفأرة أو ضغط المفتاح ، التأثير الذي سيحدث .

مثال

سوف أورد مثال آخر من عندي يكون أكثر إيضاحاً و فهماً...

قم بأنشاء ملف جديد ، مكون من طبقتين .
في الطبقة الأولى ضع شكل يتحرك ( كأن تكون دائرة تتحرك من اليمن إلى اليسار ) ،
في الطبقة الثانية أصنع زر ثم ضع بداخله الكود التالي :

شرح الكود ::: ستلاحظ انه عندما تدخل إلى الزر ستتوقف الحركة ، و عند الخروج منه سيتحرك الشكل .

كود PHP:

  on (rollOver) { 

    stop(); 

} 

on (rollOut) { 

    play(); 

}

بواسطة الأخ الأستاذ : الطرماح

**hacks** · 09-20-2007, 07:11

قاموس الأكشن : nextScene

الوظيفة المختصرة:
التوجه إلى المشهد التالي Go to the Next Scene

تستطيع الوصول للأمر في نافذة الأكشن من خلال أتباع التقسيم الآتي
Actions > Movie Control > nextScene

الصيغة [l]
nextScene( )
[/l]
العوامل
... لا يـــــــــــــــــوجــــــــــــــــــد

الوصف
يقوم هذا الأكشن بأرسال رأس القراءة إلى المشهد التالي للمشهد الحالي ؛ ثم يتوقف هناك

المثال :

1. قم بأنشاء ملف جديد ؛ ثم ضع فيه حركة بسيطة
2. ثم أذهب إلى آخر أطار في هذا المشهد و ضع الأمر stop
3. ثم ضع في طبقة جديدة زر و ضع بداخله الكود التالي

كود PHP:

  on (release) { 

    nextScene();

}

4. أضف مشهد جديد ؛ و ضع فيه حركة بسيطة .
ستجد أنه عند ضغط الزر سيتجه العرض إلى المشهد التالي و سيتوقف .

يمكنك تحميل المثال من المرفق

بواسطة الأخ الأستاذ : الطرماح

**hacks** · 09-20-2007, 07:19

قاموس الأكشن : prevScene

الوظيفة المختصرة:
التوجه إلى المشهد السابق Go to the Previous Scene

تستطيع الوصول للأمر في نافذة الأكشن من خلال أتباع التقسيم الآتي
Actions > Movie Control > prevScene

الصيغة [l]
prevScene( )
[/l]
العوامل
... لا يـــــــــــــــــوجــــــــــــــــــد

الوصف
يقوم هذا الأكشن بأرسال رأس القراءة إلى المشهد السابق للمشهد الحالي ؛ ثم يتوقف هناك

المثال :

1. قم بأنشاء ملف جديد ؛ ثم ضع فيه حركة بسيطة
2. ثم أذهب إلى آخر أطار في هذا المشهد و ضع الأمر stop
3. ثم ضع في طبقة جديدة زر و ضع بداخله الكود التالي

كود PHP:

  on (release) { 

    prevScene(); 

}

4. أضف مشهد جديد ؛ و ضع فيه حركة بسيطة .
ستجد أنه عند ضغط الزر سيتجه العرض إلى المشهد السابق و سيتوقف .

يمكنك تحميل نفس المثال السابق:

بواسطة الأخ الأستاذ : الطرماح
من شبكة هجر الثقافية

**hacks** · 09-20-2007, 07:28

الوظيفة المختصرة:
التوجه إلى الإطار التالي Go to the Next frame
تستطيع الوصول للأمر في نافذة الأكشن من خلال أتباع التقسيم الآتي
Actions > Movie Control > nextFrame

الصيغة [l]
nextFrame( )
[/l]
العوامل
... لا يـــــــــــــــــوجــــــــــــــــــد

الوصف
يقوم هذا الأكشن بأرسال رأس القراءة إلى الإطار التالي للإطار الحالي ؛ ثم يتوقف هناك

المثال :

قم بأنشاء ملف جديد ؛ ثم ضع فيه حركة بسيطة ؛ و ضع في طبقة جديدة زر و ضع بداخله الكود التالي
ستجد أنه كلما ضغط الزر سيتحرك العرض إطار واحد للأمام و سيتوقف .

كود PHP:

  on (release) { 

    nextFrame(); 

}

يمكنك تحميل المثال من المرفق
بواسطة الأستاذ: الطرماح من شبكة هجر

**hacks** · 09-20-2007, 07:31

قاموس الأكشن : prevFrame

الوظيفة المختصرة:
التوجه إلى الإطار السابق Go to the Previous frame

تستطيع الوصول للأمر في نافذة الأكشن من خلال أتباع التقسيم الآتي
Actions > Movie Control > prevFrame

الصيغة [l]
prevFrame( )
[/l]
العوامل
... لا يـــــــــــــــــوجــــــــــــــــــد

الوصف
يقوم هذا الأكشن بأرسال رأس القراءة إلى الإطار السابق للإطار الحالي ؛ ثم يتوقف هناك

المثال :

قم بأنشاء ملف جديد ؛ ثم ضع فيه حركة بسيطة ؛ و ضع في طبقة جديدة زر و ضع بداخله الكود التالي
ستجد أنه كلما ضغط الزر سيتحرك العرض إطار واحد للخلف و سيتوقف .

كود PHP:

  on (release) { 

    prevFrame(); 

}

يمكنك تحميل نفس المثال السابق
بواسطة الأستاذ: الطرماح من شبكة هجر

**hacks** · 09-20-2007, 07:37

الوظيفة المختصرة:
أرسال رسائل إلى نافذة المخرجات Sends a message to the Output window

تستطيع الوصول للأمر في نافذة الأكشن من خلال أتباع التقسيم الآتي
Actions > Miscellaneous Actions > trace

الصيغة
trace ( expression)

العوامل
expression (تعبير) ... قد يكون التعبير ثابت عددي أو ثابت نصي أو متغير عددي أو متغير نصي أو قيمة خاصية لكائن أو ناتج معادلة أو ناتج دالة أو خليط بين هذا و ذاك.

الوصف
عندما يفتح ملف SWF في برنامج فلاش ( عن طريق أمر Test Movie من قائمة Control أو بالضغط على Ctrl+Enter )، يقوم هذا الأمر بحساب قيمة التّعبير ويعرض النّتيجة في نافذة المخرجات Output Window في وضع الإختبار test mode .

يمكن أستخدام الأمر trace لتسجيل ملاحظات البرمجة أو لعرض رسائل في نافذة المخرجات Output أو لتأكّد إن شرط ما تنفذ ؟ ، أو لعرض قيم لخصية كائن في نافذة المخر