QPointer Class

Description détaillée

Un pointeur gardé, QPointer<T>, se comporte comme un pointeur C++ normal T *, sauf qu'il est automatiquement effacé lorsque l'objet référencé est détruit (contrairement aux pointeurs C++ normaux, qui deviennent des "pointeurs pendants" dans de tels cas). T doit être une sous-classe de QObject.

Les pointeurs gardés sont utiles lorsque vous devez stocker un pointeur sur un objet QObject qui appartient à quelqu'un d'autre et qui risque donc d'être détruit alors que vous détenez toujours une référence sur cet objet. Vous pouvez tester la validité du pointeur en toute sécurité.

Notez que Qt 5 introduit un léger changement de comportement lors de l'utilisation de QPointer.

• Lors de l'utilisation de QPointer sur QWidget (ou une sous-classe de QWidget), le QPointer était auparavant effacé par le destructeur de QWidget. Désormais, le QPointer est effacé par le destructeur QObject (puisque c'est à ce moment-là que les objets QWeakPointer sont effacés). Les QPointer qui suivent un widget ne seront PAS effacés avant que le destructeur QWidget ne détruise les enfants du widget suivi.

Qt XML fournit également QSharedPointer, une implémentation d'un objet pointeur partagé à comptage de références, qui peut être utilisé pour maintenir une collection de références à un pointeur individuel.

Exemple :

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

Si QLabel est supprimé entre-temps, la variable label contiendra nullptr au lieu d'une adresse invalide, et la dernière ligne ne sera jamais exécutée.

Les fonctions et les opérateurs disponibles avec un QPointer sont les mêmes que ceux disponibles avec un pointeur normal non protégé, à l'exception des opérateurs arithmétiques de pointeur (+, -, ++, et --), qui ne sont normalement utilisés qu'avec des tableaux d'objets.

Utilisez les QPointers comme des pointeurs normaux et vous n'aurez pas besoin de lire la documentation de cette classe.

Pour créer des pointeurs gardés, vous pouvez les construire ou les assigner à partir d'un T* ou d'un autre pointeur gardé du même type. Vous pouvez les comparer entre eux en utilisant operator==() et operator!=(), ou tester nullptr avec isNull(). Vous pouvez les déréférencer en utilisant la notation *x ou x->member.

Un pointeur gardé sera automatiquement transformé en T *, de sorte que vous pouvez librement mélanger des pointeurs gardés et non gardés. Cela signifie que si vous avez un QPointer<QWidget>, vous pouvez le passer à une fonction qui nécessite un QWidget *. Pour cette raison, il est peu utile de déclarer des fonctions qui prennent un QPointer en paramètre ; il suffit d'utiliser des pointeurs normaux. Utilisez un QPointer lorsque vous stockez un pointeur dans le temps.

Notez que la classe T doit hériter de QObject, sous peine d'erreur de compilation ou de liaison.