Qt para Windows: problemas específicos
Esta página contiene información sobre Qt para Windows.
Ubicación de instalación
Instalar Qt en un directorio que contenga espacios, por ejemplo, C:\Program Files, puede provocar problemas con qmake.
Instala Qt en un subdirectorio sin espacios para evitar este problema.
Longitud máxima de la ruta
La API de Win32 que utilizan tanto Qt como las herramientas del compilador tiene una longitud máxima de ruta de archivo de 260 caracteres (MAX_PATH). Esto puede afectarte de diversas formas si tus estructuras de directorios, ya sean absolutas o relativas, son demasiado extensas. Por lo tanto, se recomienda mantener las rutas del sistema de archivos dentro de los límites establecidos y colocar los directorios de compilación cerca de los directorios de código fuente.
Visual Studio
Si experimentas problemas extraños al utilizar opciones especiales que modifican la alineación de los miembros de estructuras y uniones (como /Zp2), tendrás que recompilar Qt con las opciones configuradas también para la aplicación.
Ventanas a pantalla completa basadas en OpenGL
Cuando una ventana utiliza una superficie basada en OpenGL y se muestra en modo de pantalla completa, pueden surgir problemas con otras ventanas de nivel superior que forman parte de la aplicación. Debido a las limitaciones del DWM de Windows, la composición no se gestiona correctamente para las ventanas basadas en OpenGL al pasar al modo de pantalla completa. Como resultado, las demás ventanas de nivel superior no se sitúan encima de la ventana a pantalla completa cuando se hacen visibles. Por ejemplo, es posible que los menús no aparezcan correctamente o que los cuadros de diálogo no se muestren.
Una ventana puede utilizar una superficie basada en OpenGL, ya sea de forma explícita al llamar a setSurfaceType(), o cuando se utiliza dentro de la ventana algún elemento que requiera OpenGL, lo que hace que toda la ventana se base en OpenGL. Por ejemplo, QOpenGLWidget o QQuickWidget pueden provocar esto. Sin embargo, si la superficie está contenida en un QWindow alojado con createWindowContainer(), o si se utiliza el obsoleto QGLWidget y este cubre toda la ventana a pantalla completa, entonces este problema no se produce.
Para resolver este problema, se pueden utilizar las API nativas para habilitar el atributo « WS_BORDER » al mostrar la ventana en modo de pantalla completa. Esto se puede aplicar de la siguiente manera:
bool Widget::event(QEvent *e) {
#if defined(Q_OS_WIN)
if (e->type() == QEvent::WinIdChange) {
if (windowHandle()) {
HWND handle = reinterpret_cast<HWND>(windowHandle()->winId());
SetWindowLongPtr(handle, GWL_STYLE, GetWindowLongPtr(handle, GWL_STYLE) | WS_BORDER);
}
}
#endif
return QWidget::event(e);
}Esto dotará a la ventana a pantalla completa de un borde de 1 píxel, lo que permitirá que las demás ventanas de nivel superior aparezcan por encima.
Inicialización de OLE
Qt utiliza OLE en Windows para poder admitir funcionalidades como el arrastre o el acceso al portapapeles. Para utilizar OLE, Qt tiene que llamar a `OleInitialize`. Esto, a su vez, establecerá el modelo de concurrencia del hilo en ` COINIT_APARTMENTTHREADED`.
Llamar a ` CoInitializeEx ` o ` winrt::init_apartment ` en el hilo de la interfaz de usuario y especificar un modelo de concurrencia distinto de «single-threaded apartment» (COINIT_APARTMENTTHREADED o winrt::apartment_type::single_threaded, respectivamente) podría provocar errores o que la aplicación se cuelgue.
© 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.