En esta página

Estructura del documento

Los comandos de estructuración del documento sirven para dividir el documento en secciones. QDoc admite cuatro niveles de sección: \section1, \section2, \section3 y \section4. Los comandos de sección se corresponden con los conceptos tradicionales de sección, subsección, etc., utilizados en la creación de esquemas.

Comandos de sección

En general, un comando de estructuración de documentos considera como argumento todo lo que le sigue hasta el primer salto de línea. El argumento se muestra como el título de la unidad. Si el título debe ocuparse varias líneas, asegúrate de que cada línea (excepto la última) termine con una barra invertida.

En total, hay cuatro niveles de secciones en QDoc: \section1, \section2, \section3 y \section4. Estos se corresponden con los niveles tradicionales de sección, subsección, subsubsección y subsubsubsección.

Existe un orden estricto de las unidades de sección:

section1
      |
      section2
             |
             section3
                    |
                    section4

Cuando se utilizan secciones, el primer comando de sección debe ser section1.

/*!
    \section1 Basic Qt

    This is the first section.


        \section2 Getting Started

        This is the first subsection.


            \section3 Hello Qt

            This is the first subsubsection.


            \section3 Making Connections

            This is the second subsubsection.


            \section3 Using the Reference Documentation

            This is the third subsubsection.


        \section2 Creating Dialogs

        This is the second subsection.


            \section3 Subclassing QDialog

            This is the first subsubsection.

            ...


    \section1 Intermediate Qt

    This is the second section.


        \section2 Layout Management

        This is the second section's first subsection.


            \section3 Basic Layouts

            This is the first subsubsection.

        ...
*/

Cada sección constituye una unidad lógica del documento. El título de la sección aparece en la tabla de contenidos generada automáticamente, que suele aparecer en la esquina superior derecha de la página.

\section1

El comando « \section1 » inicia una nueva sección.

Consulta «Comandos de sección» para obtener una explicación de las distintas unidades de sección, los argumentos de los comandos y su representación.

\section2

El comando « \section2 » inicia una nueva sección.

Consulte «Comandos de sección » para obtener una explicación sobre las distintas unidades de sección, los argumentos de los comandos y su representación.

\section3

El comando ` \section3 ` inicia una nueva sección.

Consulte «Comandos de sección » para obtener una explicación sobre las distintas unidades de sección, los argumentos de los comandos y su representación.

\section4

El comando « \section4 » inicia una nueva sección.

Consulte «Comandos de sección » para obtener una explicación sobre las distintas unidades de sección, los argumentos de los comandos y su representación.

© 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.