Uso Qt Assistant

Puedes leer la documentación en la ventana «Documentación ». Para abrir un tema en una nueva pestaña, haz clic con el botón derecho del ratón sobre él en la ventana «Índice» para abrir un menú contextual y selecciona «Abrir enlace en una nueva pestaña». Todos los temas abiertos aparecen en la ventana «Páginas abiertas ». Selecciona un tema para verlo en la ventana «Documentación ».
Si quieres que la ventana «Documentación» ocupe el máximo espacio posible, puedes agrupar, mover u ocultar fácilmente las ventanas de la barra lateral. Para agrupar las ventanas, arrastra una sobre otra y suelta el ratón. Si no se muestran una o todas las ventanas de la barra lateral, utiliza los atajos de teclado para mostrarlas. Puedes consultar los atajos de teclado en el menú «Ver ».
Las ventanas de la barra lateral se pueden acoplar a la ventana principal, por lo que puedes arrastrarlas a la parte superior, izquierda, derecha o inferior de la ventana principal, o bien arrastrarlas fuera de Qt Assistant para que floten como ventanas independientes.
Para cambiar la familia y el tamaño de fuente de la ventana del navegador en la que se muestra la documentación o de la propia aplicación, selecciona Edición > Preferencias > Fuentes.

Para aumentar o reducir temporalmente el tamaño de la fuente en la ventana de documentación, selecciona «Ver» > «Acercar» o «Alejar». Para restablecer el tamaño de la fuente, selecciona «Ver » > «Tamaño normal».
Para navegar entre páginas, selecciona Ir a > Anterior o Siguiente. Esto te lleva a la página anterior o siguiente del historial. Para volver a la página de inicio, selecciona Ir a > Inicio. Para especificar la página de inicio, selecciona Edición > Preferencias > Opciones.
Para sincronizar la ventana «Índice» con la página que se muestra actualmente en la ventana «Documentación», selecciona Ir > Sincronizar con el índice.
La barra de direcciones ofrece una forma rápida de introducir una URL específica para un archivo de documentación. Para mostrar la barra de direcciones, selecciona Ver > Barras de herramientas > Barra de direcciones.
Búsqueda en el contenido de la página
Para buscar texto en la página actual, selecciona Edición > Buscar en el texto. Introduce el término de búsqueda en el campo. La búsqueda es incremental, lo que significa que se muestra el resultado más relevante a medida que introduces caracteres en el campo.
Si marcas la casilla «Distinguir mayúsculas y minúsculas», la búsqueda tendrá en cuenta las mayúsculas y minúsculas del término de búsqueda. Por ejemplo, si buscas «spin», se encontrarán coincidencias con «spin», pero no con «Spin».
Para buscar hacia adelante o hacia atrás desde la posición actual en la página, haz clic en «Anterior » o «Siguiente».
Para ocultar el control de búsqueda, haz clic en «Cerrar» o pulsa Esc.
Búsqueda de texto completo
Qt Assistant para navegar por la documentación" src="images/assistant-search.png" title="Captura de pantalla del menú de búsqueda de Qt Assistant para navegar por la documentación"/>
Qt Assistant ofrece un potente motor de búsqueda de texto completo. Puede buscar determinadas palabras o texto en la ventana «Buscar ». Introduzca el texto que desea buscar y pulse Intro o haga clic en «Buscar». La búsqueda no distingue entre mayúsculas y minúsculas. Por ejemplo, «Foo», «fOo» y «FOO» se tratan todos como lo mismo.
Puede crear consultas complejas utilizando la sintaxis de consultas FTS.
A continuación se muestran ejemplos de patrones de búsqueda habituales:
deep– muestra todos los documentos que contienen la palabra «deep»deep*– muestra todos los documentos que contienen una palabra que empiece por «deep»deep copy– muestra todos los documentos que contengan tanto «deep » como «copy»"deep copy"– muestra todos los documentos que contengan la frase «deep copy»
La lista de documentos encontrados se ordena según el número de veces que aparece el texto de búsqueda en cada uno de ellos, apareciendo en primer lugar aquellos que contienen el mayor número de apariciones. Basta con hacer clic en cualquier documento de la lista para mostrarlo en la ventana «Documentación ».
Si la documentación ha cambiado —por ejemplo, si se han añadido o eliminado documentos—, « Qt Assistant » los indexará de nuevo.
Filtrado del contenido de la ayuda
Qt Assistant te permite instalar cualquier tipo de documentación siempre que esté organizada en archivos de ayuda comprimidos de Qt (*.qch). Por ejemplo, puedes consultar la documentación de referencia de Qt para varias versiones de Qt al mismo tiempo. En muchos aspectos, esto resulta muy práctico, ya que solo se necesita una versión de Qt Assistant. Sin embargo, al mismo tiempo se complica la realización de tareas como la búsqueda en el índice, ya que la mayoría de las palabras clave están definidas en más de una versión de Qt XML. Esto significa que Qt Assistant siempre pedirá al usuario que elija cuál debe mostrarse.
Utilizamos filtros de documentación para resolver este problema. Un filtro se identifica por su nombre y contiene una lista de atributos de filtro. Un atributo es simplemente una cadena de caracteres y se puede elegir libremente. Los atributos los define la propia documentación, lo que significa que cada conjunto de documentación suele tener uno o más atributos.
Por ejemplo, la documentación de Qt Assistant define los atributos assistant y tools, mientras que Qt Widgets Designer define designer y tools. El filtro para mostrar todas las herramientas definiría entonces únicamente el atributo tools, ya que este atributo forma parte de ambos conjuntos de documentación. Si se añade el atributo assistant al filtro, solo se mostrará la documentación Qt Assistant, ya que la documentación Qt Widgets Designer no contiene este atributo. Si la lista de atributos de un filtro está vacía, se mostrará toda la documentación. Es decir, equivale a solicitar la documentación sin filtrar.
Para crear y eliminar filtros de documentación, selecciona Editar > Preferencias > Filtros.

Para añadir un nuevo filtro, haz clic en «Añadir», especifica un nombre para el filtro y haz clic en «Aceptar». A continuación, selecciona los atributos del filtro en el campo «Atributos ».
Para eliminar un filtro, selecciónalo y haz clic en «Eliminar».
La barra de herramientas de filtros te permite aplicar un filtro a la documentación instalada actualmente. Para mostrar la barra de herramientas de filtros, selecciona Ver > Barras de herramientas > Barra de herramientas de filtros.
Añadir documentación
Para instalar y eliminar archivos de ayuda comprimidos, selecciona Edición > Preferencias > Documentación.

Haz clic en el botón «Instalar» y elige la ruta del archivo de ayuda comprimido (*.qch) que deseas instalar. Para eliminar un archivo de ayuda, selecciona un conjunto de documentación de la lista y haz clic en «Eliminar».
Nota: Los archivos de ayuda comprimidos de Qt (.qch) solo deben cargarse desde fuentes fiables.
Especificar la página de inicio
Para especificar la página de inicio que muestra Qt Assistant al hacer clic en el botón «Inicio», selecciona Edición > Preferencias > Opciones.

Introduce la URL de la página de inicio o selecciona «Página actual » para establecer la página que se muestra actualmente como tu página de inicio. Para dejar la página de inicio en blanco, selecciona «Página en blanco». Selecciona «Restablecer valores predeterminados » para restablecer tu página de inicio a la página predeterminada.
Uso de opciones de línea de comandos
Qt Assistant admite las siguientes opciones de línea de comandos:
| Opción de línea de comandos | Breve descripción |
|---|---|
| -collectionFile <archivo.qhc> | Utiliza el archivo de colección especificado en lugar del predeterminado. |
| -showUrl <URL> | Muestra el documento al que hace referencia la URL. |
| -enableRemoteControl | Habilita el control remoto de « Qt Assistant ». |
| -show <widget> | Muestra la ventana de la barra lateral especificada, que puede ser «contenido», «índice», «marcadores» o «búsqueda». |
| -hide <widget> | Oculta la ventana de la barra lateral especificada, que puede ser «contenido», «índice», «marcadores» o «búsqueda». |
| -activate <widget> | Activa la ventana de la barra lateral especificada, que puede ser «contenido», «índice», «marcadores» o «búsqueda». |
| -register <doc.qch> | Registra el archivo de ayuda comprimido especificado en la colección de ayuda indicada. |
| -unregister <doc.qch> | Da de baja el archivo de ayuda comprimido especificado de la colección indicada. |
| -remove-search-index | Purgará el índice del motor de búsqueda de la ayuda. Esta opción resulta útil en caso de que los archivos de índice asociados se dañen. La opción « Qt Assistant » volvería a indexar la documentación en el siguiente inicio. |
| -rebuild-search-index | Reconstruye el índice del motor de búsqueda de la ayuda. Ten en cuenta que esta operación puede tardar un rato en completarse. |
| -setCurrentFilter <filtro> | Establece el filtro indicado como filtro activo. |
| -quiet | No muestra ningún mensaje de error, advertencia o éxito. |
© 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.