3 * This file is part of LyX, the document processor.
4 * Licence details can be found in the file COPYING.
6 * \author Alejandro Aguilar Sierra
8 * \author Lars Gullik Bjønnes
9 * \author Matthias Ettrich
10 * \author André Pönitz
12 * Full author contact details are available in file CREDITS.
19 #include "buffer_funcs.h"
21 #include "BufferList.h"
22 #include "BufferParams.h"
23 #include "BufferView.h"
24 #include "CoordCache.h"
26 #include "Dimension.h"
27 #include "DispatchResult.h"
28 #include "FuncRequest.h"
29 #include "FuncStatus.h"
30 #include "InsetLayout.h"
31 #include "MetricsInfo.h"
32 #include "output_xhtml.h"
35 #include "TextClass.h"
36 #include "TocBackend.h"
38 #include "frontends/Application.h"
39 #include "frontends/Painter.h"
41 #include "support/debug.h"
42 #include "support/docstream.h"
43 #include "support/ExceptionMessage.h"
44 #include "support/gettext.h"
45 #include "support/lassert.h"
50 using namespace lyx::support;
56 InsetName(string const & n = string(), docstring const & dn = docstring())
57 : name(n), display_name(dn) {}
59 docstring display_name;
63 static InsetName insetnames[INSET_CODE_SIZE];
66 // This list should be kept in sync with the list of dialogs in
67 // src/frontends/qt/GuiView.cpp, I.e., if a dialog goes with an
68 // inset, the dialog should have the same name as the inset.
69 // Changes should be also recorded in LFUN_DIALOG_SHOW doxygen
70 // docs in LyXAction.cpp.
71 static void build_translator()
73 static bool passed = false;
76 insetnames[TOC_CODE] = InsetName("toc");
77 insetnames[QUOTE_CODE] = InsetName("quote");
78 insetnames[REF_CODE] = InsetName("ref");
79 insetnames[COUNTER_CODE] = InsetName("counter");
80 insetnames[HYPERLINK_CODE] = InsetName("href");
81 insetnames[SEPARATOR_CODE] = InsetName("separator");
82 insetnames[ENDING_CODE] = InsetName("ending");
83 insetnames[LABEL_CODE] = InsetName("label");
84 insetnames[NOTE_CODE] = InsetName("note");
85 insetnames[PHANTOM_CODE] = InsetName("phantom");
86 insetnames[ACCENT_CODE] = InsetName("accent");
87 insetnames[MATH_CODE] = InsetName("math");
88 insetnames[INDEX_CODE] = InsetName("index");
89 insetnames[NOMENCL_CODE] = InsetName("nomenclature");
90 insetnames[INCLUDE_CODE] = InsetName("include");
91 insetnames[GRAPHICS_CODE] = InsetName("graphics");
92 insetnames[BIBITEM_CODE] = InsetName("bibitem", _("Bibliography Entry"));
93 insetnames[BIBTEX_CODE] = InsetName("bibtex");
94 insetnames[TEXT_CODE] = InsetName("text");
95 insetnames[ERT_CODE] = InsetName("ert", _("TeX Code"));
96 insetnames[FOOT_CODE] = InsetName("foot");
97 insetnames[MARGIN_CODE] = InsetName("margin");
98 insetnames[FLOAT_CODE] = InsetName("float", _("Float"));
99 insetnames[WRAP_CODE] = InsetName("wrap");
100 insetnames[SPECIALCHAR_CODE] = InsetName("specialchar");
101 insetnames[IPA_CODE] = InsetName("ipa");
102 insetnames[IPACHAR_CODE] = InsetName("ipachar");
103 insetnames[IPADECO_CODE] = InsetName("ipadeco");
104 insetnames[TABULAR_CODE] = InsetName("tabular", _("Table"));
105 insetnames[EXTERNAL_CODE] = InsetName("external");
106 insetnames[CAPTION_CODE] = InsetName("caption");
107 insetnames[MATHMACRO_CODE] = InsetName("mathmacro");
108 insetnames[CITE_CODE] = InsetName("citation");
109 insetnames[FLOAT_LIST_CODE] = InsetName("floatlist");
110 insetnames[INDEX_PRINT_CODE] = InsetName("index_print");
111 insetnames[NOMENCL_PRINT_CODE] = InsetName("nomencl_print");
112 insetnames[ARG_CODE] = InsetName("optarg");
113 insetnames[NEWLINE_CODE] = InsetName("newline");
114 insetnames[LINE_CODE] = InsetName("line");
115 insetnames[BRANCH_CODE] = InsetName("branch", _("Branch"));
116 insetnames[BOX_CODE] = InsetName("box", _("Box"));
117 insetnames[FLEX_CODE] = InsetName("flex");
118 insetnames[SPACE_CODE] = InsetName("space", _("Horizontal Space"));
119 insetnames[VSPACE_CODE] = InsetName("vspace", _("Vertical Space"));
120 insetnames[MATH_MACROARG_CODE] = InsetName("mathmacroarg");
121 insetnames[LISTINGS_CODE] = InsetName("listings");
122 insetnames[INFO_CODE] = InsetName("info", _("Info"));
123 insetnames[COLLAPSIBLE_CODE] = InsetName("collapsible");
124 insetnames[NEWPAGE_CODE] = InsetName("newpage");
125 insetnames[SCRIPT_CODE] = InsetName("script");
126 insetnames[CELL_CODE] = InsetName("tablecell");
127 insetnames[MATH_AMSARRAY_CODE] = InsetName("mathamsarray");
128 insetnames[MATH_ARRAY_CODE] = InsetName("matharray");
129 insetnames[MATH_BIG_CODE] = InsetName("mathbig");
130 insetnames[MATH_BOLDSYMBOL_CODE] = InsetName("mathboldsymbol");
131 insetnames[MATH_BOX_CODE] = InsetName("mathbox");
132 insetnames[MATH_BRACE_CODE] = InsetName("mathbrace");
133 insetnames[MATH_CANCEL_CODE] = InsetName("mathcancel");
134 insetnames[MATH_CANCELTO_CODE] = InsetName("mathcancelto");
135 insetnames[MATH_CASES_CODE] = InsetName("mathcases");
136 insetnames[MATH_CHAR_CODE] = InsetName("mathchar");
137 insetnames[MATH_COLOR_CODE] = InsetName("mathcolor");
138 insetnames[MATH_COMMENT_CODE] = InsetName("mathcomment");
139 insetnames[MATH_DECORATION_CODE] = InsetName("mathdecoration");
140 insetnames[MATH_DELIM_CODE] = InsetName("mathdelim");
141 insetnames[MATH_DIFF_CODE] = InsetName("mathdiff");
142 insetnames[MATH_DOTS_CODE] = InsetName("mathdots");
143 insetnames[MATH_ENSUREMATH_CODE] = InsetName("mathensuremath");
144 insetnames[MATH_ENV_CODE] = InsetName("mathenv");
145 insetnames[MATH_EXFUNC_CODE] = InsetName("mathexfunc");
146 insetnames[MATH_EXINT_CODE] = InsetName("mathexint");
147 insetnames[MATH_FONT_CODE] = InsetName("mathfont");
148 insetnames[MATH_FONTOLD_CODE] = InsetName("mathfontold");
149 insetnames[MATH_FRAC_CODE] = InsetName("mathfrac");
150 insetnames[MATH_GRID_CODE] = InsetName("mathgrid");
151 insetnames[MATH_CODE] = InsetName("math");
152 insetnames[MATH_HULL_CODE] = InsetName("mathhull");
153 insetnames[MATH_KERN_CODE] = InsetName("mathkern");
154 insetnames[MATH_LEFTEQN_CODE] = InsetName("mathlefteqn");
155 insetnames[MATH_LIM_CODE] = InsetName("mathlim");
156 insetnames[MATH_MATRIX_CODE] = InsetName("mathmatrix");
157 insetnames[MATH_MBOX_CODE] = InsetName("mathmbox");
158 insetnames[MATH_NEST_CODE] = InsetName("mathnest");
159 insetnames[MATH_NUMBER_CODE] = InsetName("mathnumber");
160 insetnames[MATH_OVERSET_CODE] = InsetName("mathoverset");
161 insetnames[MATH_PAR_CODE] = InsetName("mathpar");
162 insetnames[MATH_PHANTOM_CODE] = InsetName("mathphantom");
163 insetnames[MATH_REF_CODE] = InsetName("mathref");
164 insetnames[MATH_ROOT_CODE] = InsetName("mathroot");
165 insetnames[MATH_SCRIPT_CODE] = InsetName("mathscript");
166 insetnames[MATH_SIZE_CODE] = InsetName("mathsize");
167 insetnames[MATH_SPACE_CODE] = InsetName("mathspace", _("Horizontal Math Space"));
168 insetnames[MATH_SPECIALCHAR_CODE] = InsetName("mathspecialchar");
169 insetnames[MATH_SPLIT_CODE] = InsetName("mathsplit");
170 insetnames[MATH_SQRT_CODE] = InsetName("mathsqrt");
171 insetnames[MATH_STACKREL_CODE] = InsetName("mathstackrel");
172 insetnames[MATH_STRING_CODE] = InsetName("mathstring");
173 insetnames[MATH_SUBSTACK_CODE] = InsetName("mathsubstack");
174 insetnames[MATH_SYMBOL_CODE] = InsetName("mathsymbol");
175 insetnames[MATH_TABULAR_CODE] = InsetName("mathtabular");
176 insetnames[MATH_UNDERSET_CODE] = InsetName("mathunderset");
177 insetnames[MATH_UNKNOWN_CODE] = InsetName("mathunknown");
178 insetnames[MATH_XARROW_CODE] = InsetName("mathxarrow");
179 insetnames[MATH_XYMATRIX_CODE] = InsetName("mathxymatrix");
180 insetnames[MATH_DIAGRAM_CODE] = InsetName("mathdiagram");
181 insetnames[MATH_MACRO_CODE] = InsetName("mathmacro");
187 void Inset::setBuffer(Buffer & buffer)
193 void Inset::resetBuffer()
199 Buffer & Inset::buffer()
203 string const iname = insetName(lyxCode());
204 LYXERR0("Inset: " << this << " LyX Code: " << lyxCode()
205 << " name: " << iname);
206 s << "LyX Code: " << lyxCode() << " name: " << from_ascii(iname);
208 throw ExceptionMessage(BufferException,
209 from_ascii("Inset::buffer_ member not initialized!"), s.str());
215 Buffer const & Inset::buffer() const
217 return const_cast<Inset *>(this)->buffer();
221 bool Inset::isBufferLoaded() const
223 return buffer_ && theBufferList().isLoaded(buffer_);
227 bool Inset::isBufferValid() const
230 && (isBufferLoaded() || buffer_->isInternal() || buffer_->isClone());
234 docstring Inset::layoutName() const
236 return from_ascii("unknown");
240 bool Inset::isFreeSpacing() const
242 return getLayout().isFreeSpacing();
246 bool Inset::allowEmpty() const
248 return getLayout().isKeepEmpty();
252 bool Inset::forceLTR(OutputParams const &) const
254 return getLayout().forceLTR();
258 bool Inset::isInToc() const
260 return getLayout().isInToc();
264 docstring Inset::toolTip(BufferView const &, int, int) const
270 void Inset::forOutliner(docstring &, size_t const, bool const) const
275 string Inset::contextMenu(BufferView const &, int, int) const
277 return contextMenuName();
281 string Inset::contextMenuName() const
287 Dimension const Inset::dimension(BufferView const & bv) const
289 return bv.coordCache().getInsets().dim(this);
293 InsetCode insetCode(string const & name)
296 for (int i = 1; i != int(INSET_CODE_SIZE); ++i) {
297 if (insetnames[i].name == name)
304 string insetName(InsetCode c)
307 return insetnames[c].name;
311 docstring insetDisplayName(InsetCode c)
314 return insetnames[c].display_name;
318 void Inset::dispatch(Cursor & cur, FuncRequest & cmd)
321 lyxerr << "Unassigned buffer_ member in Inset::dispatch()" << std::endl;
322 lyxerr << "LyX Code: " << lyxCode() << " name: "
323 << insetName(lyxCode()) << std::endl;
324 } else if (cur.buffer() != buffer_)
325 lyxerr << "cur.buffer() != buffer_ in Inset::dispatch()" << std::endl;
326 cur.screenUpdateFlags(Update::Force | Update::FitCursor);
328 doDispatch(cur, cmd);
332 bool Inset::showInsetDialog(BufferView * bv) const
334 InsetCode const code = lyxCode();
342 case MATH_SPACE_CODE:
346 bv->showDialog(insetName(code));
355 void Inset::doDispatch(Cursor & cur, FuncRequest &cmd)
357 switch (cmd.action()) {
358 case LFUN_MOUSE_RELEASE:
359 // if the derived inset did not explicitly handle mouse_release,
360 // we assume we request the settings dialog
361 if (!cur.selection() && cmd.button() == mouse_button::button1
362 && clickable(cur.bv(), cmd.x(), cmd.y()) && hasSettings()) {
363 FuncRequest tmpcmd(LFUN_INSET_SETTINGS);
364 dispatch(cur, tmpcmd);
368 case LFUN_INSET_SETTINGS:
369 if (cmd.argument().empty() || cmd.getArg(0) == insetName(lyxCode())) {
370 showInsetDialog(&cur.bv());
377 cur.noScreenUpdate();
384 bool Inset::getStatus(Cursor &, FuncRequest const & cmd,
385 FuncStatus & status) const
387 // LFUN_INSET_APPLY is sent from the dialogs when the data should
388 // be applied. This is either changed to LFUN_INSET_MODIFY (if the
389 // dialog belongs to us) or LFUN_INSET_INSERT (if the dialog does
390 // not belong to us, i. e. the dialog was open, and the user moved
391 // the cursor in our inset) in lyx::getStatus().
392 // Dialogs::checkStatus() ensures that the dialog is deactivated if
393 // LFUN_INSET_APPLY is disabled.
395 switch (cmd.action()) {
396 case LFUN_INSET_MODIFY:
397 // Allow modification of our data.
398 // This needs to be handled in the doDispatch method of our
399 // instantiatable children.
400 status.setEnabled(true);
403 case LFUN_INSET_INSERT:
404 // Don't allow insertion of new insets.
405 // Every inset that wants to allow new insets from open
406 // dialogs needs to override this.
407 status.setEnabled(false);
410 case LFUN_INSET_SETTINGS:
411 if (cmd.argument().empty() || cmd.getArg(0) == insetName(lyxCode())) {
412 bool const enable = hasSettings();
413 status.setEnabled(enable);
419 case LFUN_IN_MATHMACROTEMPLATE:
420 // By default we're not in a InsetMathMacroTemplate inset
421 status.setEnabled(false);
425 // By default we're not in an IPA inset
426 status.setEnabled(false);
436 void Inset::edit(Cursor &, bool, EntryDirection)
438 LYXERR(Debug::INSETS, "edit left/right");
442 Inset * Inset::editXY(Cursor &, int x, int y)
444 LYXERR(Debug::INSETS, "x: " << x << " y: " << y);
449 idx_type Inset::index(row_type row, col_type col) const
452 LYXERR0("illegal row: " << row);
454 LYXERR0("illegal col: " << col);
459 bool Inset::idxBetween(idx_type idx, idx_type from, idx_type to) const
461 return from <= idx && idx <= to;
465 bool Inset::idxUpDown(Cursor &, bool) const
471 void Inset::docbook(XMLStream & xs, OutputParams const &) const
473 xs << "[[Inset: " << from_ascii(insetName(lyxCode())) << "]]";
477 docstring Inset::xhtml(XMLStream & xs, OutputParams const &) const
479 xs << "[[Inset: " << from_ascii(insetName(lyxCode())) << "]]";
484 bool Inset::directWrite() const
490 bool Inset::editable() const
496 bool Inset::hasSettings() const
503 bool Inset::autoDelete() const
509 void Inset::cursorPos(BufferView const & /*bv*/, CursorSlice const &,
510 bool, int & x, int & y) const
512 LYXERR0("Inset::cursorPos called directly");
518 void Inset::metricsMarkers(Dimension & dim, int framesize) const
520 dim.wid += 2 * framesize;
521 dim.des += framesize;
525 void Inset::metricsMarkers2(Dimension & dim, int framesize) const
527 dim.wid += 2 * framesize;
528 dim.asc += framesize;
529 dim.des += framesize;
533 void Inset::drawBackground(PainterInfo & pi, int x, int y) const
535 if (pi.full_repaint && backgroundColor(pi) == Color_none)
537 Dimension const dim = dimension(*pi.base.bv);
538 pi.pain.fillRectangle(x, y - dim.asc, dim.wid, dim.asc + dim.des,
539 pi.backgroundColor(this));
543 void Inset::drawMarkers(PainterInfo & pi, int x, int y) const
545 ColorCode pen_color = mouseHovered(pi.base.bv) || editing(pi.base.bv)?
546 Color_mathframe : Color_mathcorners;
548 Dimension const dim = dimension(*pi.base.bv);
550 int const t = x + dim.width() - 1;
551 int const d = y + dim.descent();
552 pi.pain.line(x, d - 3, x, d, pen_color);
553 pi.pain.line(t, d - 3, t, d, pen_color);
554 pi.pain.line(x, d, x + 3, d, pen_color);
555 pi.pain.line(t - 3, d, t, d, pen_color);
559 bool Inset::editing(BufferView const * bv) const
561 return bv->cursor().isInside(this);
565 int Inset::xo(BufferView const & bv) const
567 return bv.coordCache().getInsets().x(this);
571 int Inset::yo(BufferView const & bv) const
573 return bv.coordCache().getInsets().y(this);
577 bool Inset::covers(BufferView const & bv, int x, int y) const
579 return bv.coordCache().getInsets().covers(this, x, y);
583 InsetLayout const & Inset::getLayout() const
586 return DocumentClass::plainInsetLayout();
587 return buffer().params().documentClass().insetLayout(layoutName());
591 bool Inset::isPassThru() const
593 return getLayout().isPassThru();
597 bool Inset::undefined() const
599 docstring const & n = getLayout().name();
600 return n.empty() || n == DocumentClass::plainInsetLayout().name();
604 CtObject Inset::getCtObject(OutputParams const &) const
606 return CtObject::Normal;
610 void Inset::dump() const
616 ColorCode Inset::backgroundColor(PainterInfo const & /*pi*/) const
622 ColorCode Inset::labelColor() const
624 return Color_foreground;
628 Buffer const * Inset::updateFrontend() const
630 //FIXME (Abdel 03/12/10): see bugs #6814 and #6949
631 // If the Buffer is null and we end up here this is most probably because we
632 // are in the CutAndPaste stack. See InsetGraphics, RenderGraphics and
636 return theApp() ? theApp()->updateInset(this) : 0;
640 bool Inset::resetFontEdit() const
642 return getLayout().resetsFont() || !inheritFont();
646 docstring Inset::completionPrefix(Cursor const &) const