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/ro
Notiuni de baza pentru programare cu Qt
Bun venit in lumea Qt—toolkitul GUI multi-platforma. In acest articol de introducere vom prezenta notiuni de baza pentru programarea cu Qt prin implementarea unei simple aplicatii Notepad. Dupa citirea acestui ghid veti fi pregatiti sa rasfoiti documentatia noastra si sa gasiti informatiile necesare pentru aplicatia pe care o dezvoltati.
Hello Notepad
In acest prim exemplu vom crea un simplu editor de text intr-o fereastra. Acesta reprezinta cel mai simplu program Qt cu interfata grafica.
Codul necesar pentru a crea aplicatia:
Sa urmarim codul line cu line. In primele doua linii includem fisierele hedear QApplication [doc.trolltech.com] si QTextEdit [doc.trolltech.com], acestea fiind clasele de care avem nevoie pentru aceasta aplicatie. Toate clasele din Qt au un header denumit dupa ele.
Linia 6 creaza o instanta a obiectului QApplication [doc.trolltech.com]. Acest obiect gestioneaza resursele aplicatiei si este neccesar pentru a rula orice aplicatie Qt care are o interfata grafica. Acesta ia ca parametri argv si args pentru ca Qt accepta cativa parametrii de start.
Linia 8 creaza un obiect de tip QTextEdit [doc.trolltech.com]. Un editor de text este un element vizual in interfata grafica (GUI). In Qt aceste elemente se numesc widget-uri. Exemple de widget-uri sunt etichete, butoane radio, bare de derulare. Un widget poate fi deasemena si un container pentru alte widget-uri; o casuta de dialog sau o fereastra principala a aplicatiei de exemplu.
Linia 9 arata editorul de text in propria lui fereastra. Deoarece widget-urile pot fi si container (de exemplu QMainWindow [doc.qt.nokia.com] care contine bare de instrumente, meniuri, bara de stare si alte widgeturi), este posibila afisarea unui singur widget in propria sa fereastra. Widget-urile nu sunt vizibile implicit functia show() [doc.qt.nokia.com] face widget-ul vizibil.
Linia 11 face ca obiectul QApplication [doc.trolltech.com] sa intre in bucla de evenimente. Cand o aplicatie Qt ruleaza, evenimente sunt generate si trimise widget-urilor care apartin de aplicatie. Exemple de astfel de evenimente sunt apasari ale butoanelor de la mouse sau apsari a butoanelor de la tastatura. Im momentul in care tastati text in editorul de text, acesta primeste evenimentele generate in urma apasari tastelor si raspunde la aceste evenimente desenand text pe ecran.
Pentru a rula aplicatia, deschideti o consola, intrati in directorul unde ati salvat fisierul .cpp. Urmatoarele comenzi vor construi aplicatia.
Aceste comenzi vor genera un executabil in directorul part1 (atentie pe windows e posibil sa fie nevoie sa rulati comanda nmake in loc de make. De asemenea executabilul va fi plasat ub folderul part1/debug sau part1/release). qmake este un utilitar care ia ca si parametru un fisier de configurare. qmake genereaza pentru noi acest fisier de configurare cand este rulat cu parametru -project. Odata generat fisierul de configurare (cu extensia .pro) qmake produce un fisier make care va construi programul pentru noi. Vom studia cum putem scrie propriile noastre fisiere .pro mai tarziu.
Studiati in continuare
- Widget-rui si geometria acestora – Widget-uri ferestre si dialoguri [doc.qt.nokia.com]
- Evenimente si modul de tratare a acestora – Sistemul de evenimente [doc.qt.nokia.com]
Adaugarea unu button de iesire
Intr-o aplicatie reala, avem nevoie de mai multe widget-uri. Vom introduce un QPushButton [doc.qt.nokia.com] sub editorul de text. Butonul va opri aplicatia in momentul in care este apasat (facand click cu mouse pe el,de exemplu).
Sa aruncam o privire asupra codului:
Linia 1 include QtGui [doc.qt.nokia.com], care contine toate clasele GUI din Qt.
Linia 10 foloseste mecanismul signal slot din Qt pentru a face aplicatia sa se inchida in momentul in care Butonul Quit este apasat. Un slot este o functie care poate fi invocata in timpul executiei folosind numele ei (ca un sir de caractere literal). Un semnal este o functie care in momentul invocarii apeleaza toate slot-urile inregistrate cu acesta; apelam acestea pentru a conecta slotul la semnal si a emite semnalul.
quit() [doc.qt.nokia.com] este un slot a QApplication [doc.trolltech.com] care intrerupe executia aplicatiei. clicked() [doc.qt.nokia.com] este un semnal emis de QPushButton”:http://doc.qt.nokia.com/latest/qpushbutton.html in momentul in care acesta este apasat. Functia statica QObject::connect() [doc.qt.nokia.com] va conecta slotul la semnal. SIGNAL si SLOT sunt doua macro-uri care iau ca parametrii semnaturile functilor care reprezinta semnalul si slotul care vor fi conectate. De asemenea trebuie sa furnizam si pointeri catre obiectele care vor emite si receptiona semnalul.
Linia 12 creaza un QVBoxLayout [doc.qt.nokia.com]. Precum am mentionat adineauri, widget-urile pot contine alte widget-uri. Este posibila setarea locatiei si a dimensiunilor a widget-urilor continute direct, dar de obicei este mai usor folosirea unui layout. Un layout gestioneaza locatia si dimensiunea widget-urilor. QVBoxLayout [doc.qt.nokia.com] , de exemplu, aseaza widget-urile intr-un rand pe verticala.
Linia 13 si 14 adauga editorul de text si butonul in layout iar linia 17 seteaza layoutul pe widget.
Studiati in continuare
- Semnale si slot-uri – Semnale & Slot-uri [doc.qt.nokia.com]
- Layout-uri – Administrarea Layout-ului [doc.qt.nokia.com], Widget-uri si Layout-uri [doc.qt.nokia.com], Exemple de Layout [doc.qt.nokia.com]
- Widget-uri care vin cu Qt – Galeria de Widget-uri Qt [doc.qt.nokia.com], Exemple de Widget-uri [doc.qt.nokia.com]
Derivarea din QWidget
In momentul in care utilizatorul vrea sa inchida aplicatia, e posibil sa doriti sa afisati un mesaj intreband utilizatorul daca el/ea chiar doreste sa inchida aplicatia. In acest exemplu, vom deriva din QWidget [doc.qt.nokia.com] si vom adauga un slot pe care il vom conecta la buton de Quit.
Sa aruncam o privire asupra codului:
Macroul Q_OBJECT trebuie definit primul in clasa, acesta declara clasa noastra ca fiind un QObject (Normal trebuie sa si mostenim din QObject [doc.qt.nokia.com]). Un QObject [doc.qt.nokia.com] adauga cateva abilitati unei clase normale de C++. Notbail este ca numele clasei si numele sloturi-lor pot fi interogate in timpul executiei. Este posibil deasemenea interogarea tipului parametrilor unui slot si invocarea acestuia.
Linia 13 declara slotul quit(). Acest lucru este usor flosind macroul slots. Slot-ul quit() poate fi acum conectat la semnale care au acelasi numar si tip de parametri (orice semnal ce nu ia parametri in cazul nostru).
In loc de a seta interfata grafica si a conecta slot-ul in main, vom folosi constructorul clasei Notepad.
Dupa cum se poate vedea in definitia clasei, folosim pointeri catre obiectele noastre de tip QObject [doc.qt.nokia.com] (textEdit si quitButton). Ca o regula, este indicata alocarea obiectelor QObject [doc.qt.nokia.com] pe heap si necopierea acestora.
Putem folosi acum functia tr() [doc.qt.nokia.com] pentru a incapsula sirurile de caractere vizibile. Acest lucru este necesar daca dorim distribuirea aplicatiei in mai mult de o limba (Engleza si Chineza de exemplu). Nu vom intra in detalii aici, dar puteti sa urmati linkurile de mai jos pentru a afla mai multe.
Studiati in continuare
- tr() si internationalizarea – Manual Qt Linguist [doc.qt.nokia.com], Scrierea de cod pentru traduceri [doc.qt.nokia.com], Exemplul Hello tr() [doc.qt.nokia.com], Internationalizarea cu Qt [doc.qt.nokia.com]
- QObjects [doc.qt.nokia.com] si modelul Qt pentru obiecte (Acest lucru este necesar pentru a intelege Qt) – Modelul de Obiecte [doc.qt.nokia.com]
- qmake si sistem de constructie Qt – Manual qmake [doc.qt.nokia.com]
Crearea unui fisier .pro
Pentru acest exemplu vom scrie propriul nostru fisier .pro in loc de a folosi parametul -project al qmake.
Urmatoarele comenzi pentru consola construiesc aplicatia.
Folosirea unei QMainWindow
Multe aplicati ar beneficia din folosirea unei QMainWindow [doc.qt.nokia.com], care are propriul layout pe care putem adauga: bari de meniu, bari de instrumente si bara de status. QMainWindow [doc.qt.nokia.com] are o zona centrala in care poate fi adaugat orice widget. In cazul nostru, vom adauga editorul de text aici.
Sa aruncam o privire asupra codului:
Adaugam inca doua sloturi pentru salvarea si deschiderea de documente. Le vom implementa in urmatoarea sectiune.
Desi, intr-o fereastra principala, acelasi slot ar trebui invocat de mai multe widget-uri. Exemple sunt elementele din meniuri si butoanele de pe o bara de instrumente. Pentru a face acest lucru mai usor, Qt ofera QAction [doc.qt.nokia.com], care poate fi furnizat mai multor widget-uri, si pot fi conectate unui slot. De exemplu si QMenu [doc.qt.nokia.com] si QToolBar [doc.qt.nokia.com] pot crea elemente de meniu si butoane pe bara de instrumente din aceleasi QAction [doc.qt.nokia.com]. Vom vedea cum functioneaza acest lucru in curand.
Ca si adineaori folosim contructorul clasei Notepad pentru a seta interfata grafica.
QAction [doc.qt.nokia.com] sunt create cu textul cu care ar trebui sa apara pe widget-uri (in cazul nostru, elemente din meniu). Daca dorim putem sa le adaugam si pe o bara de instrumente si sa le adaugam iconite [doc.qt.nokia.com]
Cand un element din meniu este apasat, acesta va activa slotul care va determina invocarea slotului.
Studiati in continuare
- Ferestre principale si clase pentru ferestre principale – Ferestre principale pentru aplicatii [doc.qt.nokia.com], Exemple de ferestre principale [doc.qt.nokia.com]
- Aplicati MDI – QMdiArea [doc.qt.nokia.com], Exemple MDI [doc.qt.nokia.com]
Salvarea si deschiderea
In acest eexmplu vom implementa functionalitatea pentru slot-urile open() si save() care le-am adaugat in exemplul anterior.
Vom incepe cu slot-ul open().
Primul pas este intrebarea utilizatorului care va fi numele fisierului ce va fi deschis. Qt ofera QFileDialog [doc.qt.nokia.com], care est o fereastra de dialog din care utilizatorul poate selecta un fisier. Imaginea de adineauri arata aceasta ferestra de dialog pe Kubuntu. Functia statica getOpenFileName() [doc.qt.nokia.com] afiseaza o fereastra de dialog modala si nu returneaza pana in momentul in care utilizatorul alege un fisier. Aceasta returneaza calea catre fisierul selectat sau un sir de caractere gol daca utilizatorul a inchis fereastra fara sa selecteze nimic.
Daca avem un nume de fisier, incercam sa il deschidem folosind functia open() [doc.qt.nokia.com], care returneaza true daca fisierul a fost deschis. Nu vom intra aici in modalitati de tratare a erorilor dar puteti urmari link-uri din sectiunea studiati in continuare. Daca fisierul nu a fost deschis, folosim un QMessageBox [doc.qt.nokia.com] pentru a afista un mesaj de eroare (vedeti documentatia QMessageBox [doc.qt.nokia.com] pentru mai multe detalii).
Citirea datelor din fisier este triviala folosind functia readAll() [doc.qt.nokia.com], care returneaza toate datele din fisier sub forma unui QByteArray [doc.qt.nokia.com]. Functia constData() [doc.qt.nokia.com] returneaza date ca si const char*, pentru care QString [doc.qt.nokia.com] are constructor. Continutul poate fi apoi afist in editorul de text. Inchidem apoi fisierul folosind close() [doc.qt.nokia.com] pentru a returna descriptorul inapoi sistemului de operare.
Acum sa trecem la slot-ul save().
Cand scriem continutul editorului de text intr-un fisier, folosim clasa QTextStream [doc.qt.nokia.com], care incapsuleaza un obiect QFile [doc.qt.nokia.com]. QTextStream poate sa scrie direct QString in fisier; QFile [doc.qt.nokia.com] accepta doar date neprelucrate (char*) cu functile write() [doc.qt.nokia.com] a unui QIODevice [doc.qt.nokia.com]