Qt 스타일 시트 참조

Qt 스타일 시트는 위젯의 모양을 사용자 정의할 수 있는 다양한 프로퍼티, 의사 상태, 서브 컨트롤을 지원합니다.

스타일 가능한 위젯 목록

다음 표에는 스타일 시트를 사용하여 사용자 정의할 수 있는 Qt 위젯이 나열되어 있습니다:

QPushButton { background-color: red; border: none; }

QToolButton { background-color: red; border: none; }

void CustomWidget::paintEvent(QPaintEvent *)
{ QStyleOption opt; opt.initFrom(this);    QPainter p(this); style()->drawPrimitive(QStyle::PE_Widget, &opt,&p, this); }

속성 목록

이 섹션에는 Qt 스타일 시트에서 지원하는 모든 프로퍼티가 나열되어 있습니다. 프로퍼티에 지정할 수 있는 값은 프로퍼티의 유형에 따라 다릅니다. 달리 명시되지 않는 한, 다음 프로퍼티는 모든 위젯에 적용됩니다. 별표 *로 표시된 프로퍼티는 Qt에만 해당되며 CSS2나 CSS3에는 해당 프로퍼티가 없습니다. Qt 전용 프로퍼티는 다음과 같습니다:

• 격자선-색*
• image*
• lineedit-password-character*
• lineedit-password-mask-delay*
• 메시지박스-텍스트-인터랙션-플래그*
• 불투명도*
• 플레이스홀더-텍스트-색상*
• 선택-배경색*
• 선택 색상*
• 표시-장식-선택됨*
• 간격*
• 서브컨트롤-원본*
• 서브컨트롤-위치*
• 위젯-애니메이션-지속시간*

액센트 색상

이 속성은 대화형 UI 요소를 강조하는 데 사용되는 Accent 색상을 설정합니다. 이 속성을 설정하지 않으면 기본값은 highlight 색상입니다.

대체 배경색

QAbstractItemView 하위 클래스에서 사용되는 alternate background color.

이 속성이 설정되지 않은 경우 기본값은 팔레트의 AlternateBase 역할에 설정된 값입니다.

예시:

QTreeView {
    alternate-background-color: blue;
    background: yellow;
}

배경 및 선택 배경색도 참조하세요.

배경

배경을 설정하기 위한 속기 표기법입니다. background-color , background-image, background-repeat 및/또는 background-position 을 지정하는 것과 동일합니다.

이 속성은 QAbstractItemView 서브클래스, QAbstractSpinBox 서브클래스, QCheckBox, QComboBox, QDialog, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip, 그리고 일반 QWidgets에서 지원됩니다.

예제:

QTextEdit { background: yellow }

종종 Qt::BrushStyle 의 스타일과 유사한 채우기 패턴을 설정해야 하는 경우가 있습니다. Qt::SolidPattern, Qt::RadialGradientPattern, Qt::LinearGradientPattern 및 Qt::ConicalGradientPattern 에 배경색 속성을 사용할 수 있습니다. 다른 패턴은 해당 패턴이 포함된 배경 이미지를 생성하면 쉽게 구현할 수 있습니다.

예시:

QLabel {
    background-image: url(dense6pattern.png);
    background-repeat: repeat-xy;
}

배경 원본, 선택 배경 색상, 배경 클립, 배경 첨부 및 대체 배경 색상도 참조하세요.

background-color

위젯에 사용되는 배경색입니다.

예시:

QLabel { background-color: yellow }
QLineEdit { background-color: rgb(255, 0, 0) }

background-image

위젯에 사용되는 배경 이미지입니다. 이미지의 반투명 부분을 통해 background-color 을 볼 수 있습니다.

예시:

QFrame { background-image: url(:/images/hydro.png) }

배경 반복

background-origin 직사각형을 채우기 위해 배경 이미지를 반복할지 여부 및 반복 방식입니다.

이 속성을 지정하지 않으면 배경 이미지가 양방향으로 반복됩니다(repeat).

예시:

QFrame {
    background: white url(:/images/ring.png);
    background-repeat: repeat-y;
    background-position: left;
}

background-position

background-origin 사각형 내 배경 이미지의 정렬입니다.

이 속성을 지정하지 않으면 정렬은 top left 입니다.

예시:

QFrame {
    background: url(:/images/footer.png);
    background-position: bottom left;
}

background-attachment

QAbstractScrollArea 의 배경 이미지를 뷰포트에 따라 스크롤할지 고정할지 결정합니다. 기본적으로 배경 이미지는 뷰포트와 함께 스크롤됩니다.

예제:

QTextEdit {
    background-image: url("leaves.png");
    background-attachment: fixed;
}

배경 참조

background-clip

background 이 그려지는 위젯의 사각형입니다.

이 속성은 background-color 및 background-image 이 클리핑되는 직사각형을 지정합니다.

이 프로퍼티는 QAbstractItemView 서브클래스, QAbstractSpinBox 서브클래스, QCheckBox, QComboBox, QDialog, QFrame, QGroupBox, QLabel, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip, 일반 QWidget에서 지원됩니다.

이 속성을 지정하지 않으면 기본값은 border 입니다.

예제:

QFrame {
    background-image: url(:/images/header.png);
    background-position: top left;
    background-origin: content;
    background-clip: padding;
}

배경, 배경-출처 및 상자 모델도 참조하세요.

배경-출처

background-position 및 background-image 과 함께 사용할 위젯의 배경 사각형입니다.

이 프로퍼티는 QAbstractItemView 서브클래스, QAbstractSpinBox 서브클래스, QCheckBox, QComboBox, QDialog, QFrame, QGroupBox, QLabel, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip, 그리고 일반 QWidget에서 지원됩니다.

이 속성을 지정하지 않으면 기본값은 padding 입니다.

예제:

QFrame {
    background-image: url(:/images/header.png);
    background-position: top left;
    background-origin: content;
}

배경 및 상자 모델도 참조하세요.

테두리

위젯의 테두리를 설정하기 위한 속기 표기법입니다. border-color , border-style 및/또는 border-width 를 지정하는 것과 동일합니다.

이 속성은 QAbstractItemView 서브클래스, QAbstractSpinBox 서브클래스, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip 및 일반 QWidgets에서 지원됩니다.

예제:

QLineEdit { border: 1px solid white }

border-top

위젯의 상단 테두리를 설정하기 위한 약식 표기법입니다. border-top-color , border-top-style 및/또는 border-top-width 를 지정하는 것과 동일합니다.

border-right

위젯의 오른쪽 테두리를 설정하기 위한 약식 표기법입니다. border-right-color , border-right-style 및/또는 border-right-width 를 지정하는 것과 동일합니다.

border-bottom

위젯의 하단 테두리를 설정하기 위한 속기 표기법입니다. border-bottom-color , border-bottom-style 및/또는 border-bottom-width 를 지정하는 것과 동일합니다.

border-left

위젯의 왼쪽 테두리를 설정하기 위한 약식 표기법입니다. border-left-color , border-left-style 및/또는 border-left-width 를 지정하는 것과 동일합니다.

테두리 색상

모든 테두리 가장자리의 색상입니다. border-top-color , border-right-color, border-bottom-color, border-left-color 을 지정하는 것과 동일합니다.

이 프로퍼티는 QAbstractItemView 서브클래스, QAbstractSpinBox 서브클래스, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip 및 일반 QWidgets에서 지원됩니다.

이 속성을 지정하지 않으면 기본값은 색상 (즉, 위젯의 전경색)입니다.

예시:

QLineEdit {
    border-width: 1px;
    border-style: solid;
    border-color: white;
}

테두리 스타일, 테두리 너비, 테두리 이미지 및 상자 모델도 참조하세요.

테두리 상단 색상

테두리 상단 가장자리의 색상입니다.

테두리 오른쪽 색상

테두리의 오른쪽 가장자리의 색상입니다.

테두리-하단 색상

테두리 하단 가장자리의 색상입니다.

테두리 왼쪽 색상

테두리 왼쪽 가장자리의 색상입니다.

테두리 이미지

테두리를 채우는 데 사용되는 이미지입니다. 이미지는 9개 부분으로 잘려서 필요한 경우 적절하게 늘어납니다. 자세한 내용은 테두리 이미지를 참조하세요.

이 속성은 QAbstractItemView 서브클래스, QAbstractSpinBox 서브클래스, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit 및 QToolTip 에서 지원됩니다.

테두리 색상, 테두리 스타일, 테두리 너비 및 상자 모델도 참조하세요.

테두리-반경

테두리 모서리의 반경입니다. border-top-left-radius , border-top-right-radius, border-bottom-right-radius, border-bottom-left-radius 을 지정하는 것과 같습니다.

테두리 반경은 요소의 배경을 잘라냅니다.

이 속성은 QAbstractItemView 서브클래스, QAbstractSpinBox 서브클래스, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip 에서 지원됩니다.

이 속성을 지정하지 않으면 기본값은 0입니다.

예시:

QLineEdit {
    border-width: 1px;
    border-style: solid;
    border-radius: 4px;
}

테두리 너비 및 상자 모델도 참조하세요.

테두리 상단-왼쪽 반경

테두리의 왼쪽 상단 모서리 반경입니다.

테두리 상단 오른쪽 반경

테두리의 오른쪽 상단 모서리 반경입니다.

테두리-우측 하단-반경

테두리의 오른쪽 하단 모서리 반경입니다. 이 속성을 양수 값으로 설정하면 모서리가 둥글게 됩니다.

테두리-하단-왼쪽-반경

테두리의 왼쪽 하단 모서리 반경입니다. 이 속성을 양수 값으로 설정하면 모서리가 둥글게 됩니다.

테두리 스타일

모든 테두리 가장자리의 스타일입니다.

이 속성은 QAbstractItemView 서브클래스, QAbstractSpinBox 서브클래스, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip 에서 지원됩니다.

이 속성을 지정하지 않으면 기본값은 none 입니다.

예제:

QLineEdit {
    border-width: 1px;
    border-style: solid;
    border-color: blue;
}

테두리 색상, 테두리 스타일, 테두리 이미지 및 상자 모델도 참조하세요.

테두리 상단 스타일

테두리 상단 가장자리의 스타일입니다.

테두리 오른쪽 스타일

테두리의 오른쪽 가장자리 스타일입니다.

테두리-하단 스타일

테두리 하단 가장자리의 스타일입니다.

테두리 왼쪽 스타일

테두리의 왼쪽 가장자리 스타일입니다.

테두리 너비

테두리의 너비입니다. border-top-width , border-right-width, border-bottom-width, border-left-width 을 설정하는 것과 같습니다.

이 프로퍼티는 QAbstractItemView 서브클래스, QAbstractSpinBox 서브클래스, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip 에서 지원됩니다.

예제:

QLineEdit {
    border-width: 2px;
    border-style: solid;
    border-color: darkblue;
}

테두리 색상, 테두리 반경, 테두리 스타일, 테두리 이미지 및 상자 모델도 참조하십시오.

테두리 상단 너비

테두리 상단 가장자리의 너비입니다.

테두리 오른쪽 너비

테두리의 오른쪽 가장자리의 너비입니다.

테두리-하단 너비

테두리의 아래쪽 가장자리의 너비입니다.

테두리 왼쪽 너비

테두리의 왼쪽 가장자리의 너비입니다.

bottom

위치가 relative (기본값)인 경우, 하위 컨트롤을 일정 오프셋만큼 위로 이동합니다. bottom: y 를 지정하는 것은 top: -y.

위치가 absolute 인 경우 bottom 속성은 하위 컨트롤의 아래쪽 가장자리를 상위 컨트롤의 아래쪽 가장자리와 관련하여 지정합니다( 하위 컨트롤-원점 참조).

예시:

QSpinBox::down-button { bottom: 2px }

왼쪽, 오른쪽 및 위쪽도 참조하세요.

버튼 레이아웃

QDialogButtonBox 또는 QMessageBox 의 버튼 레이아웃입니다. 가능한 값은 0(WinLayout), 1(MacLayout), 2(KdeLayout), 3(GnomeLayout), 5(AndroidLayout)입니다.

이 속성을 지정하지 않으면 기본값은 SH_DialogButtonLayout 스타일 힌트의 현재 스타일에 지정된 값으로 설정됩니다.

예시:

* { button-layout: 2 }

color

텍스트를 렌더링하는 데 사용되는 색상입니다.

이 프로퍼티는 QWidget::palette 을 준수하는 모든 위젯에서 지원됩니다.

이 속성이 설정되지 않은 경우 기본값은 위젯의 팔레트에 설정된 QWidget::foregroundRole (일반적으로 검은색)입니다.

예시:

QPushButton { color: red }

배경 및 선택 색상도 참조하세요.

대화 상자 버튼-버튼-아이콘 포함

QDialogButtonBox 버튼에 아이콘 표시 여부

이 속성을 1로 설정하면 QDialogButtonBox 의 버튼에 아이콘이 표시되고, 0으로 설정하면 아이콘이 표시되지 않습니다.

아이콘을 설정하는 방법에 대한 자세한 내용은 아이콘 목록 섹션을 참조하세요.

QDialogButtonBox { dialogbuttonbox-buttons-have-icons: 1; }

font

텍스트 글꼴을 설정하기 위한 속기 표기법입니다. font-family , font-size, font-style 및/또는 font-weight 을 지정하는 것과 동일합니다.

이 프로퍼티는 QWidget::font 을 준수하는 모든 위젯에서 지원됩니다.

이 속성을 설정하지 않으면 기본값은 QWidget::font 입니다.

예시:

QCheckBox { font: bold italic large "Times New Roman" }

font-family

글꼴 패밀리입니다.

예제:

QCheckBox { font-family: "New Century Schoolbook" }

글꼴 크기

글꼴 크기입니다. 이 버전의 Qt에서는 pt 및 px 메트릭만 지원됩니다.

예시:

QTextEdit { font-size: 12px }

font-style

글꼴 스타일입니다.

예시:

QTextEdit { font-style: italic }

font-weight

글꼴의 무게입니다.

그리드선 색상*

QTableView 에서 그리드 선의 색상입니다.

이 속성을 지정하지 않으면 기본값은 SH_Table_GridLineColor 스타일 힌트의 현재 스타일에 지정된 값으로 설정됩니다.

예시:

* { gridline-color: gray }

height

하위 컨트롤(또는 경우에 따라 위젯)의 높이입니다.

이 속성을 지정하지 않으면 기본적으로 하위 컨트롤/위젯과 현재 스타일에 따라 달라지는 값으로 설정됩니다.

예시:

QSpinBox::down-button { height: 10px }

너비도 참조하세요.

icon

아이콘이 있는 위젯의 경우 사용되는 아이콘입니다.

현재 이 속성을 지원하는 유일한 위젯은 QPushButton 입니다.

5.15부터 사용 가능.

아이콘 크기

위젯에서 아이콘의 너비와 높이입니다.

이 속성을 사용하여 다음 위젯의 아이콘 크기를 설정할 수 있습니다.

• QCheckBox
• QListView
• QPushButton
• QRadioButton
• QTabBar
• QToolBar
• QToolBox
• QTreeView

이미지*

하위 컨트롤의 콘텐츠 사각형에 그려지는 이미지입니다.

이미지 속성은 URL목록 또는 svg 을 허용합니다. 실제 그려지는 이미지는 QIcon 과 동일한 알고리즘을 사용하여 결정됩니다(즉, 이미지가 확대되지 않고 필요한 경우 항상 축소됩니다). svg 을 지정하면 이미지의 크기가 콘텐츠 사각형의 크기에 맞게 조정됩니다.

하위 컨트롤에서 이미지 속성을 설정하면 하위 컨트롤의 너비와 높이가 암시적으로 설정됩니다(SVG의 이미지가 아닌 경우).

Qt 4.3 이상에서는 image-position을 사용하여 사각형 내 이미지의 정렬을 지정할 수 있습니다.

이 속성은 하위 컨트롤에만 사용되며 다른 요소에는 지원되지 않습니다.

예시:

// implicitly sets the size of down-button to the
// size of spindown.png
QSpinBox::down-button { image: url(:/images/spindown.png) }

image-position

Qt 4.3 이상에서는 이미지 위치의 정렬을 상대 위치 또는 절대 위치를 사용하여 지정할 수 있습니다.

왼쪽

위치가 relative (기본값)인 경우, 하위 컨트롤을 오른쪽으로 일정 오프셋만큼 이동합니다.

위치가 absolute 인 경우 left 속성은 하위 컨트롤의 왼쪽 가장자리를 상위 컨트롤의 왼쪽 가장자리와 관련하여 지정합니다( 하위 컨트롤-원점 참조).

이 속성을 지정하지 않으면 기본값은 0 입니다.

예시:

QSpinBox::down-button { left: 2px }

오른쪽, 위쪽 및 아래쪽도 참조하세요.

라인편집-비밀번호-문자*

유니코드 숫자로 된 QLineEdit 비밀번호 문자입니다.

이 속성을 지정하지 않으면 기본값은 SH_LineEdit_PasswordCharacter 스타일 힌트의 현재 스타일에 지정된 값으로 설정됩니다.

예시:

* { lineedit-password-character: 9679 }

lineedit-password-mask-delay*

라인 편집 비밀번호 마스크가 보이는 문자에 적용되기 전의 QLineEdit 비밀번호 마스크 지연 시간(밀리초)입니다.

이 속성을 지정하지 않으면 기본값은 SH_LineEdit_PasswordMaskDelay 스타일 힌트의 현재 스타일에 지정된 값으로 설정됩니다.

Qt 5.4부터 사용 가능합니다.

예제:

* { lineedit-password-mask-delay: 1000 }

margin

위젯의 여백입니다. margin-top , margin-right, margin-bottom, margin-left 을 지정하는 것과 같습니다.

이 프로퍼티는 QAbstractItemView 서브클래스, QAbstractSpinBox 서브클래스, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip 에서 지원됩니다.

이 속성을 지정하지 않으면 기본값은 0 입니다.

예제:

QLineEdit { margin: 2px }

패딩, 간격 및 상자 모델도 참조하세요.

margin-top

위젯의 상단 여백입니다.

여백-우측

위젯의 오른쪽 여백입니다.

여백-하단

위젯의 하단 여백입니다.

여백-왼쪽

위젯의 왼쪽 여백입니다.

최대 높이

위젯 또는 하위 컨트롤의 최대 높이입니다.

이 프로퍼티는 QAbstractItemView 서브클래스, QAbstractSpinBox 서브클래스, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, QToolTip 에서 지원됩니다.

값은 상자 모델의 내용 직사각형에 상대적입니다.

예시:

QSpinBox { max-height: 24px }

최대 너비도 참조하십시오.

최대 너비

위젯 또는 하위 컨트롤의 최대 너비입니다.

이 프로퍼티는 QAbstractItemView 서브클래스, QAbstractSpinBox 서브클래스, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, QToolTip 에서 지원됩니다.

값은 상자 모델의 내용 직사각형에 상대적입니다.

예시:

QComboBox { max-width: 72px }

최대 높이도 참조하십시오.

메시지박스-텍스트-인터랙션-플래그*

메시지 상자의 텍스트에 대한 상호 작용 동작입니다. 사용 가능한 값은 Qt::TextInteractionFlags 을 기준으로 합니다.

이 속성을 지정하지 않으면 기본값은 SH_MessageBox_TextInteractionFlags 스타일 힌트의 현재 스타일에 지정된 값으로 설정됩니다.

예시:

QMessageBox { messagebox-text-interaction-flags: 5 }

min-height

위젯 또는 하위 컨트롤의 최소 높이입니다.

이 프로퍼티는 QAbstractItemView 서브클래스, QAbstractSpinBox 서브클래스, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, QToolButton 및 QToolTip 에서 지원됩니다.

이 속성을 지정하지 않으면 위젯의 콘텐츠와 스타일에 따라 최소 높이가 파생됩니다.

이 값은 상자 모델의 콘텐츠 직사각형에 상대적인 값입니다.

예시:

QComboBox { min-height: 24px }

최소 너비도 참조하세요.

최소 너비

위젯 또는 하위 컨트롤의 최소 너비입니다.

이 프로퍼티는 QAbstractItemView 서브클래스, QAbstractSpinBox 서브클래스, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, QToolButton 및 QToolTip 에서 지원됩니다.

이 속성을 지정하지 않으면 위젯의 콘텐츠와 스타일에 따라 최소 너비가 파생됩니다.

이 값은 상자 모델의 콘텐츠 직사각형에 상대적입니다.

예시:

QComboBox { min-width: 72px }

최소 높이도 참조하세요.

불투명도*

위젯의 불투명도입니다. 가능한 값은 0(투명)에서 255(불투명)까지입니다. 현재로서는 tooltips 에서만 지원됩니다.

이 속성을 지정하지 않으면 기본값은 SH_ToolTipLabel_Opacity 스타일 힌트의 현재 스타일에 지정된 값으로 설정됩니다.

예시:

QToolTip { opacity: 223 }

outline

개체의 테두리 주위에 그려진 윤곽선입니다.

윤곽선-색

윤곽선의 색상입니다. 테두리 색 참조

윤곽선 오프셋

위젯의 테두리에서 윤곽선의 오프셋입니다.

아웃라인 스타일

윤곽선을 그리는 데 사용되는 패턴을 지정합니다. 테두리 스타일 참조

윤곽선 반경

윤곽선에 둥근 모서리를 추가합니다.

윤곽선-하단-왼쪽-반경

윤곽선의 왼쪽 하단 둥근 모서리의 반경입니다.

윤곽선-하단-오른쪽-반경

윤곽선의 오른쪽 하단 둥근 모서리의 반경입니다.

윤곽선 상단-왼쪽 반지름

윤곽선의 왼쪽 상단 모서리에 대한 반경입니다.

윤곽선 상단 오른쪽 반지름

윤곽선의 오른쪽 상단 둥근 모서리의 반경입니다.

패딩

위젯의 패딩입니다. padding-top , padding-right, padding-bottom, padding-left 을 지정하는 것과 같습니다.

이 프로퍼티는 QAbstractItemView 서브클래스, QAbstractSpinBox 서브클래스, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit 및 QToolTip 에서 지원됩니다.

이 속성을 지정하지 않으면 기본값은 0 입니다.

예제:

QLineEdit { padding: 3px }

여백, 간격 및 상자 모델도 참조하세요.

패딩 상단

위젯의 상단 패딩 길이입니다.

padding-right

위젯의 오른쪽 패딩입니다.

패딩-하단

위젯의 하단 패딩입니다.

패딩-왼쪽

위젯의 왼쪽 패딩입니다.

빈 영역에 대한 행 색상 변경 페인트

QTreeView 에서 빈 영역(즉, 항목이 없는 영역)에 행 색상을 번갈아 칠할지 여부입니다.

플레이스홀더-텍스트-색상*

텍스트 편집 위젯의 플레이스홀더 텍스트에 사용되는 색상입니다.

이 속성이 설정되지 않은 경우 기본값은 팔레트의 PlaceholderText 역할에 설정된 대로 사용됩니다.

예시:

QLineEdit { placeholder-text-color: #800000ff } /* semi-transparent blue */

6.5부터 사용 가능.

위치

왼쪽, 오른쪽, 위, 아래를 사용하여 지정한 오프셋이 상대 좌표인지 절대 좌표인지 여부입니다.

이 속성을 지정하지 않으면 기본값은 relative 입니다.

right

위치가 relative (기본값)인 경우, 하위 컨트롤을 왼쪽으로 일정 오프셋만큼 이동합니다. right: x 를 지정하는 것은 left: -x.

위치가 absolute 인 경우 right 속성은 하위 컨트롤의 오른쪽 가장자리를 부모의 오른쪽 가장자리와 관련하여 지정합니다( 하위 컨트롤-원점 참조).

예시:

QSpinBox::down-button { right: 2px }

왼쪽, 위쪽 및 아래쪽도 참조하세요.

선택-배경색*

선택한 텍스트 또는 항목의 배경입니다.

이 속성은 QWidget::palette 을 준수하고 선택 텍스트를 표시하는 모든 위젯에서 지원됩니다.

이 속성이 설정되지 않은 경우 기본값은 팔레트의 Highlight 역할에 설정된 값입니다.

예시:

QTextEdit { selection-background-color: darkblue }

선택 색상 및 배경도 참조하세요.

선택 색상*

선택한 텍스트 또는 항목의 전경색입니다.

이 속성은 QWidget::palette 을 준수하고 선택 텍스트를 표시하는 모든 위젯에서 지원됩니다.

이 속성이 설정되지 않은 경우 기본값은 팔레트의 HighlightedText 역할에 설정된 값입니다.

예시:

QTextEdit { selection-color: white }

선택-배경색 및 색상도 참조하세요.

표시-장식-선택됨*

QListView 에서 선택한 내용을 전체 행에 표시할지, 아니면 텍스트 범위만 표시할지 제어합니다.

이 속성을 지정하지 않으면 기본값은 SH_ItemView_ShowDecorationSelected 스타일 힌트의 현재 스타일에 지정된 값으로 설정됩니다.

예시:

* { show-decoration-selected: 1 }

spacing*

위젯의 내부 간격입니다.

이 속성은 QCheckBox 에서 지원되며 QGroupBoxes, QMenuBar, QRadioButton 에서 확인할 수 있습니다.

이 속성을 지정하지 않으면 기본값은 위젯과 현재 스타일에 따라 달라집니다.

예시:

QMenuBar { spacing: 10 }

패딩 및 여백도 참조하세요.

subcontrol-origin*

부모 요소 내 하위 컨트롤의 원점 사각형입니다.

이 속성을 지정하지 않으면 기본값은 padding 입니다.

예시:

QSpinBox::up-button {
    image: url(:/images/spinup.png);
    subcontrol-origin: content;
    subcontrol-position: right top;
}

하위 컨트롤 위치도 참조하세요.

서브컨트롤-위치*

하위 컨트롤-오리진으로 지정된 원점 사각형 내 하위 컨트롤의 정렬입니다.

이 속성을 지정하지 않으면 기본적으로 하위 컨트롤에 따라 달라지는 값으로 설정됩니다.

예시:

QSpinBox::down-button {
    image: url(:/images/spindown.png);
    subcontrol-origin: padding;
    subcontrol-position: right bottom;
}

하위 컨트롤 오리진도 참조하세요.

제목 표시줄-툴팁-온-버튼

창 제목 표시줄 버튼에 툴팁을 표시할지 여부입니다.

위젯-애니메이션-지속 시간*

애니메이션의 지속 시간(밀리초 단위)입니다. 0과 같은 값은 애니메이션이 비활성화됨을 의미합니다.

이 속성을 지정하지 않으면 기본값은 SH_Widget_Animation_Duration 스타일 힌트의 현재 스타일에 지정된 값으로 설정됩니다.

Qt 5.10부터 사용 가능합니다.

예제:

* { widget-animation-duration: 100 }

text-align

위젯 콘텐츠 내 텍스트와 아이콘의 정렬을 지정합니다.

이 값을 지정하지 않으면 기본값은 기본 스타일에 따라 달라지는 값으로 설정됩니다.

예시:

QPushButton {
    text-align: left;
}

이 속성은 현재 QPushButton 및 QProgressBar 에서만 지원됩니다.

text-decoration

추가 텍스트 효과.

top

위치가 relative (기본값)인 경우, 하위 컨트롤을 일정 오프셋만큼 아래로 이동합니다.

위치가 absolute 인 경우 top 속성은 부모 위쪽 가장자리와 관련하여 하위 컨트롤의 위쪽 가장자리를 지정합니다( 하위 컨트롤-원점 참조).

이 속성을 지정하지 않으면 기본값은 0 입니다.

예시:

QSpinBox::up-button { top: 2px }

왼쪽, 오른쪽 및 아래쪽도 참조하세요.

너비

하위 컨트롤(또는 경우에 따라 위젯)의 너비입니다.

이 속성을 지정하지 않으면 기본적으로 하위 컨트롤/위젯 및 현재 스타일에 따라 달라지는 값으로 설정됩니다.

예시:

QSpinBox::up-button { width: 12px }

높이도 참조하세요.

-qt-background-role

선택한 역할에 따라 하위 컨트롤 또는 위젯의 background-color.

-qt-style-features

Qt 전용 스타일을 적용할 CSS 속성 목록입니다.

아이콘 목록

Qt에서 사용되는 아이콘은 다음 속성을 사용하여 사용자 정의할 수 있습니다. 이 섹션에 나열된 각 프로퍼티의 유형은 Icon입니다.

QDialogButtonBox 의 버튼에 아이콘이 표시되도록 하려면 dialogbuttonbox-buttons-have-icons 속성을 true로 설정해야 합니다. 또한 아이콘의 크기를 사용자 지정하려면 icon-size 속성을 사용합니다.

속성 유형 목록

다음 표에는 다양한 속성 유형의 구문과 의미가 요약되어 있습니다.

QTextEdit { background-position: bottom center }

QDialog { etch-disabled-text: 1 }

/* red red red red */
QLabel { border-color: red }
/* red blue red blue */
QLabel { border-color: red blue }
/* red blue green blue */
QLabel { border-color: red blue green }
/* red blue green yellow */
QLabel { border-color: red blue green yellow }

/* 1px 1px 1px 1px */
QLabel { border-width: 1px }
/* 1px 2px 1px 2px */
QLabel { border-width: 1px 2px }
/* 1px 2px 3px 2px */
QLabel { border-width: 1px 2px 3px }
/* 1px 2px 3px 4px */
QLabel { border-width: 1px 2px 3px 4px }

/* opaque red */
QLabel { border-color: red }
/* opaque red */
QLabel { border-color: #FF0000 }
/* 75% opaque red */
QLabel { border-color: rgba(255, 0, 0, 75%) }
/* opaque red */
QLabel { border-color: rgb(255, 0, 0) }
/* opaque red */
QLabel { border-color: rgb(100%, 0%, 0%) }
/* opaque yellow */
QLabel { border-color: hsv(60, 100%, 100%) }
/* 75% blue */
QLabel { border-color: hsva(240, 255, 255, 75%) }
/* opaque yellow */
QLabel { border-color: hsl(60, 100%, 50%) }
/* 75% blue */
QLabel { border-color: hsla(240, 255, 50%, 75%) }

/* linear gradient from white to green */
QTextEdit {
    background: qlineargradient(x1:0, y1:0, x2:1, y2:1,
                stop:0 white, stop: 0.4 gray, stop:1 green)
}

/* linear gradient from white to green */
QTextEdit {
    background: qlineargradient(x1:0, y1:0, x2:1, y2:1,
                stop:0 white, stop: 0.4 rgba(10, 20, 30, 40),
                stop:1 rgb(0, 200, 230, 200))
}

/* conical gradient from white to green */
QTextEdit {
    background: qconicalgradient(cx:0.5, cy:0.5, angle:30,
                stop:0 white, stop:1 #00FF00)
}

/* radial gradient from white to green */
QTextEdit {
    background: qradialgradient(cx:0, cy:0, radius: 1,
                fx:0.5, fy:0.5, stop:0 white, stop:1 green)
}

* {
    file-icon: url(file.png),
               url(file_selected.png) selected;
  }

QMessageBox {
    dialogbuttonbox-buttons-have-icons: true;
    dialog-ok-icon: url(ok.svg);
    dialog-cancel-icon: url(cancel.png),
                        url(grayed_cancel.png) disabled;
}

QPushButton { color: palette(dark); }

의사 상태 목록

다음과 같은 의사 상태가 지원됩니다:

하위 컨트롤 목록

다음과 같은 하위 컨트롤을 사용할 수 있습니다:

하위 컨트롤을 사용자 지정하는 방법에 대한 예는 QPush버튼의 메뉴 표시기 하위 컨트롤 사용자 지정하기를 참조하세요.