표와 목록
이 명령어를 사용하면 목록과 표를 만들 수 있습니다. 목록은 별도의 단락으로 왼쪽 정렬되어 표시됩니다. 표는 별도의 단락으로 중앙 정렬되어 표시됩니다. 표의 너비는 내용물의 너비에 따라 달라집니다.
\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++ 열거형 항목에 대한 문서 작성을 시작합니다.
이 명령어의 첫 번째 인수는 값 이름입니다. 값 이름 앞에는 대괄호로 묶인 선택적 since 절이 올 수 있습니다. 값 설명은 값 이름 뒤에 이어집니다. 설명은 다음 빈 줄이나 \value 에서 끝납니다. 인수는 표 형식으로 표시됩니다.
참고: ` \value ` 설명에 이미지를 포함하려면 \inlineimage 명령을 사용하십시오.
'since' 절이 없는 경우, ` \value ` 명령은 다음과 같이 표시될 수 있습니다:
'since' 절이 포함된 동일한 명령어는 다음과 같이 표시됩니다:
문서는 관련 클래스, 헤더 파일 또는 네임스페이스 문서에서 확인할 수 있습니다. 예제는 \enum 문서를 참조하십시오.
참고: Qt 5.4부터는 ` \value ` 명령을 \enum 주제 외부에서도 사용할 수 있습니다. 이 경우 QDoc은 상수 이름(첫 번째 인자에서 그대로 가져옴)과 해당 설명을 나열한 2열 표를 렌더링합니다. 이는 예를 들어 \qmlproperty 주제에서 QML 열거형 속성의 허용 가능한 값을 문서화하는 데 사용할 수 있습니다.
참조: \enum 및 \omitvalue참조하십시오.
\omitvalue
\omitvalue 명령어는 문서에서 C++ 열거형 항목을 제외합니다.
이 명령어의 유일한 필수 인수는 생략될 열거형 항목의 이름입니다. 열거형 항목 뒤에 한 줄짜리 설명이 있는 경우, 해당 설명도 함께 생략됩니다.
예시는 \enum 문서를 참조하십시오.
\list
\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.
\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
*/지정하지 않으면 항목은 한 열과 한 행을 차지합니다.
© 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.
