الدوال العامه الجزء 3

الإعلانات

الدوال العامه

 

 

الدوال العامه الجزء 3

 

onActionModeStarted

أُضيفت في المستوى 11.

public void onActionModeStarted (ActionMode mode)

 

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

إذا قمت بتجاوز هذه الداله، فيجب عليك الإستدعاء من خلال التنفيذ الفائق.

الباراميتر
mode ActionMode: وضع الإجراء الجديد.

 

 

 

 

 

onActivityReenter

أُضيفت في المستوى 21.

public void onActivityReenter (int resultCode, 
                Intent data)

تستدعى عندما، يقوم النشاط الذي بدأته بإستخدام إنتقال نشاط، بكشف هذا النشاط من خلال إرجاع إنتقال النشاط، مما يعطيك “كود النتيجه” resultCode وأي بيانات إضافية منه.

لن تستدعى هذه الدالة إلا إذا قام النشاط بتعيين كود نتيجه غير RESULT_CANCELED  و يدعم إنتقالات النشاط بإستخدام Window#FEATURE_ACTIVITY_TRANSITIONS

 

الغرض من هذه الوظيفة هو السماح للنشاط المُستدعى، أن يقوم بإرسال تلميح عن حالته، بحيث يمكن لهذا النشاط الفرعي أن يستعد للكشف “العرض”.

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

ولديها بعض البيانات لتمريرها لكي يتم إعدادها.

 

الباراميتر
resultCode int: عدد صحيح بكود النتيجه، يتم إرجاعه بواسطة النشاط الفرعي من خلال ()setResult الخاصة به.
data Intent: غرض، والذي يمكنه إرجاع بيانات النتيجة إلى المستدعي (يمكن إرفاق بيانات مختلفة بالغرض “إضافات”).

 

 

 

 

 

onAttachFragment

أُضيفت في المستوى 11.

تم إيقافها في المستوى 28.

public void onAttachFragment (Fragment fragment)
تم إيقاف هذه الدالة في المستوى 28.

إستخدم

(FragmentActivity.onAttachFragment(android.support.v4.app.Fragment

تستدعى عندما يتم إرفاق شظيه بهذا النشاط، مباشرة بعد إستدعاء دالة Fragment#onAttach الخاصة بها، وقبل Fragment#onCreate.

الباراميتر
fragment Fragment

 

 

 

 

onAttachedToWindow

أُضيفت في المستوى 5.

public void onAttachedToWindow ()

تستدعى عندما يتم إرفاق النافذه الرئيسية، المرتبطه بالنشاط، بمدير النوافذ. راجع ()View#onAttachedToWindow لمزيد من المعلومات.

أنظر أيضاً:

()View.onAttachedToWindow

 

 

 

 

onBackPressed

أُضيفت في المستوى 5.

public void onBackPressed ()

تستدعى عندما يكتشف النشاط ضغط المستخدم على مفتاح الرجوع. يقوم التنفيذ الإفتراضي بإنهاء النشاط الحالي ببساطه، ولكن بإمكانك تجاوز هذا للقيام بما تريد.

 

 

 

 

onConfigurationChanged

أُضيفت في المستوى 1.

public void onConfigurationChanged (Configuration newConfig)

 

تستدعى بواسطة النظام، عند تغير تكوين الجهاز أثناء تشغيل نشاطك. لاحظ أن هذه لن يتم إستدعاؤها إلا إذا قمت بتحديد التكوينات..

التي تريد التعامل معها، بإستخدام السمه R.attr.configChanges، في ملف الإيضاح الخاص بك.

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

في الوقت الذي تم فيه إستدعاء هذه الوظيفه، كائن المصادر الخاص بك، سوف يتم تحديثه، لإرجاع قيم المصادر المتطابقه مع التكوين الجديد. 

 

الباراميتر
newConfig Configuration: التكوين الجديد للجهاز. يجب ألا تكون هذه القيمة فارغة أبداً.

 

 

 

 

 

 

onContentChanged

أُضيفت في المستوى 1.

public void onContentChanged ()

يستدعى هذا الخطاف، متى ما تغير محتوى عرض الشاشه (بسبب إستدعاء

(Window#setContentView(View, android.view.ViewGroup.LayoutParams أو 

(Window#addContentView(View, android.view.ViewGroup.LayoutParams).

 

 

 

 

 

 

onContextItemSelected

أُضيفت في المستوى 1.

public boolean onContextItemSelected (MenuItem item)

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

( إستدعاء العنصر Runnable أو إرسال رسالة إلى معالجه إن كان ذلك ملائماً).

يمكنك إستخدام هذه الداله لأي عناصر، ترغب في معالجتها بدون تلك التجهيزات “facilities” الأخرى.

 

إستخدم ()MenuItem#getMenuInfo للحصول على معلومات إضافيه، تم تعيينها بواسطة المعاينه، التي قامت بإضافة عنصر القائمة هذا.

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

الباراميتر
item MenuItem: عنصر قائمة السياق الذي تم تحديده. يجب ألا تكون هذه القيمه فارغه.
النتائج
boolean قيمة منطقيه تقوم بإرجاع “خطأ” للسماح بمعالجة قائمة السياق العاديه بالمواصله. و “صحيح” ليتم إستهلاكها هنا.

 

 

 

 

 

onContextMenuClosed

أُضيفت في المستوى 1.

 

public void onContextMenuClosed (Menu menu)

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

الباراميتر
menu Menu: قائمة السياق التي يتم إغلاقها. يجب ألا تكون هذه القيمه فارغة أبداً.

 

 

 

 

 

 

onCreate

أُضيفت في المستوى 21.

public void onCreate (Bundle savedInstanceState, 
                PersistableBundle persistentState)

مشابهه لـ (onCreate(android.os.Bundle لكنها تستدعى لتلك الأنشطة التي تم إنشاؤها بواسطة السمه R.attr.persistableMode المعينه إلى persistAcrossReboots.

الباراميتر
savedInstanceState Bundle: إذا تمت إعادة تهيئة النشاط، بعد إيقاف تشغيله مسبقاً، فإن هذه الحزمة ستحتوي على..

البيانات التي تقديمها مؤخراً في (onSaveInstanceState(Bundle.

ملاحظة: خلاف ذلك ستقوم بإرجاع فارغ. هذه القيمه قد تكون فارغه.

persistentState PersistableBundle: إذا تمت إعادة تهيئة النشاط، بعد إيقاف تشغيله أو إنهاؤه مسبقاً، فإن هذه الحزمة ستحتوي على..

البيانات التي تم تقديمها مؤخراً لـ outPersistentState في (onSaveInstanceState(Bundle.

ملاحظه: خلاف ذلك ستقوم بإرجاع فارغ. هذه القيمه قد تكون فارغه.

أنظر أيضاً:

 


 

 

 

 

onCreateContextMenu

أُضيفت في المستوى 1.

public void onCreateContextMenu (ContextMenu menu, 
                View v, 
                ContextMenu.ContextMenuInfo menuInfo)

تستدعى عندما يكون سياق القائمه الخاص بالمعاينه على وشك أن يُعرض. على عكس (onCreateOptionsMenu(android.view.Menu..

سوف يتم إستدعاء هذه الداله في كل مره، تكون فيها قائمة السياق على وشك أن تعرض، ويجب ملؤها للعرض “المعاينه”..

(أو عنصر بداخل المعاينه للفئات الفرعية لـAdapterView، وهذه يمكن العثور عليها في menuInfo).

إستخدم (onContextItemSelected(android.view.MenuItem للمعرفة متى ما تم إختيار عنصر.

ليس من الآمن الإحتفاظ بقائمة السياق بعد إرجاع هذه الداله.

الباراميتر
menu ContextMenu: قائمة السياق التي يتم بناؤها.
v View: المعاينه التي من أجلها يتم بناء قائمة السياق.
menuInfo ContextMenu.ContextMenuInfo: معلومات إضافية، حول العنصر الذي يجب عرض قائمة السياق به.

هذه المعلومات سوف تختلف تبعاً لإختلاف الفئه v.

 

 

 

 

 

 

 

onCreateDescription

أُضيفت في المستوى 1.

public CharSequence onCreateDescription ()

تقوم بإنشاء وصف جديد لهذا النشاط. تستدعى هذه الداله قبل إيقاف النشاط، وعندما ترغب يمكن إرجاع بعض الوصف النصي، للحاله الحاليه للنشاط، لكي يتم عرضها للمستخدم.

التنفيذ الإفتراضي يقوم بإرجاع “فارغ”، مما سيجعلك ترث الوصف من النشاط السابق. إذا قامت كافة الأنشطة بإرجاع “فارغ”، فسوف يتم إستخدام مسمى النشاط العلوي، كوصف، عادة.

 

النتائج
CharSequence وصف لما يقوم به المستخدم. يجب أن يكون مختصر ومفيد (فقط بضع كلمات).

 

أنظر أيضاً:


 

 

 

 

 

onCreateNavigateUpTaskStack

أُضيفت في المستوى 16.

public void onCreateNavigateUpTaskStack (TaskStackBuilder builder)

تقوم بتحديد تركيب كومة المهام، التي سيتم إنشاؤها أثناء الإنتقال من مهمة مختلفة.

التنفيذ الإفتراضي لهذه الداله، يقوم بإضافة السلسلة الأصل لهذا النشاط، كما هو محدد في ملف إيضاح التطبيق، إلى TaskStackBuilder المزود.

قد تختار التطبيقات تجاوز هذه الداله، لإنشاء كومة المهام المطلوبه، بطريقة مختلفه.

 

سوف تستدعى هذه الداله، بواسطة التنفيذ الإفتراضي لـ ()onNavigateUp إذا قامت (shouldUpRecreateTask(android.content.Intent بإرجاع “صحيح”..

عند تزويدها بالغرض المرجع بواسطة ()getParentActivityIntent.

التطبيقات التي ترغب في توفير باراميترات “معامل” غرض إضافيه، إلى الكومه الأصليه المعرفة بواسطة ملف الإيضاح، يجب أن تتجاوز (onPrepareNavigateUpTaskStack(android.app.TaskStackBuilder.

 

الباراميتر
builder TaskStackBuilder: هي TaskStackBuilder فارغه – يجب على التطبيق أن يضيف الأغراض التي تمثل كومة المهام المطلوبه.

 

 

 

 

 

 

 

onCreateOptionsMenu

أُضيفت في المستوى 1.

public boolean onCreateOptionsMenu (Menu menu)

تقوم بتهيئة محتويات، قائمة الخيارات القياسيه للنشاط. يجب عليك وضع عناصر القائمة الخاصة بك في القائمه.

هذه الدالة تستدعى مرة واحدة فقط، في المرة الأولى التي يتم فيها عرض قائمة الخيارات. لتحديث القائمة في كل مرة يتم فيها عرضها، راجع (onPrepareOptionsMenu(Menu.

يقوم التنفيذ الإفتراضي بملأ القائمه، بعناصر قائمة النظام القياسيه. وهذه يتم وضعها في مجموعة Menu#CATEGORY_SYSTEM..

بحيث يتم ترتيبها بشكلٍ صحيح، عناصر القائمة المحددة بالتطبيق. يجب دائماً إستدعاء الفئات الفرعية من خلال التنفيذ الأساسي.

يمكنك الإحتفاظ بالقائمة، بأمان (وأي عناصر تم إنشاؤها منها)، وإجراء تعديلات عليها حسب الحاجه، حتى يتم إستدعاء onCreateOptionsMenu في المرة التاليه.

عندما تقوم بإضافة عناصر إلى القائمه، يمكنك تنفيذ دالة النشاط (onOptionsItemSelected(MenuItem، للإحتفاظ بهم هناك.

الباراميتر
menu Menu: قائمة الخيارات التي تضع فيها عناصرك.
النتائج
boolean يجب عليك إعادة “صحيح” لقائمة لكي يتم عرضها؛ إذا قمت بإعادة “خطأ” فلن تظهر.

 

أنظر أيضاً:

(onPrepareOptionsMenu(Menu

(onOptionsItemSelected(MenuItem

 


 

 

 

 

 

 

onCreatePanelMenu

أُضيفت في المستوى 1.

public boolean onCreatePanelMenu (int featureId, 
                Menu menu)

التنفيذ الإفتراضي لـ(Window.Callback.onCreatePanelMenu(int, Menu للأنشطة، تستدعى هذه من خلال دالة (onCreateOptionsMenu(Menu الجديدة، للوحه Window.FEATURE_OPTIONS_PANEL..

بحيث لا تحتاج الفئات الفرعية للنشاط، للتعامل مع أكواد الخصائص.

 

الباراميتر
featureId int: اللوحة التي يتم إنشاؤها.
menu Menu: يجب ألا تكون هذه القيمة فارغة أبداً.
النتائج
boolean قيمة منطقيه، يجب أن تقوم بإرجاع “صحيح” للوحه لكي يتم عرضها؛ إذا قمت بإرجاع “خطأ” فلن يتم عرضها.

 

 

 

 

 

 

 

onCreatePanelView

أُضيفت في المستوى 1.

public View onCreatePanelView (int featureId)

 

التنفيذ الإفتراضي لـ(Window.Callback.onCreatePanelView(int للأنشطه. هذا ببساطه يقوم بإرجاع “فارغ”، بحيث يكون لكافة النوافذ الفرعية الخاصة باللوحه، سلوك القائمة الإفتراضي.

الباراميتر
featureId int: أي لوحة يتم إنشاؤها.
النتائج
View عرض، عرض المستوى الأعلى لوضعه في اللوحه.

 

 

 

 

 

 

onCreateThumbnail

أُضيفت في المستوى 1.

تم إيقافها في المستوى 28.

public boolean onCreateThumbnail (Bitmap outBitmap, 
                Canvas canvas)
تم إيقاف هذه الدالة في المستوى 28.

هذه الداله لا تفعل شيئاً وستتم إزالتها في المستقبل.

الباراميتر
outBitmap Bitmap
canvas Canvas
النتائج
boolean

 

 

 

 

 

 

 

onCreateView

أُضيفت في المستوى 11.

public View onCreateView (View parent, 
                String name, 
                Context context, 
                AttributeSet attrs)

تنفيذ قياسي لـ (LayoutInflater.Factory2.onCreateView(View, String, Context, AttributeSet، يستخدم عند التضخيم بإستخدام LayoutInflater..

المًرجعه بواسطة (Context.getSystemService(Class. يقوم هذا التنفيذ بالتعامل مع الوسوم لتضمين الشظايا بداخل النشاط.

الباراميتر
parent View: قد تكون هذه القيمة فارغه.
name String: يجب ألا تكون هذه القيمة فارغة أبداً.
context Context: يجب ألا تكون هذه القيمة فارغة أبداً.
attrs AttributeSet: يجب ألا تكون هذه القيمة فارغة أبداً.
النتائج
View قد تكون هذه القيمة فارغه.

أنظر أيضاً:

(LayoutInflater.createView(String, String, AttributeSet

()Window.getLayoutInflater


 

 

 

 

 

onCreateView

أُضيفت في المستوى 1.

public View onCreateView (String name, 
                Context context, 
                AttributeSet attrs)

تنفيذ قياسي لـ(LayoutInflater.Factory.onCreateView(String, Context, AttributeSet المستخدمه عند التضخيم بإستخدام LayoutInflater، المرجعة بواسطة (Context.getSystemService(Class.

هذا التنفيذ لا يفعل شيئاً، وهو للتطبيقات ما قبل Build.VERSION_CODES.HONEYCOMB. التطبيقات الأحدث يجب أن تستخدم

(onCreateView(android.view.View, java.lang.String, android.content.Context, android.util.AttributeSet.

الباراميتر
name String: يجب ألا تكون هذه القيمة فارغة أبداً.
context Context: يجب ألا تكون هذه القيمة فارغة أبداً.
attrs AttributeSet: يجب ألا تكون هذه القيمة فارغة أبداً.
النتائج
View قد تكون هذه القيمة فارغه.

أنظر أيضاً:

(LayoutInflater.createView(String, String, AttributeSet

()Window.getLayoutInflater


 

 

 

 

 

 

onDetachedFromWindow

أُضيفت في المستوى 5.

public void onDetachedFromWindow ()

تستدعى عندما يتم فصل النافذة الرئيسية المرتبطة بالنشاط، عن مدير النوافذ. راجع ()View#onDetachedFromWindow لمزيد من المعلومات.

أنظر أيضاً:

()View.onDetachedFromWindow

 

 

 

 

 

 

onEnterAnimationComplete

أُضيفت في المستوى 21.

public void onEnterAnimationComplete ()

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

التي سوف تستدعى عند إكتمال حركات الدخول.

 

 

 

 

 

الدوال العامه الجزء 3

onGenericMotionEvent

أُضيفت في المستوى 12.

public boolean onGenericMotionEvent (MotionEvent event)

تستدعى عندما لا يتم التعامل مع حدث الحركة العام بواسطة أي من المعاينات بداخل النشاط.

أحداث الحركة العامه تصف: حركات عصا التحكم، تأرجح الفأره، تتبع لمسات لوح الفأرة “pad”، حركات عجلة التمرير، وأحداث الإدخال الأخرى.

دالة ()MotionEvent#getSource الخاصة بأحداث الحركة، تحدد فئة المدخلات التي تم إستلامها. تنفيذات هذه الدالة يجب أن تفحص “البت bits” في المصدر قبل معالجة الحدث.

 

المثال التالي من الكود يوضح كيف يتم ذلك. يتم تسليم أحداث الحركة العامة بإستخدام فئة المصدر InputDevice.SOURCE_CLASS_POINTER، إلى المعاينة الموجودة تحت المؤشر.

يتم تسليم كافة أحداث الحركة العامه الأخرى إلى المعاينه المرّكزة.

راجع (View#onGenericMotionEvent(MotionEvent للحصول على مثال عن كيفية التعامل مع هذا الحدث.

الباراميتر
event MotionEvent: حدث الحركة العام، قيد المعالجه.
النتائج
boolean تقوم بإرجاع “صحيح” إذا قمت بإستهلاك الحدث، و “خطأ” إذا لم تفعل.

التنفيذ الإفتراضي يُرجع “خطأ” دائماً.

 

 

 

 

 

 

onKeyDown

أُضيفت في المستوى 1.

public boolean onKeyDown (int keyCode, 
                KeyEvent event)

تستدعى عندما يتم الضغط على مفتاح، ولا يتم التعامل معه بواسطة أي من المعاينات بداخل النشاط. لذا، كمثال..

الضغط على المفتاح أثناء وجود المؤشر بداخل TextView لن يؤدي إلى تشغيل الحدث (إلا إذا تنقل إلى كائن آخر)..

لأن TextView تتعامل مع ضغطة المفتاح الخاصة بها. إذا لم تكن المعاينة المركة ترغب بهذا الحدث، فسيتم إستدعاء هذه الداله.

التنفيذ الإفتراضي يعتني بـKeyEvent#KEYCODE_BACK، عن طريق إستدعاء ()onBackPressed..

على الرغم من أن السلوك يختلف بناءً على وضع توافق التطبيقات: لـ Build.VERSION_CODES.ECLAIR أو التطبيقات الأحدث..

سيتم إعداد الإرسال لإستدعاء (onKeyUp(int, KeyEvent حيث سيتم تنفيذ الإجراء؛ بالنسبة للتطبيقات السابقه، سيتم تنفيذ الإجراء فوراً، بنفس سلوك تلك الإصدارات من النظام.

قد يتم تنفيذ، معالجة إفتراضية إضافية، أخرى، إذا تم تكوينها بإستخدام (setDefaultKeyMode(int.

 

الباراميتر
keyCode int: القيمة في ()event.getKeyCode.
event KeyEvent: وصف لحدث رئيسي.
النتائج
boolean تقوم بإرجاع “صحيح” لمنع هذا الحدث من الإنتشار بشكلٍ أكبر، أو “خطأ” للإشارة إلى أنك لم تتعامل مع هذا الحدث، ويجب أن يستمر نشره.

أنظر أيضاً:

(onKeyUp(int, KeyEvent

KeyEvent


 

 

 

 

الدوال العامه الجزء 3

onKeyLongPress

أُضيفت في المستوى 5.

public boolean onKeyLongPress (int keyCode, 
                KeyEvent event)

التنفيذ الإفتراضي لـ (KeyEvent.Callback#onKeyLongPress(int, KeyEvent: دائماً تُرجع “خطأ”، (لا تتعامل مع الحدث).

الباراميتر
keyCode int: القيمة في ()event.getKeyCode.
event KeyEvent: وصف لحدث رئيسي.
النتائج
boolean إذا تعاملت مع الحدث، تُرجع “صحيح”. إذا أردت السماح للحدث بأن يتم التعامل معه بواسطة المستقبل التالي، تُرجع “خطأ”.

 


 

 

 

 

 

onKeyMultiple

أُضيفت في المستوى 1.

public boolean onKeyMultiple (int keyCode, 
                int repeatCount, 
                KeyEvent event)

تنفيذ إفتراضي لـ (KeyEvent.Callback#onKeyMultiple(int, int, KeyEvent: تقوم دائماً بإرجاع “خطأ” (لا تتعامل مع الحدث).

الباراميتر
keyCode int: القيمة في ()event.getKeyCode.
repeatCount int: عدد الأزواج كما هي مُرجعه بواسطة ()event.getRepeatCount.
event KeyEvent: وصف لحدث رئيسي.
النتائج
boolean إذا تعاملت مع الحدث، تُرجع “صحيح”. إذا أردت السماح للحدث بأن يتم التعامل معه بواسطة المستقبل التالي، تُرجع “خطأ”.

 

 

 

 

 

 

onKeyShortcut

أُضيفت في المستوى 11.

public boolean onKeyShortcut (int keyCode, 
                KeyEvent event)

تستدعى عندما لا يتم التعامل مع، حدث إختصار رئيسي، بواسطة أي من المعاينات بداخل النشاط. يتم تجاوز هذه الداله لتنفيذ، الإختصارات الرئيسيه العامه، للنشاط. 

يمكن أيضاً تنفيذ الإختصارات الرئيسيه، من خلال تعيين الخاصية (MenuItem#setShortcut(char, char لعناصر القائمه.

الباراميتر
keyCode int: القيمة في ()event.getKeyCode.
event KeyEvent: وصف لحدث رئيسي.
النتائج
boolean ترجع “صحيح” إذا تم التعامل مع الإختصار الرئيسي.

 

 

 

 

 

 

onKeyUp

أُضيفت في المستوى 1.

public boolean onKeyUp (int keyCode, 
                KeyEvent event)

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

لن يؤدي إلى تشغيل الحدث (ما لم ينتقل إلى كائن آخر)، لأن TextView يتعامل مع ضغطات المفتاح الخاصة به.

 

التنفيذ الإفتراضي يعالج KEYCODE_BACK لإيقاف النشاط و الرجوع.

الباراميتر
keyCode int: القيمة في ()event.getKeyCode.
event KeyEvent: وصف لحدث رئيسي.
النتائج
boolean ترجع “صحيح” لكي تمنع هذا الحدث من الإنتشار بشكلٍ أكبر، أو “خطأ” للإشارة بأنك لم تتعامل مع هذا الحدث..

ويجب أن يستمر نشره.

 

أنظر أيضاً:

(onKeyDown(int, KeyEvent

KeyEvent


 

 

 

 

الدوال العامه الجزء 3

onLocalVoiceInteractionStarted

أُضيفت في المستوى 24.

public void onLocalVoiceInteractionStarted ()

إستدعاء، للإشارة إلى أن (startLocalVoiceInteraction(android.os.Bundle قد أدت إلى بدء جلسة تفاعل صوتي.

يمكنك الآن إستيراد تفاعل صوتي بإستخدام ()getVoiceInteractor.

 

 

 

 

 

 

onLocalVoiceInteractionStopped

أُضيفت في المستوى 24.

public void onLocalVoiceInteractionStopped ()

إستدعاء، للإشارة إلى أن التفاعل الصوتي المحلي قد توقف، إما بسبب طلب إيقافه بواسطة ()stopLocalVoiceInteraction، أو بسبب إلغاؤه بواسطة المستخدم.

لم تعد VoiceInteractor المكتسبه سابقاً، صالحة بعد هذه.

 

 

 

 

 

الدوال العامه الجزء 3

 

onLowMemory

أُضيفت في المستوى 1.

public void onLowMemory ()

تستدعى عندما يكون النظام بالكامل، يعمل على ذاكرة منخفضه، وينبغي على العمليات النشطة أن تخفض من إستهلاكها للذاكرة.

على الرغم من أن المرحلة المحددة، التي ستقوم هذه الدالة بإستدعائها، غير محددة، سوف تحدث عادة، عندما يتم إنهاء كافة العمليات الموجودة في الخلفيه.

وهو، قبل الوصول إلى مرحلة إنهاء عمليات، الخدمة المستضافه، وأمام واجهة المستخدم الأماميه التي نرغب في تجنب إنهاؤها.

يجب عليك تنفيذ هذه الداله، لتحرير أي ذاكرة تخزين مؤقت، أو غيرها من المصادر الغير ضرورية والتي قد تكون مُحتفظ بها.

سيقوم النظام بإجراء عملية تجميع المهملات من أجلك، بعد الإرجاع من هذه الداله.

يفضل، أن تقوم بتنفيذ ComponentCallbacks2#onTrimMemory من ComponentCallbacks2 لتفريغ مصادرك تدريجياً، بناءً على مستويات مختلفة من متطلبات الذاكرة.

تتوفر واجهة برمجة التطبيقات هذه، للمستوى 14 من واجهة برمجة التطبيقات أو أعلى، لذا يجب عليك إستخدام دالة ()onLowMemory هذه فقط، كنسخة إحتياطيه للإصدارات الأقدم.

والتي يمكن التعامل معها كـ ComponentCallbacks2#onTrimMemory مع المستوى ComponentCallbacks2#TRIM_MEMORY_COMPLETE.

 


 

 

 

 

 

onMenuItemSelected

أُضيفت في المستوى 1.

public boolean onMenuItemSelected (int featureId, 
                MenuItem item)

تنفيذ أفتراضي لـ(Window.Callback.onMenuItemSelected(int, MenuItem للأنشطة.

تستدعى هذه عبر الداله الجديده (onOptionsItemSelected(MenuItem، للوحه Window.FEATURE_OPTIONS_PANEL، بحيث لا تحتاج الفئات الفرعية للنشاط، إلى التعامل مع أكواد الخصائص.

الباراميتر
featureId int: اللوحة التي توجد بها القائمه.
item MenuItem: يجب ألا تكون هذه القيمة فارغة أبداً.
النتائج
boolean ترجع “صحيح” لكي تنهي المعالجة المحددة، أو “خطأ” لتنفيذ معالجة القائمة العاديه..

(إستدعاء Runnable الخاصة بها أو ترسل رسالة إلى معالجها المستهدف).

 

 

 

 

 

 

onMenuOpened

أُضيفت في المستوى 1.

public boolean onMenuOpened (int featureId, 
                Menu menu)

تستدعى عندما يتم فتح لوحة القائمه من قبل المستخدم. وقد تستدعى أيضاً عند تغيير القائمة من نوع إلى آخر (مثال، من قائمة الأيقونات إلى القائمة الموسعه).

الباراميتر
featureId int: اللوحة التي توجد بها القائمه.
item MenuItem: يجب ألا تكون هذه القيمة فارغة أبداً.
النتائج
boolean التنفيذ الإفتراضي يرجع القيمة “صحيح”.

 

 

 

 

 

الدوال العامه الجزء 3

onMultiWindowModeChanged

أُضيفت في المستوى 24.

تم إيقافها في المستوى 26.

public void onMultiWindowModeChanged (boolean isInMultiWindowMode)
تم إيقاف هذه الدالة في المستوى 26.

إستخدم (onMultiWindowModeChanged(boolean, android.content.res.Configuration بدلاً منها.

 

تستدعى بواسطة النظام عندما يتغير النشاط من وضع ملء الشاشة، إلى وضع تعدد النوافذ والعكس.

الباراميتر
isInMultiWindowMode boolean: ترجع “صحيح” إذا كان النشاط في وضع تعدد النوافذ.

أنظر أيضاً:

R.attr.resizeableActivity

 

 

 

 

 

 

onMultiWindowModeChanged

أُضيفت في المستوى 26.

public void onMultiWindowModeChanged (boolean isInMultiWindowMode, 
                Configuration newConfig)

تستدعى بواسطة النظام عندما يتغير النشاط من وضع ملء الشاشة، إلى وضع تعدد النوافذ والعكس.

توفر هذه الداله نفس التكوين الذي سيتم إرساله في الإستدعاء التالي (onConfigurationChanged(android.content.res.Configuration، بعد دخول النشاط إلى هذا الوضع.

الباراميتر
isInMultiWindowMode boolean: ترجع “صحيح” إذا كان النشاط في وضع تعدد النوافذ.
newConfig Configuration: التكوين الجديد للنشاط مع الحاله.

أنظر أيضاً:

R.attr.resizeableActivity


 

 

 

الدوال العامه الجزء 3

onNavigateUp

أُضيفت في المستوى 16.

public boolean onNavigateUp ()

تستدعى هذه الداله، كلما إختار المستخدم التنقل لأعلى، بداخل التسلسل الهرمي لنشاط تطبيقك، من خلال شريط الإجراءات.

إذا كانت السمه parentActivityName محددة في ملف إيضاح هذا النشاط أو النشاط المستعار له، فسيتم التعامل مع التنقل لأعلى الإفتراضي تلقائياً.

إذا تطلب أي نشاط موجود على إمتداد السلسلة الأصل، أي معطيات غرض إضافيه، فيجب أن تتخطى الفئة الفرعية للنشاط الداله..

(onPrepareNavigateUpTaskStack(android.app.TaskStackBuilder.. لتوفير هذه المعطيات.

راجع المهام والكومة الخلفيه من دليل المطورين و التنقل من دليل التصميم لمزيد من المعلومات عن التنقل بداخل تطبيقك.

راجع فئة TaskStackBuilder و دوال النشاط ()getParentActivityIntent، 

(shouldUpRecreateTask(android.content.Intent و (navigateUpTo(android.content.Intent

للمساعدة في تنفيذ تنقل مخصص لأعلى.

نموذج التطبيق AppNavigation في حزمة SDK للأندرويد، متوفر أيضاً كمرجع.

النتائج
boolean ترجع “صحيح” إذا أكتمل التنقل لأعلى بنجاح، وتم إنهاء هذا النشاط، خلاف ذلك، ترجع “خطأ”.

 


أضغط على اسم الداله للإطلاع على المقال باللغة الإنجليزيه.

 

الإعلانات