src/insets/Inset.cpp

   1 /**
   2  * \file Inset.cpp
   3  * This file is part of LyX, the document processor.
   4  * Licence details can be found in the file COPYING.
   5  *
   6  * \author Alejandro Aguilar Sierra
   7  * \author Jürgen Vigna
   8  * \author Lars Gullik Bjønnes
   9  * \author Matthias Ettrich
  10  * \author André Pönitz
  11  *
  12  * Full author contact details are available in file CREDITS.
  13  */
  14
  15 #include <config.h>
  16
  17 #include "Inset.h"
  18
  19 #include "buffer_funcs.h"
  20 #include "Buffer.h"
  21 #include "BufferList.h"
  22 #include "BufferParams.h"
  23 #include "BufferView.h"
  24 #include "CoordCache.h"
  25 #include "Cursor.h"
  26 #include "Dimension.h"
  27 #include "DispatchResult.h"
  28 #include "FuncRequest.h"
  29 #include "FuncStatus.h"
  30 #include "MetricsInfo.h"
  31 #include "output_xhtml.h"
  32 #include "Text.h"
  33 #include "TextClass.h"
  34
  35 #include "frontends/Application.h"
  36 #include "frontends/Painter.h"
  37
  38 #include "support/debug.h"
  39 #include "support/docstream.h"
  40 #include "support/ExceptionMessage.h"
  41 #include "support/gettext.h"
  42 #include "support/lassert.h"
  43
  44 #include <map>
  45
  46 using namespace std;
  47 using namespace lyx::support;
  48
  49 namespace lyx {
  50
  51 class InsetName {
  52 public:
  53         InsetName(string const & n = string(), docstring const & dn = docstring())
  54                 : name(n), display_name(dn) {}
  55         string name;
  56         docstring display_name;
  57 };
  58
  59
  60 static InsetName insetnames[INSET_CODE_SIZE];
  61
  62
  63 static void build_translator()
  64 {
  65         static bool passed = false;
  66         if (passed)
  67                 return;
  68         insetnames[TOC_CODE] = InsetName("toc");
  69         insetnames[QUOTE_CODE] = InsetName("quote");
  70         insetnames[REF_CODE] = InsetName("ref");
  71         insetnames[HYPERLINK_CODE] = InsetName("href");
  72         insetnames[SEPARATOR_CODE] = InsetName("separator");
  73         insetnames[ENDING_CODE] = InsetName("ending");
  74         insetnames[LABEL_CODE] = InsetName("label");
  75         insetnames[NOTE_CODE] = InsetName("note");
  76         insetnames[PHANTOM_CODE] = InsetName("phantom");
  77         insetnames[ACCENT_CODE] = InsetName("accent");
  78         insetnames[MATH_CODE] = InsetName("math");
  79         insetnames[INDEX_CODE] = InsetName("index");
  80         insetnames[NOMENCL_CODE] = InsetName("nomenclature");
  81         insetnames[INCLUDE_CODE] = InsetName("include");
  82         insetnames[GRAPHICS_CODE] = InsetName("graphics");
  83         insetnames[BIBITEM_CODE] = InsetName("bibitem");
  84         insetnames[BIBTEX_CODE] = InsetName("bibtex");
  85         insetnames[TEXT_CODE] = InsetName("text");
  86         insetnames[ERT_CODE] = InsetName("ert", _("TeX Code"));
  87         insetnames[FOOT_CODE] = InsetName("foot");
  88         insetnames[MARGIN_CODE] = InsetName("margin");
  89         insetnames[FLOAT_CODE] = InsetName("float", _("Float"));
  90         insetnames[WRAP_CODE] = InsetName("wrap");
  91         insetnames[SPECIALCHAR_CODE] = InsetName("specialchar");
  92         insetnames[TABULAR_CODE] = InsetName("tabular", _("Table"));
  93         insetnames[EXTERNAL_CODE] = InsetName("external");
  94         insetnames[CAPTION_CODE] = InsetName("caption");
  95         insetnames[MATHMACRO_CODE] = InsetName("mathmacro");
  96         insetnames[CITE_CODE] = InsetName("citation");
  97         insetnames[FLOAT_LIST_CODE] = InsetName("floatlist");
  98         insetnames[INDEX_PRINT_CODE] = InsetName("index_print");
  99         insetnames[NOMENCL_PRINT_CODE] = InsetName("nomencl_print");
 100         insetnames[OPTARG_CODE] = InsetName("optarg");
 101         insetnames[NEWLINE_CODE] = InsetName("newline");
 102         insetnames[LINE_CODE] = InsetName("line");
 103         insetnames[BRANCH_CODE] = InsetName("branch", _("Branch"));
 104         insetnames[BOX_CODE] = InsetName("box", _("Box"));
 105         insetnames[FLEX_CODE] = InsetName("flex");
 106         insetnames[SPACE_CODE] = InsetName("space");
 107         insetnames[VSPACE_CODE] = InsetName("vspace", _("Vertical Space"));
 108         insetnames[MATH_MACROARG_CODE] = InsetName("mathmacroarg");
 109         insetnames[LISTINGS_CODE] = InsetName("listings");
 110         insetnames[INFO_CODE] = InsetName("info", _("Info"));
 111         insetnames[COLLAPSABLE_CODE] = InsetName("collapsable");
 112         insetnames[NEWPAGE_CODE] = InsetName("newpage");
 113         insetnames[CELL_CODE] = InsetName("tablecell");
 114         insetnames[MATH_AMSARRAY_CODE] = InsetName("mathamsarray");
 115         insetnames[MATH_ARRAY_CODE] = InsetName("matharray");
 116         insetnames[MATH_BIG_CODE] = InsetName("mathbig");
 117         insetnames[MATH_BOLDSYMBOL_CODE] = InsetName("mathboldsymbol");
 118         insetnames[MATH_BOX_CODE] = InsetName("mathbox");
 119         insetnames[MATH_BRACE_CODE] = InsetName("mathbrace");
 120         insetnames[MATH_CASES_CODE] = InsetName("mathcases");
 121         insetnames[MATH_CHAR_CODE] = InsetName("mathchar");
 122         insetnames[MATH_COLOR_CODE] = InsetName("mathcolor");
 123         insetnames[MATH_COMMENT_CODE] = InsetName("mathcomment");
 124         insetnames[MATH_DECORATION_CODE] = InsetName("mathdecoration");
 125         insetnames[MATH_DELIM_CODE] = InsetName("mathdelim");
 126         insetnames[MATH_DIFF_CODE] = InsetName("mathdiff");
 127         insetnames[MATH_DOTS_CODE] = InsetName("mathdots");
 128         insetnames[MATH_ENSUREMATH_CODE] = InsetName("mathensuremath");
 129         insetnames[MATH_ENV_CODE] = InsetName("mathenv");
 130         insetnames[MATH_EXFUNC_CODE] = InsetName("mathexfunc");
 131         insetnames[MATH_EXINT_CODE] = InsetName("mathexint");
 132         insetnames[MATH_FONT_CODE] = InsetName("mathfont");
 133         insetnames[MATH_FONTOLD_CODE] = InsetName("mathfontold");
 134         insetnames[MATH_FRAC_CODE] = InsetName("mathfrac");
 135         insetnames[MATH_GRID_CODE] = InsetName("mathgrid");
 136         insetnames[MATH_CODE] = InsetName("math");
 137         insetnames[MATH_HULL_CODE] = InsetName("mathhull");
 138         insetnames[MATH_KERN_CODE] = InsetName("mathkern");
 139         insetnames[MATH_LEFTEQN_CODE] = InsetName("mathlefteqn");
 140         insetnames[MATH_LIM_CODE] = InsetName("mathlim");
 141         insetnames[MATH_MATRIX_CODE] = InsetName("mathmatrix");
 142         insetnames[MATH_MBOX_CODE] = InsetName("mathmbox");
 143         insetnames[MATH_NEST_CODE] = InsetName("mathnest");
 144         insetnames[MATH_NUMBER_CODE] = InsetName("mathnumber");
 145         insetnames[MATH_OVERSET_CODE] = InsetName("mathoverset");
 146         insetnames[MATH_PAR_CODE] = InsetName("mathpar");
 147         insetnames[MATH_PHANTOM_CODE] = InsetName("mathphantom");
 148         insetnames[MATH_REF_CODE] = InsetName("mathref");
 149         insetnames[MATH_ROOT_CODE] = InsetName("mathroot");
 150         insetnames[MATH_SCRIPT_CODE] = InsetName("mathscript");
 151         insetnames[MATH_SIZE_CODE] = InsetName("mathsize");
 152         insetnames[MATH_SPACE_CODE] = InsetName("mathspace");
 153         insetnames[MATH_SPECIALCHAR_CODE] = InsetName("mathspecialchar");
 154         insetnames[MATH_SPLIT_CODE] = InsetName("mathsplit");
 155         insetnames[MATH_SQRT_CODE] = InsetName("mathsqrt");
 156         insetnames[MATH_STACKREL_CODE] = InsetName("mathstackrel");
 157         insetnames[MATH_STRING_CODE] = InsetName("mathstring");
 158         insetnames[MATH_SUBSTACK_CODE] = InsetName("mathsubstack");
 159         insetnames[MATH_SYMBOL_CODE] = InsetName("mathsymbol");
 160         insetnames[MATH_TABULAR_CODE] = InsetName("mathtabular");
 161         insetnames[MATH_UNDERSET_CODE] = InsetName("mathunderset");
 162         insetnames[MATH_UNKNOWN_CODE] = InsetName("mathunknown");
 163         insetnames[MATH_XARROW_CODE] = InsetName("mathxarrow");
 164         insetnames[MATH_XYARROW_CODE] = InsetName("mathxyarrow");
 165         insetnames[MATH_XYMATRIX_CODE] = InsetName("mathxymatrix");
 166         insetnames[MATH_MACRO_CODE] = InsetName("mathmacro");
 167
 168         passed = true;
 169 }
 170
 171
 172 void Inset::setBuffer(Buffer & buffer)
 173 {
 174         buffer_ = &buffer;
 175 }
 176
 177
 178 Buffer & Inset::buffer()
 179 {
 180         if (!buffer_) {
 181                 odocstringstream s;
 182                 lyxerr << "Inset: " << this
 183                                         << " LyX Code: " << lyxCode()
 184                                         << " name: " << insetName(lyxCode())
 185                                         << std::endl;
 186                 s << "LyX Code: " << lyxCode() << " name: " << name();
 187                 LASSERT(false, /**/);
 188                 throw ExceptionMessage(BufferException,
 189                         from_ascii("Inset::buffer_ member not initialized!"), s.str());
 190         }
 191         return *buffer_;
 192 }
 193
 194
 195 Buffer const & Inset::buffer() const
 196 {
 197         return const_cast<Inset *>(this)->buffer();
 198 }
 199
 200
 201 bool Inset::isBufferValid() const
 202 {
 203         return buffer_ && theBufferList().isLoaded(buffer_);
 204 }
 205
 206
 207 docstring Inset::name() const
 208 {
 209         return from_ascii("unknown");
 210 }
 211
 212
 213 bool Inset::isFreeSpacing() const
 214 {
 215         return getLayout().isFreeSpacing();
 216 }
 217
 218
 219 bool Inset::allowEmpty() const
 220 {
 221         return getLayout().isKeepEmpty();
 222 }
 223
 224 bool Inset::forceLTR() const
 225 {
 226         return getLayout().forceLTR();
 227 }
 228
 229 void Inset::initView()
 230 {
 231         if (isLabeled())
 232                 buffer().updateLabels();
 233 }
 234
 235
 236 docstring Inset::toolTip(BufferView const &, int, int) const
 237 {
 238         return docstring();
 239 }
 240
 241
 242 docstring Inset::contextMenu(BufferView const &, int, int) const
 243 {
 244         return docstring();
 245 }
 246
 247
 248 Dimension const Inset::dimension(BufferView const & bv) const
 249 {
 250         return bv.coordCache().getInsets().dim(this);
 251 }
 252
 253
 254 InsetCode insetCode(string const & name)
 255 {
 256         build_translator();
 257         for (int i = 1; i != int(INSET_CODE_SIZE); ++i) {
 258                 if (insetnames[i].name == name)
 259                         return InsetCode(i);
 260         }
 261         return NO_CODE;
 262 }
 263
 264
 265 string insetName(InsetCode c)
 266 {
 267         build_translator();
 268         return insetnames[c].name;
 269 }
 270
 271
 272 docstring insetDisplayName(InsetCode c)
 273 {
 274         build_translator();
 275         return insetnames[c].display_name;
 276 }
 277
 278
 279 void Inset::dispatch(Cursor & cur, FuncRequest & cmd)
 280 {
 281         if (buffer_ == 0) {
 282                 lyxerr << "Unassigned buffer_ member in Inset::dispatch()" << std::endl;
 283                 lyxerr << "LyX Code: " << lyxCode() << " name: " << insetName(lyxCode()) << std::endl;
 284         } else if (cur.buffer() != buffer_)
 285                 lyxerr << "cur.buffer() != buffer_ in Inset::dispatch()" << std::endl;
 286         cur.updateFlags(Update::Force | Update::FitCursor);
 287         cur.dispatched();
 288         doDispatch(cur, cmd);
 289 }
 290
 291
 292 bool Inset::showInsetDialog(BufferView * bv) const
 293 {
 294         InsetCode const code = lyxCode();
 295         switch (code){
 296         case ERT_CODE:
 297         case FLOAT_CODE:
 298         case BOX_CODE:
 299         case BRANCH_CODE:
 300         case INFO_CODE:
 301         case TABULAR_CODE:
 302         case VSPACE_CODE:
 303                 bv->showDialog(insetName(code));
 304                 break;
 305         default:
 306                 return false;
 307         }
 308         return true;
 309 }
 310
 311
 312 void Inset::doDispatch(Cursor & cur, FuncRequest &cmd)
 313 {
 314         switch (cmd.action) {
 315         case LFUN_MOUSE_RELEASE:
 316                 // if the derived inset did not explicitly handle mouse_release,
 317                 // we assume we request the settings dialog
 318                 if (!cur.selection() && cmd.button() == mouse_button::button1
 319                           && hasSettings()) {
 320                         FuncRequest tmpcmd(LFUN_INSET_SETTINGS);
 321                         dispatch(cur, tmpcmd);
 322                 }
 323                 break;
 324
 325         case LFUN_INSET_SETTINGS:
 326                 if (cmd.argument().empty() || cmd.getArg(0) == insetName(lyxCode())) {
 327                         showInsetDialog(&cur.bv());
 328                         cur.dispatched();
 329                 } else
 330                         cur.undispatched();
 331                 break;
 332
 333         default:
 334                 cur.noUpdate();
 335                 cur.undispatched();
 336                 break;
 337         }
 338 }
 339
 340
 341 bool Inset::getStatus(Cursor &, FuncRequest const & cmd,
 342         FuncStatus & flag) const
 343 {
 344         // LFUN_INSET_APPLY is sent from the dialogs when the data should
 345         // be applied. This is either changed to LFUN_INSET_MODIFY (if the
 346         // dialog belongs to us) or LFUN_INSET_INSERT (if the dialog does
 347         // not belong to us, i. e. the dialog was open, and the user moved
 348         // the cursor in our inset) in lyx::getStatus().
 349         // Dialogs::checkStatus() ensures that the dialog is deactivated if
 350         // LFUN_INSET_APPLY is disabled.
 351
 352         switch (cmd.action) {
 353         case LFUN_INSET_MODIFY:
 354                 // Allow modification of our data.
 355                 // This needs to be handled in the doDispatch method of our
 356                 // instantiatable children.
 357                 flag.setEnabled(true);
 358                 return true;
 359
 360         case LFUN_INSET_INSERT:
 361                 // Don't allow insertion of new insets.
 362                 // Every inset that wants to allow new insets from open
 363                 // dialogs needs to override this.
 364                 flag.setEnabled(false);
 365                 return true;
 366
 367         case LFUN_INSET_SETTINGS:
 368                 if (cmd.argument().empty() || cmd.getArg(0) == insetName(lyxCode())) {
 369                         bool const enable = hasSettings();
 370                         flag.setEnabled(enable);
 371                         return true;
 372                 } else {
 373                         flag.setEnabled(false);
 374                         return false;
 375                 }
 376
 377         default:
 378                 break;
 379         }
 380         return false;
 381 }
 382
 383
 384 void Inset::edit(Cursor &, bool, EntryDirection)
 385 {
 386         LYXERR(Debug::INSETS, "edit left/right");
 387 }
 388
 389
 390 Inset * Inset::editXY(Cursor &, int x, int y)
 391 {
 392         LYXERR(Debug::INSETS, "x: " << x << " y: " << y);
 393         return this;
 394 }
 395
 396
 397 Inset::idx_type Inset::index(row_type row, col_type col) const
 398 {
 399         if (row != 0)
 400                 LYXERR0("illegal row: " << row);
 401         if (col != 0)
 402                 LYXERR0("illegal col: " << col);
 403         return 0;
 404 }
 405
 406
 407 bool Inset::idxBetween(idx_type idx, idx_type from, idx_type to) const
 408 {
 409         return from <= idx && idx <= to;
 410 }
 411
 412
 413 bool Inset::idxUpDown(Cursor &, bool) const
 414 {
 415         return false;
 416 }
 417
 418
 419 int Inset::docbook(odocstream &, OutputParams const &) const
 420 {
 421         return 0;
 422 }
 423
 424
 425 docstring Inset::xhtml(XHTMLStream & xs, OutputParams const &) const
 426 {
 427         xs << "[[Inset: " << from_ascii(insetName(lyxCode())) << "]]";
 428         return docstring();
 429 }
 430
 431
 432 bool Inset::directWrite() const
 433 {
 434         return false;
 435 }
 436
 437
 438 bool Inset::editable() const
 439 {
 440         return false;
 441 }
 442
 443
 444 bool Inset::hasSettings() const
 445 {
 446         return false;
 447 }
 448
 449
 450
 451 bool Inset::autoDelete() const
 452 {
 453         return false;
 454 }
 455
 456
 457 void Inset::cursorPos(BufferView const & /*bv*/, CursorSlice const &,
 458                 bool, int & x, int & y) const
 459 {
 460         LYXERR0("Inset::cursorPos called directly");
 461         x = 100;
 462         y = 100;
 463 }
 464
 465
 466 void Inset::metricsMarkers(Dimension & dim, int framesize) const
 467 {
 468         dim.wid += 2 * framesize;
 469         dim.des += framesize;
 470 }
 471
 472
 473 void Inset::metricsMarkers2(Dimension & dim, int framesize) const
 474 {
 475         dim.wid += 2 * framesize;
 476         dim.asc += framesize;
 477         dim.des += framesize;
 478 }
 479
 480
 481 void Inset::drawMarkers(PainterInfo & pi, int x, int y) const
 482 {
 483         ColorCode pen_color = mouseHovered() || editing(pi.base.bv)?
 484                 Color_mathframe : Color_mathcorners;
 485
 486         Dimension const dim = dimension(*pi.base.bv);
 487
 488         int const t = x + dim.width() - 1;
 489         int const d = y + dim.descent();
 490         pi.pain.line(x, d - 3, x, d, pen_color);
 491         pi.pain.line(t, d - 3, t, d, pen_color);
 492         pi.pain.line(x, d, x + 3, d, pen_color);
 493         pi.pain.line(t - 3, d, t, d, pen_color);
 494         setPosCache(pi, x, y);
 495 }
 496
 497
 498 void Inset::drawMarkers2(PainterInfo & pi, int x, int y) const
 499 {
 500         ColorCode pen_color = mouseHovered() || editing(pi.base.bv)?
 501                 Color_mathframe : Color_mathcorners;
 502
 503         drawMarkers(pi, x, y);
 504         Dimension const dim = dimension(*pi.base.bv);
 505         int const t = x + dim.width() - 1;
 506         int const a = y - dim.ascent();
 507         pi.pain.line(x, a + 3, x, a, pen_color);
 508         pi.pain.line(t, a + 3, t, a, pen_color);
 509         pi.pain.line(x, a, x + 3, a, pen_color);
 510         pi.pain.line(t - 3, a, t, a, pen_color);
 511         setPosCache(pi, x, y);
 512 }
 513
 514
 515 bool Inset::editing(BufferView const * bv) const
 516 {
 517         return bv->cursor().isInside(this);
 518 }
 519
 520
 521 int Inset::xo(BufferView const & bv) const
 522 {
 523         return bv.coordCache().getInsets().x(this);
 524 }
 525
 526
 527 int Inset::yo(BufferView const & bv) const
 528 {
 529         return bv.coordCache().getInsets().y(this);
 530 }
 531
 532
 533 bool Inset::covers(BufferView const & bv, int x, int y) const
 534 {
 535         return bv.coordCache().getInsets().covers(this, x, y);
 536 }
 537
 538
 539 InsetLayout const & Inset::getLayout() const
 540 {
 541         if (!buffer_)
 542                 return DocumentClass::plainInsetLayout();
 543         return buffer().params().documentClass().insetLayout(name());
 544 }
 545
 546
 547 bool Inset::undefined() const
 548 {
 549         docstring const & n = getLayout().name();
 550         return n.empty() || n == DocumentClass::plainInsetLayout().name();
 551 }
 552
 553
 554 void Inset::dump() const
 555 {
 556         write(lyxerr);
 557 }
 558
 559
 560 ColorCode Inset::backgroundColor(PainterInfo const & /*pi*/) const
 561 {
 562         return Color_none;
 563 }
 564
 565
 566 ColorCode Inset::labelColor() const
 567 {
 568         return Color_foreground;
 569 }
 570
 571
 572 void Inset::setPosCache(PainterInfo const & pi, int x, int y) const
 573 {
 574         //LYXERR("Inset: set position cache to " << x << " " << y);
 575         pi.base.bv->coordCache().insets().add(this, x, y);
 576 }
 577
 578
 579 void Inset::setDimCache(MetricsInfo const & mi, Dimension const & dim) const
 580 {
 581         mi.base.bv->coordCache().insets().add(this, dim);
 582 }
 583
 584
 585 Buffer const * Inset::updateFrontend() const
 586 {
 587         return theApp() ? theApp()->updateInset(this) : 0;
 588 }
 589
 590
 591 docstring Inset::completionPrefix(Cursor const &) const
 592 {
 593         return docstring();
 594 }
 595
 596 } // namespace lyx