Warning, file /office/calligra/libs/text/KoTextReference.h was not indexed or was modified since last indexation (in which case cross-reference links may be missing, inaccurate or erroneous).

0001 /* This file is part of the KDE project
0002  * Copyright (C) 2007 Thomas Zander <zander@kde.org>
0003  *
0004  * This library is free software; you can redistribute it and/or
0005  * modify it under the terms of the GNU Library General Public
0006  * License as published by the Free Software Foundation; either
0007  * version 2 of the License, or (at your option) any later version.
0008  *
0009  * This library is distributed in the hope that it will be useful,
0010  * but WITHOUT ANY WARRANTY; without even the implied warranty of
0011  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
0012  * Library General Public License for more details.
0013  *
0014  * You should have received a copy of the GNU Library General Public License
0015  * along with this library; see the file COPYING.LIB.  If not, write to
0016  * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
0017  * Boston, MA 02110-1301, USA.
0018  */
0019 #ifndef KOTEXTREFERENCE_H
0020 #define KOTEXTREFERENCE_H
0021 
0022 #include "KoVariable.h"
0023 
0024 class KoTextLocator;
0025 
0026 /**
0027  * This variable displays information about a text reference.
0028  * A user can insert characters that are called locators.  And are represented by a KoTextLocator
0029  * the user can then insert (several) KoTextReference variables that will update the textual description
0030  * of the locator whenever text is re-layouted.
0031  * This effectively means that the reference will print the page number (for example) of where the
0032  * locator is and keep it updated automatically.
0033  */
0034 class KoTextReference : public KoVariable
0035 {
0036 Q_OBJECT
0037 public:
0038     /**
0039      * Constructor; please don't use directly as the KoInlineTextObjectManager will supply an action
0040      * to create one.
0041      * @param indexId the index of the inline object that is the locator.  See KoInlineObject::id()
0042      */
0043     explicit KoTextReference(int indexId);
0044     ~KoTextReference() override;
0045 
0046     void variableMoved(const QTextDocument *document, int posInDocument) override;
0047     void setup() override;
0048     bool loadOdf(const KoXmlElement &element, KoShapeLoadingContext &context) override;
0049     void saveOdf(KoShapeSavingContext &context) override;
0050 
0051 private:
0052     KoTextLocator *locator();
0053     int m_indexId;
0054     // TODO store a config of what we actually want to show.  The hardcoded pagenumber is not enough.
0055     // we want 'section' / chapter name/number and maybe word.  All in a nice formatted text.
0056     // see also the ODF spec.
0057 };
0058 
0059 #endif