/usr/include/libkeduvocdocument/keduvoccontainer.h is in libkeduvocdocument-dev 4:15.12.3-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 | /***************************************************************************
Copyright 2007 Jeremy Whiting <jpwhiting@kde.org>
Copyright 2007 Frederik Gladhorn <frederik.gladhorn@kdemail.net>
***************************************************************************/
/***************************************************************************
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
* *
***************************************************************************/
#ifndef KEDUVOCCONTAINER_H
#define KEDUVOCCONTAINER_H
#include "keduvocdocument_export.h"
#include "keduvoctext.h"
#include <QtCore/QList>
#include <QUrl>
class KEduVocDocument;
class KEduVocExpression;
/** class to store information about a container - that can be a lesson or word types */
class KEDUVOCDOCUMENT_EXPORT KEduVocContainer
{
// make this a template?
public:
enum EnumContainerType{
Container,
Lesson,
WordType,
Leitner
};
enum EnumEntriesRecursive{
NotRecursive = 0,
Recursive = 1
};
/** default constructor */
explicit KEduVocContainer(const QString& name, EnumContainerType type,
KEduVocContainer *parent = 0);
void appendChildContainer(KEduVocContainer *child);
void insertChildContainer(int row, KEduVocContainer *child);
void deleteChildContainer(int row);
void removeChildContainer(int row);
KEduVocContainer *childContainer(int row);
/**
* Retrieve a child container by its name
* Returns 0 if no container is found
* @param name container name
* @return the child container
*/
KEduVocContainer *childContainer(const QString& name);
QList<KEduVocContainer *> childContainers();
/**
* Find a child container
* @param name
* @return
*/
// KEduVocContainer *childContainer(const QString& name);
int childContainerCount() const;
int row() const;
virtual KEduVocContainer *parent();
/** copy constructor for d-pointer safe copying */
KEduVocContainer( const KEduVocContainer &other );
/** destructor */
virtual ~KEduVocContainer();
/** assignment operator */
KEduVocContainer& operator= ( const KEduVocContainer& );
/** @return the containing KEduVocDocument */
KEduVocDocument *document() const;
/** set the container name
* @param name text to set for the name
*/
void setName( const QString &name );
/** get the container name */
QString name();
/** get a list of all entries in the container */
virtual QList < KEduVocExpression* > entries(EnumEntriesRecursive recursive = NotRecursive) =0;
virtual int entryCount(EnumEntriesRecursive recursive = NotRecursive) =0;
virtual KEduVocExpression* entry(int row, EnumEntriesRecursive recursive = NotRecursive) =0;
/**
* Removes a translation. This has to be called when a language is removed from a document.
* @param translation
*/
void removeTranslation(int translation);
bool inPractice();
void setInPractice( bool inPractice );
/** equality operator */
bool operator==(const KEduVocContainer &other);
/**
* The type of this container. @see EnumContainerType
* @return
*/
KEduVocContainer::EnumContainerType containerType();
/**
* Set the type of container.
* For convenience by default this is taken over from the parent, so no need to set.
* @param type the new type
*/
void setContainerType(KEduVocContainer::EnumContainerType type);
/** get the image url for this container if it exists */
QUrl imageUrl();
/** set the image url for this container
* @param url url of the image
*/
void setImageUrl(const QUrl &url);
double averageGrade(int translation, EnumEntriesRecursive recursive);
int expressionsOfGrade(int translation, grade_t grade, EnumEntriesRecursive recursive);
/**
* Remove grades from all entries of this lessons
* @param translation which translation to remove. -1 for all.
* @param recursive whether to include child lessons
*/
void resetGrades(int translation, EnumEntriesRecursive recursive);
protected:
QList< KEduVocExpression * > entriesRecursive();
/**
* Set the child entry cache to invalid
*/
void invalidateChildLessonEntries();
/**
* Recreate the cache of entries in this lesson's child lessons.
*/
void updateChildLessonEntries();
// Used by KEduVocLesson when the Document creates the top level lesson.
explicit KEduVocContainer(const QString& name, EnumContainerType type,
KEduVocDocument *document);
private:
class Private;
Private * const d;
};
#endif
|