QPointer Class

Descripción detallada

Un puntero protegido, QPointer<T>, se comporta como un puntero C++ normal T *, excepto que se borra automáticamente cuando se destruye el objeto referenciado (a diferencia de los punteros C++ normales, que se convierten en "punteros colgantes" en tales casos). T debe ser una subclase de QObject.

Los punteros protegidos son útiles cuando se necesita almacenar un puntero a QObject que pertenece a otra persona y que, por lo tanto, puede ser destruido mientras se tiene una referencia a él. Puedes comprobar con seguridad la validez del puntero.

Tenga en cuenta que Qt 5 introduce un ligero cambio en el comportamiento cuando se utiliza QPointer.

• Cuando se usa QPointer en un QWidget (o una subclase de QWidget), anteriormente el QPointer era borrado por el destructor QWidget. Ahora, el QPointer es borrado por el destructor QObject (ya que es cuando los objetos QWeakPointer son borrados). Cualquier QPointer que rastree un widget NO será borrado antes de que el destructor QWidget destruya los hijos del widget que está siendo rastreado.

Qt también proporciona QSharedPointer, una implementación de un objeto puntero compartido con contador de referencias, que puede usarse para mantener una colección de referencias a un puntero individual.

Ejemplo:

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

Si QLabel se borra mientras tanto, la variable label contendrá nullptr en lugar de una dirección inválida, y la última línea nunca se ejecutará.

Las funciones y operadores disponibles con un QPointer son los mismos que los disponibles con un puntero normal no protegido, excepto los operadores aritméticos de puntero (+, -, ++, y --), que normalmente sólo se utilizan con matrices de objetos.

Use QPointers como punteros normales y no necesitará leer la documentación de esta clase.

Para crear punteros protegidos, puedes construirlos o asignarlos desde un T* o desde otro puntero protegido del mismo tipo. Puedes compararlos entre sí utilizando operator==() y operator!=(), o comprobar nullptr con isNull(). Se puede hacer referencia a ellos utilizando la notación *x o x->member.

Un puntero protegido se convertirá automáticamente en un T *, por lo que puedes mezclar libremente punteros protegidos y no protegidos. Esto significa que si tienes un QPointer<QWidget>, puedes pasarlo a una función que requiera un QWidget *. Por esta razón, es de poco valor declarar funciones para tomar un QPointer como parámetro; simplemente usa punteros normales. Utilice un QPointer cuando esté almacenando un puntero en el tiempo.

Tenga en cuenta que la clase T debe heredar de QObject, o se producirá un error de compilación o enlace.