包括图片

图形命令使在文档中插入图片成为可能。图片可以单独成段落显示，或嵌入到正文文本中。

\image

\image命令扩展为指定于其第一个参数中的图片，并以单独段落的居中方式渲染。

该命令有两个参数。第一个参数是图片文件的名称。第二个参数是可选的，是对图片的简单描述，相当于HTML标签中的alt=""。描述用于工具提示以及不支持图片的浏览器，如Lynx文本浏览器。

文件名之后的所有文本是该可选的描述参数。务必在文件名或描述之后添加换行符。如果描述参数跨越多行，则需要使用大括号。

/*!
    Qt is a C++ toolkit for cross-platform GUI application development.

    \image happyguy.jpg "Happy guy"

    Qt provides single-source portability across Microsoft
    Windows, macOS, Linux, and all major commercial Unix
    variants. It is also available for embedded devices.
*/

参见\inlineimage和\caption。

\inlineimage

\inlineimage命令扩展为指定于其参数中的图片。图片以文本的内置方式渲染。

该命令有两个参数。第一个参数是图片文件的名称。第二个参数是可选的，是在花括号{}内的图片简单描述，相当于HTML标签中的alt=""。描述用于工具提示及当浏览器不支持图片时，如Lynx文本浏览器。

\inlineimage命令最常见的用途是在列表和表格中使用。以下是如何在列表中嵌入内联图片的示例

/*!
    \list 1
      \li \inlineimage happy.gif {Oh so happy, I am a caption!}
      \li \inlineimage happy.gif Oh so happy, but I'm not a caption.
    \endlist
*/

以下是如何在表格中嵌入内联图片的示例

/*!
    \table
    \header
        \li Qt
        \li Qt Creator
    \row
        \li \inlineimage happy.gif {Oh so happy!}
        \li \inlineimage happy.gif Oh so happy!
    \row
        \li \inlineimage happy.gif Oh so happy!
        \li \inlineimage happy.gif {Oh so happy!}
    \endtable
*/

该命令也可以将图片内嵌到文本中。

/*!
    \inlineimage training.jpg {Qt Training} The Qt Programming course is
    offered as a five day Open Enrollment Course. The classes are open to
    the public. Although the course is open to anyone who wants to learn,
    attendees should have significant experience in C++ development to
    derive maximum benefit from the course.
*/

参见\image和\caption。

\caption

\caption命令为图片提供标题。

该命令将直到段落结束的所有文本视为标题。试验直到得到您想要的效果。

/*!
  \table 100%
    \row
      \li \image windows-pushbutton.png
         \caption The QPushButton widget provides a command button.
      \li \image windows-toolbutton.png
         \caption The QToolButton class provides a quick-access button to commands
         or options, usually used inside a QToolBar.
   \endtable
*/

参见\image和\inlineimage。

创建链接表格与列表