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
7 * \author Alfredo Braunstein
10 * Full author contact details are available in file CREDITS.
15 #include "BufferView.h"
18 #include "CutAndPaste.h"
20 #include "dispatchresult.h"
22 #include "funcrequest.h"
26 #include "lyxfunc.h" // only for setMessage()
30 #include "paragraph.h"
31 #include "paragraph_funcs.h"
32 #include "pariterator.h"
34 #include "insets/updatableinset.h"
35 #include "insets/insettabular.h"
36 #include "insets/insettext.h"
38 #include "mathed/math_data.h"
39 #include "mathed/math_support.h"
40 #include "mathed/math_inset.h"
42 #include "support/limited_stack.h"
43 #include "support/std_sstream.h"
45 #include "frontends/LyXView.h"
47 #include <boost/assert.hpp>
54 #ifndef CXX_GLOBAL_CSTD
63 limited_stack<string> theCutBuffer;
68 void region(CursorSlice const & i1, CursorSlice const & i2,
69 LCursor::row_type & r1, LCursor::row_type & r2,
70 LCursor::col_type & c1, LCursor::col_type & c2)
72 InsetBase & p = i1.inset();
86 LCursor::LCursor(BufferView & bv)
87 : DocumentIterator(), bv_(&bv),
88 anchor_(), cached_y_(0), x_target_(-1),
89 selection_(false), mark_(false)
93 void LCursor::reset(InsetBase & inset)
96 push_back(CursorSlice(inset));
97 anchor_ = DocumentIterator(inset);
105 void LCursor::setCursor(DocumentIterator const & cur, bool sel)
107 // this (intentionally) does not touch the anchor
108 DocumentIterator::operator=(cur);
113 DispatchResult LCursor::dispatch(FuncRequest const & cmd0)
115 lyxerr << "\nLCursor::dispatch: cmd: " << cmd0 << endl << *this << endl;
117 return DispatchResult();
119 FuncRequest cmd = cmd0;
120 LCursor safe = *this;
122 for ( ; size(); pop()) {
123 //lyxerr << "\nLCursor::dispatch: cmd: " << cmd0 << endl << *this << endl;
124 BOOST_ASSERT(pos() <= lastpos());
125 BOOST_ASSERT(idx() <= lastidx());
126 BOOST_ASSERT(par() <= lastpar());
128 // The common case is 'LFUN handled, need update', so make the
129 // LFUN handler's life easier by assuming this as default value.
130 // The handler can reset the update and val flags if necessary.
132 disp_.dispatched(true);
133 inset().dispatch(*this, cmd);
134 if (disp_.dispatched())
137 // it completely to get a 'bomb early' behaviour in case this
138 // object will be used again.
139 if (!disp_.dispatched()) {
140 lyxerr << "RESTORING OLD CURSOR!" << endl;
147 bool LCursor::getStatus(FuncRequest const & cmd, FuncStatus & status)
149 // This is, of course, a mess. Better create a new doc iterator and use
150 // this in Inset::getStatus. This might require an additional
151 // BufferView * arg, though (which should be avoided)
152 LCursor safe = *this;
154 for ( ; size(); pop()) {
155 //lyxerr << "\nLCursor::getStatus: cmd: " << cmd << endl << *this << endl;
156 BOOST_ASSERT(pos() <= lastpos());
157 BOOST_ASSERT(idx() <= lastidx());
158 BOOST_ASSERT(par() <= lastpar());
160 // The inset's getStatus() will return 'true' if it made
161 // a definitive decision on whether it want to handle the
162 // request or not. The result of this decision is put into
163 // the 'status' parameter.
164 if (inset().getStatus(*this, cmd, status)) {
174 BufferView & LCursor::bv() const
182 BOOST_ASSERT(size() >= 1);
187 void LCursor::push(InsetBase & p)
189 push_back(CursorSlice(p));
193 void LCursor::pushLeft(InsetBase & p)
195 BOOST_ASSERT(!empty());
196 //lyxerr << "Entering inset " << t << " left" << endl;
202 bool LCursor::popLeft()
204 BOOST_ASSERT(!empty());
205 //lyxerr << "Leaving inset to the left" << endl;
206 inset().notifyCursorLeaves(idx());
214 bool LCursor::popRight()
216 BOOST_ASSERT(!empty());
217 //lyxerr << "Leaving inset to the right" << endl;
218 inset().notifyCursorLeaves(idx());
227 int LCursor::currentMode()
229 BOOST_ASSERT(!empty());
230 for (int i = size() - 1; i >= 0; --i) {
231 int res = operator[](i).inset().currentMode();
232 if (res != InsetBase::UNDECIDED_MODE)
235 return InsetBase::TEXT_MODE;
239 void LCursor::updatePos()
241 BOOST_ASSERT(!empty());
243 cached_y_ = bv().top_y() + back().inset().yo();
244 //cached_y_ = back().inset().yo();
248 void LCursor::getDim(int & asc, int & des) const
251 BOOST_ASSERT(inset().asMathInset());
252 //inset().asMathInset()->getCursorDim(asc, des);
255 } else if (inTexted()) {
256 Row const & row = textRow();
257 asc = row.baseline();
258 des = row.height() - asc;
260 lyxerr << "should this happen?" << endl;
267 void LCursor::getPos(int & x, int & y) const
272 inset().getCursorPos(back(), x, y);
273 // getCursorPos gives _screen_ coordinates. We need to add
274 // top_y to get document coordinates. This is hidden in cached_y_.
275 //y += cached_y_ - inset().yo();
276 // The rest is non-obvious. The reason we have to have these
277 // extra computation is that the getCursorPos() calls rely
278 // on the inset's own knowledge of its screen position.
279 // If we scroll up or down in a big enough increment,
280 // inset->draw() is not called: this doesn't update
281 // inset.yo_, so getCursor() returns an old value.
286 void LCursor::paste(string const & data)
288 dispatch(FuncRequest(LFUN_PASTE, data));
292 void LCursor::resetAnchor()
299 bool LCursor::posLeft()
308 bool LCursor::posRight()
310 if (pos() == lastpos())
317 CursorSlice & LCursor::anchor()
319 BOOST_ASSERT(!anchor_.empty());
320 return anchor_.back();
324 CursorSlice const & LCursor::anchor() const
326 BOOST_ASSERT(!anchor_.empty());
327 return anchor_.back();
331 CursorSlice const & LCursor::selBegin() const
335 return anchor() < back() ? anchor() : back();
339 CursorSlice const & LCursor::selEnd() const
343 return anchor() > back() ? anchor() : back();
347 DocumentIterator LCursor::selectionBegin() const
351 return anchor() < back() ? anchor_ : *this;
355 DocumentIterator LCursor::selectionEnd() const
359 return anchor() > back() ? anchor_ : *this;
363 void LCursor::setSelection()
366 // a selection with no contents is not a selection
367 if (par() == anchor().par() && pos() == anchor().pos())
372 void LCursor::setSelection(DocumentIterator const & where, size_t n)
375 setCursor(where, false);
381 void LCursor::clearSelection()
390 int & LCursor::x_target()
396 int LCursor::x_target() const
402 void LCursor::clearTargetX()
409 void LCursor::info(std::ostream & os) const
411 for (int i = 1, n = depth(); i < n; ++i) {
412 operator[](i).inset().infoize(os);
416 prevInset()->infoize2(os);
417 // overwite old message
422 string LCursor::grabSelection()
427 CursorSlice i1 = selBegin();
428 CursorSlice i2 = selEnd();
430 if (i1.idx() == i2.idx()) {
431 if (i1.inset().asMathInset()) {
432 MathArray::const_iterator it = i1.cell().begin();
433 return asString(MathArray(it + i1.pos(), it + i2.pos()));
435 return "unknown selection 1";
441 region(i1, i2, r1, r2, c1, c2);
444 if (i1.inset().asMathInset()) {
445 for (row_type row = r1; row <= r2; ++row) {
448 for (col_type col = c1; col <= c2; ++col) {
451 data += asString(i1.asMathInset()->cell(i1.asMathInset()->index(row, col)));
455 data = "unknown selection 2";
461 void LCursor::eraseSelection()
463 //lyxerr << "LCursor::eraseSelection" << endl;
464 CursorSlice const & i1 = selBegin();
465 CursorSlice const & i2 = selEnd();
467 if (i1.inset().asMathInset()) {
468 if (i1.idx() == i2.idx()) {
469 i1.cell().erase(i1.pos(), i2.pos());
471 MathInset * p = i1.asMathInset();
474 region(i1, i2, r1, r2, c1, c2);
475 for (row_type row = r1; row <= r2; ++row)
476 for (col_type col = c1; col <= c2; ++col)
477 p->cell(p->index(row, col)).clear();
481 lyxerr << "can't erase this selection 1" << endl;
483 //lyxerr << "LCursor::eraseSelection end" << endl;
487 string LCursor::grabAndEraseSelection()
491 string res = grabSelection();
498 void LCursor::selClear()
505 void LCursor::selCopy()
508 theCutBuffer.push(grabSelection());
511 //theCutBuffer.erase();
516 void LCursor::selCut()
518 theCutBuffer.push(grabAndEraseSelection());
522 void LCursor::selDel()
524 //lyxerr << "LCursor::selDel" << endl;
532 void LCursor::selPaste(size_t n)
535 if (n < theCutBuffer.size())
536 paste(theCutBuffer[n]);
542 void LCursor::selHandle(bool sel)
544 //lyxerr << "LCursor::selHandle" << endl;
545 if (sel == selection())
552 void LCursor::selClearOrDel()
554 //lyxerr << "LCursor::selClearOrDel" << endl;
555 if (lyxrc.auto_region_delete)
562 std::ostream & operator<<(std::ostream & os, LCursor const & cur)
564 for (size_t i = 0, n = cur.size(); i != n; ++i) {
565 os << " " << cur.operator[](i) << " | ";
566 if (i < cur.anchor_.size())
567 os << cur.anchor_[i];
569 os << "-------------------------------";
572 for (size_t i = cur.size(), n = cur.anchor_.size(); i < n; ++i) {
573 os << "------------------------------- | " << cur.anchor_[i] << "\n";
575 os << " selection: " << cur.selection_
576 << " x_target: " << cur.x_target_ << endl;
583 ///////////////////////////////////////////////////////////////////
585 // The part below is the non-integrated rest of the original math
586 // cursor. This should be either generalized for texted or moved
587 // back to mathed (in most cases to MathNestInset).
589 ///////////////////////////////////////////////////////////////////
591 #include "mathed/math_charinset.h"
592 #include "mathed/math_factory.h"
593 #include "mathed/math_gridinset.h"
594 #include "mathed/math_macroarg.h"
595 #include "mathed/math_macrotemplate.h"
596 #include "mathed/math_mathmlstream.h"
597 #include "mathed/math_scriptinset.h"
598 #include "mathed/math_support.h"
599 #include "mathed/math_unknowninset.h"
601 //#define FILEDEBUG 1
604 bool LCursor::isInside(InsetBase const * p)
606 for (unsigned i = 0; i < depth(); ++i)
607 if (&operator[](i).inset() == p)
613 bool LCursor::openable(MathAtom const & t) const
624 // we can't move into anything new during selection
625 if (depth() >= anchor_.size())
627 if (!ptr_cmp(t.nucleus(), &anchor_[depth()].inset()))
634 bool positionable(DocumentIterator const & cursor,
635 DocumentIterator const & anchor)
637 // avoid deeper nested insets when selecting
638 if (cursor.size() > anchor.size())
641 // anchor might be deeper, should have same path then
642 for (size_t i = 0; i < cursor.size(); ++i)
643 if (&cursor[i].inset() != &anchor[i].inset())
646 // position should be ok.
651 void LCursor::setScreenPos(int x, int y)
654 bruteFind(x, y, 0, bv().workWidth(), 0, bv().workHeight());
659 void LCursor::plainErase()
665 void LCursor::markInsert()
667 cell().insert(pos(), MathAtom(new MathCharInset(0)));
671 void LCursor::markErase()
677 void LCursor::plainInsert(MathAtom const & t)
679 cell().insert(pos(), t);
684 void LCursor::insert(string const & str)
686 lyxerr << "LCursor::insert str '" << str << "'" << endl;
687 for (string::const_iterator it = str.begin(); it != str.end(); ++it)
692 void LCursor::insert(char c)
694 //lyxerr << "LCursor::insert char '" << c << "'" << endl;
695 BOOST_ASSERT(!empty());
698 plainInsert(MathAtom(new MathCharInset(c)));
700 text()->insertChar(*this, c);
705 void LCursor::insert(MathAtom const & t)
707 //lyxerr << "LCursor::insert MathAtom: " << endl;
714 void LCursor::insert(InsetBase * inset)
717 insert(MathAtom(inset));
719 text()->insertInset(*this, inset);
723 void LCursor::niceInsert(string const & t)
734 void LCursor::niceInsert(MathAtom const & t)
737 string safe = grabAndEraseSelection();
739 // enter the new inset and move the contents of the selection if possible
742 // be careful here: don't use 'pushLeft(t)' as this we need to
743 // push the clone, not the original
744 pushLeft(*nextInset());
750 void LCursor::insert(MathArray const & ar)
755 cell().insert(pos(), ar);
760 bool LCursor::backspace()
762 autocorrect() = false;
770 if (inset().nargs() == 1 && depth() == 1 && lastpos() == 0)
777 MathUnknownInset * p = activeMacro();
778 if (p->name().size() > 1) {
779 p->setName(p->name().substr(0, p->name().size() - 1));
784 if (pos() != 0 && prevAtom()->nargs() > 0) {
785 // let's require two backspaces for 'big stuff' and
786 // highlight on the first
797 bool LCursor::erase()
799 autocorrect() = false;
808 // delete empty cells if possible
809 if (pos() == lastpos() && inset().idxDelete(idx()))
812 // special behaviour when in last position of cell
813 if (pos() == lastpos()) {
814 bool one_cell = inset().nargs() == 1;
815 if (one_cell && depth() == 1 && lastpos() == 0)
821 inset().idxGlue(idx());
825 if (pos() != lastpos() && inset().nargs() > 0) {
839 DocumentIterator save = *this;
842 setCursor(save, false);
843 autocorrect() = false;
851 DocumentIterator save = *this;
854 setCursor(save, false);
855 autocorrect() = false;
860 void LCursor::macroModeClose()
864 MathUnknownInset * p = activeMacro();
866 string s = p->name();
870 // do nothing if the macro name is empty
874 string const name = s.substr(1);
876 // prevent entering of recursive macros
877 InsetBase const * macro = innerInsetOfType(InsetBase::MATHMACRO_CODE);
878 if (macro && macro->getInsetName() == name)
879 lyxerr << "can't enter recursive macro" << endl;
881 niceInsert(createMathInset(name));
885 string LCursor::macroName()
887 return inMacroMode() ? activeMacro()->name() : string();
891 void LCursor::handleNest(MathAtom const & a, int c)
893 //lyxerr << "LCursor::handleNest: " << c << endl;
895 asArray(grabAndEraseSelection(), t.nucleus()->cell(c));
898 pushLeft(*nextInset());
902 int LCursor::targetX() const
904 if (x_target() != -1)
913 void LCursor::adjust(pos_type from, int diff)
917 if (anchor().pos() > from)
918 anchor().pos() += diff;
919 // just to be on the safe side
920 // theoretically unecessary
925 bool LCursor::inMacroMode() const
929 MathUnknownInset const * p = prevAtom()->asUnknownInset();
930 return p && !p->final();
934 MathUnknownInset * LCursor::activeMacro()
936 return inMacroMode() ? prevAtom().nucleus()->asUnknownInset() : 0;
940 bool LCursor::inMacroArgMode() const
942 return pos() > 0 && prevAtom()->getChar() == '#';
946 MathGridInset * LCursor::enclosingGrid(idx_type & idx) const
948 for (MathInset::difference_type i = depth() - 1; i >= 0; --i) {
949 MathInset * m = operator[](i).inset().asMathInset();
952 MathGridInset * p = m->asGridInset();
954 idx = operator[](i).idx();
962 void LCursor::pullArg()
965 MathArray ar = cell();
966 if (popLeft() && inMathed()) {
968 cell().insert(pos(), ar);
971 //formula()->mutateToText();
976 void LCursor::touch()
980 DocumentIterator::const_iterator it = begin();
981 DocumentIterator::const_iterator et = end();
982 for ( ; it != et; ++it)
988 void LCursor::normalize()
990 if (idx() >= nargs()) {
991 lyxerr << "this should not really happen - 1: "
992 << idx() << ' ' << nargs()
993 << " in: " << &inset() << endl;
995 idx() = min(idx(), lastidx());
997 if (pos() > lastpos()) {
998 lyxerr << "this should not really happen - 2: "
999 << pos() << ' ' << lastpos() << " in idx: " << idx()
1001 WriteStream wi(lyxerr, false, true);
1002 inset().asMathInset()->write(wi);
1005 pos() = min(pos(), lastpos());
1009 char LCursor::valign()
1012 MathGridInset * p = enclosingGrid(idx);
1013 return p ? p->valign() : '\0';
1017 char LCursor::halign()
1020 MathGridInset * p = enclosingGrid(idx);
1021 return p ? p->halign(idx % p->ncols()) : '\0';
1025 bool LCursor::goUpDown(bool up)
1027 // Be warned: The 'logic' implemented in this function is highly
1028 // fragile. A distance of one pixel or a '<' vs '<=' _really
1029 // matters. So fiddle around with it only if you think you know
1030 // what you are doing!
1036 // check if we had something else in mind, if not, this is the future goal
1037 if (x_target() == -1)
1042 // try neigbouring script insets
1046 MathScriptInset const * p = prevAtom()->asScriptInset();
1047 if (p && p->has(up)) {
1050 idx() = up; // the superscript has index 1
1052 //lyxerr << "updown: handled by scriptinset to the left" << endl;
1058 if (pos() != lastpos()) {
1059 MathScriptInset const * p = nextAtom()->asScriptInset();
1060 if (p && p->has(up)) {
1064 //lyxerr << "updown: handled by scriptinset to the right" << endl;
1070 // try current cell for e.g. text insets
1071 if (inset().idxUpDown2(*this, up))
1074 //xarray().boundingBox(xlow, xhigh, ylow, yhigh);
1079 //if (bruteFind(xo, yo, xlow, xhigh, ylow, yhigh)) {
1080 // lyxerr << "updown: handled by brute find in the same cell" << endl;
1084 // try to find an inset that knows better then we
1086 //lyxerr << "updown: We are in " << &inset() << " idx: " << idx() << endl;
1088 if (inset().idxUpDown(*this, up)) {
1089 // try to find best position within this inset
1095 // no such inset found, just take something "above"
1096 //lyxerr << "updown: handled by strange case" << endl;
1098 int ylow = up ? 0 : yo + 1;
1099 int yhigh = up ? yo - 1 : bv().workHeight();
1100 return bruteFind(xo, yo, 0, bv().workWidth(), ylow, yhigh);
1103 // any improvement so far?
1106 if (up ? ynew < yo : ynew > yo)
1112 bool LCursor::bruteFind(int x, int y, int xlow, int xhigh, int ylow, int yhigh)
1114 BOOST_ASSERT(!empty());
1116 CursorSlice bottom = operator[](0);
1117 LyXText * text = bottom.text();
1119 getParsInRange(text->paragraphs(), ylow, yhigh, beg, end);
1121 DocumentIterator it = doc_iterator_begin(bv().buffer()->inset());
1122 DocumentIterator et = doc_iterator_end(bv().buffer()->inset());
1123 //lyxerr << "x: " << x << " y: " << y << endl;
1124 //lyxerr << "xlow: " << xlow << " ylow: " << ylow << endl;
1125 //lyxerr << "xhigh: " << xhigh << " yhigh: " << yhigh << endl;
1128 //et.par() = text->parOffset(end);
1130 double best_dist = 10e10;
1131 DocumentIterator best_cursor = it;
1133 for ( ; it != et; it.forwardPos()) {
1134 // avoid invalid nesting when selecting
1135 if (!selection() || positionable(it, anchor_)) {
1137 CursorSlice & cur = it.back();
1138 cur.inset().getCursorPos(cur, xo, yo);
1139 if (xlow <= xo && xo <= xhigh && ylow <= yo && yo <= yhigh) {
1140 double d = (x - xo) * (x - xo) + (y - yo) * (y - yo);
1141 //lyxerr << "xo: " << xo << " yo: " << yo << " d: " << d << endl;
1142 // '<=' in order to take the last possible position
1143 // this is important for clicking behind \sum in e.g. '\sum_i a'
1144 if (d <= best_dist) {
1145 //lyxerr << "*" << endl;
1153 //lyxerr << "best_dist: " << best_dist << " cur:\n" << best_cursor << endl;
1154 if (best_dist < 1e10)
1155 setCursor(best_cursor, false);
1156 return best_dist < 1e10;
1160 void LCursor::bruteFind2(int x, int y)
1162 double best_dist = 1e10;
1164 DocumentIterator it = *this;
1165 it.back().pos() = 0;
1166 DocumentIterator et = *this;
1167 et.back().pos() = et.back().asMathInset()->cell(et.back().idx()).size();
1168 for (int i = 0; ; ++i) {
1170 CursorSlice & cur = it.back();
1171 cur.inset().getCursorPos(cur, xo, yo);
1172 double d = (x - xo) * (x - xo) + (y - yo) * (y - yo);
1173 // '<=' in order to take the last possible position
1174 // this is important for clicking behind \sum in e.g. '\sum_i a'
1175 lyxerr << "i: " << i << " d: " << d << " best: " << best_dist << endl;
1176 if (d <= best_dist) {
1178 setCursor(it, false);
1187 CursorSlice LCursor::normalAnchor()
1189 if (anchor_.size() < depth()) {
1191 lyxerr << "unusual Anchor size" << endl;
1193 //lyx::BOOST_ASSERT(Anchor_.size() >= cursor.depth());
1194 // use Anchor on the same level as Cursor
1195 CursorSlice normal = anchor_[size() - 1];
1197 if (depth() < anchor_.size() && !(normal < xx())) {
1198 // anchor is behind cursor -> move anchor behind the inset
1206 void LCursor::handleFont(string const & font)
1208 lyxerr << "LCursor::handleFont: " << font << endl;
1212 safe = grabAndEraseSelection();
1215 if (lastpos() != 0) {
1216 // something left in the cell
1218 // cursor in first position
1220 } else if (pos() == lastpos()) {
1221 // cursor in last position
1224 // cursor in between. split cell
1225 MathArray::iterator bt = cell().begin();
1226 MathAtom at = createMathInset(font);
1227 at.nucleus()->cell(0) = MathArray(bt, bt + pos());
1228 cell().erase(bt, bt + pos());
1233 // nothing left in the cell
1241 void LCursor::message(string const & msg) const
1243 bv().owner()->getLyXFunc().setMessage(msg);
1247 void LCursor::errorMessage(string const & msg) const
1249 bv().owner()->getLyXFunc().setErrorMessage(msg);
1253 string LCursor::selectionAsString(bool label) const
1259 Buffer const & buffer = *bv().buffer();
1260 ParagraphList & pars = text()->paragraphs();
1262 // should be const ...
1263 par_type startpit = selBegin().par();
1264 par_type endpit = selEnd().par();
1265 size_t const startpos = selBegin().pos();
1266 size_t const endpos = selEnd().pos();
1268 if (startpit == endpit)
1269 return pars[startpit].asString(buffer, startpos, endpos, label);
1271 // First paragraph in selection
1272 string result = pars[startpit].
1273 asString(buffer, startpos, pars[startpit].size(), label) + "\n\n";
1275 // The paragraphs in between (if any)
1276 for (par_type pit = startpit + 1; pit != endpit; ++pit) {
1277 Paragraph & par = pars[pit];
1278 result += par.asString(buffer, 0, par.size(), label) + "\n\n";
1281 // Last paragraph in selection
1282 result += pars[endpit].asString(buffer, 0, endpos, label);
1287 #warning and mathed?
1292 string LCursor::currentState()
1295 std::ostringstream os;
1301 return text()->currentState(*this);
1307 string LCursor::getPossibleLabel()
1309 return inMathed() ? "eq:" : text()->getPossibleLabel(*this);
1313 Encoding const * LCursor::getEncoding() const
1320 // go up until first non-0 text is hit
1321 // (innermost text is 0 in mathed)
1322 for (s = size() - 1; s >= 0; --s)
1323 if (operator[](s).text())
1325 CursorSlice const & sl = operator[](s);
1326 LyXText & text = *sl.text();
1327 LyXFont font = text.getPar(sl.par()).getFont(
1328 bv().buffer()->params(), sl.pos(), outerFont(sl.par(), text.paragraphs()));
1329 return font.language()->encoding();
1333 void LCursor::undispatched()
1335 disp_.dispatched(false);
1339 void LCursor::dispatched()
1341 disp_.dispatched(true);
1345 void LCursor::noUpdate()
1347 disp_.update(false);