فئة GCKRequest

طُرق المثيل | طُرق الفئة | السمات

مرجع فئة GCKRequest

نظرة عامة

كائن لتتبُّع طلب غير متزامن

يمكنك الاطّلاع على GCKRequestDelegate لمعرفة بروتوكول التفويض.

منذ

3.0

تتضمّن NSObject.

ملخّص طرق المثيل
(void)	- cancel
	لإلغاء الطلب المزيد...
(void)	- complete
	يُكمل الطلب ويُرسل إشعارًا إلى المستخدم المفوض. المزيد...
(void)	- failWithError:
	يرفض الطلب بسبب حدوث خطأ ويُرسل إشعارًا إلى المستخدم المفوض وفقًا لذلك. المزيد...
(void)	- abortWithReason:
	يوقف الطلب مع ذكر السبب ويُعلم المفوَّض بذلك. المزيد...

ملخّص طرق الفئات
(GCKRequest *)	+ applicationRequest
	تنشئ هذه الدالة كائن GCKRequest لاستخدامه من قِبل التطبيق الذي يستدعيها. المزيد...

ملخّص الموقع
id< GCKRequestDelegate >	delegate
	المفوَّض بتلقّي إشعارات حول حالة الطلب. المزيد...
GCKRequestID	requestID
	المعرّف الفريد الذي تمّ تعيينه لهذا الطلب. المزيد...
GCKError *	error
	الخطأ الذي أدّى إلى تعذُّر تلبية الطلب، إن وُجد، وإلا سيتم عرض nil. المزيد...
BOOL	inProgress
	علامة تشير إلى ما إذا كان الطلب قيد التقدم حاليًا. المزيد...
BOOL	external
	علامة تشير إلى ما إذا كان هذا الطلب خارجيًا، أي تم إنشاؤه بواسطة التطبيق وليس بواسطة إطار العمل نفسه. المزيد...

تفاصيل الطريقة

- (void) cancel

لإلغاء الطلب

لا يضمن إلغاء الطلب عدم إكماله على جهاز المستلِم، بل يؤدي ببساطة إلى توقّف المُرسِل عن تتبُّع الطلب.

+ (GCKRequest *) applicationRequest

تنشئ هذه الدالة كائن GCKRequest لاستخدامه من قِبل التطبيق الذي يستدعيها.

يمكن للتطبيق إدارة عناصر الطلبات التي تم إنشاؤها باستخدام طريقة المصنع هذه من خلال الطرق complete وfailWithError: وabortWithReason:.

منذ

3.4

- (void) complete

يُكمل الطلب ويُرسل إشعارًا إلى المستخدم المفوض.

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

منذ

3.4

- (void) failWithError:

(GCKError *)

error

يرفض الطلب بسبب حدوث خطأ ويُرسل إشعارًا إلى المستخدم المفوض وفقًا لذلك.

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

Parameters

error

The error describing the failure.

منذ

3.4

- (void) abortWithReason:

(GCKRequestAbortReason)

reason

يوقف الطلب مع ذكر السبب ويُعلم المفوَّض بذلك.

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

Parameters

reason

The reason for the abort.

منذ

3.4

تفاصيل الموقع

- (id<GCKRequestDelegate>) delegate

readwritenonatomicweak

المفوَّض بتلقّي إشعارات حول حالة الطلب.

- (GCKRequestID) requestID

readnonatomicassign

المعرّف الفريد الذي تمّ تعيينه لهذا الطلب.

- (GCKError*) error

readnonatomiccopy

الخطأ الذي أدّى إلى تعذُّر تلبية الطلب، إن وُجد، وإلا سيتم عرض nil.

- (BOOL) inProgress

readnonatomicassign

علامة تشير إلى ما إذا كان الطلب قيد التقدم حاليًا.

- (BOOL) external

readnonatomicassign

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

منذ

3.4