QIcon Class
QIcon 클래스는 다양한 모드와 상태에서 크기를 조정할 수 있는 아이콘을 제공합니다. 더 보기...
| 헤더: | #include <QIcon> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- 상속된 멤버를 포함한 모든 멤버 목록
- 사용 중단된 멤버
- QIcon은 페인팅 클래스와 암시적 공유 클래스의 일부입니다.
공개 유형
| enum | Mode { Normal, Disabled, Active, Selected } |
| enum | State { On, Off } |
(since 6.7) enum class | ThemeIcon { AddressBookNew, ApplicationExit, AppointmentNew, CallStart, CallStop, …, WeatherStorm } |
공개 함수
| QIcon() | |
| QIcon(QIconEngine *engine) | |
| QIcon(const QPixmap &pixmap) | |
| QIcon(const QString &fileName) | |
| QIcon(const QIcon &other) | |
| QIcon(QIcon &&other) | |
| ~QIcon() | |
| QSize | actualSize(const QSize &size, QIcon::Mode mode = Normal, QIcon::State state = Off) const |
| void | addFile(const QString &fileName, const QSize &size = QSize(), QIcon::Mode mode = Normal, QIcon::State state = Off) |
| void | addPixmap(const QPixmap &pixmap, QIcon::Mode mode = Normal, QIcon::State state = Off) |
| QList<QSize> | availableSizes(QIcon::Mode mode = Normal, QIcon::State state = Off) const |
| qint64 | cacheKey() const |
| bool | isMask() const |
| bool | isNull() const |
| QString | name() const |
| void | paint(QPainter *painter, const QRect &rect, Qt::Alignment alignment = Qt::AlignCenter, QIcon::Mode mode = Normal, QIcon::State state = Off) const |
| void | paint(QPainter *painter, int x, int y, int w, int h, Qt::Alignment alignment = Qt::AlignCenter, QIcon::Mode mode = Normal, QIcon::State state = Off) const |
| QPixmap | pixmap(const QSize &size, QIcon::Mode mode = Normal, QIcon::State state = Off) const |
| QPixmap | pixmap(int extent, QIcon::Mode mode = Normal, QIcon::State state = Off) const |
(since 6.0) QPixmap | pixmap(const QSize &size, qreal devicePixelRatio, QIcon::Mode mode = Normal, QIcon::State state = Off) const |
| QPixmap | pixmap(int w, int h, QIcon::Mode mode = Normal, QIcon::State state = Off) const |
| void | setIsMask(bool isMask) |
| void | swap(QIcon &other) |
| operator QVariant() const | |
| QIcon & | operator=(QIcon &&other) |
| QIcon & | operator=(const QIcon &other) |
정적 공용 멤버
| QStringList | fallbackSearchPaths() |
| QString | fallbackThemeName() |
| QIcon | fromTheme(const QString &name) |
(since 6.7) QIcon | fromTheme(QIcon::ThemeIcon icon) |
(since 6.7) QIcon | fromTheme(QIcon::ThemeIcon icon, const QIcon &fallback) |
| QIcon | fromTheme(const QString &name, const QIcon &fallback) |
| bool | hasThemeIcon(const QString &name) |
(since 6.7) bool | hasThemeIcon(QIcon::ThemeIcon icon) |
| void | setFallbackSearchPaths(const QStringList &paths) |
| void | setFallbackThemeName(const QString &name) |
| void | setThemeName(const QString &name) |
| void | setThemeSearchPaths(const QStringList &paths) |
| QString | themeName() |
| QStringList | themeSearchPaths() |
관련 비멤버
| QDataStream & | operator<<(QDataStream &stream, const QIcon &icon) |
| QDataStream & | operator>>(QDataStream &stream, QIcon &icon) |
상세 설명
QIcon은 주어진 픽스맵 집합으로부터 더 작거나 더 큰 픽스맵, 활성 상태의 픽스맵, 비활성 상태의 픽스맵을 생성할 수 있습니다. 이러한 픽스맵은 Qt UI 컴포넌트에서 특정 동작을 나타내는 아이콘을 표시하는 데 사용됩니다.
이미지 파일을 사용하여 아이콘 생성
QIcon을 생성하는 가장 간단한 방법은 하나 또는 여러 개의 이미지 파일이나 리소스를 사용하여 만드는 것입니다. 예를 들어:
QToolButton *button = new QToolButton;
button->setIcon(QIcon("open.png"));QIcon은 다양한 상태에 해당하는 여러 이미지를 저장할 수 있으며, Qt는 해당 동작의 현재 상태와 가장 잘 일치하는 이미지를 선택합니다.
Qt는 필요할 때 필요한 아이콘 스타일과 크기를 생성합니다. 예를 들어, ' QIcon::Disabled ' 상태에 대한 픽스맵은 제공된 픽스맵 중 하나를 회색으로 처리하여 생성될 수 있습니다.
아이콘을 지우려면 해당 위치에 null 아이콘을 설정하기만 하면 됩니다:
button->setIcon(QIcon());QImageReader::supportedImageFormats() 및 QImageWriter::supportedImageFormats() 함수를 사용하여 지원되는 파일 형식의 전체 목록을 가져올 수 있습니다.
참고: SVG 이미지 파일을 사용하는경우 , 올바른 icon engine 이 선택되도록 해당 파일을 비-SVG 파일보다 먼저 추가해야 합니다.
테마 또는 아이콘 라이브러리를 사용하여 아이콘 생성
아이콘을 생성하는 가장 편리한 방법은 fromTheme() 팩토리 함수를 사용하는 것입니다. Qt는 Freedesktop 아이콘 테마 사양을 지원하는 플랫폼에서 네이티브 아이콘 라이브러리에 대한 액세스를 구현합니다.
애플리케이션은 동일한 테마 사양을 사용하여 자체 아이콘 라이브러리를 제공할 수 있습니다. 아래에서 테마 설명 예시와 이미지 파일에 대한 해당 디렉터리 구조를 확인하십시오.
Qt 6.7부터 Qt는 macOS, iOS, Windows 10 및 11에서도 네이티브 아이콘 라이브러리에 대한 액세스를 제공합니다. Android의 경우, 시스템에 MaterialIcons-Regular 글꼴이 있거나 :/qt-project.org/icons/MaterialIcons-Regular.ttf 에 애플리케이션 리소스로 번들되어 있는 한 Qt는 머티리얼 디자인 시스템의 아이콘에 액세스할 수 있습니다.
Qt 6.9부터는 사용 가능한 아이콘 폰트 내의 명명된 글리프에서 아이콘을 생성할 수 있습니다. ` theme name `을 폰트의 패밀리 이름으로 설정하고, 글리프 이름을 사용하여 ` fromTheme()`를 호출하면 됩니다.
QIcon::setThemeName("Material Symbols Outlined");
QIcon muteIcon = QIcon::fromTheme(u"volume_off"_s);아이콘 폰트는 시스템에 설치하거나, ` application font`로 번들링할 수 있습니다.
아이콘 엔진
내부적으로 QIcon은 아이콘 이미지를 처리하고 렌더링하기 위해 ` icon engine ` 백엔스를 인스턴스화합니다. 아이콘 엔진의 유형은 QIcon 객체에 가장 먼저 추가된 파일, 픽스맵 또는 테마에 의해 결정됩니다. 이후 추가되는 파일이나 픽스맵은 동일한 엔진에 의해 처리됩니다.
아이콘 엔진은 아이콘을 처리하고 렌더링하는 방식에 따라 다릅니다. 기본 픽스맵 기반 엔진은 고정된 이미지만 처리하는 반면, QtSvg 모듈은 제공된 벡터 그래픽 파일을 요청된 크기로 재렌더링하여 더 나은 품질을 제공하는 아이콘 엔진을 제공합니다. 테마 아이콘 엔진은 일반적으로 네이티브 플랫폼 아이콘 라이브러리의 이미지만 제공하며, 추가된 파일이나 픽스맵은 무시합니다.
또한 사용자 정의 아이콘 엔진을 제공할 수도 있습니다. 이를 통해 애플리케이션은 생성된 아이콘의 모든 측면을 맞춤 설정할 수 있습니다. QIconEnginePlugin 를 사용하면 파일 확장자별로 서로 다른 아이콘 엔진을 등록할 수 있으므로, 타사 개발자가 Qt에 포함된 아이콘 엔진 외에도 추가적인 아이콘 엔진을 제공할 수 있습니다.
사용자 인터페이스에서 QIcon 사용하기
작은 픽스맵을 설정할 수 있는 옵션을 가진 자체 위젯을 작성하는 경우, 해당 픽스맵에 QIcon을 설정할 수 있도록 고려하십시오. Qt 클래스 ` QToolButton `는 이러한 위젯의 예시입니다.
QIcon을 설정하는 메서드를 제공하고, 위젯의 현재 상태에 따라 적절한 매개변수를 선택하여 paint 를 사용하여 QIcon을 그립니다. 예를 들어:
void MyWidget::drawIcon(QPainter *painter, const QRect &rect)
{
icon.paint(painter, rect, Qt::AlignCenter, isEnabled() ? QIcon::Normal
: QIcon::Disabled,
isChecked() ? QIcon::On
: QIcon::Off);
}pixmap(QSize, Mode, State)를 사용하여 픽스맵을 가져올 때, 주어진 크기, 모드 및 상태에 해당하는 픽스맵이 addFile() 또는 addPixmap()를 통해 추가되지 않은 경우, QIcon이 그 자리에서 픽스맵을 생성합니다. 이러한 픽스맵 생성은 ` QIconEngine`에서 이루어집니다. 기본 엔진은 필요한 경우 픽스맵을 축소하되 절대 확대하지 않으며, 현재 스타일을 사용하여 비활성화된 상태를 계산합니다.
또한 Active 모드를 활용할 수도 있습니다. 예를 들어, 마우스가 위젯 위에 있을 때(` QWidget::enterEvent()` 참조), 마우스를 누른 상태에서 함수가 활성화될 때까지, 또는 현재 선택된 항목일 때 위젯을 ` Active ` 상태로 만들 수 있습니다. 위젯을 토글할 수 있는 경우, "On" 모드를 사용하여 다른 아이콘을 그릴 수 있습니다.
네이티브 아이콘 라이브러리나 아이콘 폰트에서 생성된 QIcon은 아이콘의 On 및 Off 상태 모두에 동일한 글리프를 사용합니다. 애플리케이션은 해당 UI 컨트롤이나 동작의 상태에 따라 아이콘을 변경할 수 있습니다. Qt Quick 애플리케이션에서는 바인딩을 사용하여 이를 구현할 수 있습니다.
ToolButton {
id: muteButton
checkable: true
icon.name: checked ? "volume_off" : "volume_up"
}
참고: QIcon은 아이콘이 생성되기 전에 QGuiApplication 인스턴스가 필요합니다.
고해상도(High DPI) 아이콘
네이티브 아이콘 라이브러리에서 제공되거나 아이콘 폰트의 글리프에서 생성된 아이콘은 대개 벡터 그래픽을 기반으로 하며, 적절한 해상도로 자동으로 렌더링됩니다.
addFile()를 통해 자체 이미지 파일을 제공하는 경우, QIcon은 Qt의 "@nx" high DPI syntax 를 사용합니다. 이는 사용자 정의 디렉터리 구조를 가지고 있으며 Freedesktop 아이콘 테마 사양을 따르지 않는 경우에 유용합니다.
애플리케이션 테마를 제공하는 경우에는 아이콘 테마 사양을 준수하여 각 해상도에 사용할 파일을 지정해야 합니다. QIcon이 이미지의 고해상도(고 DPI) 버전을 사용하도록 하려면, 해당 index.theme 파일에 다음 항목을 추가하십시오:
[Icon Theme]
Name=Test
Comment=Test Theme
Directories=32x32/actions,32x32@2/actions
[32x32/actions]
Size=32
Context=Actions
Type=Fixed
# High DPI version of the entry above.
[32x32@2/actions]
Size=32
Scale=2
Type=Fixed그러면 아이콘 테마 디렉터리는 다음과 같이 구성됩니다:
├── 32x32
│ └── actions
│ └── appointment-new.png
├── 32x32@2
│ └── actions
│ └── appointment-new.png
└── index.theme멤버 유형 문서
enum QIcon::Mode
이 열거형 유형은 픽스맵이 사용될 목적인 모드를 나타냅니다. 현재 정의된 모드는 다음과 같습니다.
| 상수 | 값 | 설명 |
|---|---|---|
QIcon::Normal | 0 | 사용자가 아이콘과 상호작용하지 않지만, 아이콘이 나타내는 기능이 사용 가능한 경우 픽스맵을 표시합니다. |
QIcon::Disabled | 1 | 아이콘이 나타내는 기능을 사용할 수 없을 때 픽스맵을 표시합니다. |
QIcon::Active | 2 | 아이콘이 나타내는 기능을 사용할 수 있고, 사용자가 아이콘과 상호작용하고 있는 경우(예: 마우스를 아이콘 위로 이동하거나 클릭하는 경우) 픽스맵을 표시합니다. |
QIcon::Selected | 3 | 아이콘이 나타내는 항목이 선택되었을 때 픽스맵을 표시합니다. |
enum QIcon::State
이 열거형은 픽스맵이 사용될 목적인 상태를 설명합니다. 상태는 다음과 같을 수 있습니다:
| 상수 | 값 | 설명 |
|---|---|---|
QIcon::On | 0 | 위젯이 "on" 상태일 때 픽스맵을 표시합니다 |
QIcon::Off | 1 | 위젯이 “off” 상태일 때 픽스맵을 표시합니다 |
[since 6.7] enum class QIcon::ThemeIcon
이 열거형은 대부분의 아이콘 테마 구현에서 제공하는 아이콘에 접근할 수 있게 해줍니다.
| 상수 | 값 | 설명 |
|---|---|---|
QIcon::ThemeIcon::AddressBookNew | 0 | 새 주소록을 생성하는 작업에 대한 아이콘입니다. |
QIcon::ThemeIcon::ApplicationExit | 1 | 응용 프로그램을 종료하는 작업에 대한 아이콘입니다. |
QIcon::ThemeIcon::AppointmentNew | 2 | 새 약속을 생성하는 작업의 아이콘입니다. |
QIcon::ThemeIcon::CallStart | 3 | 통화를 시작하거나 수락하는 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::CallStop | 4 | 현재 통화를 종료하는 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::ContactNew | 5 | 새 연락처를 생성하는 작업의 아이콘. |
QIcon::ThemeIcon::DocumentNew | 6 | 새 문서를 생성하는 작업의 아이콘. |
QIcon::ThemeIcon::DocumentOpen | 7 | 문서를 여는 작업의 아이콘. |
QIcon::ThemeIcon::DocumentOpenRecent | 8 | 최근에 열었던 문서를 여는 작업의 아이콘. |
QIcon::ThemeIcon::DocumentPageSetup | 9 | 페이지 설정 작업용 아이콘. |
QIcon::ThemeIcon::DocumentPrint | 10 | 인쇄 작업 아이콘. |
QIcon::ThemeIcon::DocumentPrintPreview | 11 | 인쇄 미리 보기 작업 아이콘. |
QIcon::ThemeIcon::DocumentProperties | 12 | 문서의 속성을 확인하는 작업의 아이콘. |
QIcon::ThemeIcon::DocumentRevert | 13 | 문서의 이전 버전으로 되돌리는 작업의 아이콘. |
QIcon::ThemeIcon::DocumentSave | 14 | 저장 작업 아이콘. |
QIcon::ThemeIcon::DocumentSaveAs | 15 | 다른 이름으로 저장 작업의 아이콘. |
QIcon::ThemeIcon::DocumentSend | 16 | 보내기 작업 아이콘. |
QIcon::ThemeIcon::EditClear | 17 | 지우기 작업 아이콘. |
QIcon::ThemeIcon::EditCopy | 18 | 복사 작업 아이콘. |
QIcon::ThemeIcon::EditCut | 19 | 잘라내기 작업 아이콘. |
QIcon::ThemeIcon::EditDelete | 20 | '삭제 ' 작업의 아이콘. |
QIcon::ThemeIcon::EditFind | 21 | 찾기 작업 아이콘. |
QIcon::ThemeIcon::EditPaste | 22 | 붙여넣기 작업 아이콘. |
QIcon::ThemeIcon::EditRedo | 23 | 다시 실행 작업의 아이콘. |
QIcon::ThemeIcon::EditSelectAll | 24 | 모두 선택 작업의 아이콘. |
QIcon::ThemeIcon::EditUndo | 25 | 실행 취소 작업의 아이콘. |
QIcon::ThemeIcon::FolderNew | 26 | 새 폴더 만들기 아이콘. |
QIcon::ThemeIcon::FormatIndentLess | 27 | 들여쓰기 줄이기 서식 지정 작업의 아이콘. |
QIcon::ThemeIcon::FormatIndentMore | 28 | 들여쓰기 늘리기 서식 지정 작업 아이콘. |
QIcon::ThemeIcon::FormatJustifyCenter | 29 | 중앙 정렬 서식 지정 작업 아이콘. |
QIcon::ThemeIcon::FormatJustifyFill | 30 | 채우기 정렬 서식 지정 작업 아이콘. |
QIcon::ThemeIcon::FormatJustifyLeft | 31 | 왼쪽 정렬 서식 지정 작업 아이콘. |
QIcon::ThemeIcon::FormatJustifyRight | 32 | 오른쪽 정렬 서식 지정 작업 아이콘. |
QIcon::ThemeIcon::FormatTextDirectionLtr | 33 | 왼쪽에서 오른쪽으로 텍스트 서식 지정 작업 아이콘. |
QIcon::ThemeIcon::FormatTextDirectionRtl | 34 | 오른쪽에서 왼쪽으로 텍스트 정렬 서식 지정 작업 아이콘. |
QIcon::ThemeIcon::FormatTextBold | 35 | 굵은 텍스트 서식 지정 작업 아이콘. |
QIcon::ThemeIcon::FormatTextItalic | 36 | 이탤릭체 서식 지정 작업 아이콘. |
QIcon::ThemeIcon::FormatTextUnderline | 37 | 밑줄 텍스트 서식 지정 작업 아이콘. |
QIcon::ThemeIcon::FormatTextStrikethrough | 38 | 취소선 텍스트 서식 지정 작업 아이콘. |
QIcon::ThemeIcon::GoDown | 39 | 목록에서 아래로 이동 작업 아이콘. |
QIcon::ThemeIcon::GoHome | 40 | 시작 위치로 이동 작업의 아이콘. |
QIcon::ThemeIcon::GoNext | 41 | 목록에서 다음 항목으로 이동 작업의 아이콘. |
QIcon::ThemeIcon::GoPrevious | 42 | 목록에서 이전 항목으로 이동 작업의 아이콘. |
QIcon::ThemeIcon::GoUp | 43 | 목록에서 위쪽으로 이동 작업의 아이콘. |
QIcon::ThemeIcon::HelpAbout | 44 | 도움말 메뉴의 ‘정보 ’ 항목 아이콘. |
QIcon::ThemeIcon::HelpFaq | 45 | 도움말 메뉴의 ‘자주 묻는 질문(FAQ) ’ 항목 아이콘. |
QIcon::ThemeIcon::InsertImage | 46 | 응용 프로그램의 ‘이미지 삽입 ’ 작업 아이콘. |
QIcon::ThemeIcon::InsertLink | 47 | 응용 프로그램의 ‘링크 삽입 ’ 작업 아이콘. |
QIcon::ThemeIcon::InsertText | 48 | 응용 프로그램의 '텍스트 삽입 ' 작업 아이콘. |
QIcon::ThemeIcon::ListAdd | 49 | 목록에 추가 작업의 아이콘. |
QIcon::ThemeIcon::ListRemove | 50 | 목록에서 제거 작업의 아이콘. |
QIcon::ThemeIcon::MailForward | 51 | 전달 작업의 아이콘. |
QIcon::ThemeIcon::MailMarkImportant | 52 | '중요로 표시' 작업의 아이콘. |
QIcon::ThemeIcon::MailMarkRead | 53 | '읽은 것으로 표시' 작업의 아이콘. |
QIcon::ThemeIcon::MailMarkUnread | 54 | '미읽음으로 표시 ' 작업의 아이콘. |
QIcon::ThemeIcon::MailMessageNew | 55 | 새 메일 작성 작업의 아이콘. |
QIcon::ThemeIcon::MailReplyAll | 56 | '모두에게 답장 ' 작업의 아이콘. |
QIcon::ThemeIcon::MailReplySender | 57 | 보낸 사람에게 답장하기 작업의 아이콘. |
QIcon::ThemeIcon::MailSend | 58 | '보내기' 작업 아이콘. |
QIcon::ThemeIcon::MediaEject | 59 | 미디어 플레이어 또는 파일 관리자의 '꺼내기' 작업 아이콘. |
QIcon::ThemeIcon::MediaPlaybackPause | 60 | 미디어 플레이어의 일시 정지 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::MediaPlaybackStart | 61 | 미디어 플레이어의 '재생 시작' 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::MediaPlaybackStop | 62 | 미디어 플레이어의 중지 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::MediaRecord | 63 | 미디어 애플리케이션의 녹화 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::MediaSeekBackward | 64 | 미디어 플레이어의 뒤로 감기 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::MediaSeekForward | 65 | 미디어 플레이어의 앞으로 빨리 감기 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::MediaSkipBackward | 66 | 미디어 플레이어의 뒤로 건너뛰기 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::MediaSkipForward | 67 | 미디어 플레이어의 앞으로 건너뛰기 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::ObjectRotateLeft | 68 | 개체에 대해 수행되는 왼쪽으로 회전 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::ObjectRotateRight | 69 | 개체에 대해 수행되는 오른쪽으로 회전 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::ProcessStop | 70 | 브라우저에서 웹 페이지를 로드하는 등 처리에 시간이 다소 걸릴 수 있는 작업이 포함된 애플리케이션에서 중지 동작을 나타내는 아이콘입니다. |
QIcon::ThemeIcon::SystemLockScreen | 71 | 화면 잠금 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::SystemLogOut | 72 | 로그아웃 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::SystemSearch | 73 | 검색 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::SystemReboot | 74 | 재부팅 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::SystemShutdown | 75 | 시스템 종료 작업용 아이콘. |
QIcon::ThemeIcon::ToolsCheckSpelling | 76 | 맞춤법 검사 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::ViewFullscreen | 77 | 전체 화면 모드로 전환하기 아이콘. |
QIcon::ThemeIcon::ViewRefresh | 78 | 새로 고침 작업용 아이콘. |
QIcon::ThemeIcon::ViewRestore | 79 | 전체 화면 보기에서 나가는 아이콘. |
QIcon::ThemeIcon::WindowClose | 80 | 창 닫기 작업용 아이콘. |
QIcon::ThemeIcon::WindowNew | 81 | 새 창 열기 작업의 아이콘. |
QIcon::ThemeIcon::ZoomFitBest | 82 | 최적 크기 조정 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::ZoomIn | 83 | 확대 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::ZoomOut | 84 | 축소 동작을 나타내는 아이콘. |
QIcon::ThemeIcon::AudioCard | 85 | 오디오 렌더링 장치 아이콘. |
QIcon::ThemeIcon::AudioInputMicrophone | 86 | 마이크 오디오 입력 장치 아이콘. |
QIcon::ThemeIcon::Battery | 87 | 시스템 배터리 장치의 아이콘. |
QIcon::ThemeIcon::CameraPhoto | 88 | 디지털 스틸 카메라 장치 아이콘. |
QIcon::ThemeIcon::CameraVideo | 89 | 비디오 카메라 장치 아이콘. |
QIcon::ThemeIcon::CameraWeb | 90 | 웹캠 장치의 아이콘. |
QIcon::ThemeIcon::Computer | 91 | 컴퓨팅 장치 전체를 나타내는 아이콘. |
QIcon::ThemeIcon::DriveHarddisk | 92 | 하드 디스크 드라이브 아이콘. |
QIcon::ThemeIcon::DriveOptical | 93 | CD 및 DVD와 같은 광학 미디어 드라이브 아이콘. |
QIcon::ThemeIcon::InputGaming | 94 | 게임 입력 장치의 아이콘. |
QIcon::ThemeIcon::InputKeyboard | 95 | 키보드 입력 장치의 아이콘. |
QIcon::ThemeIcon::InputMouse | 96 | 마우스 입력 장치의 아이콘. |
QIcon::ThemeIcon::InputTablet | 97 | 그래픽 태블릿 입력 장치의 아이콘. |
QIcon::ThemeIcon::MediaFlash | 98 | 메모리 스틱과 같은 플래시 미디어 아이콘. |
QIcon::ThemeIcon::MediaOptical | 99 | CD 및 DVD와 같은 물리적 광학 미디어의 아이콘. |
QIcon::ThemeIcon::MediaTape | 100 | 일반 물리적 테이프 미디어를 나타내는 아이콘. |
QIcon::ThemeIcon::MultimediaPlayer | 101 | 일반 멀티미디어 재생 장치의 아이콘. |
QIcon::ThemeIcon::NetworkWired | 102 | 유선 네트워크 연결을 나타내는 아이콘. |
QIcon::ThemeIcon::NetworkWireless | 103 | 무선 네트워크 연결 아이콘. |
QIcon::ThemeIcon::Phone | 104 | 전화기 장치의 아이콘. |
QIcon::ThemeIcon::Printer | 105 | 프린터 장치의 아이콘. |
QIcon::ThemeIcon::Scanner | 106 | 스캐너 장치를 나타내는 아이콘. |
QIcon::ThemeIcon::VideoDisplay | 107 | 영상이 표시되는 모니터 아이콘. |
QIcon::ThemeIcon::AppointmentMissed | 108 | 약속을 놓쳤을 때 표시되는 아이콘. |
QIcon::ThemeIcon::AppointmentSoon | 109 | 예약이 곧 있을 때 표시되는 아이콘. |
QIcon::ThemeIcon::AudioVolumeHigh | 110 | 오디오 볼륨이 높음을 나타내는 아이콘. |
QIcon::ThemeIcon::AudioVolumeLow | 111 | 오디오 볼륨이 낮음을 나타내는 아이콘. |
QIcon::ThemeIcon::AudioVolumeMedium | 112 | 중간 음량을 나타내는 데 사용되는 아이콘. |
QIcon::ThemeIcon::AudioVolumeMuted | 113 | 오디오 재생 시 음소거 상태를 나타내는 아이콘. |
QIcon::ThemeIcon::BatteryCaution | 114 | 배터리 잔량이 40% 미만일 때 사용되는 아이콘. |
QIcon::ThemeIcon::BatteryLow | 115 | 배터리 잔량이 20% 미만일 때 사용되는 아이콘. |
QIcon::ThemeIcon::DialogError | 116 | 사용자에게 오류 상황을 설명하기 위해 대화 상자가 열릴 때 사용되는 아이콘. |
QIcon::ThemeIcon::DialogInformation | 117 | 요청된 작업과 관련이 있을 수 있는 정보를 사용자에게 제공하기 위해 대화 상자가 열릴 때 사용되는 아이콘. |
QIcon::ThemeIcon::DialogPassword | 118 | 사용자의 인증 정보를 요청하는 대화 상자가 열릴 때 사용되는 아이콘입니다. |
QIcon::ThemeIcon::DialogQuestion | 119 | 사용자에게 간단한 질문을 하기 위해 대화 상자가 열릴 때 사용되는 아이콘. |
QIcon::ThemeIcon::DialogWarning | 120 | 요청된 작업과 관련하여 발생할 수 있는 문제를 사용자에게 경고하기 위해 대화 상자가 열릴 때 사용되는 아이콘. |
QIcon::ThemeIcon::FolderDragAccept | 121 | 허용되는 개체를 폴더 위로 드래그하는 동안 폴더에 사용되는 아이콘. |
QIcon::ThemeIcon::FolderOpen | 122 | 폴더의 내용이 동일한 창 내에 표시되는 동안 폴더에 사용되는 아이콘. |
QIcon::ThemeIcon::FolderVisiting | 123 | 폴더의 내용이 다른 창에 표시되는 동안 폴더에 사용되는 아이콘. |
QIcon::ThemeIcon::ImageLoading | 124 | 다른 이미지가 로드되는 동안 사용되는 아이콘. |
QIcon::ThemeIcon::ImageMissing | 125 | 다른 이미지를 불러올 수 없을 때 사용되는 아이콘. |
QIcon::ThemeIcon::MailAttachment | 126 | 첨부 파일이 포함된 메시지의 아이콘. |
QIcon::ThemeIcon::MailUnread | 127 | 읽지 않은 메시지의 아이콘. |
QIcon::ThemeIcon::MailRead | 128 | 읽은 메시지의 아이콘. |
QIcon::ThemeIcon::MailReplied | 129 | 답장이 달린 메시지의 아이콘. |
QIcon::ThemeIcon::MediaPlaylistRepeat | 130 | 미디어 플레이어의 반복 모드 아이콘. |
QIcon::ThemeIcon::MediaPlaylistShuffle | 131 | 미디어 플레이어의 셔플 모드 아이콘. |
QIcon::ThemeIcon::NetworkOffline | 132 | 기기가 네트워크에 연결되어 있지 않음을 나타내는 아이콘. |
QIcon::ThemeIcon::PrinterPrinting | 133 | 인쇄 작업이 인쇄 장치로 성공적으로 스풀링되는 동안 사용되는 아이콘. |
QIcon::ThemeIcon::SecurityHigh | 134 | 항목의 보안 수준이 높은 것으로 알려진 것을 나타내는 아이콘. |
QIcon::ThemeIcon::SecurityLow | 135 | 항목의 보안 수준이 낮은 것으로 알려진 것을 나타내는 데 사용되는 아이콘. |
QIcon::ThemeIcon::SoftwareUpdateAvailable | 136 | 업데이트가 사용 가능함을 나타내는 아이콘. |
QIcon::ThemeIcon::SoftwareUpdateUrgent | 137 | 긴급 업데이트가 사용 가능함을 나타내는 아이콘입니다. |
QIcon::ThemeIcon::SyncError | 138 | 기기 간 데이터 동기화를 시도하는 동안 오류가 발생했을 때 표시되는 아이콘입니다. |
QIcon::ThemeIcon::SyncSynchronizing | 139 | 기기 간 데이터 동기화가 성공적으로 진행 중일 때 표시되는 아이콘입니다. |
QIcon::ThemeIcon::UserAvailable | 140 | 사용자가 접속 가능함을 나타내는 아이콘. |
QIcon::ThemeIcon::UserOffline | 141 | 사용자가 연결되지 않았음을 나타내는 데 사용되는 아이콘. |
QIcon::ThemeIcon::WeatherClear | 142 | 하늘이 맑음을 나타내는 아이콘. |
QIcon::ThemeIcon::WeatherClearNight | 143 | 밤에 하늘이 맑음을 나타내는 아이콘. |
QIcon::ThemeIcon::WeatherFewClouds | 144 | 하늘이 부분적으로 구름이 낀 상태를 나타내는 아이콘. |
QIcon::ThemeIcon::WeatherFewCloudsNight | 145 | 밤에 하늘이 부분적으로 구름이 낀 것을 나타내는 아이콘. |
QIcon::ThemeIcon::WeatherFog | 146 | 안개가 낀 날씨를 나타내는 아이콘. |
QIcon::ThemeIcon::WeatherShowers | 147 | 소나기가 내리고 있음을 나타내는 아이콘. |
QIcon::ThemeIcon::WeatherSnow | 148 | 눈이 내리고 있음을 나타내는 아이콘입니다. |
QIcon::ThemeIcon::WeatherStorm | 149 | 폭풍우가 치고 있음을 나타내는 아이콘입니다. |
이 열거형은 Qt 6.7에서 도입되었습니다.
Creating an icon from a theme or icon library 및 fromTheme()도 참조하십시오 .
멤버 함수 문서
[noexcept] QIcon::QIcon()
null 아이콘을 생성합니다.
[explicit] QIcon::QIcon(QIconEngine *engine)
engine 에 지정된 아이콘을 사용하여 아이콘을 생성합니다. 이 아이콘은 엔진의 소유권을 가져옵니다.
QIcon::QIcon(const QPixmap &pixmap)
pixmap 를 사용하여 아이콘을 생성합니다.
[explicit] QIcon::QIcon(const QString &fileName)
지정된 ` fileName`을 사용하여 파일로부터 아이콘을 생성합니다. 파일은 필요에 따라 로드됩니다.
fileName 에 상대 경로(예: 파일 이름만)가 포함된 경우, 해당 파일은 런타임 작업 디렉터리를 기준으로 찾아야 합니다.
파일 이름은 디스크에 실제로 존재하는 파일을 가리킬 수도 있고, 애플리케이션의 내장 리소스 중 하나를 가리킬 수도 있습니다. 애플리케이션 실행 파일에 이미지 및 기타 리소스 파일을 내장하는 방법에 대한 자세한 내용은 리소스 시스템 개요를 참조하십시오.
QImageReader::supportedImageFormats() 및 QImageWriter::supportedImageFormats() 함수를 사용하여 지원되는 파일 형식의 전체 목록을 확인하십시오.
QIcon::QIcon(const QIcon &other)
other 의 복사본을 생성합니다. 이 작업은 매우 빠르게 수행됩니다.
[noexcept] QIcon::QIcon(QIcon &&other)
QIcon 인스턴스를 이동 생성하여, 해당 인스턴스가 ` other `가 가리키던 것과 동일한 객체를 가리키도록 합니다.
[noexcept] QIcon::~QIcon()
아이콘을 삭제합니다.
QSize QIcon::actualSize(const QSize &size, QIcon::Mode mode = Normal, QIcon::State state = Off) const
요청된 size, mode 및 state 에 대한 아이콘의 실제 크기를 반환합니다. 결과는 요청된 크기보다 작을 수는 있지만, 결코 크지는 않습니다. 반환된 크기는 장치 독립 픽셀(DIP) 단위입니다(이는 고해상도 픽스맵의 경우 관련이 있습니다).
void QIcon::addFile(const QString &fileName, const QSize &size = QSize(), QIcon::Mode mode = Normal, QIcon::State state = Off)
size, mode 및 state 의 특화 기능으로서, 지정된 fileName 를 가진 파일의 이미지를 아이콘에 추가합니다. 해당 파일은 필요에 따라 로드됩니다. 참고: 사용자 정의 아이콘 엔진은 추가로 추가된 픽스맵을 무시해도 무방합니다.
fileName 에 상대 경로(예: 파일명만)가 포함된 경우, 해당 파일은 런타임 작업 디렉터리를 기준으로 찾아야 합니다.
파일 이름은 디스크에 실제로 존재하는 파일을 가리킬 수도 있고, 애플리케이션에 내장된 리소스 중 하나를 가리킬 수도 있습니다. 애플리케이션 실행 파일에 이미지 및 기타 리소스 파일을 내장하는 방법에 대한 자세한 내용은 리소스 시스템 개요를 참조하십시오.
QImageReader::supportedImageFormats() 및 QImageWriter::supportedImageFormats() 함수를 사용하여 지원되는 파일 형식의 전체 목록을 확인하십시오.
이미지의 고해상도 버전이 존재하는 경우(기본 이름에 @2x 접미사가 붙어 있음), 해당 이미지는 자동으로 로드되며 장치 픽셀 비율이 2로 설정된 상태로 추가됩니다. 이 기능은 QT_HIGHDPI_DISABLE_2X_IMAGE_LOADING 환경 변수를 설정하여 비활성화할 수 있습니다( QImageReader 참조).
참고: QIcon 에 비어 있지 않은 파일 이름을추가하면 , 파일이 존재하지 않거나 손상된 파일을 가리키더라도 아이콘은 null이 아닙니다.
addPixmap() 및 QPixmap::devicePixelRatio()도 참조하십시오 .
void QIcon::addPixmap(const QPixmap &pixmap, QIcon::Mode mode = Normal, QIcon::State state = Off)
mode 와 state 의 하위 유형으로, 아이콘에 ‘ pixmap ’를 추가합니다.
사용자 정의 아이콘 엔진은 추가로 추가된 픽스맵을 무시해도 무방합니다.
addFile()도 참조하십시오 .
QList<QSize> QIcon::availableSizes(QIcon::Mode mode = Normal, QIcon::State state = Off) const
지정된 mode 및 state 에 대해 사용 가능한 아이콘 크기 목록을 반환합니다.
qint64 QIcon::cacheKey() const
이 QIcon 객체의 내용을 식별하는 숫자를 반환합니다. 서로 다른 QIcon 객체라도 동일한 내용을 가리키는 경우 동일한 키를 가질 수 있습니다.
addPixmap() 또는 addFile()을 통해 아이콘이 변경되면 cacheKey()도 변경됩니다.
캐시 키는 주로 캐싱과 함께 사용할 때 유용합니다.
QPixmap::cacheKey()도 참조하십시오 .
[static] QStringList QIcon::fallbackSearchPaths()
아이콘에 대한 대체 검색 경로를 반환합니다.
current icon theme 또는 fallback icon theme 에서 아이콘 조회 시 결과가 제공되지 않을 경우, 독립형 아이콘 파일을 찾기 위해 대체 검색 경로가 참조됩니다.
설정되지 않은 경우, 대체 검색 경로는 플랫폼에 의해 정의됩니다.
setFallbackSearchPaths() 및 themeSearchPaths()도 참조하십시오 .
[static] QString QIcon::fallbackThemeName()
대체 아이콘 테마의 이름을 반환합니다.
설정되지 않은 경우, 대체 아이콘 테마는 플랫폼에 의해 정의됩니다.
참고: 플랫폼 대체 아이콘 테마는 현재 Freedesktop 기반 시스템에서만 구현되어 있으며, 아이콘 테마는 데스크톱 설정에 따라 달라집니다.
setFallbackThemeName() 및 themeName()도 참조하십시오 .
[static] QIcon QIcon::fromTheme(const QString &name)
current icon theme 에서 name 에 해당하는 QIcon 를 반환합니다.
현재 테마에 name 에 해당하는 아이콘이 없는 경우, fallback icon theme 를 먼저 확인한 후, fallback icon search path 에 있는 독립형 아이콘 파일을 검색합니다. 마지막으로 플랫폼의 기본 아이콘 라이브러리를 확인합니다.
현재 아이콘 테마에서 아이콘을 가져오려면:
icon theme 가 setThemeName()를 통해 명시적으로 설정되지 않은 경우, 플랫폼에서 정의한 아이콘 테마가 사용됩니다.
themeName(), fallbackThemeName(), setThemeName(), themeSearchPaths(), fallbackSearchPaths() 및 Freedesktop 아이콘 명명 사양도참조하십시오 .
[static, since 6.7] QIcon QIcon::fromTheme(QIcon::ThemeIcon icon)
[static, since 6.7] QIcon QIcon::fromTheme(QIcon::ThemeIcon icon, const QIcon &fallback)
current icon theme 에서 icon 에 해당하는 QIcon 를 반환합니다.
현재 테마에서 icon 에 대한 아이콘을 제공하지 않는 경우, fallback icon theme 를 먼저 확인한 후, fallback icon search path 에 있는 독립형 아이콘 파일을 검색합니다. 마지막으로 플랫폼의 기본 아이콘 라이브러리를 확인합니다.
아이콘을 찾을 수 없지만 fallback 가 제공된 경우, fallback 가 반환됩니다. 이는 현재 설정된 아이콘 테마 및 대체 경로 세트가 요청된 아이콘을 지원하는지 여부와 관계없이 확실한 대체 옵션을 제공하는 데 유용합니다.
아이콘을 찾을 수 없고 fallback 도 제공되지 않은 경우, 기본 생성된 빈 QIcon 가 반환됩니다.
이 함수들은 Qt 6.7에서 도입되었습니다.
[static] QIcon QIcon::fromTheme(const QString &name, const QIcon &fallback)
current icon theme 에서 name 에 해당하는 QIcon 를 반환합니다.
현재 테마에서 name 에 대한 아이콘을 제공하지 않는 경우, fallback icon theme 를 먼저 확인한 후, fallback icon search path 에 있는 독립형 아이콘 파일을 검색합니다. 마지막으로 플랫폼의 기본 아이콘 라이브러리를 확인합니다.
아이콘이 발견되지 않으면 fallback 가 반환됩니다.
이는 현재 설정된 아이콘 테마 및 대체 경로 세트가 요청된 아이콘을 지원하는지 여부와 관계없이, 확실한 대체 옵션을 제공하는 데 유용합니다.
예를 들어:
이 함수는 오버로드된 함수입니다.
fallbackThemeName() 및 fallbackSearchPaths()도 참조하십시오 .
[static] bool QIcon::hasThemeIcon(const QString &name)
fromTheme()에 설명된 대로, 현재 아이콘 테마나 대체 테마 중 어느 곳에서든 name 에 대한 아이콘이 있는 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다.
themeSearchPaths(), fromTheme(), setThemeName()도 참조하십시오 .
[static, since 6.7] bool QIcon::hasThemeIcon(QIcon::ThemeIcon icon)
fromTheme()에 설명된 대로, 현재 아이콘 테마나 대체 테마 중 어느 곳에서든 ` icon `에 대한 아이콘이 있는 경우 ` true `을 반환하고, 그렇지 않으면 ` false`을 반환합니다.
이 함수는 오버로드된 함수입니다.
이 함수는 Qt 6.7에서 도입되었습니다.
fromTheme()도 참조하십시오 .
bool QIcon::isMask() const
이 아이콘이 마스크 이미지로 표시된 경우 ` true `를 반환합니다. 일부 플랫폼에서는 마스크 아이콘을 다르게 렌더링합니다(예: macOS의 메뉴 아이콘).
setIsMask()도 참조하십시오 .
bool QIcon::isNull() const
아이콘이 비어 있으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.
아이콘에 픽스맵도 파일 이름도 없는 경우, 해당 아이콘은 비어 있는 것으로 간주됩니다.
참고: null이 아닌 아이콘이라도, 예를 들어 파일이 존재하지 않거나 읽을 수 없는 경우 등에는 유효한 픽스맵을 생성하지 못할 수도 있습니다.
QString QIcon::name() const
가능한 경우, 아이콘을 생성할 때 사용된 이름을 반환합니다.
아이콘이 생성된 방식에 따라 해당 아이콘에 이름이 연결되어 있을 수 있습니다. 이는 fromTheme()를 사용하여 생성된 아이콘의 경우입니다.
fromTheme() 및 QIconEngine::iconName()도 참조하십시오 .
void QIcon::paint(QPainter *painter, const QRect &rect, Qt::Alignment alignment = Qt::AlignCenter, QIcon::Mode mode = Normal, QIcon::State state = Off) const
painter 를 사용하여 지정된 alignment, 필수 mode 및 state 를 직사각형 rect 내에 아이콘으로 그립니다.
actualSize() 및 pixmap()도 참조하십시오 .
void QIcon::paint(QPainter *painter, int x, int y, int w, int h, Qt::Alignment alignment = Qt::AlignCenter, QIcon::Mode mode = Normal, QIcon::State state = Off) const
QRect(x, y, w, h) 크기의 사각형 안에 아이콘을 그립니다.
이 함수는 오버로드된 함수입니다.
QPixmap QIcon::pixmap(const QSize &size, QIcon::Mode mode = Normal, QIcon::State state = Off) const
요청된 size, mode 및 state 을 가진 픽스맵을 반환하며, 필요한 경우 이를 생성합니다. 반환된 픽스맵의 장치 픽셀 비율이 1보다 크지 않은 한, 픽스맵의 크기는 요청된 크기보다 작을 수는 있으나 절대 더 클 수는 없습니다.
actualSize() 및 paint()도 참조하십시오 .
QPixmap QIcon::pixmap(int extent, QIcon::Mode mode = Normal, QIcon::State state = Off) const
QSize(extent, extent) 크기의 픽스맵을 반환합니다. 반환된 픽스맵의 장치 픽셀 비율이 1보다 크지 않은 한, 픽스맵의 크기는 요청된 크기보다 작을 수는 있지만 절대 더 클 수는 없습니다.
이 함수는 오버로드된 함수입니다.
[since 6.0] QPixmap QIcon::pixmap(const QSize &size, qreal devicePixelRatio, QIcon::Mode mode = Normal, QIcon::State state = Off) const
요청된 size, devicePixelRatio, mode 및 state 값을 가진 픽스맵을 반환하며, 필요한 경우 주어진 mode 및 state 값을 사용하여 픽스맵을 생성합니다. 반환된 픽스맵의 디바이스 픽셀 비율이 1보다 크지 않은 한, 픽스맵의 크기는 요청된 크기보다 작을 수는 있지만 절대 크지 않습니다.
참고: 요청된devicePixelRatio가 반환된 값과 일치하지 않을 수 있습니다. 이 경우 QPixmap 의 크기 조정은 나중에 그려질 때까지 지연됩니다.
참고: Qt 6.8이전에는 이 함수가 장치 종속적인 픽스맵 크기를 QIconEngine::scaledPixmap()에 잘못 전달했으나, Qt 6.8부터는 장치 독립적인 크기( devicePixelRatio 로 스케일링되지 않은)를 전달합니다.
이 함수는 오버로드된 함수입니다.
이 함수는 Qt 6.0에서 도입되었습니다.
actualSize() 및 paint()도 참조하십시오 .
QPixmap QIcon::pixmap(int w, int h, QIcon::Mode mode = Normal, QIcon::State state = Off) const
QSize 크기의 픽스맵을 반환합니다(w, h). 반환된 픽스맵의 디바이스 픽셀 비율이 1보다 크지 않은 한, 픽스맵의 크기는 요청된 크기보다 작을 수는 있으나 절대 더 크지는 않습니다.
이 함수는 오버로드된 함수입니다.
[static] void QIcon::setFallbackSearchPaths(const QStringList &paths)
아이콘에 대한 대체 검색 경로를 paths 로 설정합니다.
current icon theme 또는 fallback icon theme 에서 아이콘 조회에 대한 결과를 제공하지 않는 경우, 독립형 아이콘 파일을 찾기 위해 대체 검색 경로가 참조됩니다.
예:
fallbackSearchPaths() 및 setThemeSearchPaths()도 참조하십시오 .
[static] void QIcon::setFallbackThemeName(const QString &name)
대체 아이콘 테마를 name 로 설정합니다.
current icon theme 에서 제공하지 않는 아이콘이 있거나, current icon theme 가 존재하지 않는 경우 대체 아이콘 테마가 참조됩니다.
name 은 setThemeName()에 문서화된 형식과 동일한 형식의 테마와 일치해야 하며, themeSearchPaths()에서 조회됩니다.
참고: 올바른 초기화를 보장하기 위해 QGuiApplication 를 생성하기 전에대체 아이콘 테마를 설정해야 합니다.
fallbackThemeName(), themeSearchPaths(), themeName()도 참조하십시오 .
void QIcon::setIsMask(bool isMask)
이 아이콘이 마스크 이미지(부울형 isMask)임을 나타내며, 따라서 표시되는 위치에 따라 수정될 수 있음을 의미합니다.
isMask()도 참조하십시오 .
[static] void QIcon::setThemeName(const QString &name)
현재 아이콘 테마를 name 로 설정합니다.
테마 이름이 명명된 글리프를 제공하는 설치된 글꼴의 이름과 일치하는 경우, 해당 글리프 중 하나와 일치하는 QIcon::fromTheme 호출이 해당 글리프에 대한 아이콘을 생성합니다.
그렇지 않은 경우, themeSearchPaths()에서 테마를 검색합니다. 현재 지원되는 유일한 아이콘 테마 형식은 Freedesktop 아이콘 테마 사양입니다. name 는 themeSearchPath() 내의 디렉터리 이름과 일치해야 하며, 해당 디렉터리에는 내용을 설명하는 index.theme 파일이 포함되어 있어야 합니다.
themeSearchPaths(), themeName() 및 Freedesktop 아이콘 테마 사양도참조하십시오 .
[static] void QIcon::setThemeSearchPaths(const QStringList &paths)
아이콘 테마의 검색 경로를 paths 로 설정합니다.
paths 의 내용은 setThemeName()에 문서화된 테마 형식을 따라야 합니다.
themeSearchPaths(), fromTheme(), setThemeName()도 참조하십시오 .
[noexcept] void QIcon::swap(QIcon &other)
이 아이콘을 other 로 교체합니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.
[static] QString QIcon::themeName()
현재 아이콘 테마의 이름을 반환합니다.
설정되지 않은 경우, 현재 아이콘 테마는 플랫폼에 의해 정의됩니다.
참고: 플랫폼 아이콘 테마는 현재 Freedesktop 기반 시스템에서만 구현되어 있으며, 아이콘 테마는 데스크톱 설정에 따라 달라집니다.
setThemeName(), themeSearchPaths(), fromTheme() 및 hasThemeIcon()도 참조하십시오 .
[static] QStringList QIcon::themeSearchPaths()
아이콘 테마에 대한 검색 경로를 반환합니다.
기본 검색 경로는 플랫폼에 따라 정의됩니다. 또한 모든 플랫폼에는 대체 경로로 :\icons 리소스 디렉터리가 제공됩니다.
setThemeSearchPaths(), fromTheme() 및 setThemeName()도 참조하십시오 .
QIcon::operator QVariant() const
아이콘을 ` QVariant` 형식으로 반환합니다.
[noexcept] QIcon &QIcon::operator=(QIcon &&other)
other 를 이 QIcon 인스턴스에 할당합니다.
QIcon &QIcon::operator=(const QIcon &other)
이 아이콘에 ‘ other ’ 아이콘을 할당하고, 이 아이콘에 대한 참조를 반환합니다.
관련 비회원
QDataStream &operator<<(QDataStream &stream, const QIcon &icon)
지정된 ` icon `를 지정된 ` stream `에 PNG 이미지로 기록합니다. 아이콘에 두 개 이상의 이미지가 포함된 경우, 모든 이미지가 스트림에 기록됩니다. 스트림을 파일에 기록한다고 해서 유효한 이미지 파일이 생성되는 것은 아니라는 점에 유의하십시오.
QDataStream &operator>>(QDataStream &stream, QIcon &icon)
지정된 ` stream `에서 이미지 하나 또는 여러 개를 읽어와, 지정된 ` icon`로 저장합니다.
© 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.
