QPointer Class

Ausführliche Beschreibung

Ein geschützter Zeiger, QPointer<T>, verhält sich wie ein normaler C++-Zeiger T *, mit dem Unterschied, 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 „dangling pointers“ werden). Der Template-Parameter ` T ` gibt den von ` QObject` abgeleiteten Typ an, auf den verwiesen wird; ` T ` muss eine Unterklasse von ` QObject` sein.

Geschützte Zeiger sind immer dann nützlich, wenn Sie einen Zeiger auf ein ` QObject ` speichern müssen, das einem anderen Objekt gehört und daher möglicherweise zerstört wird, während Sie noch eine Referenz darauf halten. Sie können den Zeiger sicher auf Gültigkeit prüfen.

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

• Bei der Verwendung von `QPointer` für ein ` QWidget ` (oder eine Unterklasse von ` QWidget`) wurde der `QPointer` bisher durch den Destruktor von ` QWidget ` gelöscht. Nun wird der `QPointer` durch den Destruktor von ` QObject ` gelöscht (da zu diesem Zeitpunkt die ` QWeakPointer `-Objekte gelöscht werden). Alle QPointer, die ein Widget verfolgen, werden NICHT gelöscht, bevor der Destruktor von ` QWidget ` die untergeordneten Elemente des verfolgten Widgets zerstört.

Qt stellt außerdem ` QSharedPointer` zur Verfügung, eine Implementierung eines referenzgezählten Shared-Pointer-Objekts, das verwendet werden kann, um eine Sammlung von Verweisen auf einen einzelnen Zeiger zu verwalten.

Beispiel:

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

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

Die für einen QPointer verfügbaren Funktionen und Operatoren entsprechen denen eines normalen, ungeschützten Zeigers, mit Ausnahme der Zeigerarithmetikoperatoren (+, -, ++ und --), die normalerweise nur bei Arrays von Objekten verwendet werden.

Verwenden Sie QPointers wie normale Zeiger, dann müssen Sie diese Klassendokumentation nicht lesen.

Um geschützte Zeiger zu erstellen, können Sie diese aus einem T* oder aus einem anderen geschützten Zeiger desselben Typs konstruieren oder ihnen einen Wert zuweisen. Sie können sie mithilfe der Operatoren ==() und !=() miteinander vergleichen oder mit isNull() prüfen, ob sie auf nullptr stehen. Sie können sie entweder mit der Notation *x oder x->member dereferenzieren.

Ein geschützter Zeiger wird automatisch in einen ` T *` umgewandelt, sodass Sie geschützte und ungeschützte Zeiger beliebig miteinander kombinieren können. Das bedeutet: Wenn Sie einen `QPointer<QWidget>` haben, können Sie diesen an eine Funktion übergeben, die einen ` QWidget *` benötigt. Aus diesem Grund ist es wenig sinnvoll, Funktionen zu deklarieren, die einen `QPointer` als Parameter erwarten; verwenden Sie stattdessen einfach normale Zeiger. Verwenden Sie einen `QPointer`, wenn Sie einen Zeiger über einen längeren Zeitraum hinweg speichern möchten.

Beachten Sie, dass die Klasse „ T “ von „ QObject “ erben muss, da es sonst zu einem Kompilierungs- oder Verknüpfungsfehler kommt.