Qt 4.8
|
The QTextList class provides a decorated list of items in a QTextDocument. More...
#include <qtextlist.h>
Public Functions | |
void | add (const QTextBlock &block) |
Makes the given block part of the list. More... | |
int | count () const |
Returns the number of items in the list. More... | |
QTextListFormat | format () const |
Returns the list's format. More... | |
bool | isEmpty () const |
Returns true if the list has no items; otherwise returns false. More... | |
QTextBlock | item (int i) const |
Returns the {i}-th text block in the list. More... | |
int | itemNumber (const QTextBlock &) const |
Returns the index of the list item that corresponds to the given block. More... | |
QString | itemText (const QTextBlock &) const |
Returns the text of the list item that corresponds to the given block. More... | |
QTextList (QTextDocument *doc) | |
void | remove (const QTextBlock &) |
Removes the given block from the list. More... | |
void | removeItem (int i) |
Removes the item at item position i from the list. More... | |
void | setFormat (const QTextListFormat &format) |
Sets the list's format to format. More... | |
~QTextList () | |
Public Functions inherited from QTextObject | |
QTextDocumentPrivate * | docHandle () const |
QTextDocument * | document () const |
Returns the document this object belongs to. More... | |
QTextFormat | format () const |
Returns the text object's format. More... | |
int | formatIndex () const |
Returns the index of the object's format in the document's internal list of formats. More... | |
int | objectIndex () const |
Returns the object index of this object. More... | |
Public Functions inherited from QObject | |
bool | blockSignals (bool b) |
If block is true, signals emitted by this object are blocked (i.e., emitting a signal will not invoke anything connected to it). More... | |
const QObjectList & | children () const |
Returns a list of child objects. More... | |
bool | connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const |
bool | disconnect (const char *signal=0, const QObject *receiver=0, const char *member=0) |
bool | disconnect (const QObject *receiver, const char *member=0) |
void | dumpObjectInfo () |
Dumps information about signal connections, etc. More... | |
void | dumpObjectTree () |
Dumps a tree of children to the debug output. More... | |
QList< QByteArray > | dynamicPropertyNames () const |
Returns the names of all properties that were dynamically added to the object using setProperty(). More... | |
virtual bool | event (QEvent *) |
This virtual function receives events to an object and should return true if the event e was recognized and processed. More... | |
virtual bool | eventFilter (QObject *, QEvent *) |
Filters events if this object has been installed as an event filter for the watched object. More... | |
template<typename T > | |
T | findChild (const QString &aName=QString()) const |
Returns the child of this object that can be cast into type T and that is called name, or 0 if there is no such object. More... | |
template<typename T > | |
QList< T > | findChildren (const QString &aName=QString()) const |
Returns all children of this object with the given name that can be cast to type T, or an empty list if there are no such objects. More... | |
template<typename T > | |
QList< T > | findChildren (const QRegExp &re) const |
bool | inherits (const char *classname) const |
Returns true if this object is an instance of a class that inherits className or a QObject subclass that inherits className; otherwise returns false. More... | |
void | installEventFilter (QObject *) |
Installs an event filter filterObj on this object. More... | |
bool | isWidgetType () const |
Returns true if the object is a widget; otherwise returns false. More... | |
void | killTimer (int id) |
Kills the timer with timer identifier, id. More... | |
virtual const QMetaObject * | metaObject () const |
Returns a pointer to the meta-object of this object. More... | |
void | moveToThread (QThread *thread) |
Changes the thread affinity for this object and its children. More... | |
QString | objectName () const |
QObject * | parent () const |
Returns a pointer to the parent object. More... | |
QVariant | property (const char *name) const |
Returns the value of the object's name property. More... | |
Q_INVOKABLE | QObject (QObject *parent=0) |
Constructs an object with parent object parent. More... | |
void | removeEventFilter (QObject *) |
Removes an event filter object obj from this object. More... | |
void | setObjectName (const QString &name) |
void | setParent (QObject *) |
Makes the object a child of parent. More... | |
bool | setProperty (const char *name, const QVariant &value) |
Sets the value of the object's name property to value. More... | |
void | setUserData (uint id, QObjectUserData *data) |
bool | signalsBlocked () const |
Returns true if signals are blocked; otherwise returns false. More... | |
int | startTimer (int interval) |
Starts a timer and returns a timer identifier, or returns zero if it could not start a timer. More... | |
QThread * | thread () const |
Returns the thread in which the object lives. More... | |
QObjectUserData * | userData (uint id) const |
virtual | ~QObject () |
Destroys the object, deleting all its child objects. More... | |
Additional Inherited Members | |
Public Slots inherited from QObject | |
void | deleteLater () |
Schedules this object for deletion. More... | |
Signals inherited from QObject | |
void | destroyed (QObject *=0) |
This signal is emitted immediately before the object obj is destroyed, and can not be blocked. More... | |
Static Public Functions inherited from QObject | |
static bool | connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection) |
Creates a connection of the given type from the signal in the sender object to the method in the receiver object. More... | |
static bool | connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection) |
static bool | disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member) |
Disconnects signal in object sender from method in object receiver. More... | |
static bool | disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member) |
static uint | registerUserData () |
static QString | tr (const char *sourceText, const char *comment=0, int n=-1) |
static QString | trUtf8 (const char *sourceText, const char *comment=0, int n=-1) |
Static Public Variables inherited from QObject | |
static const QMetaObject | staticMetaObject |
This variable stores the meta-object for the class. More... | |
Protected Functions inherited from QTextBlockGroup | |
virtual void | blockFormatChanged (const QTextBlock &block) |
This function is called whenever the specified block of text is changed. More... | |
virtual void | blockInserted (const QTextBlock &block) |
Appends the given block to the end of the group. More... | |
QList< QTextBlock > | blockList () const |
Returns a (possibly empty) list of all the blocks that are part of the block group. More... | |
virtual void | blockRemoved (const QTextBlock &block) |
Removes the given block from the group; the block itself is not deleted, it simply isn't a member of this group anymore. More... | |
QTextBlockGroup (QTextDocument *doc) | |
Creates a new new block group for the given document. More... | |
QTextBlockGroup (QTextBlockGroupPrivate &p, QTextDocument *doc) | |
~QTextBlockGroup () | |
Destroys this block group; the blocks are not deleted, they simply don't belong to this block anymore. More... | |
Protected Functions inherited from QTextObject | |
QTextObject (QTextDocument *doc) | |
Creates a new QTextObject for the given document. More... | |
QTextObject (QTextObjectPrivate &p, QTextDocument *doc) | |
void | setFormat (const QTextFormat &format) |
Sets the text object's format. More... | |
~QTextObject () | |
Destroys the text object. More... | |
Protected Functions inherited from QObject | |
virtual void | childEvent (QChildEvent *) |
This event handler can be reimplemented in a subclass to receive child events. More... | |
virtual void | connectNotify (const char *signal) |
This virtual function is called when something has been connected to signal in this object. More... | |
virtual void | customEvent (QEvent *) |
This event handler can be reimplemented in a subclass to receive custom events. More... | |
virtual void | disconnectNotify (const char *signal) |
This virtual function is called when something has been disconnected from signal in this object. More... | |
QObject (QObjectPrivate &dd, QObject *parent=0) | |
int | receivers (const char *signal) const |
Returns the number of receivers connected to the signal. More... | |
QObject * | sender () const |
Returns a pointer to the object that sent the signal, if called in a slot activated by a signal; otherwise it returns 0. More... | |
int | senderSignalIndex () const |
virtual void | timerEvent (QTimerEvent *) |
This event handler can be reimplemented in a subclass to receive timer events for the object. More... | |
Protected Variables inherited from QObject | |
QScopedPointer< QObjectData > | d_ptr |
Static Protected Variables inherited from QObject | |
static const QMetaObject | staticQtMetaObject |
Related Functions inherited from QObject | |
T | qFindChildqFindChildren (const QObject *obj, const QString &name)() |
QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QString &name)() |
QList< T > | qFindChildrenqFindChildren (const QObject *obj, const QRegExp ®Exp)() |
T * | qobject_cast (QObject *object) |
QObjectList | |
void * | qt_find_obj_child (QObject *parent, const char *type, const QString &name) |
Returns a pointer to the object named name that inherits type and with a given parent. More... | |
The QTextList class provides a decorated list of items in a QTextDocument.
A list contains a sequence of text blocks, each of which is marked with a bullet point or other symbol. Multiple levels of lists can be used, and the automatic numbering feature provides support for ordered numeric and alphabetical lists.
Lists are created by using a text cursor to insert an empty list at the current position or by moving existing text into a new list. The QTextCursor::insertList() function inserts an empty block into the document at the cursor position, and makes it the first item in a list.
The QTextCursor::createList() function takes the contents of the cursor's current block and turns it into the first item of a new list.
The cursor's current list is found with QTextCursor::currentList().
The number of items in a list is given by count(). Each item can be obtained by its index in the list with the item() function. Similarly, the index of a given item can be found with itemNumber(). The text of each item can be found with the itemText() function.
Note that the items in the list may not be adjacent elements in the document. For example, the top-level items in a multi-level list will be separated by the items in lower levels of the list.
List items can be deleted by index with the removeItem() function. remove() deletes the specified item in the list.
The list's format is set with setFormat() and read with format(). The format describes the decoration of the list itself, and not the individual items.
Definition at line 57 of file qtextlist.h.
|
explicit |
Definition at line 124 of file qtextlist.cpp.
QTextList::~QTextList | ( | ) |
Definition at line 132 of file qtextlist.cpp.
void QTextList::add | ( | const QTextBlock & | block | ) |
Makes the given block part of the list.
Definition at line 332 of file qtextlist.cpp.
Referenced by QTextHtmlImporter::processBlockNode().
int QTextList::count | ( | ) | const |
Returns the number of items in the list.
Definition at line 139 of file qtextlist.cpp.
Referenced by QTextHtmlExporter::emitBlock().
|
inline |
Returns the list's format.
Definition at line 80 of file qtextlist.h.
Referenced by QTextHtmlExporter::emitBlock(), QTextControlPrivate::indent(), itemText(), QTextControlPrivate::outdent(), remove(), and QTextOdfWriter::writeBlock().
|
inline |
Returns true if the list has no items; otherwise returns false.
Note: Empty lists are automatically deleted by the QTextDocument that owns them.
Definition at line 66 of file qtextlist.h.
QTextBlock QTextList::item | ( | int | i | ) | const |
Returns the {i}-th text block in the list.
Definition at line 150 of file qtextlist.cpp.
Referenced by itemText().
int QTextList::itemNumber | ( | const QTextBlock & | block | ) | const |
Returns the index of the list item that corresponds to the given block.
Returns -1 if the block was not present in the list.
Definition at line 185 of file qtextlist.cpp.
Referenced by QTextHtmlExporter::emitBlock(), and QTextControlPrivate::indent().
QString QTextList::itemText | ( | const QTextBlock & | block | ) | const |
Returns the text of the list item that corresponds to the given block.
Definition at line 199 of file qtextlist.cpp.
void QTextList::remove | ( | const QTextBlock & | block | ) |
Removes the given block from the list.
Definition at line 319 of file qtextlist.cpp.
Referenced by QTextControlPrivate::keyPressEvent(), QPlainTextEdit::keyReleaseEvent(), and QTextEdit::keyReleaseEvent().
void QTextList::removeItem | ( | int | i | ) |
Removes the item at item position i from the list.
When the last item in the list is removed, the list is automatically deleted by the QTextDocument that owns it.
Definition at line 303 of file qtextlist.cpp.
|
inline |
Sets the list's format to format.
Definition at line 87 of file qtextlist.h.
Referenced by QTextControlPrivate::indent(), and QTextControlPrivate::outdent().