表とリスト
これらのコマンドを使用すると、リストや表を作成できます。リストは左揃えで、独立した段落として表示されます。表は中央揃えで、独立した段落として表示されます。表の幅は、その内容の幅によって決まります。
\table
\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
\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コマンド内でのみ使用できます。1つの行には複数のセルを含めることができます。セルは \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++の列挙型項目のドキュメント作成を開始します。
このコマンドの最初の引数は値の名前です。値の名前の前には、角括弧で囲まれたオプションの「since」節を付けることができます。値の説明は値の名前の後に続きます。説明は、次の空白行または「\value 」で終了します。引数は表形式で表示されます。
注： \value の説明に画像を含めるには 、 \inlineimage コマンドを使用してください。
「since」節がない場合、「\value 」コマンドは次のような形式になります：
since節を含む同じコマンドは、次のようになります：
ドキュメントは、関連するクラス、ヘッダーファイル、または名前空間のドキュメント内に記載されます。例については、 \enum ドキュメントを参照してください。
注： Qt 5.4以降 、\value コマンドは \enum トピックの外でも使用できるようになりました。この場合、QDocは定数名（最初の引数からそのまま取得）とその説明を列挙した2列の表を生成します。これは、例えば、 \qmlproperty トピック内で、QMLの列挙型プロパティの許容値について記述する際などに利用できます。
関連項目 \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.
