표 및 목록
이 명령을 사용하면 목록과 표를 만들 수 있습니다. 목록은 별도의 단락으로 왼쪽 정렬로 렌더링됩니다. 표는 별도의 단락으로 중앙에 렌더링됩니다. 표 너비는 해당 콘텐츠의 너비에 따라 달라집니다.
\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 명령 내에서만 사용할 수 있습니다. 한 행에는 여러 개의 셀이 포함될 수 있습니다. 셀은 \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
value 명령은 C++ 열거형 항목의 문서를 시작합니다.
명령의 첫 번째 인수는 값 이름입니다. 값 이름 앞에는 대괄호로 묶인 선택적 이후 절이 올 수 있습니다. 값 설명은 값 이름 다음에 나옵니다. 설명은 다음 빈 줄 또는 \value에서 끝납니다. 인수는 테이블로 렌더링됩니다.
참고: \value 설명에 이미지를 포함하려면 \inlineimage 명령을 사용합니다.
이후 절이 없는 \value 명령은 다음과 같이 보일 수 있습니다:
이후 절이 있는 동일한 명령은 다음과 같이 표시됩니다:
관련 문서는 관련 클래스, 헤더 파일 또는 네임스페이스 문서에 있습니다. 열거형 문서에서 예시를 참조하세요.
참고: Qt 5.4부터 \enum 항목 외부에서도 \value 명령을 사용할 수 있습니다. 이 경우 QDoc은 상수 이름(첫 번째 인수에서 그대로 가져온)과 해당 설명을 나열하는 두 열의 테이블을 렌더링합니다. 예를 들어 \qmlproperty 항목에서 QML 열거형 속성에 대해 허용되는 값을 문서화할 때 사용할 수 있습니다.
enum 및 \omitvalue도 참조하세요.
\omitvalue
omitvalue 명령은 문서에서 C++ 열거형 항목을 제외합니다.
명령의 유일한 필수 인수는 생략될 열거형 항목의 이름입니다. 열거형 항목 뒤에 한 줄 설명이 오는 경우 이 설명도 생략됩니다.
열거형 문서의 예시를 참조하세요.
\목록
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
*/li.
\l(표 셀, 목록 항목)
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.
