Handout zur Vorlesung OOC++ am

Transkript

1 Handout zur Vorlesung OOC++ am QString (analog zu den Strings aus C++; beherrscht aber z.b. den Unicode-Zeichensatz) int contains(qstring &pattern) - wie oft ist pattern im String enthalten? QString left(int num) - liefert num Character ab Anfang des aktuellen Strings QString right(int num) - liefert num Character vor Ende des aktuellen String int find(char ch) - Position des Characters ch in String const char * QString::latin1() - konvertiert den Inhalt des QStrings in ein char-array (Zeichensatz = Latin1) QFile (File IO) Konstruktor: QFile(const QString & name) - Datei name öffnen bool open(int ioflags) - setzt Dateimodus (Lesen/Schreiben) bool open(int ioflags, int fd) - macht aus einem Filedeskriptor ein Qfile; Lese- bzw. Schreibmodus wird in ioflags angegeben QTextStream (ähnlich zur C++ Stringstream-Klasse; schreiben in (Q)Strings, IODevice, File...) Konstruktor: QTextStream(QIODevice *io) (z.b. QSocket und Qfile sind QIODevices!!) z.b. QTextStream &operator<<(qstring &s)etc. QObject (Basisklasse (fast) aller QT-Klassen) QObject *sender(); Ermitteln des Absenderobjekts eines Signals in einer Qt-Slot-Funktion QApplication (GUI-Eventloop) extern QApplication * qapp; aktuell aktive Application - immer global ansprechbar z.b. für qapp->quit(); Konstruktor: QApplication(int argc,char**argv, bool gui): GUI enabled true/false QListBox (Auswahlmöglichkeit aus einer Liste) QString currenttext(); aktuell markierter Text in der Liste clear(); komplettes Löschen der Liste insertitem(qstring &s); Einfügen eines QStrings in die Liste QListBoxItem *finditem(qstring &s); Liefert einen Zeiger auf ein durch s repräsentiertes Listenelement setcurrentitem(qlistboxitem *l); markiert den durch l repräsentierten Listeneintrag QLineEdit (eine Eingabe/Ausgabezeile) void setreadonly(bool wert); true: nur Textausgabe; false: auch Texteingabe QString text(); liefert den aktuell eingegebenen Text void returnpressed [signal]; tritt auf bei Drücken von RETURN im Textfeld QTextEdit (sehr mächtiger Texteditor, der auch HTML und Richtextformat beherrscht) void setreadonly(bool wert); true: nur Textausgabe; false: auch Texteingabe void settextformat(textformat f); f kann sein: o PlainText: Text wird im Original angezeigt o RichText: HTML und RTF-Tags werden automatisch interpretiert und angezeigt void insert(qstring) - fügt Text an die aktuelle Cursorposition ein Qlabel (Textausgabe oder Bilddarstellung in einem Widget) Konstruktor QLabel(QWidget * parent, const char * name = 0, WFlags f = 0 ) QT-Ergänzung

2 QVBox, QHBox (einfaches vertikales bzw. horizontales Geometrie-Management/Widgetanordnung) QWidget w; QHBox hb(&w); QLabel lb("eingabe:", &hb); QLineEdit le(&hb); hb.adjustsize(); w.adjustsize(); //Größe autom. anpassen! MAP (nicht Qt, sondern C++ STL!) map<typ1, typ2> mymap; map<typ1, typ2>::iterator i;... mymap.erase(i); löscht das durch den Iterator i repräsentierte Element aus der Map mymap Einschub: Wiederholung Client-Server-Kommunikation über ein TCP-IP-Netzwerk (z.b. Internet) die TCP-Kommunikation zwischen 2 Rechnern wird durch 5 Parameter eindeutig festgelegt: o IP-Adresse bzw. Name des Servers (z.b. theseus.mathematik.uni-ulm.de) o IP-Adresse bzw. Name des Client o Protokollfamilie (hier immer TCP - es wäre aber auch z.b.udp möglich) o lokaler Port des Servers - der sollte beim Aufsetzen des Servers eingetragen werden und dann nach aussen bekannt sein: z.b. Port 80 für Webserver o lokaler Port des Clients - wird meist automatisch beim Verbindungsaufbau vergeben die Kommunikation zwischen Client und Server erfolgt bidirektional über sog. Sockets bidirektional: über die Socktes kann sowohl gelesen wie auch geschrieben werden Sockets werden im UNIX/Windows-Bereich durch sog. Filedeskriptoren (kleine Integerzahlen) repräsentiert; "normale" Systemcalls zum Lesen/Schreiben: read() und write() Achtung: die Ports kann nur der SysAdmin vergeben; richtig "freie" Ports finden sich im Bereich bis QSocket (Schreib/Leseverbindung für einen Client über TCP/IP) void connecttohost(qstring &host, int port)- Verbindung zum Zielhost herstellen void connected()[signal] - Signal tritt ein, wenn Verbindung zum Host hergestellt ist bool canreadline() - eine komplette Zeile incl. newline kann gelesen werden QString readline() - komplette Zeile aus der Verbindung auslesen void close() - Verbindung beenden void connectionclosed()[signal] - Signal tritt ein, wenn die Verbindung abbricht void readyread()[signal] - Signal tritt ein, wenn Daten zum Lesen angekommen sind void error(int) [signal] - (Netzwerk-)Fehler(-nummer) void delayedclosefinished()[signal] - Daten werden evtl. erst mit Zeitverzögerung nach einem close() geschrieben. Signal trifft dann ein, wenn alle Daten geschrieben wurden. void setsocket(int sock) - erzeugt ein QSocket-Objekt aus dem Filedeskriptor sock QServerSocket (abstrakte Klasse; erzeugt TCP/IP-Server; Kommunikation geschieht dann via QSocket) QServerSocket(int port) - versucht einen lokalen TCP-Server auf Port port aufzusetzen bool ok()- ist z.b. dann false, wenn auf dem gewünschten Port nicht gehorcht werden kann virtual void newconnection(int sockid)=0; diese Funktion muss überladen werden; sie wird aufgerufen, wenn sich ein Client an den Port anbinden will; socket repräsentiert den Socket-Filedeskriptor für die neue Verbindung; via QSocket socket und dann socket.setsocket(sockid) kann aus dem Filedeskriptor ein QSocket-Objekt für die eigentliche Kommunikation erzeugt werden QT-Ergänzung

3 Einzelheiten zum Kommunikationsserverbeispiel aus der Vorlesung Server: der Server (server.cc) horcht per Default auf Port mit telnet theseus.mathematik.uni-ulm.de kann man ihn auch ohne Qt von überall in der Welt aus ansprechen der Server läuft im Non-Gui-Mode unter Qt: QApplication a(argc, argv, false) der Server interpretiert die folgenden Kommandos: o LIST! - schicke eine Liste aller gerade angemeldeten Teilnehmer; beim Neuanmelden oder Ausscheiden eines Teilnehmers werden die anderen automatisch mit der neuen Liste benachrichtigt o USER!meinname - melde Teilnehmer meinname am Server an o QUIT! - Teilnehmer verläßt den Server wieder o SEND!name!text - sende Text text an Teilnehmer mit Namen name class server : public QServerSocket - Server beruht auf Basisklasse QServerSocket, überlädt und definiert im wesentlichen die rein viruelle Methode newconnection() der Basisklasse; hier wird pro Chatteilnehmer ein QSocket erzeugt Client: der Client (client.cc) bekommt beim Start des Programms als Parameter den Namen des Zielhosts mit, auf dem der Server läuft; gibt man nichts an, wird angenommen, dass der Server auf dem gleichen Rechner wie der Client läuft (localhost) Aufbau des GUIs: class Client : public QVBox Qhbox *hb0 TextEdit - Chat-Anzeige plain Text readonly ListBox für die Anzeige der Teilnehmer; an den markierten Teilnehmer wird der Chat-Text QVbox Qhbox *hb1 Qhbox *hb2 LineEdit: Eingabe des Usernamens LineEdit: Eingabe des Chat-Textes QT-Ergänzung

4 Serverklasse: class server : public QServerSocket Q_OBJECT public: server( int port=port, QObject* mparent=0, const char* name = 0 ) : QServerSocket( port ); virtual void newconnection( int socket ); // called for each client private slots: void slotdeletesocket(); // called after a socket has been closed void slotincomingdata(); // called when data is arriving void lostconnection(); // called when a client closes the connection private: std::map<qstring, QSocket*> user; // user list void senduserlist(qsocket*); // send user list to all clients ; Clientklasse: // Qvbox: all added widgets will be displayed vertically in their insert order class Client : public QVBox Q_OBJECT // provided for own slots public: Client( const QString &host, int port ); ~Client(); private slots: void closeconnection(); // used for closing the socket connection void sendname(); // send username to server and enable textfield void sendtoserver(); // used to send one text line to the server void socketreadyread(); // slot called when server data arrives void socketconnected(); // called, when server connection is established void socketconnectionclosed(); // server closes the connection!! void socketerror( int e ); // network error occurred private: QSocket *socket; // socket connection to server QTextEdit *infotext; // displayed chat text QLineEdit *username; // my user name QLineEdit *inputtext; // input text line for chat QListBox *userlist; // current list of participating users ; QT-Ergänzung

5 Scribble-Beispiel scribble.h #include <QApplication.h> #include <qmenubar.h> #include <qmessagebox.h> #include <qpainter.h> #include <qpixmap.h> #include <qpopupmenu.h> #include <qwidget.h> // menu item's corresponding numbers enum MenuIDs COLOR_MENU_ID_BLACK, COLOR_MENU_ID_RED, COLOR_MENU_ID_BLUE, COLOR_MENU_ID_GREEN, COLOR_MENU_ID_YELLOW ; * A class that lets the user draw with the mouse. The * window knows how to redraw itself. class ScribbleWindow : public QWidget Q_OBJECT // necessary because ScribbleWindow contains slots public: ScribbleWindow(); ~ScribbleWindow(); protected: virtual void mousepressevent( QMouseEvent* );// mouse button pressed virtual void mousemoveevent( QMouseEvent* ); // moved AND button pressed virtual void paintevent( QPaintEvent* ); // widget must be repainted virtual void resizeevent( QResizeEvent* ); // widget was resized private slots: void slotabout(); void slotaboutqt(); void slotcolormenu( int ); private: QPoint _last; QColor _currentcolor; // tell me more about the program // tell me more about Qt // new color has been selected // point where button was pressed // current painting color QPixmap _buffer; // buffer copy of the screen QMenuBar* _menubar; // menu bar :-) QPopupMenu* _filemenu; // menu item filemenu :-) QPopupMenu* _colormenu; //... (read and understand!) QPopupMenu* _helpmenu; //... (read and understand!) ; QT-Ergänzung

6 scribble.cc #include <QApplication.h> #include <qmenubar.h> #include <qmessagebox.h> #include <qpainter.h> #include <qpixmap.h> #include <qpopupmenu.h> #include <qwidget.h> #include "scribble.h" The constructor. Initializes the member variables and the menu * system. ScribbleWindow::ScribbleWindow() _currentcolor = black; // don't blank the window before repainting setbackgroundmode( NoBackground ); /* The next lines build the menu bar. We first create the menus * one by one, then add them to the menu bar. _filemenu = new QPopupMenu; // create a file menu _filemenu->insertitem( "&Quit", QApp, SLOT( quit() ) ); _colormenu = new QPopupMenu; // create a color menu _colormenu->insertitem( "B&lack", COLOR_MENU_ID_BLACK ); _colormenu->insertitem( "&Red", COLOR_MENU_ID_RED ); _colormenu->insertitem( "&Blue", COLOR_MENU_ID_BLUE ); _colormenu->insertitem( "&Green", COLOR_MENU_ID_GREEN ); _colormenu->insertitem( "&Yellow", COLOR_MENU_ID_YELLOW ); QObject::connect( _colormenu, SIGNAL( activated( int ) ), this, SLOT( slotcolormenu( int ) ) ); _helpmenu = new QPopupMenu; // create a help menu _helpmenu->insertitem( "&About QtScribble", this, SLOT( slotabout() ) ); _helpmenu->insertitem( "About &Qt", this, SLOT( slotaboutqt() ) ); _menubar = new QMenuBar( this ); // create a menu bar _menubar->insertitem( "&File", _filemenu ); _menubar->insertitem( "&Color", _colormenu ); _menubar->insertseparator(); _menubar->insertitem( "&Help", _helpmenu ); * The destructor. Does nothing for now. ScribbleWindow::~ScribbleWindow() * This virtual method is called whenever the user presses the * mouse over the window. It just records the position of the mouse * at the time of the click. void ScribbleWindow::mousePressEvent( QMouseEvent* event ) _last = event->pos(); // retrieve the coordinates from the event * This virtual method is called whenever the user moves the mouse * while the mouse button is pressed (this is also known as * "dragging"). If we had called setmousetracking( true ) before, QT-Ergänzung

7 * this method would also be called when the mouse was moved without * any button pressed. We know that we haven't, and thus don't have * to check whether any buttons are pressed. void ScribbleWindow::mouseMoveEvent( QMouseEvent* event ) // create a QPainter object for drawing onto the window QPainter windowpainter; // and another QPainter object for drawing into an off-screen pixmap QPainter bufferpainter; // start painting windowpainter.begin( this ); // this painter paints onto the window bufferpainter.begin( &_buffer ); // and this one in the buffer // set a standard pen with the currently selected color windowpainter.setpen( _currentcolor ); bufferpainter.setpen( _currentcolor ); // draw a line in both the window and the buffer windowpainter.drawline( _last, event->pos() ); bufferpainter.drawline( _last, event->pos() ); // done with painting windowpainter.end(); bufferpainter.end(); // remember the current mouse position _last = event->pos(); * This virtual method is called whenever the widget needs * painting, such as when it has been obscured and then revealed again. void ScribbleWindow::paintEvent( QPaintEvent* event ) // copy the image from the buffer pixmap to the window bitblt( this, 0, 0, &_buffer ); * This virtual method is called whenever the window is resized. We * use it to make sure that the off-screen buffer is always the same * size as the window. * In order to retain the original drawing, it is first copied * to a temporary buffer. After the main buffer has been resized and * filled with white, the image is copied from the temporary buffer to * the main buffer. void ScribbleWindow::resizeEvent( QResizeEvent* event ) QPixmap save( _buffer ); _buffer.resize( event->size() ); _buffer.fill( white ); bitblt( &_buffer, 0, 0, &save ); void ScribbleWindow::slotAbout() QMessageBox::information( this, "About QtScribble 2", "This is the QtScribble 2 application\n" QT-Ergänzung

8 "Copyright by Matthias Kalle Dalheimer\n" "slightly adepted by Matthias Grabert\n" ); void ScribbleWindow::slotAboutQt() QMessageBox::aboutQt( this, "About Qt" ); void ScribbleWindow::slotColorMenu( int item ) switch( item ) case COLOR_MENU_ID_BLACK: _currentcolor = black; case COLOR_MENU_ID_RED: _currentcolor = red; case COLOR_MENU_ID_BLUE: _currentcolor = blue; case COLOR_MENU_ID_GREEN: _currentcolor = green; case COLOR_MENU_ID_YELLOW: _currentcolor = yellow; int main( int argc, char* argv[] ) QApplication myapp( argc, argv ); ScribbleWindow* mywidget = new ScribbleWindow(); mywidget->setgeometry( 50, 50, 400, 400 ); myapp.setmainwidget( mywidget ); mywidget->show(); return myapp.exec(); QT-Ergänzung