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