التنبيهات Note والتساؤلات Query في PyS60

التنبيهات Note والتساؤلاتQuery ‎ في PyS60

بسم الله الرحمن الرحيم
اليوم سأتحدث عن التنبيهات(الملاحظات) والتساؤلات بإستخدام مكتبات(وحدات) قياسية مدعما كتاباتي بالأمثلة والصور.

التساؤلات
تحوي الوحدة appuifw عدة دوال تؤمن تساؤلات بخيارات أو تطلب مدخلات من المستخدم، سأمر عليها تباعا.
*. الدالة query‏ ، صيغتها كالتالي:

query(label, type[, initial_value])

العنوان label‏ : هو العنوان الذي سيظهر في التساؤل.
النوع type : يحدد نوع التساؤل، سنمر عليها تباعا.
[إختياري] القيمة البدئية initial_value‏ : هي القيمة التي تحددها أنت وتظهر في حقل الإدخال ، تكون بحسب نوع التساؤل.
- يمكن لنوع التساؤل أن يكون أي من هذه السلاسل النصية [type]:
'text', 'code', 'number', 'date', 'time', 'query', 'float'
- نوع القيمة الإختيارية والدخل المعاد(بضم الميم) يعتمد على الجدلية: type، فمثلا:
-> للحقول النصية ('text', 'code') فإنه Unicode‏ "وحيد الرمز"
-> للحقول العددية، إنه رقم
-> لحقول التاريخ والوقت ('date', 'time')، إنه ثوان منذ "الأزل‏"‏ epoch مقرب لأقرب أدنى منتصف ليل محلي. [الأزل: 1970-يناير(1)-1 الساعة 12:00 ص]
-> حقول لا تأخذ قيمة بدئية التساؤل 'query' والوقت 'time' وتعودان على التوالي، بقيمة منطقية True/None‏ وبثوان منذ منتصف الليل المحلي.
-> للحقول العشرية 'float' فإن تنصيب قيمة بدئية ليس له أي تأثير.
-> كل الحقول تعود ب None‏ إذا ألغى المستخدم الحوار.

حسنا، كفانا كلاما ولنرى شيئًا عمليًا.

جلب الدالة query من الوحدة القياسية للواجهة الرسومية في PyS60

from appuifw import query

الآن أصبحنا جاهزين لتجربتها، فلنقم بذلك..

query=query(u'is python fun?', 'query') if query==1: print "it really fun" else: print "why not !!!!?"

Image1: query-OK-Cancel.jpg

الحصول على مدخلات من لوحة المفاتيح...

code=query(u'Type password..','code') print code

Image2: query-code.jpg

text=query(u'Type something..','text', u'text here') print text

Image3: query-text.jpg

number=query(u'Type numbers..','number',123) print number

Image4: query-number.jpg

_float=query(u'Type numbers..','float',123.0) print _float

Image5: query-float.jpg

time=query(u'Type the time you want','time',43200.0) print time

Image6: query-time.jpg

date=query(u'Type the date you want','date',755992800.0) print date

Image7: query-date.jpg

لم ننته بعد ففي جعبتي الكثير، فماذا لو رغبنا بطلب مدخلين دفعة واحدة من المستخدم!
*. الدالة multi_query‏ ‏، صيغتها كالتالي:

multi_query(label_1, label_2)

تقدم مربع حوار بحقلي إدخال نصيين(Unicode) ، تعود بصف tuple‏ يحوي القيمتين المدخلتين وبـ None‏ إذا ألغى المستخدم مربع الحوار.
- لا يوجد قيم إفتراضية للحقول.

from appuifw import multi_query mQuery=multi_query(u'Type text_1', u'Type text_2') print mQuery #if mQuery: # var1, var2=mQuery

Image8: multi_query.jpg

ماذا إن أردت أن أظهر تساؤلا بغير الأشكال السابقة، ماذا إن تأخر المستخدم بالرد عن تساؤلي ، ماذا وماذا..... الحل تجده في الوحدة القياسية globalui‏ قبل البدء لم لا نبدأ بلمحة موجزة عنها:
تؤمن الوحدة globalui‏ تنبيهات وتساؤلات تظهر في واجهة مستخدم سلسلة ٦٠ العالمية (S60 global UI) ؛ تفيد في حالة التطبيقات التي ليس لها واجهة مستخدم رسومية.
*. الدالة global_query‏ ‏، صيغتها كالتالي:

global_query(query_text[, timeout])

تعرض تأكيد عام (نعم/لا) ذي النص query_text‏ ‏(Unicode). تعود ب 1 إذا ضغط المستخدم 'نعم' و ب 0 عكس ذلك. إذا لم يستجب المستخدم للتساؤل خلال ثوان المهلة timeout‏ فستعود ب None‏ ‏. إذا كانت ثوان المهلة صفر (وهي القيمة الإفتراضية/التفضيلية) فسينتظر التساؤل حتما من أجل دخل المستخدم.
يجب أن تكون قيمة وقت المهلة عددا صحيحا/طبيعيا.

from globalui import global_query from time import sleep from msys import send_bg out=global_query(u"do you want to go outside the program?", 5) #waits 5 seconds. if out: send_bg() #send program to background sleep(6) #sleeps 6 seconds global_query(u"i'm global, Are you okay with that?")

Image9: global_query.jpg

*. الدالة global_msg_query‏ ‏، صيغتها كالتالي:

global_msg_query(query_text, header_text[, timeout])

تعرض رسالة عالمية ذات النص query_text‏ ‏(Unicode) وتحمل العنوان header_text. تعود ب 1 إذا ضغط المستخدم 'موافق' و ب 0 عكس ذلك. إذا لم يستجب المستخدم للتساؤل خلال ثوان المهلة timeout‏ فستعود ب None‏ ‏. إذا كانت ثوان المهلة صفر (وهي القيمة الإفتراضية/التفضيلية) فسينتظر التساؤل حتما من أجل دخل المستخدم.
يجب أن تكون قيمة وقت المهلة عددا صحيحا/طبيعيا.

from globalui import global_msg_query from time import sleep from msys import send_bg send_bg() #send program to background sleep(6) #sleeps 6 seconds global_msg_query(u"This message from me 'Samer jabal' to You :\nAlways believe in your idea, let it shine and lighten your ways.", u'Licenses', 5) #waits for 5 seconds

Image10: global_msg_query.jpg

التنبيهات
إسمها يدل على ما تقوم به، فليس هدفها سؤال المستخدم أو طلب مدخل منه.. سنرى ما تقوم به من خلال قرائتنا.
*. الوحدة appuifw‏ تحوي الدالة note‏ ‏، صيغتها كالتالي:

note(text[, type[, global]])

تعرض تنبيه يظهر النص text(Unicode) وبحسب النوع type المختار يتغير الشكل. يمكن لقيمة النوع type‏ أن تكون أحد السلاسل النصية التالية:

'error',‏ ‏'info'(الإفتراضية‏‏),‏ ‏'conf'.

إذا لم يحدد النوع فإنه ينصب: 'info'.
إذا كانت قيمة global‏(عدد صحيح/طبيعي) أي عدد عدا الصفر فإن تنبيها عالميا سيعرض؛ التنبيه العالمي يعرض حتى لو طلبت الدالة في الخلفية.
الأمثلة التالية تظهر إستخدام الدالة:

from appuifw import note note(u'This is a local Note', 'info', 0) #or just like this: #note(u'This is a local Note') #note(u'This is a local Note', 'info')

Image11: note-info-Non global.jpg

from appuifw import note from msys import send_bg from time import sleep #just to show you how to take a screen shot for global notes without any external program. # from graphics import screenshot #to take a shot of screen send_bg() sleep(4) note(u'This is a global Error Note', 'error', 1) # screenshot().save('C:\\Nokia\\Images\\ScreenSnap\\note-error-global.jpg', callback=None, quality=75, bpp=1, compression='best')

Image12: note-error-global.jpg

from appuifw import note from msys import send_bg from time import sleep send_bg() sleep(4) note(u'This is a global Confirm Note', 'conf', 1)

Image13: note-conf-global.jpg

*. الوحدة globalui‏ توفر الدالة global_note‏ ‏، صيغتها كالتالي:

global_note(note_text[, type])

حيث تقوم بنفس مهمة الشكل العالمي من الدالة note‏ الموجودة في الوحدة appuifw، التي صيغتها العامة كالتالي:

note(text[, type[, 1]])

لكن مع توفر خيارات أوسع من ناحية النوع type.
- خيارات النوع المتاحة هي:

'info'(الإفتراضية), 'error', 'text', 'warn', 'charging', 'wait', 'perm', 'not_charging', 'battery_full', 'battery_low', 'recharge_battery', 'confirm'.

الأنواع: info,‎ error,‎ confirm‏ تظهر ذات الأشكال المتوفرة في الدالة note‏ الموجودة في الوحدة appuifw. لذلك سأضع أمثلة عن الأشكال الجديدة..

from globalui import global_note from msys import send_bg from time import sleep send_bg() sleep(2) #ثانيتين #تعرض فقط نصا دون أي شكل global_note(u'text !', 'text') #just displays text without any figure sleep(2) global_note(u"warning !", 'warn') sleep(2) global_note(u"charging !", 'charging') sleep(2) global_note(u"not_charging !", 'not_charging') sleep(2) global_note(u"battery_low !", 'battery_low') sleep(2) global_note(u"recharge_battery !", 'recharge_battery') sleep(2) global_note(u"Fully Charged!", 'battery_full') sleep(2) global_note(u"wait !", 'wait') sleep(2) global_note(u"confirm !", 'confirm') sleep(2) """هذه لن تنتهي لأنها دائمة permanent‏ ‏، يمكنك إنهاؤها بإعادة تشغيل هاتفك !!""" global_note(u"permanent !", 'perm') 

Image14: global_note-text.jpg

Image15: global_note-warn.jpg

Image16: global_note-charging.jpg

Image17: global_note-not charging.jpg

Image18: global_note-battery low.jpg

Image19: global_note-recharge battery.jpg

Image20: global_note-battery full.jpg

Image21: global_note-wait.jpg

Image22: global_note-confirm.jpg

Image23: global_note-perm.jpg

*. قد تضطر لعرض رسالة طويلة للمستخدم وتنتظر منه ردا مناسبا، في هذه الحالة الوحدة msgquery‏ ‏ "رسالة تساؤل" ستفي بالغرض.
- تحوي الوحدة دالة وحيدة infopopup() لها عدة أعلام flags‏ سنتطرق لها تباعا.. صيغتها كالتالي:

infopopup(message, title, flag)

كما ترى فكل الجدليات arguments إجبارية.
الرسالة message‏ ‏: هي الرسالة التي ستعرض للمستخدم داخل التساؤل.
العنوان title : هو عنوان الرسالة، سيظهر فوقها.
العلم flag : سيحدد الخيارات المتاحة للمستخدم للرد بشكل ملائم.
الأعلام المتاحة هي:

'LYesRNo', 'OKRBack', 'OKRCancel', 'OKREmpty', 'RBack', 'RCancel', 'RClose'

سأعرضها الآن فتابع معي:
(ستعرض الأعلام تبعا للخيارات المرتبطة بأحداث الزر الأملس soft الأيمن والأيسر)

١) الأيسر: نعم ، الأيمن: لا - LYesRNo

#قبل البدء سنستورد/نجلب الدالة من الوحدة وأيضا العلم المراد إستخدامه: from msgquery import infopopup, LYesRNo # Left-Yes Right-No infopopup(u"text", u"title", LYesRNo) #أو هكذا، إذا فقط قمنا بجلب الوحدة: #import msgquery #msgquery.infopopup(u"text", u"title", msgquery.LYesRNo)

Image24: msgquery-yes-no.jpg

٢) الأيسر: موافق ، الأيمن: رجوع - OKRBack

from msgquery import infopopup, OKRBack # OK Right-Back infopopup(u"text", u"title", OKRBack)

Image25: msgquery-ok-back.jpg

٣) الأيسر: موافق ، الأيمن: إلغاء - OKRCancel

from msgquery import infopopup, OKRCancel # OK Right-Cancel infopopup(u"text", u"title", OKRCancel)

Image26: msgquery-ok-cancel.jpg

٤) الأيسر: موافق ، الأيمن: فارغ - OKREmpty

from msgquery import infopopup, OKREmpty # OK Right-Empty infopopup(u"text", u"title", OKREmpty)

Image27: msgquery-ok.jpg

٥) الأيسر: فارغ ، الأيمن: رجوع - RBack

from msgquery import infopopup, RBack # Right-Back infopopup(u"text", u"title", RBack)

Image28: msgquery-back.jpg

٦) الأيسر: فارغ ، الأيمن: إلغاء - RCancel

from msgquery import infopopup, RCancel # Right-Cancel infopopup(u"text", u"title", RCancel)

Image29: msgquery-cancel.jpg

٧) الأيسر: فارغ ، الأيمن: إغلاق - RClose

from msgquery import infopopup, RClose # Right-Close infopopup(u"text", u"title", RClose)

Image30: msgquery-close.jpg

*. آخر ما سأتحدث عنه، تنبيه من نوع مختلف بإستخدام الوحدة TopWindow‏ لكن إعتبر التالي كمثال ولا تحصر تفكيرك بما يمكنك القيام به فيها *حرر تفكيرك* ، وحدة Note‏ تقدم الصنف note‏ الذي يمكن إستخدامه لعرض تنبيهات تظهر فوق كل واجهات جهازك فهو كإسم الوحدة المستخدمة في شفرته المصدرية: TopWindow‏(النافذة العُلوية(بضم العين))، سأشرح كيفية إستخدامها من خلال المثال التالي:

from Note import note from e32 import ao_sleep #جلب دالة النوم المتعلقة بالنظام‏(كائن فعال‏)‏ n=note() #إنشاء كائن من الصنف #الصفة self.cvet‏ هي صف tuple‏ ذي طول 3 ‏(أي بمؤشرات: 0، 1 و 2) تحوي ثلاثة ألوان: #[0] أزرق 0x7f8fef‏ ‏، vid=0 #[1] أخضر 0x00ff00‏ ‏، vid=1 #[2] أحمر 0xff0000‏ ‏، vid=2 wait=3 #ثوان n.note(note="This is a TopWindow Note.", name="The Title", vid=0, sek=wait) ao_sleep(wait) n.note(note="This is a TopWindow 'Succeeds' Note.", name="Succeeds", vid=1, sek=wait) ao_sleep(wait) n.note(note="This is a TopWindow 'Try Again' Note.", name="Try Again", vid=0, sek=wait) ao_sleep(wait) n.note(note="This is a TopWindow 'Warning' Note.", name="Warning", vid=2, sek=wait) ao_sleep(wait) #إذا أردت أن أضع حدا لها قبل أن تنتهي، أستخدم الوسيلة: #n.hide()

Image31: Note-1.jpg

Image32: Note-2.jpg

Image33: Note-3.jpg

Image34: Note-4.jpg

الشفرات المصدرية للوحدة Note إذا أردت الإطلاع والإستفادة منها:

File: Note.py

import e32 import topwindow import akntextutils from graphics import * from sysinfo import display_pixels (screen_width,screen_height)=display_pixels() s_x=screen_width/176. s_y=screen_height/208. class note: def __init__(self): self.cvet=(0x7f8fef,0x00ff00,0xff0000) self.t_img_s=0 self.__gTimer = e32.Ao_timer() self.t_img=topwindow.TopWindow() self.t_img.background_color=0xffffff self.t_img.position=(12*s_x,70*s_y) self.t_img.shadow=2 def note(self,note,name='',vid=0,sek=4): try: note=akntextutils.wrap_text_to_array(unicode(note,'utf-8'),u'latinbold12',166*s_x) f=Image.new((148*s_x,(16+22*len(note))*s_y)) f.rectangle((0,0,148*s_x,(16+22*len(note))*s_y),fill=0xdfefef) f.rectangle((1*s_x,1*s_y,147*s_x,16*s_y),fill=self.cvet[vid]) f.text((5*s_x,12*s_y),unicode(name,'utf-8'),0x836699,font=u'latinbold12') m=0 for x in note: m+=1 f.text((5*s_x,(12+20*m)*s_y),x,0x336699,font=u'latinbold12') e32.reset_inactivity() self.t_img.size=(150*s_x,(16+22*len(note))*s_y) self.t_img_s=1 self.t_img.add_image(f,(2,2)) self.t_img.show() self.__gTimer.after(sek, self.hide) except: print 'error in note' def hide(self): if self.t_img_s: self.t_img.hide() self.t_img_s=0 if __name__ == '__main__': n=note() n.note('ä½śèE… VIP666VIP icq:430011011\n',' INFO',vid=1,sek=5)

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