2 * \file InsetCollapsable.cpp
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
10 * Full author contact details are available in file CREDITS.
15 #include "InsetCollapsable.h"
18 #include "BufferParams.h"
19 #include "BufferView.h"
21 #include "Dimension.h"
22 #include "DispatchResult.h"
23 #include "FloatList.h"
24 #include "FuncStatus.h"
25 #include "InsetLayout.h"
27 #include "LaTeXFeatures.h"
29 #include "FuncRequest.h"
30 #include "MetricsInfo.h"
31 #include "ParagraphParameters.h"
32 #include "TextClass.h"
34 #include "frontends/FontMetrics.h"
35 #include "frontends/Painter.h"
37 #include "support/debug.h"
38 #include "support/docstream.h"
39 #include "support/gettext.h"
46 InsetCollapsable::CollapseStatus InsetCollapsable::status() const
48 return autoOpen_ ? Open : status_;
52 InsetCollapsable::Geometry InsetCollapsable::geometry() const
54 switch (decoration()) {
55 case InsetLayout::Classic:
56 if (status() == Open) {
64 case InsetLayout::Minimalistic:
65 return status() == Open ? NoButton : ButtonOnly ;
67 case InsetLayout::Conglomerate:
68 return status() == Open ? SubLabel : Corners ;
70 case InsetLayout::Default:
71 break; // this shouldn't happen
74 // dummy return value to shut down a warning,
80 InsetCollapsable::InsetCollapsable(BufferParams const & bp,
81 CollapseStatus status, TextClassPtr tc)
82 : InsetText(bp), status_(status),
83 openinlined_(false), autoOpen_(false), mouse_hover_(false)
86 setAutoBreakRows(true);
88 setFrameColor(Color_collapsableframe);
89 paragraphs().back().setLayout(bp.textClass().emptyLayout());
93 InsetCollapsable::InsetCollapsable(InsetCollapsable const & rhs)
95 textClass_(rhs.textClass_),
97 labelstring_(rhs.labelstring_),
98 button_dim(rhs.button_dim),
100 openinlined_(rhs.openinlined_),
101 autoOpen_(rhs.autoOpen_),
102 // the sole purpose of this copy constructor
108 docstring InsetCollapsable::toolTip(BufferView const & bv, int x, int y) const
110 Dimension dim = dimensionCollapsed();
111 if (geometry() == NoButton)
112 return layout_->labelstring();
113 else if (x > xo(bv) + dim.wid || y > yo(bv) + dim.des)
118 return _("Left-click to collapse the inset");
120 return _("Left-click to open the inset");
126 void InsetCollapsable::setLayout(BufferParams const & bp)
128 setLayout(bp.textClassPtr());
132 void InsetCollapsable::setLayout(TextClassPtr tc)
135 if ( tc.get() != 0 ) {
136 layout_ = &tc->insetLayout(name());
137 labelstring_ = layout_->labelstring();
139 layout_ = &TextClass::emptyInsetLayout();
140 labelstring_ = _("UNDEFINED");
147 void InsetCollapsable::write(Buffer const & buf, ostream & os) const
159 text_.write(buf, os);
163 void InsetCollapsable::read(Buffer const & buf, Lexer & lex)
165 bool token_found = false;
168 string const token = lex.getString();
169 if (token == "status") {
171 string const tmp_token = lex.getString();
173 if (tmp_token == "collapsed") {
176 } else if (tmp_token == "open") {
180 lyxerr << "InsetCollapsable::read: Missing status!"
182 // Take countermeasures
183 lex.pushToken(token);
186 LYXERR0("InsetCollapsable::read: Missing 'status'-tag!");
187 // take countermeasures
188 lex.pushToken(token);
191 //this must be set before we enter InsetText::read()
192 setLayout(buf.params());
194 InsetText::read(buf, lex);
197 status_ = isOpen() ? Open : Collapsed;
199 // Force default font, if so requested
200 // This avoids paragraphs in buffer language that would have a
201 // foreign language after a document language change, and it ensures
202 // that all new text in ERT and similar gets the "latex" language,
203 // since new text inherits the language from the last position of the
204 // existing text. As a side effect this makes us also robust against
205 // bugs in LyX that might lead to font changes in ERT in .lyx files.
206 resetParagraphsFont();
210 Dimension InsetCollapsable::dimensionCollapsed() const
212 BOOST_ASSERT(layout_);
214 theFontMetrics(layout_->labelfont()).buttonText(
215 labelstring_, dim.wid, dim.asc, dim.des);
220 void InsetCollapsable::metrics(MetricsInfo & mi, Dimension & dim) const
222 BOOST_ASSERT(layout_);
224 autoOpen_ = mi.base.bv->cursor().isInside(this);
226 FontInfo tmpfont = mi.base.font;
227 mi.base.font = layout_->font();
228 mi.base.font.realize(tmpfont);
230 switch (geometry()) {
232 InsetText::metrics(mi, dim);
235 InsetText::metrics(mi, dim);
240 InsetText::metrics(mi, dim);
241 // consider width of the inset label
242 FontInfo font(layout_->labelfont());
243 font.realize(sane_font);
249 theFontMetrics(font).rectText(labelstring_, w, a, d);
256 dim = dimensionCollapsed();
257 if (geometry() == TopButton
258 || geometry() == LeftButton) {
260 InsetText::metrics(mi, textdim);
261 openinlined_ = (textdim.wid + dim.wid) < mi.base.textwidth;
263 // Correct for button width.
264 dim.wid += textdim.wid;
265 dim.des = max(dim.des - textdim.asc + dim.asc, textdim.des);
266 dim.asc = textdim.asc;
268 dim.des += textdim.height() + TEXT_TO_INSET_OFFSET;
269 dim.wid = max(dim.wid, textdim.wid);
275 mi.base.font = tmpfont;
279 bool InsetCollapsable::setMouseHover(bool mouse_hover)
281 mouse_hover_ = mouse_hover;
286 void InsetCollapsable::draw(PainterInfo & pi, int x, int y) const
288 BOOST_ASSERT(layout_);
290 autoOpen_ = pi.base.bv->cursor().isInside(this);
291 ColorCode const old_color = pi.background_color;
292 pi.background_color = backgroundColor();
294 FontInfo tmpfont = pi.base.font;
295 pi.base.font = layout_->font();
296 pi.base.font.realize(tmpfont);
298 // Draw button first -- top, left or only
299 Dimension dimc = dimensionCollapsed();
301 if (geometry() == TopButton ||
302 geometry() == LeftButton ||
303 geometry() == ButtonOnly) {
304 button_dim.x1 = x + 0;
305 button_dim.x2 = x + dimc.width();
306 button_dim.y1 = y - dimc.asc;
307 button_dim.y2 = y + dimc.des;
309 pi.pain.buttonText(x, y, labelstring_, layout_->labelfont(),
318 Dimension const textdim = InsetText::dimension(*pi.base.bv);
319 int const baseline = y;
321 switch (geometry()) {
323 textx = x + dimc.width();
325 InsetText::draw(pi, textx, texty);
329 texty = baseline + dimc.des + textdim.asc;
330 InsetText::draw(pi, textx, texty);
337 InsetText::draw(pi, textx, texty);
343 const_cast<InsetCollapsable *>(this)->setDrawFrame(false);
344 InsetText::draw(pi, textx, texty);
345 const_cast<InsetCollapsable *>(this)->setDrawFrame(true);
347 int desc = textdim.descent();
348 if (geometry() == Corners)
351 const int xx1 = x + TEXT_TO_INSET_OFFSET - 1;
352 const int xx2 = x + textdim.wid - TEXT_TO_INSET_OFFSET + 1;
353 pi.pain.line(xx1, y + desc - 4,
355 layout_->labelfont().color());
357 pi.pain.line(xx1, y + desc,
359 layout_->labelfont().color());
361 // Make status_ value visible:
362 pi.pain.line(xx1, y + desc,
364 layout_->labelfont().color());
365 pi.pain.line(xx2 - 4, y + desc,
367 layout_->labelfont().color());
369 pi.pain.line(x + textdim.wid - 3, y + desc, x + textdim.wid - 3,
370 y + desc - 4, layout_->labelfont().color());
372 // the label below the text. Can be toggled.
373 if (geometry() == SubLabel) {
374 FontInfo font(layout_->labelfont());
375 font.realize(sane_font);
381 theFontMetrics(font).rectText(labelstring_, w, a, d);
382 int const ww = max(textdim.wid, w);
383 pi.pain.rectText(x + (ww - w) / 2, y + desc + a,
384 labelstring_, font, Color_none, Color_none);
388 // a visual cue when the cursor is inside the inset
389 Cursor & cur = pi.base.bv->cursor();
390 if (cur.isInside(this)) {
393 pi.pain.line(xx1, y + 4, xx1, y, layout_->labelfont().color());
394 pi.pain.line(xx1 + 4, y, xx1, y, layout_->labelfont().color());
395 pi.pain.line(xx2, y + 4, xx2, y,
396 layout_->labelfont().color());
397 pi.pain.line(xx2 - 4, y, xx2, y,
398 layout_->labelfont().color());
402 pi.background_color = old_color;
404 pi.base.font = tmpfont;
408 void InsetCollapsable::cursorPos(BufferView const & bv,
409 CursorSlice const & sl, bool boundary, int & x, int & y) const
411 if (geometry() == ButtonOnly)
413 BOOST_ASSERT(geometry() != ButtonOnly);
415 InsetText::cursorPos(bv, sl, boundary, x, y);
416 Dimension const textdim = InsetText::dimension(bv);
418 switch (geometry()) {
420 x += dimensionCollapsed().wid;
423 y += dimensionCollapsed().des + textdim.asc;
438 Inset::EDITABLE InsetCollapsable::editable() const
440 return geometry() != ButtonOnly? HIGHLY_EDITABLE : IS_EDITABLE;
444 bool InsetCollapsable::descendable() const
446 return geometry() != ButtonOnly;
450 bool InsetCollapsable::hitButton(FuncRequest const & cmd) const
452 return button_dim.contains(cmd.x, cmd.y);
456 docstring const InsetCollapsable::getNewLabel(docstring const & l) const
459 pos_type const max_length = 15;
460 pos_type const p_siz = paragraphs().begin()->size();
461 pos_type const n = min(max_length, p_siz);
464 for (; i < n && j < p_siz; ++j) {
465 if (paragraphs().begin()->isInset(j))
467 label += paragraphs().begin()->getChar(j);
470 if (paragraphs().size() > 1 || (i > 0 && j < p_siz)) {
473 return label.empty() ? l : label;
477 void InsetCollapsable::edit(
478 Cursor & cur, bool front, EntryDirection entry_from)
480 //lyxerr << "InsetCollapsable: edit left/right" << endl;
482 InsetText::edit(cur, front, entry_from);
486 Inset * InsetCollapsable::editXY(Cursor & cur, int x, int y)
488 //lyxerr << "InsetCollapsable: edit xy" << endl;
489 if (geometry() == ButtonOnly
490 || (button_dim.contains(x, y)
491 && geometry() != NoButton))
494 return InsetText::editXY(cur, x, y);
498 void InsetCollapsable::doDispatch(Cursor & cur, FuncRequest & cmd)
500 //lyxerr << "InsetCollapsable::doDispatch (begin): cmd: " << cmd
501 // << " cur: " << cur << " bvcur: " << cur.bv().cursor() << endl;
503 switch (cmd.action) {
504 case LFUN_MOUSE_PRESS:
505 if (cmd.button() == mouse_button::button1
507 && geometry() != NoButton) {
508 // reset selection if necessary (see bug 3060)
510 cur.bv().cursor().clearSelection();
516 if (geometry() == NoButton)
517 InsetText::doDispatch(cur, cmd);
518 else if (geometry() != ButtonOnly
520 InsetText::doDispatch(cur, cmd);
525 case LFUN_MOUSE_MOTION:
526 case LFUN_MOUSE_DOUBLE:
527 case LFUN_MOUSE_TRIPLE:
528 if (geometry() == NoButton)
529 InsetText::doDispatch(cur, cmd);
530 else if (geometry() != ButtonOnly
532 InsetText::doDispatch(cur, cmd);
537 case LFUN_MOUSE_RELEASE:
538 if (cmd.button() == mouse_button::button3) {
539 // There is no button to right click:
540 if (decoration() == InsetLayout::Minimalistic ||
541 geometry() == Corners ||
542 geometry() == SubLabel ||
543 geometry() == NoButton
546 setStatus(cur, Collapsed);
548 setStatus(cur, Open);
552 // configuration dialog
553 showInsetDialog(&cur.bv());
558 if (geometry() == NoButton) {
559 // The mouse click has to be within the inset!
560 InsetText::doDispatch(cur, cmd);
564 if (cmd.button() == mouse_button::button1 && hitButton(cmd)) {
565 // if we are selecting, we do not want to
569 // Left button is clicked, the user asks to
570 // toggle the inset visual state.
572 cur.updateFlags(Update::Force | Update::FitCursor);
573 if (geometry() == ButtonOnly) {
574 setStatus(cur, Open);
578 setStatus(cur, Collapsed);
580 cur.bv().cursor() = cur;
584 // The mouse click is within the opened inset.
585 if (geometry() == TopButton
586 || geometry() == LeftButton)
587 InsetText::doDispatch(cur, cmd);
590 case LFUN_INSET_TOGGLE:
591 if (cmd.argument() == "open")
592 setStatus(cur, Open);
593 else if (cmd.argument() == "close")
594 setStatus(cur, Collapsed);
595 else if (cmd.argument() == "toggle" || cmd.argument().empty())
596 if (status_ == Open) {
597 setStatus(cur, Collapsed);
598 if (geometry() == ButtonOnly)
599 cur.top().forwardPos();
601 setStatus(cur, Open);
602 else // if assign or anything else
608 case LFUN_CLIPBOARD_PASTE:
609 case LFUN_PRIMARY_SELECTION_PASTE: {
610 InsetText::doDispatch(cur, cmd);
611 // Since we can only store plain text, we must reset all
613 // FIXME: Change only the pasted paragraphs
615 resetParagraphsFont();
620 if (layout_ && layout_->isForceLtr()) {
621 // Force any new text to latex_language
622 // FIXME: This should only be necessary in constructor, but
623 // new paragraphs that are created by pressing enter at the
624 // start of an existing paragraph get the buffer language
625 // and not latex_language, so we take this brute force
627 cur.current_font.setLanguage(latex_language);
628 cur.real_current_font.setLanguage(latex_language);
630 InsetText::doDispatch(cur, cmd);
636 bool InsetCollapsable::allowMultiPar() const
638 return layout_->isMultiPar();
642 void InsetCollapsable::resetParagraphsFont()
645 font.fontInfo() = inherit_font;
646 if (layout_->isForceLtr())
647 font.setLanguage(latex_language);
648 if (layout_->isPassThru()) {
649 ParagraphList::iterator par = paragraphs().begin();
650 ParagraphList::iterator const end = paragraphs().end();
652 par->resetFonts(font);
653 par->params().clear();
660 bool InsetCollapsable::getStatus(Cursor & cur, FuncRequest const & cmd,
661 FuncStatus & flag) const
663 switch (cmd.action) {
665 case LFUN_ACCENT_ACUTE:
666 case LFUN_ACCENT_BREVE:
667 case LFUN_ACCENT_CARON:
668 case LFUN_ACCENT_CEDILLA:
669 case LFUN_ACCENT_CIRCLE:
670 case LFUN_ACCENT_CIRCUMFLEX:
671 case LFUN_ACCENT_DOT:
672 case LFUN_ACCENT_GRAVE:
673 case LFUN_ACCENT_HUNGARIAN_UMLAUT:
674 case LFUN_ACCENT_MACRON:
675 case LFUN_ACCENT_OGONEK:
676 case LFUN_ACCENT_SPECIAL_CARON:
677 case LFUN_ACCENT_TIE:
678 case LFUN_ACCENT_TILDE:
679 case LFUN_ACCENT_UMLAUT:
680 case LFUN_ACCENT_UNDERBAR:
681 case LFUN_ACCENT_UNDERDOT:
683 case LFUN_BIBITEM_INSERT:
684 case LFUN_BOX_INSERT:
685 case LFUN_BRANCH_INSERT:
687 case LFUN_CAPTION_INSERT:
688 case LFUN_CLEARPAGE_INSERT:
689 case LFUN_CLEARDOUBLEPAGE_INSERT:
690 case LFUN_DEPTH_DECREMENT:
691 case LFUN_DEPTH_INCREMENT:
692 case LFUN_ENVIRONMENT_INSERT:
693 case LFUN_ERT_INSERT:
694 case LFUN_FILE_INSERT:
695 case LFUN_FLEX_INSERT:
696 case LFUN_FLOAT_INSERT:
697 case LFUN_FLOAT_LIST:
698 case LFUN_FLOAT_WIDE_INSERT:
700 case LFUN_FONT_TYPEWRITER:
701 case LFUN_FONT_DEFAULT:
703 case LFUN_FONT_FREE_APPLY:
704 case LFUN_FONT_FREE_UPDATE:
706 case LFUN_FONT_ROMAN:
711 case LFUN_FONT_STATE:
712 case LFUN_FONT_UNDERLINE:
713 case LFUN_FOOTNOTE_INSERT:
714 case LFUN_HFILL_INSERT:
715 case LFUN_HYPERLINK_INSERT:
716 case LFUN_INDEX_INSERT:
717 case LFUN_INDEX_PRINT:
718 case LFUN_INSET_INSERT:
719 case LFUN_LABEL_GOTO:
720 case LFUN_LABEL_INSERT:
721 case LFUN_LINE_INSERT:
722 case LFUN_NEWPAGE_INSERT:
723 case LFUN_PAGEBREAK_INSERT:
725 case LFUN_LAYOUT_PARAGRAPH:
726 case LFUN_LAYOUT_TABULAR:
727 case LFUN_MARGINALNOTE_INSERT:
728 case LFUN_MATH_DISPLAY:
729 case LFUN_MATH_INSERT:
730 case LFUN_MATH_MATRIX:
734 case LFUN_NOMENCL_INSERT:
735 case LFUN_NOMENCL_PRINT:
736 case LFUN_NOTE_INSERT:
738 case LFUN_OPTIONAL_INSERT:
739 case LFUN_PARAGRAPH_PARAMS:
740 case LFUN_PARAGRAPH_PARAMS_APPLY:
741 case LFUN_PARAGRAPH_SPACING:
742 case LFUN_PARAGRAPH_UPDATE:
743 case LFUN_REFERENCE_NEXT:
744 case LFUN_SERVER_GOTO_FILE_ROW:
745 case LFUN_SERVER_NOTIFY:
746 case LFUN_SERVER_SET_XY:
747 case LFUN_SPACE_INSERT:
748 case LFUN_SPECIALCHAR_INSERT:
749 case LFUN_TABULAR_INSERT:
750 case LFUN_TOC_INSERT:
751 case LFUN_WRAP_INSERT:
752 if (layout_->isPassThru()) {
756 return InsetText::getStatus(cur, cmd, flag);
758 case LFUN_INSET_TOGGLE:
759 if (cmd.argument() == "open" || cmd.argument() == "close" ||
760 cmd.argument() == "toggle")
767 flag.enabled(!layout_->isForceLtr());
768 return InsetText::getStatus(cur, cmd, flag);
770 case LFUN_BREAK_PARAGRAPH:
771 case LFUN_BREAK_PARAGRAPH_SKIP:
772 flag.enabled(layout_->isMultiPar());
776 return InsetText::getStatus(cur, cmd, flag);
781 void InsetCollapsable::setLabel(docstring const & l)
787 void InsetCollapsable::setStatus(Cursor & cur, CollapseStatus status)
791 if (status_ == Collapsed)
792 cur.leaveInset(*this);
796 docstring InsetCollapsable::floatName(
797 string const & type, BufferParams const & bp) const
799 FloatList const & floats = bp.textClass().floats();
800 FloatList::const_iterator it = floats[type];
802 return (it == floats.end()) ? from_ascii(type) : bp.B_(it->second.name());
806 InsetLayout::InsetDecoration InsetCollapsable::decoration() const
809 return InsetLayout::Classic;
810 InsetLayout::InsetDecoration const dec = layout_->decoration();
812 case InsetLayout::Classic:
813 case InsetLayout::Minimalistic:
814 case InsetLayout::Conglomerate:
816 case InsetLayout::Default:
819 if (lyxCode() == FLEX_CODE)
820 // FIXME: Is this really necessary?
821 return InsetLayout::Conglomerate;
822 return InsetLayout::Classic;
826 bool InsetCollapsable::isMacroScope(Buffer const &) const
828 // layout_ == 0 leads to no latex output, so ignore
829 // the macros outside
833 // see InsetCollapsable::latex(...) below. In these case
834 // an environment is opened there
835 if (!layout_->latexname().empty())
842 int InsetCollapsable::latex(Buffer const & buf, odocstream & os,
843 OutputParams const & runparams) const
845 // FIXME: What should we do layout_ is 0?
847 // 2) through an error
851 // This implements the standard way of handling the LaTeX output of
852 // a collapsable inset, either a command or an environment. Standard
853 // collapsable insets should not redefine this, non-standard ones may
855 if (!layout_->latexname().empty()) {
856 if (layout_->latextype() == "command") {
858 if (runparams.moving_arg)
860 os << '\\' << from_utf8(layout_->latexname());
861 if (!layout_->latexparam().empty())
862 os << from_utf8(layout_->latexparam());
864 } else if (layout_->latextype() == "environment") {
865 os << "%\n\\begin{" << from_utf8(layout_->latexname()) << "}\n";
866 if (!layout_->latexparam().empty())
867 os << from_utf8(layout_->latexparam());
870 OutputParams rp = runparams;
871 if (layout_->isPassThru())
873 if (layout_->isNeedProtect())
874 rp.moving_arg = true;
875 int i = InsetText::latex(buf, os, rp);
876 if (!layout_->latexname().empty()) {
877 if (layout_->latextype() == "command") {
879 } else if (layout_->latextype() == "environment") {
880 os << "\n\\end{" << from_utf8(layout_->latexname()) << "}\n";
888 void InsetCollapsable::validate(LaTeXFeatures & features) const
893 // Force inclusion of preamble snippet in layout file
894 features.require(to_utf8(layout_->name()));
895 InsetText::validate(features);
899 bool InsetCollapsable::undefined() const
901 docstring const & n = getLayout().name();
902 return n.empty() || n == TextClass::emptyInsetLayout().name();