이미지 포함

그래픽 명령을 사용하면 문서에 이미지를 포함할 수 있습니다. 이미지는 별도의 단락으로 렌더링하거나 실행 중인 텍스트 안에 렌더링할 수 있습니다.

\이미지

image 명령은 첫 번째 인자로 지정된 이미지로 확장한 후 별도의 단락으로 중앙에 렌더링합니다.

이 명령은 두 개의 인수를 받습니다. 첫 번째 인수는 이미지 파일의 이름입니다. 두 번째 인수는 이미지에 포함된 내용에 대한 설명이며 HTML alt 속성에 사용됩니다. 해당 내용은 화면 리더에서 소리로 읽어주므로 접근성을 위해 사용하는 것이 좋습니다. Lynx 텍스트 브라우저와 같이 이미지를 지원하지 않는 브라우저에서도 사용할 수 있습니다. 사용자가 이미지 위로 마우스를 가져가면 일반적으로 그래픽 텍스트 브라우저에서 툴팁으로 렌더링되는 이미지에 대한 제목 속성을 생성하도록 사용알트텍스트 제목 변수를 설정할 수도 있습니다.

QDoc은 상당히 관대하지만 파일 이름과 설명을 모두 중괄호로 묶어야 합니다(예: 다음과 같이):

\image {Bandit.png} {A Golden Retriever holding a bag of coffee in its mouth}

이 구문이 가장 명확하며 항상 예상되는 결과를 제공합니다. 그렇지 않은 경우 파일 이름이나 설명 뒤에 줄 바꿈으로 묶어야 합니다. 설명 인수가 여러 줄에 걸쳐 있는 경우 중괄호는 필수입니다. 설명이 큰따옴표로 묶여 있으면 QDoc은 출력을 생성하기 전에 큰따옴표를 제거합니다. 특수 문자는 QDoc의 HTML 출력에서 해당 HTML 엔티티 코드로 대체될 수 있습니다.

/*!
    Qt is a C++ toolkit for cross-platform GUI application development.

    \image {happyguy.jpg} {Happy guy}

    Qt provides single-source portability across Microsoft
    Windows, macOS, Linux, and all major commercial Unix
    variants. It is also available for embedded devices.
*/

인라인 이미지\캡션도 참조하세요.

\inlineimage

inlineimage 명령은 인수가 지정한 이미지로 확장됩니다. 이미지가 나머지 텍스트와 함께 인라인으로 렌더링됩니다.

이 명령은 두 개의 인수를 받습니다. 첫 번째 인수는 이미지 파일의 이름입니다. 두 번째 인수는 선택 사항이며 이미지 태그의 HTML alt=""에 해당하는 중괄호 {} 안에 이미지에 대한 간단한 설명입니다. 이 설명은 도구 설명에 사용되며, Lynx 텍스트 브라우저처럼 브라우저에서 이미지를 지원하지 않는 경우에 사용됩니다.

inlineimage 명령은 목록과 표에서 가장 일반적으로 사용됩니다. 다음은 목록에 인라인 이미지를 포함하는 예제입니다:

/*!
    \list 1
      \li \inlineimage happy.gif {Oh so happy, I am a caption!}
      \li \inlineimage happy.gif Oh so happy, but I'm not a caption.
    \endlist
*/

다음은 표에 인라인 이미지를 포함하는 예제입니다:

/*!
    \table
    \header
        \li Qt
        \li Qt Creator
    \row
        \li \inlineimage happy.gif {Oh so happy!}
        \li \inlineimage happy.gif Oh so happy!
    \row
        \li \inlineimage happy.gif Oh so happy!
        \li \inlineimage happy.gif {Oh so happy!}
    \endtable
*/

이 명령은 텍스트와 함께 이미지를 인라인으로 삽입하는 데에도 사용할 수 있습니다.

/*!
    \inlineimage training.jpg {Qt Training} The Qt Programming course is
    offered as a five day Open Enrollment Course. The classes are open to
    the public. Although the course is open to anyone who wants to learn,
    attendees should have significant experience in C++ development to
    derive maximum benefit from the course.
*/

이미지 캡션도 참조하세요.

\캡션

캡션 명령은 이미지에 캡션을 제공합니다.

이 명령은 단락 끝까지의 모든 텍스트를 캡션으로 가져옵니다. 원하는 효과를 얻을 때까지 실험해 보세요.

/*!
  \table 100%
    \row
      \li \image windows-pushbutton.png
         \caption The QPushButton widget provides a command button.
      \li \image windows-toolbutton.png
         \caption The QToolButton class provides a quick-access button to commands
         or options, usually used inside a QToolBar.
   \endtable
*/

이미지\inlineimage도 참조하세요.

© 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.