]> git.lyx.org Git - lyx.git/blobdiff - src/insets/InsetInfo.h
More GuiInfo usability work
[lyx.git] / src / insets / InsetInfo.h
index 9a82e13d724d4683101e5d5a2d33d8a1c5b04b3d..e1c42a7c91578573fe6694cb3d237e773049d0c1 100644 (file)
 #ifndef INSET_INFO_H
 #define INSET_INFO_H
 
-#include "InsetText.h"
-#include "RenderButton.h"
-#include "support/gettext.h"
-#include "Cursor.h"
-#include "support/Translator.h"
+#include "InsetCollapsible.h"
 
-/* InsetInfo displays shortcuts, lyxrc, package and textclass 
+namespace lyx {
+
+class Cursor;
+
+/* InsetInfo displays shortcuts, lyxrc, package and textclass
 availability and menu information in a non-editable boxed InsetText.
 
 Output of such an inset may vary from system to system, depending
@@ -29,15 +29,17 @@ uses it to display currently used shortcuts.
 
 This inset has two arguments: the type and argument of the information. The
 screen and latex output is the content of the information. An InsetInfo can
-have type "shortcut", "lyxrc", "package", "textclass", "menu", or "buffer".
-Arguments and outputs vary by type.
+have type "shortcuts", "shortcut", "lyxrc", "package", "textclass", "menu",
+"buffer" or "vcs". Arguments and outputs vary by type.
 
-shortcut: argument of this type of InsetInfo is the name of the LFUN such as
+shortcuts: argument of this type of InsetInfo is the name of the LFUN such as
     "math-insert \alpha". The syntax is the same as what is used in the bind
     and ui files. The output of this inset is all shortcuts for this LFUN
     separated by comma.
 
-lyxrc: argument is the name of the rc entry such as "bind_file". Look in 
+shortcut: the same as shortcuts, but only output the last shortcut.
+
+lyxrc: argument is the name of the rc entry such as "bind_file". Look in
     src/LyXRC.h for available entries. The output is the content of this RC
     entry.
 
@@ -52,75 +54,120 @@ menu: argument is the name of the LFUN such as "paste". The syntax is the same
     triggers this LFUN. For example, "File > Paste", where '>' is actually
     \lyxarrow (an InsetSpecialChar).
 
-buffer: argument can be one of "name", "path", "class". This inset output the 
+icon: argument is the name of the LFUN such as "paste". The syntax is the same
+    as what is used in the bind and ui files. The output is the icon use in
+    the toolbar for this LFUN. Alternatively, argument can be the icon path
+    without extension specified with respect to the images directory.
+
+buffer: argument can be one of "name", "path", "class". This inset output the
     filename, path, and textclass of this buffer.
 
-There is currently no GUI, no menu entry for this inset. A user can define a 
+lyxinfo: argument must (presently) be "version". This inset outputs information
+    about the version of LyX currently in use.
+
+vcs: argument can be one of "revision", "tree-revision", "author", "time", "date".
+    This insets outputs revision control information, if available.
+
+There is currently no GUI, no menu entry for this inset. A user can define a
 shortcut for "info-insert" (e.g. C-S-I), and
 
-1. input the type and argument of this inset, e.g. "menu paste", in 
+1. input the type and argument of this inset, e.g. "menu paste", in
    the work area.
 2. select the text and run "info-insert" (e.g. press C-S-I).
 
-An alternative method is to enter command "info-insert type arg" in 
+An alternative method is to enter command "info-insert type arg" in
 the command buffer (view->Toolbar->Command Buffer).
 
 */
 
-namespace lyx {
-
-/** Used to insert index labels
-  */
-class InsetInfo : public InsetText {
+class InsetInfo : public InsetCollapsible {
 public:
        enum info_type {
                UNKNOWN_INFO,   // Invalid type
+               SHORTCUTS_INFO, // Keyboard shortcuts
                SHORTCUT_INFO,  // Keyboard shortcut
                LYXRC_INFO,     // RC entry
                PACKAGE_INFO,   // Availability of package
                TEXTCLASS_INFO, // Availability of textclass
                MENU_INFO,      // Which menu item is used for certain function
+               ICON_INFO,      // which toolbar icon is used for certain function
                BUFFER_INFO,    // Buffer related information
+               LYX_INFO,        // LyX version information
+               VCS_INFO,        // Version control information
        };
 
        ///
-       InsetInfo(Buffer const & buf, std::string const & info = std::string());
+       InsetInfo(Buffer * buf, std::string const & info = std::string());
+       ///
+       InsetCode lyxCode() const { return INFO_CODE; }
+       ///
+       docstring layoutName() const;
        ///
        Inset * editXY(Cursor & cur, int x, int y);
+       /** FIXME: we would like to do that, but then InsetText::updateBuffer breaks
+        * on info insets. Do we need to run this method on InsetInfo contents?
+        * Having a InsetInfo that hides an InsetText is really annoying, actually.
+        */
+       ///bool isActive() const { return false; }
        ///
-       EDITABLE editable() const { return NOT_EDITABLE; }
+       bool editable() const { return false; }
        ///
-       void draw(PainterInfo & pi, int x, int y) const;
+       bool hasSettings() const { return true; }
        ///
        void read(Lexer & lex);
        ///
        void write(std::ostream & os) const;
        ///
-       void doDispatch(Cursor & cur, FuncRequest & cmd);
+       std::string infoType() const;
        ///
-       InsetCode lyxCode() const { return INFO_CODE; }
+       std::string infoName() const { return name_; }
+       ///
+       bool validateModifyArgument(docstring const & argument) const;
+       ///
+       std::vector<std::pair<std::string,docstring>> getArguments(std::string const &) const;
+       ///
+       bool showInsetDialog(BufferView * bv) const;
+       ///
+       bool getStatus(Cursor &, FuncRequest const &, FuncStatus &) const;
+       ///
+       void doDispatch(Cursor & cur, FuncRequest & cmd);
+       /// Force inset into LTR environment if surroundings are RTL
+       bool forceLTR() const;
        ///
        void setInfo(std::string const & info);
-       /// update info_ and text
-       void updateInfo();
        ///
-       bool setMouseHover(bool mouse_hover);
+       void updateBuffer(ParIterator const & it, UpdateType utype);
+       ///
+       docstring toolTip(BufferView const & bv, int x, int y) const;
+       ///
+       std::string contextMenu(BufferView const &, int, int) const;
+       ///
+       std::string contextMenuName() const;
+       /// should paragraph indendation be omitted in any case?
+       bool neverIndent() const { return true; }
 
 private:
-       /// The translator between the information type enum and corresponding string.
-       Translator<info_type, std::string> const & nameTranslator() const;
        ///
        virtual Inset * clone() const { return new InsetInfo(*this); }
        ///
+       void error(docstring const & err, Language const *);
+       ///
+       void info(docstring const & err, Language const *);
+       ///
+       void setText(docstring const & str, Language const *);
+       // make sure that the other version of setText is still available.
+       using InsetCollapsible::setText;
+       ///
+       bool initialized_;
+       ///
        info_type type_;
        ///
        std::string name_;
        ///
-       bool mouse_hover_;
+       bool force_ltr_;
 };
 
 
-
 } // namespace lyx
 
 #endif