Windows and Dialogs/ro

Ferestre și dialoguri

Generalități

Un widget care nu este inclus într-un widget părinte se numește fereastră. De obicei, ferestrele au o ramă și o bară de titlu, deși este posibil să fie create ferestre și fără asemenea decorațiuni. În Qt, "QMainWindow ":http://doc.qt.nokia.com/4.7-snapshot/qmainwindow.html și alte diverse subclase ale lui "QDialog":http://doc.qt.nokia.com/4.7-snapshot/qdialog.html sunt cele mai obișnuite tipuri de ferestre.

Orice "QWidget":http://doc.qt.nokia.com/4.7-snapshot/qwidget.html care nu are fereastră devine fereastră și va fi listat în taskbar-ul sistemului de operare. Acest lucru este de dorit pentru o singură fereastră, numită și fereastra principală. În plus orice QWidget care are părinte poate deveni fereastră prin setarea flagului "Qt::WA_Window":http://doc.qt.nokia.com/4.7-snapshot/qt.html#WindowType-enum. În funcție de sistemul de management al ferestrelor, ferestrele secundare sunt de obicei puse deasupra ferestrei lor principale și nu apar în taskbar-ul sistemului de operare. Clasele QMainWindow și QDialog setează flag-ul Qt::WA_Window în constructorul lor, întrucât sunt proiectate pentru a fi folosite ca ferestre.

Fereastra principală a unei aplicații furnizează instrumentele pentru construirea unei interfețe principale cu utilizatorul și este creată prin subclasarea QMainWindow . QMainWindow are propriul său layout la care poate fi adăugat o bară de meniu, bară cu instrumente, widget-uri andocabile și o bară de status. Centrul ferestrei principale poate fi ocupat de orice tip de QWidget.

Ferestrele de dialog sunt folosite ca ferestre secundare care prezintă utilizatorului opțiuni și alegeri. Dialogurile sunt create prin subclasarea clasei QDialog și folosind widgeturi și layout-uri pentru implementarea interfeței cu utilizatorul. În plus Qt furnizează un număr de dialoguri specializate care pot fi utilizate pentru niște sarcini standard precum selecția unui fișier sau a unui font.

Fereastra principală

Fereastra princiapală unei aplicații se crează prin subclasarea clasei QMainWindow. O fereastră principală Qt are propriul său layout și putem adăuga o bară de unelte ("QToolBar":http://doc.qt.nokia.com/4.7-snapshot/qtoolbar.html), widget-uri andocabile ("QDockWidget":http://doc.qt.nokia.com/4.7-snapshot/qdockwidget.html), o bară de meniu ("QMenuBar":http://doc.qt.nokia.com/4.7-snapshot/qmenubar.html) și o bară de status ("QStatusBar":http://doc.qt.nokia.com/4.7-snapshot/qstatusbar.html). Centrul ferestrei principale poate fi ocupat de orice tip de widget și se setează prin apelul funcției "void setCentralWidget(QWidget* widget)":http://doc.qt.nokia.com/4.7-snapshot/qmainwindow.html#setCentralWidget.

https://lh6.googleusercontent.com/-irzsFIm9E-o/TiLoLdTWjDI/AAAAAAAAAOA/luYpIPljKto/image001.png Model de fereastră în Qt

Pentru a adăuga o bară de instrumente mai întâi trebuie să creem o serie de acțiuni. O acțiune este implementată prin clasa "QAction":http://doc.qt.nokia.com/4.7-snapshot/qaction.html. Aceasta asigură o acțiune abstractă a interfeței grafice care poate fi inserată în widgeturi. În aplicații multe comenzi comune pot fi invocate din meniuri, bară de instrumente sau scurtături de tastatură. Cum utilizatorul se așteaptă ca orice comandă să fie efectuată în același mod, indiferent de modul de apelare, este extrem de util să reprezentăm astfel de comenzi ca acțiuni. Acțiunilor le putem asocia o imagine, un text, o scurtătură de tastatură sau un tooltip. Un exemplu în acest sens îl aveți mai jos:

 newAct = new QAction(QIcon(":/images/new.png"), tr("&New;"), this);
 newAct->setShortcuts(QKeySequence::New);
 newAct->setStatusTip(tr("Crează un nou fisier"));
 connect(newAct, SIGNAL (triggered()), this, SLOT (newFile()));

Mai apoi creem barele de instrumente propriu-zise:

 fileToolBar = addToolBar(tr("Fisier"));
 fileToolBar->addAction(newAct);
 fileToolBar->addAction(openAct);
 fileToolBar->addAction(saveAct);
 editToolBar = addToolBar(tr("Editare"));
 editToolBar->addAction(cutAct);
 editToolBar->addAction(copyAct);
 editToolBar->addAction(pasteAct);

Aceleași acțiuni pot fi adăugate și la bara de meniu, precum mai jos:

 fileMenu = menuBar()->addMenu(tr("&Fisier;"));
 fileMenu->addAction(newAct);
 fileMenu->addAction(openAct);
 fileMenu->addAction(saveAct);
 fileMenu->addAction(saveAsAct);
 fileMenu->addSeparator();
 fileMenu->addAction(exitAct);

editMenu = menuBar()->addMenu(tr("&Editare;"));
 editMenu->addAction(cutAct);
 editMenu->addAction(copyAct);
 editMenu->addAction(pasteAct);
 menuBar()->addSeparator();

 helpMenu = menuBar()->addMenu(tr("&Ajutor;"));
 helpMenu->addAction(aboutAct);
 helpMenu->addAction(aboutQtAct);

Pentru a seta widget-ul central ne folosim de funcția void "setCentralWidget(QWidget* widget)":http://doc.qt.nokia.com/4.7-snapshot/qmainwindow.html#setCentralWidget precum în exemplul următor :

 textEdit = new QPlainTextEdit;
 setCentralWidget(textEdit);

Iar dacă dorim să avem acces la bara de status, folosim funcția "void showMessage(const QString& message, int timeout = 0)":http://doc.qt.nokia.com/4.7-snapshot/qstatusbar.html#showMessage precum mai jos:

 statusBar()->showMessage(tr("Gata"));<code>
 Iar la final vom obține o fereastră principală ca în imaginile de mai jos :
 [[Image:https://lh5.googleusercontent.com/-0VSLxOupaDk/TiLoLXdpNLI/AAAAAAAAAN4/po0_PRGjYx8/image002.png|https://lh5.googleusercontent.com/-0VSLxOupaDk/TiLoLXdpNLI/AAAAAAAAAN4/po0_PRGjYx8/image002.png]]

h2. Ferestre de dialog


 Clasa "QAction ":http://doc.qt.nokia.com/4.7-snapshot/qaction.html este clasa de bază pentru ferestrele de dialog. O fereastră de dialog este o fereastră folosită mai ales pentru sarcini pe termen scurt și comunicări succinte cu utilizatorul.

 Dialogurile pot fi modale, caz în care utilizatorul trebuie să furnizeze informațiile necesare înainte ca lucrul în fereastra principală să poate continua, sau nemodale. Dialogurile nemodale permit utilizatorului să interacționeze și cu alte ferestre ale aplicației.

 Butonul implicit al unui dialog este butonul care este apăsat atunci când utilizatorul apasă tasta Enter. Pentru a seta butonul implicit al unui dialog apelăm funcția : "void setDefault(bool) ":http://doc.qt.nokia.com/4.7-snapshot/qpushbutton.html#default-prop al clasei "QPushButton ":http://doc.qt.nokia.com/4.7-snapshot/qpushbutton.html .

 Atunci când utilizatorul va apăsa tasta Esc într-un fereastră de dialog, se va invoca funcția "void reject()":http://doc.qt.nokia.com/4.7-snapshot/qdialog.html#reject. Acest lucru va duce la închiderea ferestrei.
 Qt ne pune la dispoziție un set de dialoguri gata implementate precum :
* "QColorDialog":http://doc.qt.nokia.com/4.7-snapshot/qcolordialog.html- asigură o fereastră de dialog prin intermediul căreia putem alege și specifica culori. De exemplu, în cadrul unui program de desenare putem folosi un asemenea dialog pentru a alege culoarea cu care se desenează.

[[Image:http://doc.qt.nokia.com/4.7-snapshot/images/plastique-colordialog.png|http://doc.qt.nokia.com/4.7-snapshot/images/plastique-colordialog.png]]

* "QFileDialog":http://doc.qt.nokia.com/4.7-snapshot/qfiledialog.html - furnizează o fereastră de dialog prin intermediul căreia putem selecta fișiere sau directoare. El permite utilizatorului să navigheze prin sistemul de fișiere. Cel mai ușor mod de a folosi acest dialog este printr-o funcție statică precum în următorul exemplu :

QFileDialog::getOpenFileName(0, "Open Image", "", "Image (.png.jpg .bmp)");

''' "QFontDialog":http://doc.qt.nokia.com/4.7-snapshot/qfontdialog.html - ne dă posibilitatea să creăm o fereastră de dialog prin care să selectăm un font. Un exemplu de apel aveți mai jos :

QFont font = QFontDialog::getFont(QFont("Helvetica [Cronyx]", 10), 0);

• "QInputDialog":http://doc.qt.nokia.com/4.7-snapshot/qinputdialog.html - este o fereastră de dialog prin care obținem o singură valoare de de la utilizator. Această valoare poate fi un text, un număr sau un element dintr-o listă. De asemenea trebuie precizat și o etichetă prin care să înștiințăm utilizatorul ce anume trebuie să introducă. Pentru a ne declara o asemenea fereastră se folosește în mod uzual funcțiile statice "getText(),":http://doc.qt.nokia.com/4.7-snapshot/qinputdialog.html#getText "getInt()":http://doc.qt.nokia.com/4.7-snapshot/qinputdialog.html#getInt, "getDouble()":http://doc.qt.nokia.com/4.7-snapshot/qinputdialog.html#getDouble și "getItem()":http://doc.qt.nokia.com/4.7-snapshot/qinputdialog.html#getItem precum în exemplul următor :

 QString text = QInputDialog::getText(0, "QInputDialog::getText()",
 "Numele tau:", QLineEdit::Normal,QDir::home().dirName());

• "QMessageBox":http://doc.qt.nokia.com/4.7-snapshot/qmessagebox.html - este o fereastră modală de dialog folosită pentru a informa utilizatorul sau pentru a-l interoga cu intenția de obține un răspuns. Ea afișează un text informativ, iar uneori se cere de la utilizator un răspuns. O astfel de fereastră poate afișa o imagine sau niște butoane standard. Ea suportă 4 nivele predefinite a nivelului de securitate, care se diferențiază prin imaginea pe care o afișează fiecare.

1. http://doc.qt.nokia.com/4.7-snapshot/images/qmessagebox-quest.png Întrebare - pentru a interoga un utilizator.
2. http://doc.qt.nokia.com/4.7-snapshot/images/qmessagebox-info.png Informație - pentru a raporta informații.
3. http://doc.qt.nokia.com/4.7-snapshot/images/qmessagebox-warn.png Avertisment - pentru a raporta erori non-critice.
4. http://doc.qt.nokia.com/4.7-snapshot/images/qmessagebox-crit.png Critic - pentru a raporta erori critice.

Cel mai convenabil mod de folosi aceste ferestre este prin apelarea funcţiilor ei statice precum în exemplul următor:

 int ret = QMessageBox::warning(0, "Aplicatia mea",
 "Documentul a fost modificat."
 "Doriti sa salvati schimbarile?",
 QMessageBox::Save | QMessageBox::Discard | QMessageBox::Cancel,QMessageBox::Save);

• "QPageSetupDialog":http://doc.qt.nokia.com/4.7-snapshot/qpagesetupdialog.html - este o fereastră de dialog care ne oferă opțiuni de printare pentru o pagină.
• "QPrintDialog":http://doc.qt.nokia.com/4.7-snapshot/qprintdialog.html - ne dă posibilitatea să specificăm configurarea unei imprimante. Putem schimba mărimea foii, orientarea, tipul de imprimare (color sau alb-negru), paginile care urmează să fie printate, respectiv numărul de copii.
• "QPrintPreviewDialog":http://doc.qt.nokia.com/4.7-snapshot/qprintpreviewdialog.html - putem vedea și configura așezarea în pagină a paginilor pe care urmează să le printăm.
• QProgressDialog - este o fereastră de dialog care ne informează despre progresul unei operații de lungă durată. Această fereastră dă posibilitatea utilizatorului să anuleze respectiva operație. Următorul cod ne propune o variantă de utilizare a acestei ferestre de dialog:

 qint32 numFiles = 100000;
 QProgressDialog progress("Copiaza fisiere…", "Anuleaza copiere", 0,numFiles, 0);
 progress.setWindowModality(Qt::WindowModal);
 for (int i = 0; i < numFiles; i++) {
 progress.setValue(i); if (progress.wasCanceled())break;
 }
 progress.setValue(numFiles);