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

الإعلانات

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

 

 

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

setTurnScreenOn

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

public void setTurnScreenOn (boolean turnScreenOn)

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

ولكن عند تعيين هذه العلامه، سوف يؤدي النشاط إلى تشغيل الشاشه، إذا كان النشاط مرئياً، وتم إستئنافه بسبب ظهور الشاشه.

لن تشتغل الشاشه، إذا لم يكن النشاط مرئياً، بعد تشغيل الشاشه. تستخدم هذه العلامه عادة، مقترنة مع علامة R.attr.showWhenLocked ..

للتأكد من أن النشاط مرئي، بعد تشغيل الشاشه، عند ظهور شاشة القفل.

بالإضافه إلى ذلك، إذا تم تعيين هذه العلامه وقام النشاط بإستدعاء

KeyguardManager#requestDismissKeyguard(Activity, KeyguardManager.KeyguardDismissCallback

فسيتم تشغيل الشاشه.

 

الباراميتر
turnScreenOn boolean: تكون “صحيح” لتشغيل الشاشه؛ و “خطأ” خلاف ذلك.

أنظر أيضاً:

  • (setShowWhenLocked(boolean
  • R.attr.turnScreenOn
  • R.attr.showWhenLocked

 


setVisible

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

public void setVisible (boolean visible)

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

ولكن لا يمكنه الإنتهاء قبل ()onResume لأنه بحاجة لإنتظار ربط خدمة أو شيء مماثل.

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

القيمة الإفتراضية لها مأخوذة من السمه R.attr.windowNoDisplay الخاصة بثيم النشاط. 

الباراميتر
visible boolean

 

 

setVolumeControlStream

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

public final void setVolumeControlStream (int streamType)

تقترح التدفق الصوتي الذي يجب تغيير مستواه الصوتي، بواسطة مفاتيح التحكم بمستوى الصوت الخاصة بالجهاز.

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

ليس مضموناً أن تقوم مفاتيح التحكم بمستوى الصوت الخاصة بالجهاز، بتغيير مستوى صوت هذا التدفق دائماً..

(مثال، إذا كانت هناك مكالمة هاتفيه تجري، فقد يتم تغيير مستوى صوت التدفق الخاص بها بدلاً من ذلك).

للعودة إلى التعيين الإفتراضي، إستخدم AudioManager#USE_DEFAULT_STREAM_TYPE.

الباراميتر
streamType int: نوع التدفق الصوتي الذي يجب تغيير مستواه، بواسطة مفاتيح التحكم بالصوت الخاصة بالجهاز.

 

 

 

 

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

setVrModeEnabled

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

public void setVrModeEnabled (boolean enabled, 
                ComponentName requestedComponent)

تقوم بتمكين أو تعطيل وضع الواقع الإفتراضي (VR) لهذا النشاط.

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

من المستحسن أن تقوم التطبيقات بالإعلان عن R.attr.enableVrMode في ملفات إيضاحها، للسماح بإنتقالات النشاط السلسه عند التبديل بين أنشطة الواقع الإفتراضي.

إذا كان مكون VrListenerService المطلوب غير متاح، فلن يتم بدء وضع الواقع الإفتراضي. يمكن للمطورين التعامل مع هذه الحاله كما يلي: 

String servicePackage = "com.whatever.app";
String serviceClass = "com.whatever.app.MyVrListenerService";

// Name of the component of the VrListenerService to start.
ComponentName serviceComponent = new ComponentName(servicePackage, serviceClass);

try {
   setVrModeEnabled(true, myComponentName);
} catch (PackageManager.NameNotFoundException e) {
       List<ApplicationInfo> installed = getPackageManager().getInstalledApplications(0);
       boolean isInstalled = false;
       for (ApplicationInfo app : installed) {
           if (app.packageName.equals(servicePackage)) {
               isInstalled = true;
               break;
           }
       }
       if (isInstalled) {
           // Package is installed, but not enabled in Settings.  Let user enable it.
           startActivity(new Intent(Settings.ACTION_VR_LISTENER_SETTINGS));
       } else {
           // Package is not installed.  Send an intent to download this.
           sentIntentToLaunchAppStore(servicePackage);
       }
}

 

الباراميتر
enabled boolean: “صحيح” لتمكين هذا الوضع.
requestedComponent ComponentName: اسم المكون المراد إستخدامه كـ VrListenerService..

أثناء تمكين وضع الواقع الإفتراضي. يجب ألا تكون هذه القيمة فارغة أبداً.

الإلقاء
PackageManager.NameNotFoundException إذا لم يتم تثبيت المكون المعطى للتشغيل كـVrListenerService..

أو لم يتم تمكينه في إعدادات المستخدم.

 

أنظر أيضاً:

PackageManager.FEATURE_VR_MODE_HIGH_PERFORMANCE

VrListenerService

Settings.ACTION_VR_LISTENER_SETTINGS

R.attr.enableVrMode

 


 

shouldShowRequestPermissionRationale

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

public boolean shouldShowRequestPermissionRationale (String permission)

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

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

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

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

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

الباراميتر
permission String: إذن يريد تطبيقك طلبها. يجب ألا تكون هذه القيمة فارغة أبداً.
النتائج
boolean ما إذا كان يمكنك إظهار شاشة المبررات للإذن أم لا.

 

أنظر أيضاً:

(ContextWrapper.checkSelfPermission(String

(requestPermissions(String[], int

([]onRequestPermissionsResult(int, String[], int

 


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

shouldUpRecreateTask

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

public boolean shouldUpRecreateTask (Intent targetIntent)

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

إذا أرجعت هذه الداله “خطأ”، يمكن للتطبيق ببساطه إستدعاء (navigateUpTo(android.content.Intent بإستخدام نفس المعاملات، لتنفيذ التنقل بشكلٍ صحيح.

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

أو آلية أخرى مماثله، لتنفيذ التنقل.

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

 

 

showAssist

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

public boolean showAssist (Bundle args)

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

وهو مثل إستدعاء VoiceInteractionService.showSession، وطلب كل السياق المحتمل.

سيرى المستلم دائماً تعيين VoiceInteractionSession.SHOW_SOURCE_APPLICATION.

الباراميتر
args Bundle
النتائج
boolean ترجع “صحيح” إذا أُستدعي المساعد بنجاح، خلاف ذلك ترجع “خطأ”.

مثال، سترجع “خطأ”، إذا لم يكن المستدعي هو النشاط العلوي حالياً.

 

 

 

 

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

showDialog

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

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

public final boolean showDialog (int id, 
                Bundle args)
تم إيقاف هذه الداله في المستوى 15.

إستخدم فئة DialogFragment الجديده، مع FragmentManager بدلاً من ذلك؛ وهذه متوفرة أيضاً في الإصدارات الأقدم من خلال حزمة توافق الأندرويد.

 

تعرض مربع حوار يديره هذا النشاط. سوف يتم إجراء إستدعاء لـ

(onCreateDialog(int, android.os.Bundle بنفس المعرف الذي تم إستدعاء هذه به في المرة الأولى، لمعرف معطى.

بعد ذلك، سيحفظ مربع الحوار تلقائياً وإستعادته. إذا كنت تستهدف الإصدار Build.VERSION_CODES.HONEYCOMB أو أحدث، فخذ في الإعتبار إستخدام DialogFragment بدلاً من ذلك.

في كل مرة يعرض فيها مربع حوار، سوف يتم إجراء

(onPrepareDialog(int, android.app.Dialog, android.os.Bundle لتوفير فرصة للقيام بأي تجهيزات في الوقت المناسب.

الباراميتر
id int: المعرف الخاص بمربع الحوار الذي يُدار.
args Bundle: معطيات لتمريرها إلى مربع الحوار. هذه سيتم حفظها وإستعادتها من أجلك.

لاحظ أنه إذا أُنشيء مربع الحوار بالفعل، فلن يتم إستدعاء

(onCreateDialog(int, android.os.Bundle بالمعطيات الجديده، بل (onPrepareDialog(int, android.app.Dialog, android.os.Bundle سوف تستدعى بها.

إذا أحتجت إلى إعادة بناء مربع الحوار، فقم بإستدعاء (removeDialog(int أولاً.

النتائج
boolean ترجع “صحيح” إذا تم إنشاء مربع الحوار؛ وترجع “خطأ” إذا لم يتم إنشاؤه لأن (onCreateDialog(int, android.os.Bundle ترجع “خطأ”.

أنظر أيضاً:

Dialog

(onCreateDialog(int, Bundle

(onPrepareDialog(int, Dialog, Bundle

(dismissDialog(int

(removeDialog(int


 

showDialog

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

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

public final void showDialog (int id)

 

تم إيقاف هذه الداله في المستوى 15.

إستخدم فئة DialogFragment الجديده، مع FragmentManager بدلاً من ذلك؛ وهذه متوفرة أيضاً في الإصدارات الأقدم من خلال حزمة توافق الأندرويد.

إصدار بسيط من (showDialog(int, android.os.Bundle لا يأخذ أي معطيات. ببساطة قم بإستدعاء

(showDialog(int, android.os.Bundle بإستخدام معطيات فارغه “null”.

الباراميتر
id int

 

 

 

 

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

showLockTaskEscapeMessage

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

public void showLockTaskEscapeMessage ()

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

في وقت هذا الإستدعاء، لعرض الرساله.

 

startActionMode

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

public ActionMode startActionMode (ActionMode.Callback callback, 
                int type)

تقوم ببدء وضع الإجراء، للنوع المعطى.

الباراميتر
callback ActionMode.Callback: إستدعاء يقوم بإدارة أحداث دورة الحياه، الخاصه بوضع الإجراء هذا.
type int: واحد من ActionMode#TYPE_PRIMARY أو ActionMode#TYPE_FLOATING.
النتائج
ActionMode هو وضع الإجراء ActionMode الذي بدأ تشغيله، أو فارغ إذا تم إلغاؤه.

أنظر أيضاً:

ActionMode


 

 

 

 

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

startActionMode

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

public ActionMode startActionMode (ActionMode.Callback callback)

تقوم ببدء وضع إجراء من النوع الإفتراضي ActionMode#TYPE_PRIMARY.

الباراميتر
callback ActionMode.Callback: إستدعاء يقوم بإدارة أحداث دورة الحياه، الخاصه بوضع الإجراء هذا.
النتائج
ActionMode هو وضع الإجراء ActionMode الذي بدأ تشغيله، أو فارغ إذا تم إلغاؤه.

 

أنظر أيضاً:

ActionMode


startActivities

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

public void startActivities (Intent[] intents, 
                Bundle options)

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

بسبب هذه المعلومات الإضافيه، لن تكون علامة الإطلاق Intent#FLAG_ACTIVITY_NEW_TASK مطلوبه؛ إذا لم تكن محدده، فستتم إضافة النشاط الجديد إلى مهمة المستدعي.

هذه الداله تقوم بإلقاء ActivityNotFoundException في حالة عدم العثور على نشاط، لتشغيل الغرض المعطى.

الباراميتر
intents Intent: الأغراض المراد بدأها.
options Bundle: خيارات إضافيه لكيفية بدء النشاط. راجع

{(Context.startActivity(Intent, Bundle) Context.startActivity(Intent, Bundle

لمزيد من التفاصيل. قد تكون هذه القيمة فارغه.

الإلقاء
android.content.ActivityNotFoundException

أنظر أيضاً:

([]startActivities(Intent

(startActivityForResult(Intent, int


startActivities

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

public void startActivities (Intent[] intents)

مشابهة لـ(startActivities(android.content.Intent[], android.os.Bundle ولكن بلا خيارات محدده.

الباراميتر
intents Intent: الأغراض المراد بدأها.
الإلقاء
android.content.ActivityNotFoundException

أنظر أيضاً:

(startActivities(Intent[], Bundle

(startActivityForResult(Intent, int


 

 

 

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

 

startActivity

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

public void startActivity (Intent intent)

مشابهة لـ(startActivity(android.content.Intent, android.os.Bundle ولكن بلا خيارات محدده.

الباراميتر
intent Intent: الغرض المراد بدأه.
الإلقاء
android.content.ActivityNotFoundException

أنظر أيضاً:

(startActivity(Intent, Bundle

(startActivityForResult(Intent, int


startActivity

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

public void startActivity (Intent intent, 
                Bundle options)

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

بسبب هذه المعلومات الإضافيه، لن تكون علامة الإطلاق Intent#FLAG_ACTIVITY_NEW_TASK مطلوبه؛ إذا لم تكن محدده، فستتم إضافة النشاط الجديد إلى مهمة المستدعي.

هذه الداله تقوم بإلقاء ActivityNotFoundException في حالة عدم العثور على نشاط، لتشغيل الغرض المعطى.

الباراميتر
intent Intent: الغرض المراد بدأه.
options Bundle: خيارات إضافيه لكيفية بدء النشاط. راجع

{(Context.startActivity(Intent, Bundle) Context.startActivity(Intent, Bundle

لمزيد من التفاصيل. قد تكون هذه القيمة فارغه.

الإلقاء
android.content.ActivityNotFoundException

أنظر أيضاً:

(startActivity(Intent

(startActivityForResult(Intent, int


 

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

 

startActivityForResult

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

public void startActivityForResult (Intent intent, 
                int requestCode)

مشابهة لإستدعاء (startActivityForResult(android.content.Intent, int, android.os.Bundle ولكن بلا خيارات.

الباراميتر
intent Intent: الغرض المراد بدأه.
requestCode int: إذا كانت  0 = < ، سوف يتم إرجاع هذا الكود في ()onActivityResult عند إنتهاء النشاط.
الإلقاء
android.content.ActivityNotFoundException

أنظر أيضاً:

(startActivity(Intent


startActivityForResult

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

public void startActivityForResult (Intent intent, 
                int requestCode, 
                Bundle options)

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

إن إستخدام requestCode سالب، مشابه لإستدعاء (startActivity(Intent (لا يتم بدء النشاط كنشاط فرعي).

لاحظ أنه يجب إستخدام هذه الداله فقط مع بروتوكولات الغرض، المُعرفه لإرجاع نتيجه. في بروتوكولات أخرى (مثل Intent#ACTION_MAIN أو Intent#ACTION_VIEW)

قد لا تحصل على النتيجة عندما تتوقعها. مثال، إذا كان النشاط الذي أطلقته، يستخدم Intent#FLAG_ACTIVITY_NEW_TASK، فلن يعمل في مهمتك..

وبالتالي سوف تتلقى نتيجة إلغاء فوراً.

كحالة خاصه، إذا قمت بإستدعاء ()startActivityForResult، مع requestCode >= 0 أثناء

()onCreate(Bundle savedInstanceState)/onResume الأوليه لنشاط، عندها لن يتم عرض نافذتك، حتى يتم إرجاع نتيجه من النشاط الذي بدأ فيه.

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

تقوم هذه الداله بإلقاء ActivityNotFoundException في حالة عدم العثور على نشاط لتشغيل الغرض المعطى.

الباراميتر
intent Intent: الغرض المراد بدأه.
requestCode int: إذا كانت  0 = < ، سوف يتم إرجاع هذا الكود في ()onActivityResult عند إنتهاء النشاط.
options Bundle: خيارات إضافيه لكيفية بدء النشاط. راجع

{(Context.startActivity(Intent, Bundle) Context.startActivity(Intent, Bundle

لمزيد من التفاصيل. قد تكون هذه القيمة فارغه.

 

الإلقاء
android.content.ActivityNotFoundException

أنظر أيضاً:

(startActivity(Intent


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

 

startActivityFromChild

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

public void startActivityFromChild (Activity child, 
                Intent intent, 
                int requestCode)

شبيهة لإستدعاء

(startActivityFromChild(android.app.Activity, android.content.Intent, int, android.os.Bundle ولكن بلا خيارات.

الباراميتر
child Activity: النشاط الذي يجري الإستدعاء. يجب ألا تكون هذه القيمة فارغة أبداً.
intent Intent: الغرض المراد بدأه.
requestCode int: رد على كود الطلب. 0 > إذا لم يكن الرد مطلوباً.
الإلقاء
android.content.ActivityNotFoundException

أنظر أيضاً:

(startActivity(Intent

(startActivityForResult(Intent, int


startActivityFromChild

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

public void startActivityFromChild (Activity child, 
                Intent intent, 
                int requestCode, 
                Bundle options)

 

يتم إستدعاؤها عندما يستدعي النشاط الفرعي لهذا النشاط، دالة (startActivity(Intent أو

(startActivityForResult(Intent, int الخاصة به.

تقوم هذه الداله بإلقاء ActivityNotFoundException في حالة عدم العثور على نشاط يقوم بتشغيل الغرض المعطى.

الباراميتر
child Activity: النشاط الذي يجري الإستدعاء. يجب ألا تكون هذه القيمة فارغة أبداً.
intent Intent: الغرض المراد بدأه.
requestCode int: رد على كود الطلب. 0 > إذا لم يكن الرد مطلوباً.
options Bundle: خيارات إضافيه لكيفية بدء النشاط. راجع

{(Context.startActivity(Intent, Bundle) Context.startActivity(Intent, Bundle

لمزيد من التفاصيل. قد تكون هذه القيمة فارغه.

 

الإلقاء
android.content.ActivityNotFoundException

أنظر أيضاً:

(startActivity(Intent

(startActivityForResult(Intent, int


 

 

 

 

 

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

 

startActivityFromFragment

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

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

public void startActivityFromFragment (Fragment fragment, 
                Intent intent, 
                int requestCode, 
                Bundle options)
تم إيقاف هذه الداله في المستوى 28.

إستخدم (FragmentActivity.startActivityFromFragment(android.support.v4.app.Fragment, Intent, int, Bundle

تستدعى عندما تقوم الشظيه في هذا النشاط بإستدعاء دالة Fragment#startActivity أو Fragment#startActivityForResult الخاصة بها.

هذه الداله تلقي ActivityNotFoundException في حالة عدم العثور على نشاط يقوم بتشغيل الغرض المعطى.

الباراميتر
fragment Fragment: الشظيه التي تجري الإستدعاء. يجب ألا تكون هذه القيمة فارغة أبداً.
intent Intent: الغرض المراد بدأه.
requestCode int: رد على كود الطلب. 0 > إذا لم يكن الرد مطلوباً.
options Bundle: خيارات إضافيه لكيفية بدء النشاط. راجع

{(Context.startActivity(Intent, Bundle) Context.startActivity(Intent, Bundle

لمزيد من التفاصيل. قد تكون هذه القيمة فارغه.

 

الإلقاء
android.content.ActivityNotFoundException

أنظر أيضاً:

(Fragment.startActivity(Intent

(Fragment.startActivityForResult(Intent, int


startActivityFromFragment

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

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

public void startActivityFromFragment (Fragment fragment, 
                Intent intent, 
                int requestCode)
تم إيقاف هذه الداله في المستوى 28.

إستخدم (FragmentActivity.startActivityFromFragment(android.support.v4.app.Fragment, Intent, int, Bundle

مشابهه لإستدعاء (startActivityFromFragment(android.app.Fragment, android.content.Intent, int, android.os.Bundle بلا خيارات.

الباراميتر
fragment Fragment: الشظيه التي تجري الإستدعاء. يجب ألا تكون هذه القيمة فارغة أبداً.
intent Intent: الغرض المراد بدأه.
requestCode int: رد على كود الطلب. 0 > إذا لم يكن الرد مطلوباً.
الإلقاء
android.content.ActivityNotFoundException

أنظر أيضاً:

(Fragment.startActivity(Intent

(Fragment.startActivityForResult(Intent, int


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

 

startActivityIfNeeded

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

public boolean startActivityIfNeeded (Intent intent, 
                int requestCode, 
                Bundle options)

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

(startActivityForResult(android.content.Intent, int بإستثناء:

إذا كنت تستخدم العلامه Intent#FLAG_ACTIVITY_SINGLE_TOP أو أوضاع التشغيل singleTask أو singleTop، والنشاط الذي يتعامل مع الغرض، هو نفس نشاطك الحالي..

فلا حاجة إلى مثيل جديد. في هذه الحاله، بدلاً من السلوك العادي لإستدعاء (onNewIntent(Intent فسوف تعود هذه الوظيفه و ستتمكن من التعامل مع الغرض بنفسك.

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

الباراميتر
intent Intent: الغرض المراد بدأه.
requestCode int: إذا 0 = < سيتم إرجاع هذا الكود في ()onActivityResult عند إنهاء النشاط، كما هو موضح في (startActivityForResult(Intent, int.
options Bundle: خيارات إضافيه لكيفية بدء النشاط. راجع

{(Context.startActivity(Intent, Bundle) Context.startActivity(Intent, Bundle

لمزيد من التفاصيل. قد تكون هذه القيمة فارغه.

 

النتائج
boolean إذا تم تشغيل نشاط جديد، فسيتم إرجاع “صحيح”؛ خلاف ذلك سترجع “خطأ”، وسيتوجب عليك التعامل مع الغرض بنفسك.

أنظر أيضاً:

(startActivity(Intent

(startActivityForResult(Intent, int


startActivityIfNeeded

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

public boolean startActivityIfNeeded (Intent intent, 
                int requestCode)

مشابهة لإستدعاء (startActivityIfNeeded(android.content.Intent, int, android.os.Bundle بلا خيارات.

الباراميتر
intent Intent: الغرض المراد بدأه. يجب ألا تكون هذه القيمه فارغة أبداً.
requestCode int: إذا 0 = < سيتم إرجاع هذا الكود في ()onActivityResult عند إنهاء النشاط، كما هو موضح في (startActivityForResult(Intent, int.
النتائج
boolean إذا تم تشغيل نشاط جديد، فسيتم إرجاع “صحيح”؛ خلاف ذلك سترجع “خطأ”، وسيتوجب عليك التعامل مع الغرض بنفسك.

أنظر أيضاً:

(startActivity(Intent

(startActivityForResult(Intent, int


startIntentSender

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

public void startIntentSender (IntentSender intent, 
                Intent fillInIntent, 
                int flagsMask, 
                int flagsValues, 
                int extraFlags)

مشابه لإستدعاء

startIntentSender(android.content.IntentSender, android.content.Intent, int, int, int, android.os.Bundle بدون خيارات.

الباراميتر
intent IntentSender: IntentSender المراد إطلاقه.
fillInIntent Intent: إذا لم تكن فارغه، فسوف يتم توفير ذلك كمعامل غرض لـIntentSender#sendIntent.

قد تكون هذه القيمه فارغه.

flagsMask int: علامات غرض في IntentSender الأصلي، الذي ترغب في تغييره.
flagsValues int: القيم المرغوبه، لأي وحدات بت معينه في flagsMask.
extraFlags int: مضبوطه دائماً على 0.
الإلقاء
IntentSender.SendIntentException

 


startIntentSender

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

public void startIntentSender (IntentSender intent, 
                Intent fillInIntent, 
                int flagsMask, 
                int flagsValues, 
                int extraFlags, 
                Bundle options)

مثل (startActivity(android.content.Intent, android.os.Bundle، ولكن تأخذ IntentSender للبدء؛ راجع 

startIntentSenderForResult(android.content.IntentSender, int, android.content.Intent, int, int, int, android.os.Bundle لمزيد من المعلومات.

الباراميتر
intent IntentSender: IntentSender المراد إطلاقه.
fillInIntent Intent: إذا لم تكن فارغه، فسوف يتم توفير ذلك كمعامل غرض لـIntentSender#sendIntent.

قد تكون هذه القيمه فارغه.

flagsMask int: علامات غرض في IntentSender الأصلي، الذي ترغب في تغييره.
flagsValues int: القيم المرغوبه، لأي وحدات بت معينه في flagsMask.
extraFlags int: مضبوطه دائماً على 0.
options Bundle: خيارات إضافيه لكيفية بدء النشاط. راجع

{(Context.startActivity(Intent, Bundle) Context.startActivity(Intent, Bundle

لمزيد من التفاصيل. إذا توفرت الخيارات أيضاً بواسطة IntentSender، فإن الخيارات المعطاة هنا، سوف تتجاوز أي خيارات تتعارض مع الخيارات التي توفرها IntentSender.

الإلقاء
IntentSender.SendIntentException

 


startIntentSenderForResult

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

public void startIntentSenderForResult (IntentSender intent, 
                int requestCode, 
                Intent fillInIntent, 
                int flagsMask, 
                int flagsValues, 
                int extraFlags)

 

مشابهة لإستدعاء startIntentSenderForResult(android.content.IntentSender, int, android.content.Intent, int, int, int, android.os.Bundle بلا خيارات.

الباراميتر
intent IntentSender: IntentSender المراد إطلاقه.
requestCode int: إذا 0 = < سيتم إرجاع هذا الكود في ()onActivityResult عند إنهاء النشاط.
fillInIntent Intent: إذا لم تكن فارغه، فسوف يتم توفير ذلك كمعامل غرض لـIntentSender#sendIntent.

قد تكون هذه القيمه فارغه.

flagsMask int: علامات غرض في IntentSender الأصلي، الذي ترغب في تغييره.
flagsValues int: القيم المرغوبه، لأي وحدات بت معينه في flagsMask.
extraFlags int: مضبوطه دائماً على 0.
الإلقاء
IntentSender.SendIntentException

startIntentSenderForResult

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

public void startIntentSenderForResult (IntentSender intent, 
                int requestCode, 
                Intent fillInIntent, 
                int flagsMask, 
                int flagsValues, 
                int extraFlags, 
                Bundle options)

مثل (startActivityForResult(android.content.Intent, int، لكن تسمح لك بإستخدام IntentSender لوصف النشاط الذي سوف يبدأ.

إذا كانت IntentSender مخصصة لنشاط ما، فسوف يبدأ هذا النشاط كما لو أنك قمت بإستدعاء (startActivityForResult(android.content.Intent, int الإعتيادي هنا؛ 

خلاف ذلك، سيتم تنفيذ الإجراء المرتبط به (مثل إرسال بث)، كما لو كنت قد أستدعيت IntentSender#sendIntent عليه.

الباراميتر
intent IntentSender: IntentSender المراد إطلاقه.
requestCode int: إذا 0 = < سيتم إرجاع هذا الكود في ()onActivityResult عند إنهاء النشاط.
fillInIntent Intent: إذا لم تكن فارغه، فسوف يتم توفير ذلك كمعامل غرض لـIntentSender#sendIntent.

قد تكون هذه القيمه فارغه.

flagsMask int: علامات غرض في IntentSender الأصلي، الذي ترغب في تغييره.
flagsValues int: القيم المرغوبه، لأي وحدات بت معينه في flagsMask.
extraFlags int: مضبوطه دائماً على 0.
options Bundle: خيارات إضافيه لكيفية بدء النشاط. راجع

{(Context.startActivity(Intent, Bundle) Context.startActivity(Intent, Bundle

لمزيد من التفاصيل. إذا توفرت الخيارات أيضاً بواسطة IntentSender، فإن الخيارات المعطاة هنا، سوف تتجاوز أي خيارات تتعارض مع الخيارات التي توفرها IntentSender.

 

الإلقاء
IntentSender.SendIntentException

startIntentSenderFromChild

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

public void startIntentSenderFromChild (Activity child, 
                IntentSender intent, 
                int requestCode, 
                Intent fillInIntent, 
                int flagsMask, 
                int flagsValues, 
                int extraFlags, 
                Bundle options)

مثل (startActivityFromChild(android.app.Activity, android.content.Intent, int ولكن تأخذ IntentSender؛

راجع (startIntentSenderForResult(android.content.IntentSender, int, android.content.Intent, int, int, int لمزيد من المعلومات.

الباراميتر
child
Activity
intent IntentSender
requestCode int
fillInIntent Intent
flagsMask int
flagsValues int
extraFlags
int
options Bundle: قد تكون هذه القيمه فارغه.
الإلقاء
IntentSender.SendIntent

Exception


startIntentSenderFromChild

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

public void startIntentSenderFromChild (Activity child, 
                IntentSender intent, 
                int requestCode, 
                Intent fillInIntent, 
                int flagsMask, 
                int flagsValues, 
                int extraFlags)

مشابهه لإستدعاء startIntentSenderFromChild(android.app.Activity, android.content.IntentSender, int, android.content.Intent, int, int, int, android.os.Bundle) ولكن بلا خيارات.

الباراميتر
child
Activity
intent IntentSender
requestCode int
fillInIntent Intent
flagsMask int
flagsValues int
extraFlags
int
الإلقاء
IntentSender.SendIntent

Exception

 


startLocalVoiceInteraction

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

public void startLocalVoiceInteraction (Bundle privateOptions)

تبدأ جلسة تفاعل صوتي محليه. عند الإستدعاء، يتم إستدعاء ()onLocalVoiceInteractionStarted.

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

الباراميتر
privateOptions Bundle: حزمة من المعطيات الخاصه، لخدمة التفاعل الصوتي الحاليه.

startLockTask

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

public void startLockTask ()

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

إذا قامت (DevicePolicyManager#isLockTaskPermitted(String بإرجاع “صحيح” لهذا المكون، فسوف تطلق هذه المهمه مباشرة في وضع LockTask.

فقط التطبيقات المدرجة في القائمة البيضاء بواسطة ([]DevicePolicyManager#setLockTaskPackages(ComponentName, String يمكن تشغيلها أثناء تنشيط وضع LockTask.

لن يكون المستخدم قادراً على مغادرة هذا الوضع حتى يقوم هذا النشاط بإستدعاء ()stopLockTask.

إستدعاء هذه الداله بينما يكون الجهاز في وضع LockTask بالفعل، لن يكون له أي تأثير.

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

يمكن للمستخدم الخروج في أي وقت، من خلال التعليمات الموضحه في مربع حوار الطلب.

إستدعاء ()stopLockTask سوف ينهي هذا الوضع أيضاً.

ملاحظه: يمكن إستدعاء هذه الدالة فقط في حالة كان النشاط في المقدمه. وهذا بين ()onResume و ()onPause.

أنظر أيضاً:

()stopLockTask

R.attr.lockTaskMode


startManagingCursor

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

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

public void startManagingCursor (Cursor c)
تم إيقاف هذه الداله في المستوى 15.

إستخدم الفئة الجديده CursorLoader مع LoaderManager بدلاً منها؛ تتوفر هذه أيضاً في الإصدارات الأقدم من خلال حزمة توافق الأندرويد.

 

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

أي أنه، عند توقف النشاط، سيقوم تلقائياً بإستدعاء Cursor#deactivate على المؤشر المعطى، وعند إعادة تشغيله لاحقاً، سيقوم بإستدعاء Cursor#requery من أجلك.

عند تدمير النشاط، ستغلق جميع المؤشرات المدارة تلقائياً. إذا كنت تستهدف الإصدار Build.VERSION_CODES.HONEYCOMB أو أحدث..

ففكر في إستخدام LoaderManager بدلاً من ذلك، وهي متوفرة عبر ()getLoaderManager.

تحذير: لا تستدعي ()Cursor#close على المؤشر الذي تم الحصول عليه من (managedQuery(Uri, String[], String, String[], String..

لأن النشاط سيقوم بهذا من أجلك في الوقت المناسب. مع ذلك، إذا أستدعيت (stopManagingCursor(Cursor على مؤشر من الإستعلام المدار..

لن يقوم النظام بإغلاق المؤشر تلقائياً، وفي هذه الحاله، وفي هذه الحاله يجب عليك إستدعاء ()Cursor#close.

الباراميتر
c Cursor: المؤشر المراد إدارته.

أنظر أيضاً:

(managedQuery(android.net.Uri, String[], String, String[], String

(stopManagingCursor(Cursor


startNextMatchingActivity

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

public boolean startNextMatchingActivity (Intent intent, 
                Bundle options)

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

عليك عادة إستدعاء هذه في (onCreate(Bundle مع الغرض المرجع بواسطة ()getIntent.

الباراميتر
intent Intent: الغرض الذي سيتم إرساله إلى النشاط التالي. 

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

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

options Bundle: خيارات إضافيه لكيفية بدء النشاط. راجع

{(Context.startActivity(Intent, Bundle) Context.startActivity(Intent, Bundle

لمزيد من التفاصيل. قد تكون هذه القيمه فارغه.

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

و ترجع “خطأ” إذا لم يوجد. بشكلٍ عام، إذا تم إرجاع “صحيح” فسوف ترغب في إستدعاء ()finish بنفسك.

 


startNextMatchingActivity

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

public boolean startNextMatchingActivity (Intent intent)

مشابهه لإستدعاء (startNextMatchingActivity(android.content.Intent, android.os.Bundle بلا خيارات.

الباراميتر
intent Intent: الغرض الذي سيتم إرساله إلى النشاط التالي. 

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

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

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

و ترجع “خطأ” إذا لم يوجد. بشكلٍ عام، إذا تم إرجاع “صحيح” فسوف ترغب في إستدعاء ()finish بنفسك.


startPostponedEnterTransition

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

public void startPostponedEnterTransition ()

تقوم ببدء الإنتقال المؤجل بعد إستدعاء ()postponeEnterTransition. إذا تم إستدعاء ()postponeEnterTransition، فيجب عليك إستدعاء ()startPostponedEnterTransition لكي يبدأ رسم نشاطك.


startSearch

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

public void startSearch (String initialQuery, 
                boolean selectInitialQuery, 
                Bundle appSearchData, 
                boolean globalSearch)

 

يستدعى هذا الخطاف لبدء واجهة مستخدم البحث.

عادة تستدعى من ()onSearchRequested إما بشكلٍ مباشر من ()Activity.onSearchRequested أو  من إصدار تم تجاوزه في أي نشاط معطى.

إذا كان هدفك تنشيط البحث ببساطه، فيفضل إستدعاء ()onSearchRequested، والذي قد يكون تم تجاوزه في مكان ما من نشاطك.

إذا كان هدفك هو إدخال بيانات معينه مثل بيانات السياق، فمن الأفضل تجاوز ()onSearchRequested، بحيث يستفيد أي مستدعي إليه من التجاوز.

ملاحظه: عند التشغيل في Configuration#UI_MODE_TYPE_WATCH، فإن إستخدام واجهة برمجة التطبيقات هذه غير مدعومه.

الباراميتر
initialQuery String: أي سلسلة غير فارغه، غير خاليه، سيتم إدراجها كنص مدخل مسبقاً في مربع إستعلام البحث. قد تكون هذه القيمه فارغه.
selectInitialQuery boolean: إذا كانت “صحيح” فسيتم تحديد الإستعلام الأولي مسبقاً، أي أن، أي كتابة أخرى ستحل محله.

هذا مفيد في الحالات التي يتم فيها إدراج إستعلام مصاغ بالكامل مسبقاً.

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

ويتوقع المستخدم أن يكون قادراً على الإستمرار في الكتابه. يكون هذا المعامل ذو معنى فقط في حالة كانت  initialQuery عبارة عن سلسله غير فارغه.

appSearchData Bundle: تطبيق يمكنه إدخال السياق الخاص بالتطبيق هنا، من أجل تحسين جودة أو خصوصية عمليات البحث الخاصة به.

سيتم إرجاع هذه البيانات بواسطة غرض\أغراض البحث.

تكون فارغه إذا لم تكن هناك خيارات إضافية مطلوبه. قد تكون هذه القيمة فارغه.

globalSearch boolean: إذا كانت “خطأ” فسوف تقوم فقط ببدء البحث المحدد بواسطة التطبيق (والذي يُعّرف عادة كبحث محلي).

إذا لم يتم تحديد بحث إفتراضي في التطبيق أو النشاط الحالي، سيتم بدء بحث عالمي “عام”.

إذا كانت “صحيح” فسوف يؤدي هذا عادة إلى بدء بحث على مستوى النظام (مستند على الويب) بدلاً من ذلك.

 

أنظر أيضاً:

SearchManager

()onSearchRequested


stopLocalVoiceInteraction

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

public void stopLocalVoiceInteraction ()

تطلب إنهاء التفاعل الصوتي الحالي، والذي تم تشغيله مسبقاً بواسطة (startLocalVoiceInteraction(android.os.Bundle.

عند إنهاء التفاعل، سيتم إستدعاء ()onLocalVoiceInteractionStopped.


 

stopLockTask

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

public void stopLockTask ()

توقف المهمة الحالية من أن تكون مغلقه.

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

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

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

([]DevicePolicyManager#setLockTaskPackages(ComponentName, String.

أنظر أيضاً:

()startLockTask

R.attr.lockTaskMode

()ActivityManager.getLockTaskModeState


stopManagingCursor

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

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

public void stopManagingCursor (Cursor c)
تم إيقاف هذه الداله في المستوى 15.

إستخدم الفئة الجديده CursorLoader مع LoaderManager بدلاً منها؛ تتوفر هذه أيضاً في الإصدارات الأقدم من خلال حزمة توافق الأندرويد.

تعطي المؤشر الذي تم إعطاؤه مسبقاً إلى (startManagingCursor(Cursor، توقف إدارة النشاط لهذا المؤشر.

تحذير: بعد إستدعاء هذه الداله على مؤشر من إستعلام مُدار، فلن يقوم النظام بإغلاق المؤشر تلقائياً، وسيتوجب عليك إستدعاء ()Cursor#close.

الباراميتر
c Cursor: المؤشر الذي تتم إدارته.

أنظر أيضاً:

(startManagingCursor(Cursor


takeKeyEvents

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

public void takeKeyEvents (boolean get)

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

الباراميتر
get boolean

أنظر أيضاً:

(Window.takeKeyEvents(boolean


triggerSearch

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

public void triggerSearch (String query, 
                Bundle appSearchData)

مشابهة لـ(startSearch(String, boolean, Bundle, boolean، ولكن تقوم في الواقع بإطلاق إستعلام بحث، بعد إستدعاء مربع حوار البحث.

جعلت متاحة لأغراض الإختبار.

الباراميتر
query String: الإستعلام المراد تشغيله. إذا كانت فارغه، فسيتم تجاهل الطلب.
appSearchData Bundle: يمكن للتطبيق إدراج السياق الخاص بالتطبيق هنا،

من أجل تحسين جودة أو خصوصية عمليات البحث الخاصة به.

سيتم إرجاع هذه البيانات بواسطة غرض\أغراض البحث.

تكون فارغه إذا لم تكن هناك خيارات إضافية مطلوبه. قد تكون هذه القيمة فارغه.


unregisterActivityLifecycleCallbacks

أُضيفت في أندرويد Q.

public void unregisterActivityLifecycleCallbacks (Application.ActivityLifecycleCallbacks callback)

تقوم بإلغاء تسجيل Application.ActivityLifecycleCallbacks المسجلة مسبقاً بواسطة (registerActivityLifecycleCallbacks(Application.ActivityLifecycleCallbacks.

لن تتلقى أي عمليات إستدعاء أخرى.

الباراميتر
callback Application.ActivityLifecycleCallbacks: مثيل الإستدعاء المراد إلغاء تسجيله.

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

أنظر أيضاً:

(registerActivityLifecycleCallbacks(Application.ActivityLifecycleCallbacks


unregisterForContextMenu

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

public void unregisterForContextMenu (View view)

تمنع عرض قائمة السياق في المعاينه المعطاه. ستقوم هذه الداله بإزالة OnCreateContextMenuListener على المعاينه.

الباراميتر
view View: المعاينة التي يجب أن توقف عرض قائمة السياق.

أنظر أيضاً:

(registerForContextMenu(View

 


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

الإعلانات

24 thoughts on “الدوال العامه الجزء 6”

اترك رد