QPointer Class

Description détaillée

Un pointeur protégé, QPointer<T>, se comporte comme un pointeur C++ normal T *, à l’exception qu’il est automatiquement réinitialisé lorsque l’objet référencé est détruit (contrairement aux pointeurs C++ normaux, qui deviennent des « pointeurs pendants » dans de tels cas). Le paramètre de modèle ` T ` spécifie le type dérivé de ` QObject` vers lequel pointe le pointeur ; ` T ` doit être une sous-classe de ` QObject`.

Les pointeurs protégés sont utiles chaque fois que vous devez stocker un pointeur vers une « QObject » appartenant à quelqu’un d’autre, et qui pourrait donc être détruite alors que vous en détenez encore une référence. Vous pouvez vérifier 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 une QWidget (ou une sous-classe de QWidget), auparavant, le QPointer était effacé par le destructeur de QWidget. Désormais, le QPointer est effacé par le destructeur de QObject (puisque c’est à ce moment-là que les objets QWeakPointer sont effacés). Les QPointers pointant vers un widget ne seront PAS libérés avant que le destructeur de QWidget ne détruise les enfants du widget concerné.

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

Exemple :

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

Si l’ 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 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 d’arithmétique de pointeurs (+, -, ++ 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 protégés, vous pouvez les construire ou leur attribuer une valeur à partir d’un T* ou d’un autre pointeur protégé du même type. Vous pouvez les comparer entre eux à l’aide des opérateurs ==() et !=(), ou vérifier s’ils sont de type nullptr à l’aide de isNull(). Vous pouvez les déréférencer en utilisant soit la notation *x, soit la notation x->member.

Un pointeur protégé sera automatiquement converti en T *, ce qui vous permet de mélanger librement les pointeurs protégés et non protégés. Cela signifie que si vous disposez d’un QPointer<QWidget>, vous pouvez le passer à une fonction qui requiert un QWidget *. Pour cette raison, il n’est guère utile de déclarer des fonctions prenant un QPointer en paramètre ; utilisez simplement des pointeurs normaux. Utilisez un QPointer lorsque vous stockez un pointeur pendant un certain temps.

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