이 페이지에서

macOS 스타일

macOS 스타일은 macOS에서 기본 스타일처럼 보이는 디자인입니다. 더 보기...

임포트 문: import QtQuick.Controls.macOS
버전: Qt 6.0부터

macOS 스타일은 macOS에서 네이티브처럼 보이는 스타일입니다. 컨트롤은 네이티브 프레임워크를 사용하여 런타임에 그려지므로, macOS에서 실행되는 애플리케이션에서만 사용할 수 있습니다.

참고: 이 스타일의 외관은 해당 플랫폼의 네이티브 애플리케이션과 더 잘 조화를 이루기 위해 Qt의 마이너 버전 간에 변경될 수 있음을유의하십시오 .

macOS 스타일의 밝은 테마를 적용한 컨트롤 갤러리

macOS 스타일의 밝은 테마.

macOS 스타일 다크 테마의 컨트롤 갤러리

macOS 스타일의 다크 테마입니다.

macOS 스타일로 애플리케이션을 실행하려면 『 Qt Quick Controls 』의 ‘스타일 사용’ 섹션을 참조하십시오.

현재 상태

macOS 스타일은 현재 개발 중이며, 일부 컨트롤은 아직 지원되지 않습니다. 해당 컨트롤은 다음과 같습니다: BusyIndicator, DelayButton, PageIndicator, RangeSlider, Switch, TabBar 및 Tumbler. 이러한 컨트롤은 Fusion 스타일로 대체되어 사용됩니다.

사용자 정의

macOS 스타일의 목표는 컨트롤의 모양과 느낌이 UIKit의 기본 컨트롤과 최대한 유사하도록 하는 것입니다. 이 스타일은 시스템 환경설정에서 전역적으로 구성된 테마와 색상을 따르며, 그 외에 별도의 사용자 정의 API는 제공되지 않습니다.

참고: macOS스타일은 사용자 정의에 적합하지 않습니다. 주된 이유는 콘텐츠와 배경을 하나의 배경 항목에 함께 그리는 경우가 있는데, 이 경우 사용자 정의 contentItem과 함께 사용하면 시각적으로 어색해 보일 수 있기 때문입니다. 또한 다른 스타일과 다른 패딩 및 인셋 값을 사용하는 경향이 있습니다. 대신, 사용자 정의 컨트롤은 항상 모든 플랫폼에서 사용할 수 있는 단일 스타일(예: Basic Style, Fusion Style, Imagine Style, Material Style, Universal Style)을 기반으로 하는 것이 좋습니다. 이렇게 하면 애플리케이션이 어떤 스타일로 실행되든 항상 동일한 모양을 유지할 수 있습니다. 다른 스타일을 사용하는 방법에 대해서는 Qt Quick Controls 의 ‘스타일 사용’ 섹션을 참조하십시오. 또는 직접 스타일을 생성할 수도 있습니다.

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