Qt wiki will be updated on October 12th 2023 starting at 11:30 AM (EEST) and the maintenance will last around 2-3 hours. During the maintenance the site will be unavailable.
Getting Started Programming with Qt/ar
<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>
#include <QApplication&gt;<br />#include <QTextEdit&gt;
int main(int argv, char **args)<br />{<br /> QApplication app(argv, args);
QTextEdit textEdit;<br /> textEdit.show();
return app.exec&amp;#40;&#41;;<br />}
<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>
qmake <s>project<br /> qmake<br /> make
<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"><th>الموضوع</th><th>انقر هنا</th></tr></thead>
<tbody><tr class="odd topAlign"><td><p>الحاجيات والهندسة النوافة</p></td><td><p>
<a href="http://doc.qt.nokia.com/4.7/application-windows.html">حاجيات النوافذ</a></p></td></tr>
<tr class="even topAlign"><td><p>الأحداث والتعامل مع الحدث</p></td><td><p><a href="http://doc.qt.nokia.com/4.7/eventsandfilters.html">نظام الأحداث</a></p></td></tr>
</tbody></table></p>
<br gt;<br gt;<br gt;<br gt;
<br gt;<br gt;<br gt;<br gt;
<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>
#include <QtGui&gt;
<br />int main(int argv, char **args)<br />{<br /> QApplication app(argv, args);
<br /> QTextEdit textEdit;<br /> QPushButton quitButton("Quit&quot;);
<br /> QObject::connect(&quitButton, SIGNAL (clicked()), qApp, SLOT (quit()));
<br /> QVBoxLayout layout;<br /> layout.addWidget(&textEdit);<br /> layout.addWidget(&quitButton);
<br /> QWidget window;<br /> window.setLayout(&layout);
<br /> window.show();
<br /> return app.exec&amp;#40;&#41;;<br />}
Qt - لإنهاء التطبيق عند دفع زر خروج - Quit button. الفتحة الآلية هي الدالة التي يمكن استدعاؤها في وقت التشغيل باستخدام اسمها (كسلسلة حرفية). الإشارة هي الدالة التي سوف تستدعي جميع الفتحات الآلية المسجلية لديها ، ونحن نستدعي السطر ١٠ لخلق التواصل بين فتحة للإشارة ولإصدار الإشارة - emit the signal.</p>
<p dir="rtl" lang="ar" align="right">ويشمل السطر ١ على QtGui، الذي يحتوي على كافة طبقات واجهة المستخدم الرسومية في Qt.</p>
<p dir="rtl" lang="ar" align="right">السطر ١٠ ويستخدم آلية الإشارات والفتحات الآلية في Qt's Signals and Slots mechanism
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"><th>الموضوع</th><th>انقر هنا</th></tr></thead>
<tbody><tr class="odd topAlign"><td><p>الإشارات والفتحات الآلية</p></td><td><p><a href="http://doc.qt.nokia.com/4.7/signalsandslots.html">Signals & Slots</a></p></td></tr>
<tr class="even topAlign"><td><p>التخطيط</p></td><td><p><a href="http://doc.qt.nokia.com/4.7/layout.htm">Layout Management</a>, <a href="http://doc.qt.nokia.com/4.7/widgets-and-layouts.html">Widgets and Layouts</a>, <a href="http://doc.qt.nokia.com/4.7/examples-layouts.html">Layout Examples</a></p></td></tr>
<tr class="odd topAlign"><td><p>الحاجيات المرفقة ب Qt</p></td><td><p><a href="http://doc.qt.nokia.com/4.7/gallery.html">Qt Widget Gallery</a>, <a href="http://doc.qt.nokia.com/4.7/examples-widgets.html">Widget Examples</a></p></td></tr>
</tbody></table>
<br gt;<br gt;<br gt;<br gt;
<br gt;<br gt;<br gt;<br gt;
<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>
class Notepad : public QWidget<br /> {<br /> Q_OBJECT
public:<br /> Notepad();
private slots:<br /> void quit();
private:<br /> QTextEdit *textEdit;<br /> QPushButton '''quitButton;<br />};
<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>
Notepad::Notepad()<br /> {<br /> textEdit = new QTextEdit;<br /> quitButton = new QPushButton(tr("Quit&quot;));
<br /> connect(quitButton, SIGNAL (clicked()), this, SLOT (quit()));
<br /> QVBoxLayout '''layout = new QVBoxLayout;<br /> layout->addWidget(textEdit);<br /> layout->addWidget(quitButton);
<br /> setLayout(layout);
<br /> setWindowTitle(tr("Notepad&quot;));<br /> }
<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"><th>الموضوع</th><th>انقر هنا</th></tr></thead>
<tbody><tr class="odd topAlign"><td><p>tr() والتدويل - internationalization</p></td><td><p><a href="http://doc.qt.nokia.com/4.7/linguist-manual.html">Qt Linguist Manual</a>, <a href="http://doc.qt.nokia.com/4.7/i18n-source-translation.html">Writing Source Code for Translation</a>, <a href="http://doc.qt.nokia.com/4.7/linguist-hellotr.html">Hello tr</a>() Example, <a href="http://doc.qt.nokia.com/4.7/internationalization.html">Internationalization with Qt</a></p></td></tr>
<tr class="even topAlign"><td><p><a href="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></td><td><p><a href="http://doc.qt.nokia.com/4.7/object.html">Object Model</a></p></td></tr>
<tr class="odd topAlign"><td><p>qmake و نظام البناء في Qt</p></td><td><p><a href="http://doc.qt.nokia.com/4.7/qmake-manual.html">qmake Manual</a></p></td></tr>
</tbody></table>
<br gt;<br gt;<br gt;<br gt;
<br gt;<br gt;<br gt;<br gt;
<hr>
<h2 dir="rtl" lang="ar" align="right">إنشاء الملف .pro</h2>
<hr>
<p dir="rtl" lang="ar" align="right">على سبيل المثال، سنكتب ملف .pro الخاص بنا بدلا من استخدام qmake project:</p>
HEADERS = notepad.h<br /> SOURCES = notepad.cpp main.cpp
<p dir="rtl" lang="ar" align="right">والأوامر التالية في CMD تقوم بالبناء:</p>
qmake<br /> make
<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>
#include <QtGui&gt;
<br /> class Notepad : public QMainWindow<br /> {<br /> Q_OBJECT
<br /> public:<br /> Notepad();
<br /> private slots:<br /> void open();<br /> void save();<br /> void quit();
<br /> private:<br /> QTextEdit *textEdit;
<br /> QAction *openAction;<br /> QAction *saveAction;<br /> QAction *exitAction;
<br /> QMenu '''fileMenu;<br />};
<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>
Notepad::Notepad()<br /> {<br /> saveAction = new QAction(tr("&Open&quot;), this);<br /> saveAction = new QAction(tr("&Save&quot;), this);<br /> exitAction = new QAction(tr("E&amp;xit&quot;), this);
<br /> connect(openAction, SIGNAL (triggered()), this, SLOT (open()));<br /> connect(saveAction, SIGNAL (triggered()), this, SLOT (save()));<br /> connect(exitAction, SIGNAL (triggered()), qApp, SLOT (quit()));
<br /> fileMenu = menuBar()<s>>addMenu(tr("&File&quot;));<br /> fileMenu</s>>addAction(openAction);<br /> fileMenu->addAction(saveAction);<br /> fileMenu->addSeparator();<br /> fileMenu->addAction(exitAction);
<br /> textEdit = new QTextEdit;<br /> setCentralWidget(textEdit);
<br /> setWindowTitle(tr("Notepad&quot;));<br /> }
<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"><th>الموضوع</th><th>انقر هنا</th></tr></thead>
<tbody><tr class="odd topAlign"><td><p>النوافذ الرئيسية والطبقات النافذة الرئيسية</p></td><td><p><a >Application Main Window</a>, <a >Main Window Examples</a></p></td></tr>
<tr class="even topAlign"><td><p>تطبيقات النوافذ الداخلية</p></td><td><p><a href="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></td></tr>
</tbody></table>
<br gt;<br gt;<br gt;<br gt;
<br gt;<br gt;<br gt;<br gt;
<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>
QString fileName = QFileDialog::getOpenFileName(this, tr("Open File&quot;), "",<br /> tr("Text Files ('''.txt);;C++ Files ('''.cpp'''.h)"));
<br /> if (fileName != "") {<br /> QFile file&amp;#40;fileName&amp;#41;;<br /> if (!file.open(QIODevice::ReadOnly)) {<br /> QMessageBox::critical(this, tr("Error&quot;),<br /> tr("Could not open file&quot;));<br /> return;<br /> }<br /> QString contents = file.readAll().constData();<br /> textEdit</s>>setPlainText(contents);<br /> file.close();<br /> }
<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> file descriptor - إلى نظام التشغيل.</p>
<p dir="rtl" lang="ar" align="right">في الحقيقة القراءة بيانات من ملف هي عملية سهلة باستخدام دالة readAll()، والتي ترجع كافة البيانات في الملف على هيأة QByteArray . و الدالة constData() تقوم بإرجاع كافة البيانات على هيأة const char* والتي تستخدم كمدخل لأحد منشئات QString. ويمكن بعد ذلك يتم عرض المحتويات في محرر النصوص. ثم ننهي باستخدام close() التي تعيد واصف الملف
<p dir="rtl" lang="ar" align="right">الآن ، دعونا ننتقل إلى حفظ فتحة) (.</p>
QString fileName = QFileDialog::getSaveFileName(this, tr("Save File&quot;), "",<br /> tr("Text Files ('''.txt);;C''+ Files ('''.cpp '''.h)"));
<br /> if (fileName != "") {<br /> QFile file&amp;#40;fileName&amp;#41;;<br /> if (!file.open(QIODevice::WriteOnly)) {<br /> // error message<br /> } else {<br /> QTextStream stream(&file);<br /> stream << textEdit->toPlainText();<br /> stream.flush();<br /> file.close();<br /> }<br /> }
<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"><th>الموضوع</th><th>انقر هنا</th></tr></thead>
<tbody><tr class="odd topAlign"><td><p>الملفات و أدوات الإدخال والإخراج</p></td><td><p><a href="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></td></tr>
</tbody></table>
<br gt;<br gt;<br gt;<br gt;
<br gt;<br gt;<br gt;<br gt;