src/frontends/qt4/GuiWorkArea.C

   1 /**
   2  * \file GuiWorkArea.C
   3  * This file is part of LyX, the document processor.
   4  * Licence details can be found in the file COPYING.
   5  *
   6  * \author John Levon
   7  * \author Abdelrazak Younes
   8  *
   9  * Full author contact details are available in file CREDITS.
  10  */
  11
  12 #include <config.h>
  13
  14 #include "GuiWorkArea.h"
  15
  16 #include "GuiApplication.h"
  17 #include "QLPainter.h"
  18 #include "QLyXKeySym.h"
  19 #include "qt_helpers.h"
  20
  21 #include "LyXView.h"
  22
  23 #include "BufferView.h"
  24 #include "rowpainter.h"
  25 #include "debug.h"
  26 #include "funcrequest.h"
  27 #include "LColor.h"
  28 #include "version.h"
  29 #include "lyxrc.h"
  30
  31 #include "support/filetools.h" // LibFileSearch
  32 #include "support/os.h"
  33
  34 #include "graphics/GraphicsImage.h"
  35 #include "graphics/GraphicsLoader.h"
  36
  37 #include <QLayout>
  38 #include <QMainWindow>
  39 #include <QMimeData>
  40 #include <QUrl>
  41 #include <QDragEnterEvent>
  42 #include <QPainter>
  43 #include <QScrollBar>
  44
  45 #include <boost/bind.hpp>
  46 #include <boost/current_function.hpp>
  47
  48 // Abdel (26/06/2006):
  49 // On windows-XP the UserGuide PageDown scroll test is faster without event pruning (16 s)
  50 // than with it (23 s).
  51 #ifdef Q_WS_WIN
  52 int const CursorWidth = 2;
  53  #define USE_EVENT_PRUNING 0
  54 #else
  55 int const CursorWidth = 1;
  56  #define USE_EVENT_PRUNING 0
  57 #endif
  58
  59
  60 using std::endl;
  61 using std::string;
  62
  63 namespace os = lyx::support::os;
  64
  65
  66 namespace lyx {
  67
  68 /// return the LyX key state from Qt's
  69 static key_modifier::state q_key_state(Qt::KeyboardModifiers state)
  70 {
  71         key_modifier::state k = key_modifier::none;
  72         if (state & Qt::ControlModifier)
  73                 k |= key_modifier::ctrl;
  74         if (state & Qt::ShiftModifier)
  75                 k |= key_modifier::shift;
  76         if (state & Qt::AltModifier || state & Qt::MetaModifier)
  77                 k |= key_modifier::alt;
  78         return k;
  79 }
  80
  81
  82 /// return the LyX mouse button state from Qt's
  83 static mouse_button::state q_button_state(Qt::MouseButton button)
  84 {
  85         mouse_button::state b = mouse_button::none;
  86         switch (button) {
  87                 case Qt::LeftButton:
  88                         b = mouse_button::button1;
  89                         break;
  90                 case Qt::MidButton:
  91                         b = mouse_button::button2;
  92                         break;
  93                 case Qt::RightButton:
  94                         b = mouse_button::button3;
  95                         break;
  96                 default:
  97                         break;
  98         }
  99         return b;
 100 }
 101
 102
 103 /// return the LyX mouse button state from Qt's
 104 mouse_button::state q_motion_state(Qt::MouseButtons state)
 105 {
 106         mouse_button::state b = mouse_button::none;
 107         if (state & Qt::LeftButton)
 108                 b |= mouse_button::button1;
 109         if (state & Qt::MidButton)
 110                 b |= mouse_button::button2;
 111         if (state & Qt::RightButton)
 112                 b |= mouse_button::button3;
 113         return b;
 114 }
 115
 116
 117 namespace frontend {
 118
 119 class CursorWidget : public QWidget {
 120 public:
 121         CursorWidget(QWidget * parent)
 122                 : QWidget(parent)
 123         {
 124                 resize(CursorWidth, 20);
 125         }
 126
 127         void paintEvent(QPaintEvent *)
 128         {
 129                 QColor const & col = guiApp->colorCache().get(LColor::cursor);
 130
 131 /*
 132                 int cursor_w_;
 133                 int cursor_h_;
 134
 135                 switch (cursor_shape_) {
 136                 case BAR_SHAPE:
 137                         // FIXME the cursor width shouldn't be hard-coded!
 138                         cursor_w_ = 2;
 139                         lshape_cursor_ = false;
 140                         break;
 141                 case L_SHAPE:
 142                         cursor_w_ = cursor_h_ / 3;
 143                         lshape_cursor_ = true;
 144                         break;
 145                 case REVERSED_L_SHAPE:
 146                         cursor_w_ = cursor_h_ / 3;
 147                         //cursor_x_ -= cursor_w_ - 1;
 148                         lshape_cursor_ = true;
 149                         break;
 150                 }
 151 */
 152
 153                 // We cache two pixmaps:
 154                 // 1 the vertical line of the cursor.
 155                 // 2 the horizontal line of the L-shaped cursor (if necessary).
 156
 157                 // Draw the new (vertical) cursor.
 158                 QPainter pain(this);
 159                 pain.fillRect(rect(), col);
 160 /*
 161                 // Draw the new (horizontal) cursor if necessary.
 162                 if (lshape_cursor_) {
 163                         hcursor_ = QPixmap(cursor_w_, 1);
 164                         hcursor_.fill(col);
 165                         show_hcursor_ = true;
 166                 }
 167 */
 168         }
 169         ///
 170         CursorShape shape_;
 171         ///
 172         bool show_hcursor_;
 173         ///
 174         bool show_vcursor_;
 175         ///
 176         bool lshape_cursor_;
 177         ///
 178         QColor cursor_color_;
 179 };
 180
 181
 182 // This is a 'heartbeat' generating synthetic mouse move events when the
 183 // cursor is at the top or bottom edge of the viewport. One scroll per 0.2 s
 184 SyntheticMouseEvent::SyntheticMouseEvent()
 185         : timeout(200), restart_timeout(true),
 186           x_old(-1), y_old(-1), scrollbar_value_old(-1.0)
 187 {}
 188
 189
 190 GuiWorkArea::GuiWorkArea(int w, int h, int id, LyXView & lyx_view)
 191         : WorkArea(id, lyx_view)
 192 {
 193         cursor_ = new frontend::CursorWidget(this);
 194         cursor_->hide();
 195
 196         setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOn);
 197         setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
 198         setAcceptDrops(true);
 199         setMinimumSize(100, 70);
 200
 201         //viewport()->setAutoFillBackground(false);
 202         //viewport()->setAttribute(Qt::WA_OpaquePaintEvent);
 203         setFocusPolicy(Qt::WheelFocus);
 204
 205         viewport()->setCursor(Qt::IBeamCursor);
 206
 207         resize(w, h);
 208
 209         synthetic_mouse_event_.timeout.timeout.connect(
 210                 boost::bind(&GuiWorkArea::generateSyntheticMouseEvent,
 211                             this));
 212
 213         // Initialize the vertical Scroll Bar
 214         QObject::connect(verticalScrollBar(), SIGNAL(actionTriggered(int)),
 215                 this, SLOT(adjustViewWithScrollBar(int)));
 216
 217         // PageStep only depends on the viewport height.
 218         verticalScrollBar()->setPageStep(viewport()->height());
 219
 220         lyxerr[Debug::GUI] << BOOST_CURRENT_FUNCTION
 221                 << "\n Area width\t" << width()
 222                 << "\n Area height\t" << height()
 223                 << "\n viewport width\t" << viewport()->width()
 224                 << "\n viewport height\t" << viewport()->height()
 225                 << endl;
 226
 227         if (USE_EVENT_PRUNING) {
 228                 // This is the keyboard buffering stuff...
 229                 // I don't see any need for this under windows. The keyboard is reactive
 230                 // enough...
 231
 232                 if ( !QObject::connect(&step_timer_, SIGNAL(timeout()),
 233                         this, SLOT(keyeventTimeout())) )
 234                         lyxerr[Debug::GUI] << "ERROR: keyeventTimeout cannot connect!" << endl;
 235
 236                 // Start the timer, one-shot.
 237                 step_timer_.setSingleShot(true);
 238                 step_timer_.start(50);
 239         }
 240
 241         // Enables input methods for asian languages.
 242         // Must be set when creating custom text editing widgets.
 243         setAttribute(Qt::WA_InputMethodEnabled, true);
 244 }
 245
 246
 247 void GuiWorkArea::setScrollbarParams(int h, int scroll_pos, int scroll_line_step)
 248 {
 249         verticalScrollBar()->setTracking(false);
 250
 251         // do what cursor movement does (some grey)
 252         h += height() / 4;
 253         int scroll_max_ = std::max(0, h - height());
 254
 255         setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOn);
 256         verticalScrollBar()->setRange(0, scroll_max_);
 257         verticalScrollBar()->setSliderPosition(scroll_pos);
 258         verticalScrollBar()->setSingleStep(scroll_line_step);
 259         verticalScrollBar()->setValue(scroll_pos);
 260
 261         verticalScrollBar()->setTracking(true);
 262 }
 263
 264
 265 void GuiWorkArea::adjustViewWithScrollBar(int)
 266 {
 267         scrollBufferView(verticalScrollBar()->sliderPosition());
 268 }
 269
 270
 271 void GuiWorkArea::dragEnterEvent(QDragEnterEvent * event)
 272 {
 273         if (event->mimeData()->hasUrls())
 274                 event->accept();
 275         /// \todo Ask lyx-devel is this is enough:
 276         /// if (event->mimeData()->hasFormat("text/plain"))
 277         ///     event->acceptProposedAction();
 278 }
 279
 280
 281 void GuiWorkArea::dropEvent(QDropEvent* event)
 282 {
 283         QList<QUrl> files = event->mimeData()->urls();
 284         if (files.isEmpty())
 285                 return;
 286
 287         lyxerr[Debug::GUI] << "GuiWorkArea::dropEvent: got URIs!" << endl;
 288         for (int i = 0; i!=files.size(); ++i) {
 289                 string const file = os::internal_path(fromqstr(files.at(i).toLocalFile()));
 290                 if (!file.empty())
 291                         dispatch(FuncRequest(LFUN_FILE_OPEN, file));
 292         }
 293 }
 294
 295
 296 void GuiWorkArea::focusInEvent(QFocusEvent * /*event*/)
 297 {
 298         // No need to do anything if we didn't change views...
 299         if (&lyx_view_ == &theApp->currentView())
 300                 return;
 301
 302         theApp->setCurrentView(lyx_view_);
 303
 304         // FIXME: it would be better to send a signal "newBuffer()"
 305         // in BufferList that could be connected to the different tabbars.
 306         lyx_view_.updateTab();
 307
 308         startBlinkingCursor();
 309
 310         //FIXME: Use case: Two windows share the same buffer.
 311         // The first window is resize. This modify the inner Buffer
 312         // structure because Paragraph has a notion of line break and
 313         // thus line width (this is very bad!).
 314         // When switching to the other window which does not have the
 315         // same size, LyX crashes because the line break is not adapted
 316         // the this BufferView width.
 317         // The following line fix the crash by resizing the BufferView
 318         // on a focusInEvent(). That is not a good fix but it is a fix
 319         // nevertheless. The bad side effect is that when the two
 320         // BufferViews show the same portion of the Buffer, the second
 321         // BufferView will show the same line breaks as the first one;
 322         // even though those line breaks are not adapted to the second
 323         // BufferView width... such is life!
 324         resizeBufferView();
 325 }
 326
 327
 328 void GuiWorkArea::focusOutEvent(QFocusEvent * /*event*/)
 329 {
 330         // No need to do anything if we didn't change views...
 331         if (&lyx_view_ == &theApp->currentView())
 332                 return;
 333
 334         stopBlinkingCursor();
 335 }
 336
 337
 338 void GuiWorkArea::mousePressEvent(QMouseEvent * e)
 339 {
 340         if (dc_event_.active && dc_event_ == *e) {
 341                 dc_event_.active = false;
 342                 FuncRequest cmd(LFUN_MOUSE_TRIPLE,
 343                         dc_event_.x, dc_event_.y,
 344                         q_button_state(dc_event_.state));
 345                 dispatch(cmd);
 346                 return;
 347         }
 348
 349         FuncRequest const cmd(LFUN_MOUSE_PRESS, e->x(), e->y(),
 350                               q_button_state(e->button()));
 351         dispatch(cmd);
 352 }
 353
 354
 355 void GuiWorkArea::mouseReleaseEvent(QMouseEvent * e)
 356 {
 357         if (synthetic_mouse_event_.timeout.running())
 358                 synthetic_mouse_event_.timeout.stop();
 359
 360         FuncRequest const cmd(LFUN_MOUSE_RELEASE, e->x(), e->y(),
 361                               q_button_state(e->button()));
 362         dispatch(cmd);
 363 }
 364
 365
 366 void GuiWorkArea::mouseMoveEvent(QMouseEvent * e)
 367 {
 368         FuncRequest cmd(LFUN_MOUSE_MOTION, e->x(), e->y(),
 369                               q_motion_state(e->buttons()));
 370
 371         // If we're above or below the work area...
 372         if (e->y() <= 20 || e->y() >= viewport()->height() - 20) {
 373                 // Make sure only a synthetic event can cause a page scroll,
 374                 // so they come at a steady rate:
 375                 if (e->y() <= 20)
 376                         // _Force_ a scroll up:
 377                         cmd.y = -40;
 378                 else
 379                         cmd.y = viewport()->height();
 380                 // Store the event, to be handled when the timeout expires.
 381                 synthetic_mouse_event_.cmd = cmd;
 382
 383                 if (synthetic_mouse_event_.timeout.running())
 384                         // Discard the event. Note that it _may_ be handled
 385                         // when the timeout expires if
 386                         // synthetic_mouse_event_.cmd has not been overwritten.
 387                         // Ie, when the timeout expires, we handle the
 388                         // most recent event but discard all others that
 389                         // occurred after the one used to start the timeout
 390                         // in the first place.
 391                         return;
 392                 else {
 393                         synthetic_mouse_event_.restart_timeout = true;
 394                         synthetic_mouse_event_.timeout.start();
 395                         // Fall through to handle this event...
 396                 }
 397
 398         } else if (synthetic_mouse_event_.timeout.running()) {
 399                 // Store the event, to be possibly handled when the timeout
 400                 // expires.
 401                 // Once the timeout has expired, normal control is returned
 402                 // to mouseMoveEvent (restart_timeout = false).
 403                 // This results in a much smoother 'feel' when moving the
 404                 // mouse back into the work area.
 405                 synthetic_mouse_event_.cmd = cmd;
 406                 synthetic_mouse_event_.restart_timeout = false;
 407                 return;
 408         }
 409
 410         // Has anything changed on-screen since the last QMouseEvent
 411         // was received?
 412         double const scrollbar_value = verticalScrollBar()->value();
 413         if (e->x() != synthetic_mouse_event_.x_old ||
 414             e->y() != synthetic_mouse_event_.y_old ||
 415             scrollbar_value != synthetic_mouse_event_.scrollbar_value_old) {
 416                 // Yes it has. Store the params used to check this.
 417                 synthetic_mouse_event_.x_old = e->x();
 418                 synthetic_mouse_event_.y_old = e->y();
 419                 synthetic_mouse_event_.scrollbar_value_old = scrollbar_value;
 420
 421                 // ... and dispatch the event to the LyX core.
 422                 dispatch(cmd);
 423         }
 424 }
 425
 426
 427 void GuiWorkArea::wheelEvent(QWheelEvent * e)
 428 {
 429         // Wheel rotation by one notch results in a delta() of 120 (see
 430         // documentation of QWheelEvent)
 431         int const lines = qApp->wheelScrollLines() * e->delta() / 120;
 432         verticalScrollBar()->setValue(verticalScrollBar()->value() -
 433                         lines *  verticalScrollBar()->singleStep());
 434         adjustViewWithScrollBar();
 435 }
 436
 437
 438 void GuiWorkArea::generateSyntheticMouseEvent()
 439 {
 440 // Set things off to generate the _next_ 'pseudo' event.
 441         if (synthetic_mouse_event_.restart_timeout)
 442                 synthetic_mouse_event_.timeout.start();
 443
 444         // Has anything changed on-screen since the last timeout signal
 445         // was received?
 446         double const scrollbar_value = verticalScrollBar()->value();
 447         if (scrollbar_value != synthetic_mouse_event_.scrollbar_value_old) {
 448                 // Yes it has. Store the params used to check this.
 449                 synthetic_mouse_event_.scrollbar_value_old = scrollbar_value;
 450
 451                 // ... and dispatch the event to the LyX core.
 452                 dispatch(synthetic_mouse_event_.cmd);
 453         }
 454 }
 455
 456
 457 void GuiWorkArea::keyPressEvent(QKeyEvent * e)
 458 {
 459         lyxerr[Debug::KEY] << BOOST_CURRENT_FUNCTION
 460                 << " count=" << e->count()
 461                 << " text=" << fromqstr(e->text())
 462                 << " isAutoRepeat=" << e->isAutoRepeat()
 463                 << " key=" << e->key()
 464                 << endl;
 465
 466         if (USE_EVENT_PRUNING) {
 467                 keyeventQueue_.push(boost::shared_ptr<QKeyEvent>(new QKeyEvent(*e)));
 468         }
 469         else {
 470                 boost::shared_ptr<QLyXKeySym> sym(new QLyXKeySym);
 471                 sym->set(e);
 472                 processKeySym(sym, q_key_state(e->modifiers()));
 473         }
 474 }
 475
 476
 477 // This is used only if USE_EVENT_PRUNING is defined...
 478 void GuiWorkArea::keyeventTimeout()
 479 {
 480         bool handle_autos = true;
 481
 482         while (!keyeventQueue_.empty()) {
 483                 boost::shared_ptr<QKeyEvent> ev = keyeventQueue_.front();
 484
 485                 // We never handle more than one auto repeated
 486                 // char in a list of queued up events.
 487                 if (!handle_autos && ev->isAutoRepeat()) {
 488                         keyeventQueue_.pop();
 489                         continue;
 490                 }
 491
 492                 boost::shared_ptr<QLyXKeySym> sym(new QLyXKeySym);
 493                 sym->set(ev.get());
 494
 495                 lyxerr[Debug::GUI] << BOOST_CURRENT_FUNCTION
 496                                    << " count=" << ev->count()
 497                                    << " text=" <<  fromqstr(ev->text())
 498                                    << " isAutoRepeat=" << ev->isAutoRepeat()
 499                                    << " key=" << ev->key()
 500                                    << endl;
 501
 502                 processKeySym(sym, q_key_state(ev->modifiers()));
 503                 keyeventQueue_.pop();
 504
 505                 handle_autos = false;
 506         }
 507
 508         // Restart the timer.
 509         step_timer_.setSingleShot(true);
 510         step_timer_.start(25);
 511 }
 512
 513
 514 void GuiWorkArea::mouseDoubleClickEvent(QMouseEvent * e)
 515 {
 516         dc_event_ = double_click(e);
 517
 518         if (!dc_event_.active)
 519                 return;
 520
 521         dc_event_.active = false;
 522
 523         FuncRequest cmd(LFUN_MOUSE_DOUBLE,
 524                 dc_event_.x, dc_event_.y,
 525                 q_button_state(dc_event_.state));
 526         dispatch(cmd);
 527 }
 528
 529
 530 void GuiWorkArea::resizeEvent(QResizeEvent * ev)
 531 {
 532         cursor_->hide();
 533         screen_ = QPixmap(ev->size().width(), ev->size().height());
 534         verticalScrollBar()->setPageStep(viewport()->height());
 535         QAbstractScrollArea::resizeEvent(ev);
 536         resizeBufferView();
 537 }
 538
 539
 540 void GuiWorkArea::update(int x, int y, int w, int h)
 541 {
 542         viewport()->update(x, y, w, h);
 543 }
 544
 545
 546 void GuiWorkArea::doGreyOut(QLPainter & pain)
 547 {
 548         greyed_out_ = true;
 549         pain.fillRectangle(0, 0, width(), height(),
 550                 LColor::bottomarea);
 551
 552         //if (!lyxrc.show_banner)
 553         //      return;
 554         lyxerr << "show banner: " << lyxrc.show_banner << endl;
 555         /// The text to be written on top of the pixmap
 556         string const text = lyx_version ? lyx_version : "unknown";
 557         string const file = support::libFileSearch("images", "banner", "ppm");
 558         if (file.empty())
 559                 return;
 560
 561         QPixmap pm(toqstr(file));
 562         if (!pm) {
 563                 lyxerr << "could not load splash screen: '" << file << "'" << endl;
 564                 return;
 565         }
 566
 567         QFont font;
 568         // The font used to display the version info
 569         font.setStyleHint(QFont::SansSerif);
 570         font.setWeight(QFont::Bold);
 571         font.setPointSize(LyXFont::SIZE_NORMAL);
 572
 573         int const w = pm.width();
 574         int const h = pm.height();
 575
 576         int x = (width() - w) / 2;
 577         int y = (height() - h) / 2;
 578
 579         pain.drawPixmap(x, y, pm);
 580
 581         x += 260;
 582         y += 265;
 583
 584         pain.setPen(QColor(255, 255, 0));
 585         pain.setFont(font);
 586         pain.drawText(x, y, toqstr(text));
 587 }
 588
 589
 590 void GuiWorkArea::paintEvent(QPaintEvent * ev)
 591 {
 592         QRect const rc = ev->rect();
 593         lyxerr[Debug::PAINTING] << "paintEvent begin: x: " << rc.x()
 594                 << " y: " << rc.y()
 595                 << " w: " << rc.width()
 596                 << " h: " << rc.height() << endl;
 597
 598         QPainter pain(viewport());
 599         pain.drawPixmap(rc, screen_, rc);
 600 }
 601
 602
 603
 604 void GuiWorkArea::expose(int x, int y, int w, int h)
 605 {
 606         QLPainter pain(&screen_);
 607
 608         if (w == 3) { // FIXME HACK
 609                 // Assume splash screen drawing is requested when
 610                 // width == 3
 611                 lyxerr << "splash screen requested" << endl;
 612                 doGreyOut(pain);
 613         }
 614         else if (!buffer_view_->buffer()) {
 615                 lyxerr << "no buffer: " << endl;
 616                 doGreyOut(pain);
 617                 updateScrollbar();
 618         }
 619         else {
 620                 paintText(*buffer_view_, pain);
 621         }
 622
 623         update(x, y, w, h);
 624 }
 625
 626
 627 void GuiWorkArea::showCursor(int x, int y, int h, CursorShape shape)
 628 {
 629         cursor_->setGeometry(x, y, CursorWidth, h);
 630         cursor_->shape_ = shape;
 631         cursor_->show();
 632 }
 633
 634
 635 void GuiWorkArea::removeCursor()
 636 {
 637         if (!qApp->focusWidget())
 638                 return;
 639         cursor_->hide();
 640 }
 641
 642
 643 void GuiWorkArea::inputMethodEvent(QInputMethodEvent * e)
 644 {
 645         QString const & text = e->commitString();
 646         if (!text.isEmpty()) {
 647
 648                 lyxerr[Debug::KEY] << BOOST_CURRENT_FUNCTION
 649                         << " preeditString =" << fromqstr(e->preeditString())
 650                         << " commitString  =" << fromqstr(e->commitString())
 651                         << endl;
 652
 653                 int key = 0;
 654                 // needed to make math superscript work on some systems
 655                 // ideally, such special coding should not be necessary
 656                 if (text == "^")
 657                         key = Qt::Key_AsciiCircum;
 658                 // FIXME: Needs for investigation, this key is not really used,
 659                 // the ctor below just check if key is different from 0.
 660                 QKeyEvent ev(QEvent::KeyPress, key, Qt::NoModifier, text);
 661                 keyPressEvent(&ev);
 662         }
 663         e->accept();
 664 }
 665
 666 } // namespace frontend
 667 } // namespace lyx
 668
 669 #include "GuiWorkArea_moc.cpp"