lyx_mirror/src/insets/InsetCommand.h
Richard Heck ecef54500d Introduce max_length parameter for plaintext() output routines,
so we can write a limited amount when using this for TOC and
tooltip output.

This should solve the problem with slowness that Kornel noticed,
which was caused by our trying to write an entire plaintext
bibliography every time we updated the TOC. We did that because
he had a bibliography inside a branch, and we use plaintext for
creating the tooltip that goes with the branch list.

Other related bugs were fixed along the way. E.g., it turns out
that, if someone had an InsetInclude inside a branch, then we would
have been writing a *plaintext file* for that inset every time we
updated the TOC. I wonder if some of the other reports of slowness
we have received might be due to this kind of issue?
2013-03-08 15:12:58 -05:00

154 lines
4.3 KiB
C++

// -*- C++ -*-
/**
* \file InsetCommand.h
* This file is part of LyX, the document processor.
* Licence details can be found in the file COPYING.
*
* \author Angus Leeming
* \author Lars Gullik Bjønnes
*
* Full author contact details are available in file CREDITS.
*/
#ifndef INSETCOMMAND_H
#define INSETCOMMAND_H
#include "Inset.h"
#include "InsetCommandParams.h"
#include "RenderButton.h"
namespace lyx {
class Cursor;
/////////////////////////////////////////////////////////////////////////
//
// InsetCommand
//
/////////////////////////////////////////////////////////////////////////
// Created by Alejandro 970222
// Used to insert a LaTeX command automatically.
class InsetCommand : public Inset
{
public:
///
InsetCommand(Buffer *, InsetCommandParams const &);
///
InsetCommand(InsetCommand const & rhs);
///
virtual ~InsetCommand();
///
InsetCommand * asInsetCommand() { return this; }
///
InsetCommand const * asInsetCommand() const { return this; }
/// \return true if params are successfully read
static bool string2params(std::string const & data,
InsetCommandParams &);
///
static std::string params2string(InsetCommandParams const &);
///
InsetCommandParams const & params() const { return p_; }
///
void setParams(InsetCommandParams const &);
///
docstring const & getParam(std::string const & name) const;
///
void setParam(std::string const & name, docstring const & value);
/// FIXME Remove
docstring const getFirstNonOptParam() const { return p_.getFirstNonOptParam(); }
/// \name Public functions inherited from Inset class
//@{
///
void write(std::ostream & os) const { p_.write(os); }
///
void read(Lexer & lex) { p_.read(lex); }
///
void doDispatch(Cursor & cur, FuncRequest & cmd);
///
bool getStatus(Cursor & cur, FuncRequest const & cmd, FuncStatus &) const;
///
void metrics(MetricsInfo &, Dimension &) const;
///
void draw(PainterInfo & pi, int x, int y) const;
///
void latex(otexstream &, OutputParams const &) const;
///
int plaintext(odocstringstream & ods, OutputParams const & op,
size_t max_length = INT_MAX) const;
///
int docbook(odocstream &, OutputParams const & runparams) const;
///
bool setMouseHover(BufferView const * bv, bool mouse_hover) const;
///
bool clickable(int, int) const { return hasSettings(); }
//@}
protected:
/// \name Methods relaying to the InsetCommandParams p_
//@{
///
std::string contextMenuName() const;
///
bool showInsetDialog(BufferView * bv) const;
///
Dimension const dimension(BufferView const &) const
{ return button_.dimension(); }
//@}
protected:
/// \name Functions relaying to the InsetCommandParams
//@{
/// Build the complete LaTeX command
/// \see InsetCommandParams::getCommand
docstring const getCommand(OutputParams const & rp) const
{ return p_.getCommand(rp); }
/// Return the command name
/// \see InsetCommandParams::getCmdName
std::string const & getCmdName() const { return p_.getCmdName(); }
/// Set the name to \p n. This must be a known name. All parameters
/// are cleared except those that exist also in the new command.
/// What matters here is the parameter name, not position.
/// \see InsetCommandParams::setCmdName
void setCmdName(std::string const & n) { p_.setCmdName(n); }
//@}
private:
///
RenderButton & button() const { return button_; }
/// This should provide the text for the button
virtual docstring screenLabel() const = 0;
/// \name Static public methods obligated for InsetCommand derived classes
//@{
/// Return parameter information for command cmdName.
/// Not implemented here. Must be implemented in derived class.
static ParamInfo const & findInfo(std::string const & cmdName);
/// Return default command for this inset.
/// Not implemented here. Must be implemented in derived class.
static std::string defaultCommand();
/// Whether this is a command this inset can represent.
/// Not implemented here. Must be implemented in derived class.
static bool isCompatibleCommand(std::string const & cmd);
//@}
///
InsetCommandParams p_;
/// changes color when mouse enters/leaves this inset
mutable std::map<BufferView const *, bool> mouse_hover_;
///
mutable RenderButton button_;
};
/// Decode InsetCommand considering Inset name and data.
bool decodeInsetParam(std::string const & name, std::string & data,
Buffer const & buffer);
} // namespace lyx
#endif