表格和列表
使用这些命令可以创建列表和表格。列表将作为单独段落左对齐显示。表格作为单独段落居中显示。表格的宽度取决于其内容的宽度。
\表格
\table 和 \endtable 命令对表格内容进行定界。
该命令接受一个参数，指定表格宽度占页面宽度的百分比：
/*!
\table 100 %
...
\endtable
*/
上面的代码可以确保表格填满所有可用空间。如果表格宽度小于 100%，生成的文档中表格将居中。
表格可以包含标题、行和列。行以\row命令开始，由单元格组成，每个单元格以\li命令开始。还有一个\header命令，它是一种具有特殊格式的特殊行。
/*!
\table
\header
\li Qt Core Feature
\li Brief Description
\row
\li \l {Signal and Slots}
\li Signals and slots are used for communication
between objects.
\row
\li \l {Layout Management}
\li The Qt layout system provides a simple
and powerful way of specifying the layout
of child widgets.
\row
\li \l {Drag and Drop}
\li Drag and drop provides a simple visual
mechanism which users can use to transfer
information between and within applications.
\endtable
*/
你还可以让单元格跨行跨列。例如
/*!
\table
\header
\li {3,1} This header cell spans three columns,
but only one row.
\row
\li {2, 1} This table cell spans two columns,
but only one row
\li {1, 2} This table cell spans only one column,
but two rows.
\row
\li A regular table cell
\li A regular table cell
\endtable
*/
\页眉
\header 命令表示以下表格单元格是当前表格的列头。
该命令只能在 \table...\endtable命令中使用。一个表头可以包含多个单元格。使用\li命令创建单元格。
页眉单元格的文本在表格单元格中居中，并使用粗体字体渲染。
/*!
\table
\header
\li Qt Core Feature
\li Brief Description
\row
\li \l {Signal and Slots}
\li Signals and slots are used for communication
between objects.
\endtable
*/
\行
\row 命令在表格中开始新的一行。属于新行的（li）项将紧跟在（row）之后。
该命令只能在 \table...\endtable命令中使用。一行可以包含多个单元格。一个单元格用\li命令创建。
每一行的单元格背景颜色在两种灰色之间交替，这样更容易区分行与行之间的区别。单元格的内容左对齐。
/*!
\table
\header
\li Qt Core Feature
\li Brief Description
\row
\li \l {Signal and Slots}
\li Signals and slots are used for communication
between objects.
\row
\li \l {Layout Management}
\li The Qt layout system provides a simple
and powerful way of specifying the layout
of child widgets.
\row
\li \l {Drag and Drop}
\li Drag and drop provides a simple visual
mechanism which users can use to transfer
information between and within applications.
\endtable
*/
\值
\value 命令开始记录 C++ 枚举项。
该命令的第一个参数是值名。值名前面可以有一个用方括号括起来的可选的since子句。值描述位于值名称之后。说明在下一个空行或 \value 处结束。参数以表格形式显示。
注意： 要在值描述中包含图像，请使用\inlineimage命令。
如果没有since子句，\value 命令可能是这样的
带有since子句的同一命令会是这样的
文档将位于相关的类、头文件或命名空间文档中。有关示例，请参阅\enum文档。
注意： 自 Qt 5.4 起，\value 命令也可以在\enum主题之外使用。在这种情况下，QDoc 会渲染一个双列表格，列出常量名称（从第一个参数中获取）及其描述。例如，这可以用在（qmlproperty）主题中，记录 QML 枚举属性的可接受值。
\omitvalue
\omitvalue 命令从文档中排除一个 C++ 枚举项。
该命令的唯一强制性参数是将被省略的枚举项的名称。如果枚举项后面有单行描述，也会被省略。
有关示例，请参阅\enum文档。
\列表
list和endlist命令用于限定一个项目列表。
使用\li命令创建每个列表项。一个列表总是包含一个或多个项目。列表可以嵌套。例如
/*!
\list
\li Qt Reference Documentation: Getting Started
\list
\li How to Learn Qt
\li Installation
\list
\li Qt/X11
\li Qt/Windows
\li Qt/Mac
\li Qt/Embedded
\endlist
\li Tutorial and Examples
\endlist
\endlist
*/
\list 命令使用一个可选参数，为列表项提供其他外观。
/*!
\list
\li How to Learn Qt
\li Installation
\li Tutorial and Examples
\endlist
*/
如果为 \list 命令提供 "A "作为参数，则子弹会被按字母顺序排列的字符取代：
- 如何学习 Qt
- 安装
- 教程和示例
如果将 "A "替换为 "1"，列表项将按升序编号：
- 如何学习 Qt
- 安装
- 教程和示例
如果将 "i "作为参数，则子弹会被罗马数字取代：
- 如何学习 Qt
- 安装
- 教程和示例
最后，如果你提供 "I "作为可选参数，就可以让列表项以罗马数字升序排列：
- 如何学习 Qt
- 安装
- 教程和示例
你也可以让列表从任何字符或数字开始，只需提供你想从哪个数字或字符开始即可。例如
/*!
\list G
\li How to Learn Qt
\li Installation
\li Tutorial and Examples
\endlist
*/
See also\li.
\li （表格单元格、列表项）
\li 命令用于标记表格单元格或列表项。该命令仅用于表格和列表。
在下一条 \li 命令、下一条\endtable 或\endlist命令之前，它将所有内容都视为其参数。请参阅\table和\list示例。
如果在表格中使用该命令，还可以指定项目应跨几行或几列。
/*!
\table
\header
\li {3,1} This header cell spans three columns
but only one row.
\row
\li {2, 1} This table item spans two columns
but only one row
\li {1, 2} This table item spans only one column,
but two rows.
\row
\li A regular table item
\li A regular table item
\endtable
*/
如果没有指定，项目将跨一列和一行。
© 2025 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.
