FontDialog QML Type

フォントダイアログ。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧
• 非推奨のメンバー

プロパティ

• options : flags
• selectedFont : font

詳細な説明

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 」ボタンが表示されます。

オプションは、ダイアログを表示する前に設定する必要があります。ダイアログが表示されている状態で設定しても、その変更がダイアログに即座に反映されるとは限りません（オプションやプラットフォームによって異なります）。

利用可能なオプション：

selectedFont : font

このプロパティには、ダイアログで現在選択されているフォントが格納されます。

selectedFont プロパティは、ユーザーがダイアログ内でフォントを選択している間、最終的な選択が行われる前であっても更新されます。

accepted() シグナルを処理することで、最終的な選択内容を取得することができます。ユーザーが [Select ] (プラットフォームによっては [Open]) をクリックしてフォントを確定すると、accepted() シグナルのシグナルハンドラが selectedFont プロパティを照会して、ユーザーが最終的に選択したフォントを取得することができます。

currentFont およびaccepted()も参照してください 。