QPointer Class

Detaillierte Beschreibung

Ein geschützter Zeiger, QPointer<T>, verhält sich wie ein normaler C++-Zeiger T *, außer dass er automatisch gelöscht wird, wenn das referenzierte Objekt zerstört wird (im Gegensatz zu normalen C++-Zeigern, die in solchen Fällen zu "baumelnden Zeigern" werden). T muss eine Unterklasse von QObject sein.

Guarded Pointer sind immer dann nützlich, wenn Sie einen Zeiger auf ein QObject speichern müssen, das jemand anderem gehört und daher zerstört werden könnte, während Sie noch einen Verweis darauf halten. Sie können den Zeiger sicher auf seine Gültigkeit testen.

Beachten Sie, dass Qt 5 eine leichte Änderung im Verhalten bei der Verwendung von QPointer einführt.

• Bei der Verwendung von QPointer auf QWidget (oder einer Unterklasse von QWidget) wurde der QPointer bisher durch den Destruktor von QWidget gelöscht. Jetzt wird der QPointer durch den QObject destructor gelöscht (da dies der Fall ist, wenn QWeakPointer Objekte gelöscht werden). Alle QPointer, die ein Widget verfolgen, werden NICHT gelöscht, bevor der QWidget Destruktor die Kinder des verfolgten Widgets vernichtet.

Qt bietet auch QSharedPointer, eine Implementierung eines referenzgezählten Shared-Pointer-Objekts, das verwendet werden kann, um eine Sammlung von Referenzen auf einen individuellen Zeiger zu verwalten.

Beispiel:

    QPointer<QLabel> label = new QLabel;
    label->setText("&Status:");
    ...
    if (label)
        label->show();

Wenn QLabel in der Zwischenzeit gelöscht wird, enthält die Variable label nullptr anstelle einer ungültigen Adresse, und die letzte Zeile wird nie ausgeführt.

Die Funktionen und Operatoren, die mit einem QPointer zur Verfügung stehen, sind die gleichen wie die, die mit einem normalen ungeschützten Zeiger zur Verfügung stehen, mit Ausnahme der arithmetischen Zeigeroperatoren (+, -, ++ und --), die normalerweise nur mit Arrays von Objekten verwendet werden.

Verwenden Sie QPointers wie normale Zeiger und Sie brauchen diese Klassendokumentation nicht zu lesen.

Um Guarded Pointer zu erstellen, können Sie sie aus einem T* oder einem anderen Guarded Pointer desselben Typs konstruieren oder zuweisen. Sie können sie mit operator==() und operator!=() miteinander vergleichen oder mit isNull() auf nullptr testen. Sie können sie entweder mit der *x oder der x->member Notation dereferenzieren.

Ein bewachter Zeiger wird automatisch in einen T * umgewandelt, so dass Sie bewachte und unbewachte Zeiger frei mischen können. Das bedeutet, dass Sie einen QPointer<QWidget> an eine Funktion übergeben können, die einen QWidget * benötigt. Aus diesem Grund ist es wenig sinnvoll, Funktionen so zu deklarieren, dass sie einen QPointer als Parameter annehmen; verwenden Sie einfach normale Zeiger. Verwenden Sie einen QPointer, wenn Sie einen Zeiger über einen längeren Zeitraum speichern wollen.

Beachten Sie, dass die Klasse T von QObject erben muss, da sonst ein Kompilierungs- oder Verknüpfungsfehler auftritt.