<QtClassHelperMacros>
Macros de ayuda para clases. Más...
| Header: | #include <QtClassHelperMacros> |
Macros
| Q_DISABLE_COPY(Class) | |
| Q_DISABLE_COPY_MOVE(Class) | |
(since 6.9) | Q_DISABLE_COPY_MOVE_X(Class, reason) |
(since 6.9) | Q_DISABLE_COPY_X(Class, reason) |
Documentación de macros
Q_DISABLE_COPY(Class)
Desactiva el uso de constructores de copia y operadores de asignación para la clase ` Class` indicada.
Las instancias de las subclases de ` QObject ` no deben considerarse valores que puedan copiarse o asignarse, sino identidades únicas. Esto significa que, cuando crees tu propia subclase de ` QObject ` (directa o indirecta), no debes dotarla de un constructor de copia ni de un operador de asignación. Sin embargo, puede que no baste con simplemente omitirlos en tu clase, ya que, si por error escribes algún código que requiera un constructor de copia o un operador de asignación (algo fácil de hacer), tu compilador se encargará de crearlos por ti. Debes hacer algo más.
El usuario curioso habrá observado que las clases de Qt derivadas de QObject suelen incluir esta macro en una sección privada:
class MyClass : public QObject
{
private:
Q_DISABLE_COPY(MyClass)
};Declara un constructor de copia y un operador de asignación en la sección privada, de modo que, si los utilizas por error, el compilador te indicará un error.
class MyClass : public QObject
{
private:
MyClass(const MyClass &) = delete;
MyClass &operator=(const MyClass &) = delete;
};Pero es posible que ni siquiera esto detecte absolutamente todos los casos. Podrías sentir la tentación de hacer algo como esto:
En primer lugar, no lo hagas. La mayoría de los compiladores generarán código que utilice el constructor de copia, por lo que se informará del error de violación de privacidad, pero tu compilador de C++ no está obligado a generar código para esta instrucción de una manera específica. Podría generar código que no utilice ni el constructor de copia ni el operador de asignación que hemos marcado como privados. En ese caso, no se notificaría ningún error, pero tu aplicación probablemente se bloquearía al llamar a una función miembro de ` w`.
Véase también Q_DISABLE_COPY_MOVE y Q_DISABLE_COPY_X.
Q_DISABLE_COPY_MOVE(Class)
Una macro de conveniencia que deshabilita el uso de constructores de copia, operadores de asignación, constructores de traslado y operadores de asignación de traslado para el objeto dado ` Class`.
Véase también Q_DISABLE_COPY y Q_DISABLE_COPY_MOVE_X.
[since 6.9] Q_DISABLE_COPY_MOVE_X(Class, reason)
Al igual que ` Q_DISABLE_COPY_MOVE`, esta macro desactiva las operaciones de copia y desplazamiento para la clase ` Class`.
Además, esto documenta en reason por qué esta clase no admite operaciones de copia ni de traslado. En C++26, esto hará que el compilador indique ese motivo en su mensaje de error ante cualquier código que intente realizar estas operaciones no admitidas.
Esta macro se introdujo en Qt 6.9.
Véase también Q_DISABLE_COPY_X y Q_DECL_EQ_DELETE_X.
[since 6.9] Q_DISABLE_COPY_X(Class, reason)
Al igual que Q_DISABLE_COPY, esta macro desactiva las operaciones de copia para la clase Class.
Además, esto documenta en reason por qué esta clase no admite operaciones de copia. En C++26, esto hará que el compilador indique ese motivo en su mensaje de error ante cualquier código que intente realizar estas operaciones no admitidas.
Esta macro se introdujo en Qt 6.9.
Véase también Q_DISABLE_COPY, Q_DISABLE_COPY_MOVE_X y Q_DECL_EQ_DELETE_X.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.