PyQt5: إنشاء نوافذ أساسية

يوفر هذا البرنامج التعليمي بداية سريعة لبناء نوافذ أساسية باستخدام PyQt5، وهي واجهة برمجة تطبيقات قوية بلغة Python لإطار عمل Qt. سنغطي إنشاء نافذة، وتغيير حجمها، وإضافة أيقونة.

محتويات الجدول

• إنشاء نافذة أساسية
• تغيير حجم النافذة
• إضافة أيقونة نافذة

إنشاء نافذة أساسية

لنبدأ ببناء أبسط نافذة PyQt5. يتضمن ذلك استيراد الوحدات اللازمة وإنشاء مثيل لتطبيق ونافذة رئيسية.

import sys
from PyQt5.QtWidgets import QApplication, QWidget

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = QWidget()
    window.show()
    sys.exit(app.exec_())

فيما يلي شرح:

• import sys و from PyQt5.QtWidgets import QApplication, QWidget: يستورد الوحدات المطلوبة. QApplication يدير سير عمل التطبيق وإعداداته، بينما QWidget هي الفئة الأساسية لكائنات واجهة المستخدم.
• if __name__ == '__main__':: يضمن تشغيل الكود فقط عند تنفيذه مباشرة، وليس عند استيراده.
• app = QApplication(sys.argv): ينشئ مثيلًا لـ QApplication. sys.argv يعالج وسيطات سطر الأوامر.
• window = QWidget(): ينشئ عنصر واجهة مستخدم نافذة أساسية.
• window.show(): يجعل النافذة مرئية.
• sys.exit(app.exec_()): يبدأ حلقة أحداث Qt. app.exec_() ترجع عند إغلاق التطبيق؛ sys.exit() يخرج من Python بشكل نظيف.

احفظ هذا كـ (مثلًا) basic_window.py وشغّله من محطتك الطرفية: python basic_window.py. ستظهر نافذة فارغة.

تغيير حجم النافذة

الآن دعونا نتحكم في حجم النافذة باستخدام طريقة resize().

import sys
from PyQt5.QtWidgets import QApplication, QWidget

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = QWidget()
    window.resize(400, 300)  # العرض، الارتفاع
    window.show()
    sys.exit(app.exec_())

إضافة window.resize(400, 300) يحدد عرض النافذة بـ 400 بكسل وارتفاعها بـ 300 بكسل.

إضافة أيقونة نافذة

أخيرًا، دعونا نضيف أيقونة. هذا يحتاج إلى ملف صورة (مثل ملف .ico لنظام Windows أو ملف .png للاستخدام متعدد المنصات).

import sys
from PyQt5.QtWidgets import QApplication, QWidget
from PyQt5.QtGui import QIcon

if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = QWidget()
    window.resize(400, 300)
    window.setWindowIcon(QIcon('icon.png'))  # استبدل 'icon.png' بملف الأيقونة الخاص بك
    window.show()
    sys.exit(app.exec_())

نقوم باستيراد QIcon واستخدام window.setWindowIcon(QIcon('icon.png')). استبدل 'icon.png' بمسار الأيقونة الخاصة بك. تأكد من أن الأيقونة موجودة في نفس الدليل أو قم بتوفير المسار الكامل. تذكر تثبيت PyQt5: pip install PyQt5 قبل التشغيل.

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