범용 스타일

유니버설 스타일은 Microsoft 유니버설 디자인 가이드라인을 기반으로 합니다. 더 보기...

부착된 속성

• accent: color
• background: color
• 전경색: 색상
• 테마: 열거형

연관된 메서드

• color color(열거형 사전 정의됨)

상세한 설명

유니버설 스타일은 Microsoft 유니버설 디자인 지침을 기반으로 하는 기기 독립적인 스타일입니다. 유니버설 스타일은 휴대폰과 태블릿부터 PC에 이르기까지 모든 기기에서 멋지게 보이도록 설계되었습니다.

유니버설 스타일로 애플리케이션을 실행하려면 ‘ Qt Quick Controls 에서 스타일 사용하기’를 참조하십시오.

사용자 지정

유니버설 스타일에서는 테마, 액센트, 전경, 배경의 네 가지 속성을 사용자 지정할 수 있습니다.

이 두 속성은 모든 창이나 항목에 지정할 수 있으며, ` fonts`와 동일한 방식으로 자식 요소로 자동으로 적용됩니다. 다음 예제에서는 창과 세 개의 라디오 버튼 모두 보라색 액센트 색상을 사용한 다크 테마로 표시됩니다:

import QtQuick
import QtQuick.Controls
import QtQuick.Controls.Universal

ApplicationWindow {
    visible: true

    Universal.theme: Universal.Dark
    Universal.accent: Universal.Violet

    Column {
        anchors.centerIn: parent

        RadioButton { text: qsTr("Small") }
        RadioButton { text: qsTr("Medium");  checked: true }
        RadioButton { text: qsTr("Large") }
    }
}

QML에서 속성을 지정하는 것 외에도, 환경 변수나 구성 파일을 통해 속성을 지정할 수도 있습니다. QML에서 지정된 속성은 다른 모든 지정 방법보다 우선합니다.

구성 파일

구성 파일에 대한 자세한 내용은 Qt Quick Controls 구성 파일을 참조하십시오.

환경 변수

지원되는 환경 변수의 전체 목록은 Qt Quick Controls 의 ‘지원되는 환경 변수’ 섹션을 참조하십시오.

의존성

Universal 스타일에 고유한 속성을 사용하려면 Universal 스타일을 별도로 임포트해야 합니다. Universal 스타일에 대한 참조 여부와 관계없이 동일한 애플리케이션 코드는 다른 어떤 스타일에서도 실행된다는 점에 유의해야 합니다. Universal 고유 속성은 애플리케이션이 Universal 스타일로 실행될 때만 적용됩니다.

항상 로드되는 QML 파일에 유니버설 스타일이 임포트된 경우, 어떤 스타일로 애플리케이션을 실행하든 상관없이 애플리케이션을 실행할 수 있도록 하려면 유니버설 스타일을 애플리케이션과 함께 배포해야 합니다. 파일 선택기를 사용하면 스타일에 대한 고정적인 의존성을 생성하지 않고도 스타일별 조정을 적용할 수 있습니다.

사전 정의된 유니버설 색상

사용 가능한 사전 정의된 색상:

참조: 기본 스타일, 소재 스타일

첨부된 속성 설명서

이 부착 속성은 테마의 강조색을 저장합니다. 이 속성은 모든 창이나 항목에 부착할 수 있습니다. 값은 자식 요소로 전달됩니다.

기본값은 Universal.Cobalt 입니다.

다음 예제에서는 강조 표시된 버튼의 액센트 색상이 Universal.Orange 로 변경됩니다:

Button {
    text: qsTr("Button")
    highlighted: true
    Universal.accent: Universal.Orange
}

이 첨부 속성은 테마의 배경색을 저장합니다. 이 속성은 모든 창이나 항목에 첨부할 수 있으며, 해당 값은 자식 요소로 전파됩니다.

기본값은 테마에 따라 다릅니다(밝은 테마 또는 어두운 테마).

다음 예제에서는 페인의 배경색을 Universal.Steel 로 변경합니다:

Pane {
    Universal.background: Universal.Steel

    Button {
        text: qsTr("Button")
    }
}

이 첨부 속성은 테마의 전경색을 저장합니다. 이 속성은 모든 창이나 항목에 첨부할 수 있습니다. 값은 자식 요소로 전달됩니다.

기본값은 테마에 따라 다릅니다(밝은 테마 또는 어두운 테마).

다음 예제에서는 버튼의 전경색이 Universal.Pink 로 설정되어 있습니다:

Button {
    text: qsTr("Button")
    Universal.foreground: Universal.Pink
}

이 첨부 속성은 테마가 밝은 테마인지 어두운 테마인지를 나타냅니다. 이 속성은 모든 창이나 항목에 첨부할 수 있습니다. 값은 자식 요소로 전파됩니다.

사용 가능한 테마:

테마를 ` System `로 설정하면 시스템 테마 색상에 따라 밝은 테마 또는 어두운 테마 중 하나가 선택됩니다. 그러나 테마 속성의 값을 읽을 때는 해당 값이 ` System`가 아닌 실제 테마로 반환됩니다.

다음 예제에서는 패널과 버튼 모두의 테마가 Universal.Dark 로 설정되어 있습니다:

Pane {
    Universal.theme: Universal.Dark

    Button {
        text: qsTr("Button")
    }
}

첨부된 메서드 문서

이 첨부된 메서드는 지정된 사전 정의된 유니버설 색상의 유효한 색상 값을 반환합니다.

Rectangle {
    color: Universal.color(Universal.Red)
}

관련 정보

• 스타일 지정 Qt Quick Controls