특별 콘텐츠
문서 내용 명령어는 문서의 특정 부분, 즉 특별한 표시 방식이나 개념적 의미 또는 기능을 가진 부분을 식별합니다.
\quotation
\quotation 및 \endquotation 명령어는 긴 인용문을 구분합니다.
구분된 블록 내의 텍스트는 HTML 출력에서 <blockquote> 및 </blockquote> 태그로 둘러싸이게 됩니다. 예:
/*!
Although the prospect of a significantly broader market is
good news for Firstlogic, the notion also posed some
challenges. Dave Dobson, director of technology for the La
Crosse, Wisconsin-based company, said:
\quotation
As our solutions were being adopted into new
environments, we saw an escalating need for easier
integration with a wider range of enterprise
applications.
\endquotation
*/다음 블록 내의 텍스트는 \quotation 블록 내의 텍스트는 생성된 HTML에서 다음과 같이 표시됩니다:
<blockquote>
<p>As our solutions were being adopted into new environments,
we saw an escalating need for easier integration with a wider
range of enterprise applications.</p>
</blockquote>대부분의 브라우저에 내장된 스타일 시트는 <blockquote> 태그의 내용을 좌우 들여쓰기 형태로 렌더링합니다. 위의 예제는 다음과 같이 렌더링됩니다:
당사의 솔루션이 새로운 환경에 도입됨에 따라, 더 광범위한 엔터프라이즈 애플리케이션과의 손쉬운 통합에 대한 필요성이 점점 더 커지고 있음을 확인했습니다.
하지만 style.css 파일에서 <blockquote> 태그를 재정의할 수 있습니다.
\note
\note 명령어는 굵은 글씨로 "Note:"가 앞에 붙은 새로운 단락을 정의합니다. 이 명령어는 연속된 단락을 인수로 받아, 단락이 끝나는 지점에서 종료됩니다. note 명령어는 짧은 문장에만 사용되며, 여러 줄로 구성된 긴 단락에는 사용할 수 없습니다.
이 명령은 \warning 명령어와 마찬가지로, note는 짧고 중요한 문구에 사용됩니다. 사용법에 대한 자세한 내용은 Qt 작성 지침을 참조하십시오.
\notranslate
\notranslate 명령어는 생성된 출력이 언어 번역 서비스로 전달될 때, 해당 인수가 번역 되지 않도록 지정합니다.
기타 명령어(\c, \tt)도 동일한 효과를 가지지만, ` \notranslate `는 인수의 서식을 전혀 변경하지 않습니다.
이 명령어는 QDoc 버전 6.10에서 도입되었습니다.
\brief
\brief 명령어는 모든 주제 명령어에 대한 한 문장 분량의 설명을 추가합니다.
이 간략한 설명 문구는 관련 객체의 문서를 소개하는 데 사용되며, \generatelist 명령어와 \annotatedlist 명령을 사용하여 생성된 목록에서 사용됩니다.
이 간략한 설명은 해당 주제에 대한 문서에 표시됩니다.
예를 들어, 부울형 QWidget::isWindow 속성의 경우:
/*!
\property QWidget::isActiveWindow
\brief Whether this widget's window is the active window.
The active window is the window that contains the widget that
has keyboard focus.
When popup windows are visible, this property is \c true
for both the active window \e and the popup.
\sa activateWindow(), QApplication::activeWindow()
*/그리고 ` QWidget::geometry ` 속성은
/*!
\property QWidget::geometry
\brief The geometry of the widget relative to its parent and
excluding the window frame.
When changing the geometry, the widget, if visible,
receives a move event (moveEvent()) and/or a resize
event (resizeEvent()) immediately.
...
\sa frameGeometry(), rect(), ...
*/\brief 명령어를 사용하여 클래스를 설명할 때는 다음과 같이 완전한 문장을 사용하는 것이 좋습니다:
The <classname> class is|provides|contains|specifies...경고: 간략한 설명은 상세 설명의 첫 번째 단락이 되므로, 간략한 설명과 동일한 문장으로 상세 설명을 반복하지마십시오 .
/*!
\class PreviewWindow
\brief The PreviewWindow class is a custom widget
displaying the names of its currently set
window flags in a read-only text editor.
The PreviewWindow class inherits QWidget. The widget
displays the names of its window flags set with the
setWindowFlags() function. It is also provided with a
QPushButton that closes the window.
...
\sa QWidget
*/\brief 를 \namespace:
/*!
\namespace Qt
\brief The Qt namespace contains miscellaneous identifiers
used throughout the Qt library.
*/\brief 를 사용하는 방법 \headerfile:
/*!
\headerfile <QtGlobal>
\title Global Qt Declarations
\brief The <QtGlobal> header file provides basic
declarations and is included by all other Qt headers.
\sa <QtAlgorithms>
*/참조 \property, \class, \namespace 그리고 \headerfile.
\legalese
\legalese 및 \endlegalese 명령어는 라이선스 계약의 경계를 지정합니다.
생성된 HTML에서, 구분된 텍스트는 <div class="LegaleseLeft"> 및 </div> 태그로 둘러싸여 있습니다.
\legalese 및 \endlegalese 태그로 둘러싸인 라이선스 계약서의 예시:
/*!
\legalese
Copyright 1996 Daniel Dardailler.
Permission to use, copy, modify, distribute, and sell this
software for any purpose is hereby granted without fee,
provided that the above copyright notice appear in all
copies and that both that copyright notice and this
permission notice appear in supporting documentation, and
that the name of Daniel Dardailler not be used in
advertising or publicity pertaining to distribution of the
software without specific, written prior permission. Daniel
Dardailler makes no representations about the suitability of
this software for any purpose. It is provided "as is"
without express or implied warranty.
Modifications Copyright 1999 Matt Koss, under the same
license as above.
\endlegalese
*/생성된 HTML에서는 다음과 같이 표시됩니다:
<div class="LegaleseLeft">
<p>Copyright 1996 Daniel Dardailler.</p>
<p>Permission to use, copy, modify, distribute, and sell
this software for any purpose is hereby granted without fee,
provided that the above copyright notice appear in all
copies and that both that copyright notice and this
permission notice appear in supporting documentation, and
that the name of Daniel Dardailler not be used in
advertising or publicity pertaining to distribution of the
software without specific, written prior permission. Daniel
Dardailler makes no representations about the suitability of
this software for any purpose. It is provided "as is"
without express or implied warranty.</p>
<p>Modifications Copyright 1999 Matt Koss, under the same
license as above.</p>
</div>\endlegalese 명령어가 생략된 경우, QDoc은 \legalese 명령어를 처리하되 문서 페이지의 나머지 부분을 라이선스 계약서로 간주합니다.
이상적으로는 라이선스 문구가 라이선스가 적용된 코드와 함께 위치해야 합니다.
그 외의 경우, \legalese 명령으로 식별된 문서는 \generatelistlegalese 를 인수로 사용하여 수집할 수 있습니다. 이는 소스 코드와 관련된 라이선스 계약의 개요를 생성하는 데 유용합니다.
참고: ` \generatelist legalese ` 명령어의출력 결과에는 현재 문서 프로젝트에 포함된 \legalese 텍스트만 포함됩니다. 현재 문서 프로젝트가 다른 모듈에 의존하는 경우, 해당 모듈의 라이선스 텍스트는 나열되지 않습니다.
\warning
\warning 명령어는 명령어 인수의 앞에 "Warning:"을 굵은 글꼴로 추가합니다.
/*!
Qt::HANDLE is a platform-specific handle type
for system objects. This is equivalent to
\c{void *} on Windows and macOS, and to
\c{unsigned long} on X11.
\warning Using this type is not portable.
*/© 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.
