3 * \file InsetArgument.h
4 * This file is part of LyX, the document processor.
5 * Licence details can be found in the file COPYING.
7 * \author Martin Vermeer
9 * Full author contact details are available in file CREDITS.
12 #ifndef INSETARGUMENT_H
13 #define INSETARGUMENT_H
16 #include "InsetCollapsible.h"
23 * InsetArgument. Used to insert a short version of sectioning header etc.
24 * automatically, or other optional LaTeX arguments
26 class InsetArgument : public InsetCollapsible
30 InsetArgument(Buffer *, std::string const &);
33 InsetArgument const * asInsetArgument() const override { return this; }
35 /// Outputting the parameter of a LaTeX command
36 void latexArgument(otexstream & os, OutputParams const & runparams_in,
37 docstring const & ldelim, docstring const & rdelim,
38 docstring const & presetarg) const;
40 std::string name() const { return name_; }
42 bool docbookargumentbeforemaintag() const { return docbookargumentbeforemaintag_; }
44 bool docbookargumentaftermaintag() const { return docbookargumentaftermaintag_; }
46 /// \name Public functions inherited from Inset class
49 bool hasSettings() const override { return false; }
51 InsetCode lyxCode() const override { return ARG_CODE; }
53 docstring layoutName() const override { return from_ascii("Argument"); }
54 /// Update the label string of this inset
55 void updateBuffer(ParIterator const &, UpdateType, bool const deleted = false) override;
57 void latex(otexstream &, OutputParams const &) const override { }
59 int plaintext(odocstringstream &, OutputParams const &, size_t) const override { return 0; }
61 void docbook(XMLStream & xs, OutputParams const &) const override;
63 docstring xhtml(XMLStream &, OutputParams const &) const override
64 { return docstring(); }
66 void write(std::ostream & os) const override;
68 void read(Lexer & lex) override;
70 bool neverIndent() const override { return true; }
72 std::string contextMenuName() const override;
74 bool isPassThru() const override { return pass_thru_; }
76 bool isFreeSpacing() const override { return free_spacing_; }
78 bool isTocCaption() const { return is_toc_caption_; }
80 bool resetFontEdit() const override { return false; }
82 /// \name Public functions inherited from InsetCollapsible class
85 InsetDecoration decoration() const override;
87 FontInfo getFont() const override;
89 FontInfo getLabelfont() const override;
91 ColorCode labelColor() const override;
93 void setButtonLabel() override;
96 void addToToc(DocIterator const & dit, bool output_active,
97 UpdateType utype, TocBackend & backend) const override;
101 docstring toolTip(BufferView const & bv, int, int) const override;
103 void fixParagraphLanguage(Language const *);
107 docstring labelstring_;
115 std::string decoration_;
116 /// Are we in a pass-thru context?
117 bool pass_thru_context_;
118 /// Is the argument itself have an explicitly pass-thru?
119 bool pass_thru_local_;
120 /// Effective pass-thru setting (inherited or local)
125 docstring pass_thru_chars_;
126 /// Does this argument provide content for the TOC?
127 bool is_toc_caption_;
128 /// The type of Toc this is the caption of, empty otherwise.
129 std::string caption_of_toc_;
130 /// Specific line break macro
131 std::string newline_cmd_;
132 /// DocBook tag for this argument, if any (otherwise, NONE).
133 docstring docbooktag_;
134 /// Type of DocBook tag (controls how new lines are inserted around this argument).
135 docstring docbooktagtype_;
136 /// DocBook attributes.
137 docstring docbookattr_;
139 bool docbookargumentbeforemaintag_ = false;
141 bool docbookargumentaftermaintag_ = false;
144 /// \name Protected functions inherited from Inset class
147 bool getStatus(Cursor &, FuncRequest const &, FuncStatus &) const override;
149 void doDispatch(Cursor & cur, FuncRequest & cmd) override;
151 Inset * clone() const override { return new InsetArgument(*this); }
152 /// Is the content of this inset part of the immediate (visible) text sequence?
153 bool isPartOfTextSequence() const override { return false; }
160 #endif // INSETARGUMENT_H