表とリスト
これらのコマンドにより、リストと表を作成することができます。リストは独立した段落として左揃えで表示されます。表は独立した段落として中央揃えで表示されます。表の幅は内容の幅に依存します。
\table
\table と\endtable コマンドは表の内容を区切る。
このコマンドは、テーブルの幅をページ幅に対するパーセンテージで指定する引数を1つ受け付ける：
/*!
\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, \rowおよび \li.
\header
\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
\row コマンドはテーブルの新しい行を開始する。新しい行に属する\li の項目は、\row の直後に続く。
このコマンドは、\table...\endtable コマンド内でのみ使用できる。行は複数のセルを含むことができる。セルは\liコマンドで作成される。
各行のセルの背景色は2つのグレーの濃淡が交互に表示され、行と行の区別がつきやすくなる。セルの内容は左揃えになる。
/*!
\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
\value コマンドは、C++ enum項目のドキュメントを開始する。
コマンドの最初の引数は値名です。値名の前には、角括弧で囲まれたオプションのsince句を置くことができる。値の説明は値名の後に続く。説明は、次の空行または\value で終了します。 引数は表で表示されます。
注： \value の説明に画像を含めるには \inlineimageコマンドを使用する。
since句がない場合、\value コマンドは次のようになる：
同じコマンドにsince句をつけると次のようになる：
ドキュメントは、関連するクラス、ヘッダーファイル、名前空間のドキュメントにあります。ドキュメントは関連するクラス、ヘッダーファイル、名前空間のドキュメントにあります。 \enumドキュメントを参照してください。
注: Qt 5.4 以降、\value コマンドはトピックの外でも使用できます。 \enumトピックの外でも使用できます。この場合、QDocは定数名（最初の引数からそのまま取られる）とその説明を列挙した2列の表を表示します。これは例えば \qmlpropertyトピックで使用することができます。
また \enumおよび \omitvalue.
\omitvalue
\omitvalue コマンドは、C++ の列挙項目をドキュメントから除外します。
このコマンドの唯一の必須引数は、省略される列挙項目の名前です。enum 項目の後に 1 行の説明が続く場合、その説明も省略されます。
例については \enumドキュメントを参照のこと。
\list
\list と\endlist コマンドは項目のリストを区切る。
各リスト項目は \liコマンドで作成する。リストは常に1つ以上の項目を含む。リストは入れ子にすることができる。例えば
/*!
\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
*/以下も参照してください。 \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
*/指定しない場合、項目は1列1行にまたがる。
© 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.
