이 페이지에서

FontDialog QML Type

글꼴 대화 상자. 더 보기...

Import Statement: import QtQuick.Dialogs
Since: Qt 6.2
Inherits:

Dialog

속성

상세 설명

FontDialog 유형은 글꼴 대화 상자를 위한 QML API를 제공합니다.

사용자는 글꼴 대화 상자를 통해 다양한 글꼴을 확인하고 선택할 수 있습니다.

글꼴 대화 상자를 표시하려면 FontDialog 인스턴스를 생성하고, 원하는 속성을 설정한 다음 ` open()`를 호출하십시오. ` currentFont ` 속성을 사용하여 대화 상자에서 현재 선택된 글꼴을 확인할 수 있습니다. ` selectedFont ` 속성은 대화 상자를 수락하여 최종 선택이 완료된 후에만 업데이트됩니다.

MenuItem {
    text: "Font"
    onTriggered: fontDialog.open()
}

FontDialog {
    id: fontDialog
    currentFont.family: document.font
}

MyDocument {
    id: document
    font: fontDialog.selectedFont
}

사용 가능 여부

현재 다음 플랫폼에서 네이티브 플랫폼 글꼴 대화 상자를 사용할 수 있습니다:

  • iOS
  • Linux (GTK+ 플랫폼 테마로 실행 시)
  • macOS

Qt Quick Dialogs 네이티브 구현이 제공되지 않는 플랫폼에서는 대체 수단으로 Qt Quick 구현을 사용합니다.

속성 문서

options : flags

이 속성은 대화 상자의 모양과 느낌에 영향을 미치는 다양한 옵션을 포함합니다.

기본적으로 아무런 옵션도 설정되어 있지 않으므로, 모든 글꼴 유형이 표시되며 대화 상자에는 표준 ' Select ' 및 ' Cancel ' 버튼이 나타납니다.

옵션은 대화 상자를 표시하기 전에 설정해야 합니다. 대화 상자가 표시된 상태에서 옵션을 설정하더라도 대화 상자에 즉시 반영된다고 보장할 수 없습니다(옵션 및 플랫폼에 따라 다름).

사용 가능한 옵션:

상수설명
FontDialog.ScalableFonts확장 가능한 글꼴 표시.
FontDialog.NonScalableFonts확대/축소가 불가능한 글꼴을 표시합니다.
FontDialog.MonospacedFonts고정폭 글꼴을 표시합니다.
FontDialog.ProportionalFonts비례 글꼴을 표시합니다.
FontDialog.NoButtonsOpen 및 Cancel 버튼을 표시하지 않습니다(“라이브 대화 상자”에 유용함).
FontDialog.DontUseNativeDialog대화 상자가 네이티브가 아닌 빠른 구현 방식을 사용하도록 강제합니다.

selectedFont : font

이 속성은 대화 상자에서 현재 선택된 글꼴을 저장합니다.

selectedFont 속성은 사용자가 대화 상자에서 글꼴을 선택하는 동안, 최종 선택이 이루어지기 전이라도 업데이트됩니다.

accepted() 신호를 처리하여 최종 선택 결과를 얻을 수 있습니다. 사용자가 글꼴을 수락하기 위해 [ Select ](또는 플랫폼에 따라 [ Open])을 클릭하면, accepted() 신호의 신호 핸들러가 selectedFont 속성을 조회하여 사용자가 최종적으로 선택한 글꼴을 얻을 수 있습니다.

currentFont 및 accepted()도 참조하십시오 .

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