Getting Started Programming with Qt/ar

From Qt Wiki
< Getting Started Programming with Qt
Revision as of 15:30, 14 January 2015 by Maintenance script (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

<hr>
<h1 dir=“rtl” lang=“ar” align=“right”> الشروع في برمجة QT:</h1>
<hr>
<p dir=“rtl” lang=“ar” align=“right”> مرحباً بك في عالم Qt — واجهة أدوات المستخدم الرسومية متعددة المنصات (The cross-platform GUI toolkit). في هذا الدليل، سنتعلم أساسيات QT من خلال إنشاء تطبيق مفكرة بسيطة. بعد قراءة هذا الدليل ، يجب أن تكون جاهزا للخوض في اللمحات العامة والثائق و Qt API ، والعثور على المعلومات التي تحتاج إليها لتطبيقك.</p>
<hr>
<h2 dir=“rtl” lang=“ar” align=“right”>مثال: Hello Notepad</h2>
<hr>
<p dir=“rtl” lang=“ar” align=“right”>في المثال الأول، ونحن ببساطة نقوم بإنشاء وإظهار محرر النصوص في إطار نافذة على سطح المكتب. ويمثل هذا أبسط برنامج Qt ممكن لواجهة المستخدم الرسومية.</p>
<p dir=“rtl” lang=“ar” align=“middle”>
محرر نصوص بسيط
</p>
<p dir=“rtl” lang=“ar” align=“right”>التالي هو البرنامج المصدر:</p>
<p dir=“rtl” lang=“ar” align=“right”>التالي شرح البرنامج سطرارا بسطر. في السطرين الأولين، نقوم بتضمين الملفات رأس (Header files) الخاضة بـ QApplication و QTextEdit – فئتين (classes) اللازمتان لهذا المثال. لجميع الطبقات في Qt ملف رأس المسمى بنفس الإسم – All Qt classes have a header file named after them.</p>
<p dir=“rtl” lang=“ar” align=“right”>في السطر ٦ نقوم بإنشاء كائن QApplication. هذا الكائن يدير موارد التطبيق، وهو ضروري لتشغيل أي برنامج Qt يحتوي على واجهة المستخدم الرسومية. كما أنها تحتاج الى argv و args لأن Qt تقبل القليل من متغيدات ومدخلات التشغيل من السطر ٤ – command line arguments.</p>
<p dir=“rtl” lang=“ar” align=“right”>في السطر ٨ نقوم بخلق الكائن محرر نصوص QTextEdit. محرر نصوص هو عنصر بصري – visual element – في واجهة المستخدم الرسومية. في Qt ندعو هذه العناصر بالحاجيات – widgets. ومن الأمثلة على غيرها من الحاجيات وشريط التمرير – scroll bars – أزرار الراديو – radio buttons – ، والتسميات – labels، ويمكن أيضا أن تكون الحاجيات حاوية لغيرها؛ كما في إطار التطبيق الرئيسي ، على سبيل المثال.</p>
<p dir=“rtl” lang=“ar” align=“right”>السطر ٩ يظهر محرر النصوص على الشاشة في إطاره الخاص. وكما أن الحاجيات تعمل أيضا كحاويات لبعضها (على سبيل المثال لـ QMainWindow الذي يحتوي أشرطة الأدوات والقوائم وشريط المعلومات ، وغيرها من الحاجيات) ، فمن الممكن أن تظهر القطعة واحدة في الإطار الخاص بها. الحاجيات غير مرئية بطبعتها؛ لكن باستخدام الدالة show() تصبح القطعة مرئية.</p>
<p dir=“rtl” lang=“ar” align=“right”>السطر ١١يجعل QApplication يدخل في حلقة حداث – event loop -. أثناء عمل تطبيق Qt، يتم إنشاء الأحداث وإرسالها إلى الحاجيات في التطبيق. وكمثال على الأحداث نقر الفأرة والضغط على لوحة المفاتيح. عند كتابة نص في حاجية محرر النصوص، يتلقى المحرر أحداث ضغط مفتاح – key pressed events – ويستجيب من خلال رسم النص المكتوب في المحرر.</p>
<p dir=“rtl” lang=“ar” align=“right”>لتشغيل التطبيق ، افتح موجه الأوامر CMD ، وأدخل دليل ملف .cpp الذي لديك من البرنامج. أدخل الأوامر لتالية لبناء البرنامج.</p>
<p dir=“rtl” lang=“ar” align=“right”> هذا وسوف ينشئ ملفاً تفيذياً في الدليل part1 (قد تضطر في ويندوزإلى استخدام nmake بدلا من make ، كما توضع الملف القابل للتنفيذ في part1/debug أو part1/release). qmakeهي أداة البناء في Qt، والتي تأخذ ملف الإعدادات – configuration file. qmake يولد ملف الإعدادات عندما يدفق الأمر بالدالة -project كما في السطر الأول من الأوامر السابقة.qmake بالإستعانة مع ملف الإعدادات ذي الإمتداد .pro تنتج MAKEFILE الذي سيبني البرنامج لك. لاحقا سنقوم بالكتابة ملفات .pro .</p>
<h4 dir=“rtl” lang=“ar” align=“right”>لمعرقة المزيد: </h4>
<p><table class=“generic” dir=“rtl” lang=“ar” align=“right”>
<thead><tr class=“qt-style topAlign”>

الموضوع انقر هنا
</thead>
<tbody><tr class=“odd topAlign”>
<p>الحاجيات والهندسة النوافة</p>

<p>
<a href=“>حاجيات http://doc.qt.nokia.com/4.7/application-windows.html”>حاجيات النوافذ</a></p>


<tr class=“even topAlign”>
<p>الأحداث والتعامل مع الحدث</p>

<p><a href=“>نظام http://doc.qt.nokia.com/4.7/eventsandfilters.html”>نظام الأحداث</a></p>


</tbody>

</p>
<br \><br \><br \><br \>
<br \><br \><br \><br \>
<hr>
<h2 dir=“rtl” lang=“ar” align=“right”>إضافة زر إنهاء</h2>
<hr>
<p dir=“rtl” lang=“ar” align=“right”>في تطبيق حقيقي ، وسوف تحتاج عادة أكثر من حاجية واحدة. وسوف نعرض الآن QPushButton تحت محرر النصوص. الزر وسوف ينهي تطبيق المفكرة عندالضغط عليه (أي ، عند نقره بالماوس).</p>
<p dir=“rtl” lang=“ar” align=“middle”>
محرر نصوص بسيط
</p>
<p dir=“rtl” lang=“ar” align=“right”>دعونا نلقي نظرة على المصدر:</p>
<p dir=“rtl” lang=“ar” align=“right”>ويشمل السطر ١ على QtGui، الذي يحتوي على كافة طبقات واجهة المستخدم الرسومية في Qt.</p>
<p dir=“rtl” lang=“ar” align=“right”>السطر ١٠ ويستخدم آلية الإشارات والفتحات الآلية في Qt’s Signals and Slots mechanism – Qt – لإنهاء التطبيق عند دفع زر خروج – Quit button. الفتحة الآلية هي الدالة التي يمكن استدعاؤها في وقت التشغيل باستخدام اسمها (كسلسلة حرفية). الإشارة هي الدالة التي سوف تستدعي جميع الفتحات الآلية المسجلية لديها ، ونحن نستدعي السطر ١٠ لخلق التواصل بين فتحة للإشارة ولإصدار الإشارة – emit the signal.</p>
quit<p dir=“rtl” lang=“ar” align=“right”>() هي فتحة من QApplication والتي تنهي التطبيق. clicked() هي إشارة في QPushButton تنبعث عندما الضغط على الزر. الدالة ثابتة QObject : : connect() تربط فتحة بإشارة. SIGANL و SLOT هما وحدات الماكرو التي تتخذ التوقيعات الإشارة والفتحة للتواصل. نحن بحاجة أيضا إلى إعطاء مؤشرات إلى الكائنات التي ينبغي إرسال واستقبال الإشارة.</p>
<p dir=“rtl” lang=“ar” align=“right”>السطر ١٢ يخلق QVBoxLayout . وكما ذكر ، يمكن أن تحتوي الحاجيات على الحاجيات الأخرى. فمن الممكن لتعيين حدود (الموقع والحجم) الحاجية الطفل مباشرة، ولكن من الأسهل عادة إلى استخدام التخطيط – layout. التخطيط يدير حدود الحاجية الطفل. QVBoxLayout ، على سبيل المثال ، يضع الحاجيات الأطفال في صف واحد عمودي.</p>
<p dir=“rtl” lang=“ar” align=“right”>سطر ١٣ و ١٤ ويضيفان محرر النصوص والزر إلى التخطيط. في السطر ١٧، وضعنا التخطيط على الحاجية.</p>
<h4 dir=“rtl” lang=“ar” align=“right”>لمعرقة المزيد: </h4>
<table class=“generic” dir=“rtl” lang=“ar” align=“right”>
<thead><tr class=“qt-style topAlign”>

الموضوع انقر هنا
</thead>
<tbody><tr class=“odd topAlign”>
<p>الإشارات والفتحات الآلية</p>

<p><a href=“>Signals http://doc.qt.nokia.com/4.7/signalsandslots.html”>Signals & Slots</a></p>


<tr class=“even topAlign”>
<p>التخطيط</p>

<p><a href=“>Layout http://doc.qt.nokia.com/4.7/layout.htm”>Layout Management</a>, <a href=“>Widgets http://doc.qt.nokia.com/4.7/widgets-and-layouts.html”>Widgets and Layouts</a>, <a href=“>Layout http://doc.qt.nokia.com/4.7/examples-layouts.html”>Layout Examples</a></p>


<tr class=“odd topAlign”>
<p>الحاجيات المرفقة ب Qt</p>

<p><a href=“>Qt http://doc.qt.nokia.com/4.7/gallery.html”>Qt Widget Gallery</a>, <a href=“>Widget http://doc.qt.nokia.com/4.7/examples-widgets.html”>Widget Examples</a></p>


</tbody>


<br \><br \><br \><br \>
<br \><br \><br \><br \>
<hr>
<h2 dir=“rtl” lang=“ar” align=“right”>تفريع الفئة QWidget </h2>
<hr>
<p dir=“rtl” lang=“ar” align=“right”>عندما يريد المستخدم إنهاء تطبيق قد تحتاج إلى نافذة حوار تسأله ما إذا كان يرغب حقا في الخروج. في هذا المثال ، سنشئ فئة فرعية QWidget ، ونضيف فتحة لها لتواصل مع الزر إنهاء.
</p>
<p dir=“rtl” lang=“ar” align=“middle”>
محرر نصوص بسيط
</p>
<p dir=“rtl” lang=“ar” align=“right”>التالي هو البرنامج المصدر:</p>
<p dir=“rtl” lang=“ar” align=“right”> الماكرو Q_OBJECT ويجب أن يكون الأول في تعريف الفئة، ويعلن – declares – عن الفئة باعتبارها QObject (وبطبيعة الحال ، لا بد أيضا من وراثة QObject ). و QObject يضيف قدرات عدة على الطبقة العادية في C++. خاصة ، ويمكن الاستعلام عن اسم الفئة والفتحة في وقت التشغيل. ومن الممكن أيضا للاستعلام أنواع معالم الفتحة واستدعاؤها.</p>
<p dir=“rtl” lang=“ar” align=“right”>السر ١٣ يعلن عن فتحة quit(). هذا هو السهل استخدام الماكرو slots. والآن فتحة quit() يمكن أن تكون مرتبطة إلى أي إشارة مع توقيع مطابقة (أي إشارة لا تأخذ أية معالم).</p>
<p dir=“rtl” lang=“ar” align=“right”>بدلا من إنشاء واجهة المستخدم الرسومية وتوصيل فتحة في الدالة main() ، سنستخدم منشئ المفكرة – Notepad’s constructor.</p>
<p dir=“rtl” lang=“ar” align=“right”>كما رأيتم في تعريف الفئة ، نحن نستخدم مؤشرات QObject (textEdit وquitButton). وكقاعدة عامة ، يجب عليك دائما تخصيص QObject ق على كومة – heap – وليس نسخها.</p>
<p dir=“rtl” lang=“ar” align=“right”>ونحن الآن استخدام الدالة tr() حول النصوص المرئية لدينا. هذه الدالة ضرورية عندما تريد أن يعمل برنامج في أكثر من لغة واحدة (مثل الانكليزية والصينية). ولن أخوض في التفاصيل هنا، ولكن يمكنك اتباع الرابط اللغوي Qt من معرفة المزيد الجدول.</p>
<h4 dir=“rtl” lang=“ar” align=“right”>لمعرقة المزيد: </h4>
<table class=“generic” dir=“rtl” lang=“ar” align=“right”>
<thead><tr class=“qt-style topAlign”>

الموضوع انقر هنا
</thead>
<tbody><tr class=“odd topAlign”>
<p>tr() والتدويل – internationalization</p>

<p><a href=“>Qt http://doc.qt.nokia.com/4.7/linguist-manual.html”>Qt Linguist Manual</a>, <a href=“>Writing http://doc.qt.nokia.com/4.7/i18n-source-translation.html”>Writing Source Code for Translation</a>, <a href=“>Hello http://doc.qt.nokia.com/4.7/linguist-hellotr.html”>Hello tr</a>() Example, <a href=“>Internationalization http://doc.qt.nokia.com/4.7/internationalization.html”>Internationalization with Qt</a></p>


<tr class=“even topAlign”>

<p><a href=“>QObjects</a> http://doc.qt.nokia.com/4.7/qtwebkit-bridge.html#qobjects”>QObjects</a> and the Qt Object model (This is essential to understand Qt)</p>

<p><a href=“>Object http://doc.qt.nokia.com/4.7/object.html”>Object Model</a></p>


<tr class=“odd topAlign”>
<p>qmake و نظام البناء في Qt</p>

<p><a href=“>qmake http://doc.qt.nokia.com/4.7/qmake-manual.html”>qmake Manual</a></p>


</tbody>


<br \><br \><br \><br \>
<br \><br \><br \><br \>
<hr>
<h2 dir=“rtl” lang=“ar” align=“right”>إنشاء الملف .pro</h2>
<hr>
<p dir=“rtl” lang=“ar” align=“right”>على سبيل المثال، سنكتب ملف .pro الخاص بنا بدلا من استخدام qmake -project:</p>
<p dir=“rtl” lang=“ar” align=“right”>والأوامر التالية في CMD تقوم بالبناء:</p>
<hr>
<h2 dir=“rtl” lang=“ar” align=“right”>استخدام QMainWindow</h2>
<hr>
<p dir=“rtl” lang=“ar” align=“right”>تستفيد العديد من التطبيقات باستخدام QMainWindow التي لها تخطيطها الخاصة الذي يمكنك من إضافة شريط القوائم ، وأشرطة الأدوات ، وشريط الحالة. QMainWindow تحتوي على مساحة المركز الذي يمكن أن يشغلها أي نوع من الحاجيات. في حالتنا ، وسوف نضع محرر النصوص هناك.</p>
<p dir=“rtl” lang=“ar” align=“middle”>
محرر نصوص بسيط
</p>
<p dir=“rtl” lang=“ar” align=“right”>التالي هو تعريف المفكرة الجديد:</p>
<p dir=“rtl” lang=“ar” align=“right”>في المقطع التالي نسنضيف فتحتان جديدتان تمكناننا من حفظ وفتح مستند. </p>
<p dir=“rtl” lang=“ar” align=“right”>في كثير من الأحيان ، في النافذة الرئيسية ، ينبغي إسناد حاجيات عدة إلى فتحة واحدة. كما في عناصر القائمة والأزرار على شريط الأدوات. لجعل هذا أسهل ، Qt توفر QAction ، والتي يمكن أن تعطى لالحاجيات عدة ، وتكون مرتبطة إلى فتحة واحدة. على سبيل المثال ، يمكن إنشاء عناصر القائمة وأزرار الأدوات QMenu و QToolBar من نفس QAction. وسوف نرى كيف يعمل هذا في قريبا.</p>
<p dir=“rtl” lang=“ar” align=“right”>كما كان من قبل ، ونحن نستخدم منشئ المفكرة لإعداد واجهة المستخدم الرسومية.</p>
<p dir=“rtl” lang=“ar” align=“right”>يتم إنشاء QAction مع النص الذي يجب أن تظهر على الحاجيات التي نضيفها لهم (في حالتنا ، عناصر القائمة). إذا أردنا أيضا لإضافتها إلى شريط الأدوات ، يمكن للإجراءات – Actions – أن تحوي رموزا.</p>
<p dir=“rtl” lang=“ar” align=“right”>عند النقر فوق عناصر قائمة الآن ، سوف تستدعي الإجراء، وسيتم استدعاء كل فتحات المرتبطة بهذا الإجراء.</p>
<h4 dir=“rtl” lang=“ar” align=“right”>لمعرقة المزيد: </h4>
<table class=“generic” dir=“rtl” lang=“ar” align=“right”>
<thead><tr class=“qt-style topAlign”>

الموضوع انقر هنا
</thead>
<tbody><tr class=“odd topAlign”>
<p>النوافذ الرئيسية والطبقات النافذة الرئيسية</p> <p><a >Application Main Window</a>, <a >Main Window Examples</a></p>

<tr class=“even topAlign”>
<p>تطبيقات النوافذ الداخلية</p>

<p><a href=“>QMdiArea</a>, http://doc.qt.nokia.com/4.7/qmdiarea.html”>QMdiArea</a>, <a href=“> http://doc.qt.nokia.com/4.7/mainwindows-mdi.html”>MDI Example</a></p>


</tbody>


<br \><br \><br \><br \>
<br \><br \><br \><br \>
<hr>
<h2 dir=“rtl” lang=“ar” align=“right”>فتح وحفظ الملفات</h2>
<hr>
<p dir=“rtl” lang=“ar” align=“right”>في هذا المثال ، وسوف ننفذ وظائف الفتحات save() & load() التي أضيفت في المثال السابق.</p>
<p dir=“rtl” lang=“ar” align=“middle”>
محرر نصوص بسيط جدا
</p>
<p dir=“rtl” lang=“ar” align=“right”> سنبدأ مع فتحة open():</p>
<p dir=“rtl” lang=“ar” align=“right”>والخطوة الأولى هي تطلب من المستخدم hلحصول على اسم الملف لفتحه. Qt تأتي مع QFileDialog ، وهي النافذة التي تمكن المستخدم من تحديد ملف. وتوضح الصورة أعلاه التافذة في نتظام تشغيل Kubuntu. الدالة ثابتة ()getOpenFileName تعرض نافذة اختيار الملف، ولا يعود – return – حتى يحدد المستخدم ملف المطلوب. والتي ترجع مسار الملف المختار أو نصا فارغا عند الإلغاء.</p>
<p dir=“rtl” lang=“ar” align=“right”>إذا كان لدينا اسم الملف ، نحاول فتح الملف مع open() ، والتي ترجع صحيحا – true -إذا أمكن فتح الملف. ونحن لن نتطرق إلى معالجة أخطاء الفتح هنا، ولكن يمكنك اتباع الروابط من معرفة المزيد. إذا لم يمكن فتح الملف ، ونحن نستخدم QMessageBox لعرض نافذة حوار تظهر رسالة خطأ (انظر وصف فئة QMessageBox للمزيد من التفاصيل).</p>
<p dir=“rtl” lang=“ar” align=“right”>في الحقيقة القراءة بيانات من ملف هي عملية سهلة باستخدام دالة readAll()، والتي ترجع كافة البيانات في الملف على هيأة QByteArray . و الدالة constData() تقوم بإرجاع كافة البيانات على هيأة const char* والتي تستخدم كمدخل لأحد منشئات QString. ويمكن بعد ذلك يتم عرض المحتويات في محرر النصوص. ثم ننهي باستخدام close() التي تعيد واصف الملف – file descriptor – إلى نظام التشغيل.</p>
<p dir=“rtl” lang=“ar” align=“right”>الآن ، دعونا ننتقل إلى حفظ فتحة) (.</p>
<p dir=“rtl” lang=“ar” align=“right”>عندما نكتب محتويات محرر النصوص إلى الملف ، استخدام الطبقة QTextStream ، التي يشتمل الكائن QFile. QTextStream يمكنه كتابة QStrings مباشرة إلى الملف – QFile لا يقبل إلا البيانات الخام من نوع (char *) مع دالات write() التابعة لـQIODevice .</p>
<h4 dir=“rtl” lang=“ar” align=“right”>لمعرقة المزيد: </h4>
<table class=“generic” dir=“rtl” lang=“ar” align=“right”>
<thead><tr class=“qt-style topAlign”>

الموضوع انقر هنا
</thead>
<tbody><tr class=“odd topAlign”>
<p>الملفات و أدوات الإدخال والإخراج</p>

<p><a href=“>QFile</a>, http://doc.qt.nokia.com/4.7/qfile.html”>QFile</a>, <a href=“> http://doc.qt.nokia.com/4.7/qiodevice.html”>QIODevice</a></p>


</tbody>


<br \><br \><br \><br \>
<br \><br \><br \><br \>
<hr>