QFont::setFamily()だけじゃない!Qtのフォント設定代替手法

2025-06-06

QFont::setFamily() は、Qtアプリケーションでテキストを表示する際に使用されるフォントの**書体(フォントファミリー)**を設定するための非常に重要な関数です。

どのような働きをするのか?

この関数は、QFont オブジェクトに対して、どのフォントグループを使用するかを指定します。例えば、「Arial」、「Times New Roman」、「游ゴシック」といった具体的なフォント名を指定することができます。

関数の書式

void QFont::setFamily(const QString &family);
  • family: 設定したいフォントファミリーの名前を QString 型で渡します。

使用例

一般的な使用例を以下に示します。

#include <QApplication>
#include <QLabel>
#include <QFont>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QLabel label;
    label.setText("こんにちは、世界!");

    QFont font = label.font(); // 現在のフォントを取得
    font.setFamily("Arial");   // フォントファミリーをArialに設定
    // font.setFamily("游ゴシック"); // 日本語フォントを設定する場合

    label.setFont(font); // ラベルに新しいフォントを設定

    label.show();

    return app.exec();
}

上記の例では、QLabel ウィジェットに表示されるテキストのフォントを「Arial」に設定しています。

重要事項と注意点

  1. システム依存性: setFamily() で指定したフォントがユーザーのシステムにインストールされていない場合、Qtは代替のフォント(通常はシステムのデフォルトフォント)を使用します。そのため、指定したフォントが必ずしも適用されるとは限りません。
  2. 複数フォントの指定(Qt 6以降): Qt 6からは、setFamily() は非推奨となり、代わりに setFamilies() が推奨されています。setFamilies() を使うと、複数のフォントファミリーをリストで指定でき、見つかった最初のフォントが使用されるようになります。これにより、より堅牢なフォント選択が可能になります。
    // Qt 6 以降の推奨される方法
    // font.setFamilies({"Arial", "Helvetica", "sans-serif"});
    
  3. フォントファミリーの種類: QFont::setFamily() は、フォントの「太さ(Weight)」や「スタイル(Italic)」を設定するものではありません。これらは QFont::setWeight()QFont::setItalic() などの別の関数で設定します。


QFont::setFamily() はフォントの設定に不可欠な関数ですが、意図した通りに動作しない場合、いくつかの一般的な落とし穴があります。ここでは、よくあるエラーとその解決策について説明します。

エラー: 指定したフォントが適用されない

問題の状況
setFamily("MyCustomFont") のように設定しても、アプリケーション上でテキストがそのフォントで表示されず、デフォルトのフォント(例: Arial, Meiryo UIなど)で表示されてしまう。

考えられる原因

  • Qtのフォントデータベースの更新不足
    まれに、新しいフォントをインストールした直後など、Qtの内部フォントキャッシュが更新されていないことがあります。
  • フォント名のスペルミス
    フォント名が正確でない場合、Qtは一致するフォントを見つけられません。大文字・小文字の区別(システムによるが、一般的に区別される)や、スペースの有無などが原因になることがあります。
  • フォントがシステムにインストールされていない
    これが最も一般的な原因です。指定したフォントがユーザーのオペレーティングシステムにインストールされていないため、Qtがそのフォントを見つけられず、代替のフォントを使用します。

トラブルシューティング

  • QFontDatabase の利用
    QFontDatabase::families() を使って、システムが認識しているフォントファミリーのリストをプログラム的に取得し、その中から目的のフォント名を探すことができます。
    #include <QApplication>
    #include <QLabel>
    #include <QFont>
    #include <QFontDatabase> // これを追加
    
    int main(int argc, char *argv[]) {
        QApplication app(argc, argv);
    
        qDebug() << "Available font families:";
        for (const QString &family : QFontDatabase::families()) {
            qDebug() << family;
        }
    
        // ... 後は通常通りフォントを設定
        QLabel label("Test Text");
        QFont font = label.font();
        font.setFamily("Meiryo UI"); // 取得したリストから正しい名前をコピー
        label.setFont(font);
        label.show();
    
        return app.exec();
    }
    
    このコードを実行すると、コンソールに利用可能なフォント名が一覧表示されます。その中から正確な名前をコピーして使用します。
  • アプリケーションの再起動
    フォントを新しくインストールした場合は、Qtアプリケーションを完全に終了し、再起動してみてください。システムによっては、再起動が必要な場合もあります。
  • フォントのインストール確認
    • Windows: コントロールパネルの「フォント」または「設定」アプリの「フォント」で、指定したフォントがリストにあるか確認します。
    • macOS: 「Font Book.app」で確認します。
    • Linux: 各ディストリビューションのフォント管理ツールや、fc-list コマンドなどで確認します。

エラー: 異なるOSで見た目が変わる

問題の状況
Windowsではうまく表示されるフォントが、macOSやLinuxでは別のフォントに見える、または文字化けする。

考えられる原因

  • フォントのレンダリングエンジンの違い
    OSやQtのバージョンによって、フォントのアンチエイリアシングやヒンティングの処理が異なるため、同じフォントでも微妙に表示が変わることがあります。
  • OS間のフォントの有無
    特定のフォントはOSにバンドルされているもの(例: Windowsの「游ゴシック」、macOSの「ヒラギノ角ゴシック」)が多く、別のOSには存在しないため、代替フォントが使用されます。

トラブルシューティング

  • フォントファイルの同梱
    アプリケーションにフォントファイルを同梱し、QFontDatabase::addApplicationFont() を使ってプログラムからロードすることも可能です。これにより、ユーザーのシステムに依存せず、常に同じフォントを使用できます。
    int fontId = QFontDatabase::addApplicationFont(":/fonts/MyCustomFont.ttf");
    if (fontId != -1) {
        QStringList families = QFontDatabase::applicationFontFamilies(fontId);
        if (!families.isEmpty()) {
            font.setFamily(families.at(0));
        }
    }
    
    この方法では、Qtのリソースシステム (.qrc ファイル) を利用してフォントファイルを組み込みます。

エラー: 太さやイタリックが効かない

問題の状況
setFamily() でフォントを設定した後、setWeight(QFont::Bold)setItalic(true) を設定しても、見た目が変わらない。

考えられる原因

  • 指定したフォントファミリーにそのスタイルが存在しない
    例えば、「MyCustomFont」というフォントに「Bold」や「Italic」のバリアントが含まれていない場合、Qtはそれらをシミュレートしようとしますが、多くの場合、期待通りの結果にはなりません。
  • シミュレーションの許容
    フォント自体がそのスタイルを持たない場合、Qtは可能な限りそのスタイルをシミュレートしようとします。これにより、太字は「通常のフォントを少し太く描画する」ように見えることがあります。このシミュレーションの見た目が許容できるか判断します。
  • 別のフォントファミリーを検討
    そのスタイルをサポートしている別のフォントファミリーへの変更を検討します。
  • フォントファミリーの確認
    • 使用したいフォントが、太字やイタリックなどのスタイルを個別のフォントファイルとして持っているか確認します(例: MyCustomFont-Bold.ttf, MyCustomFont-Italic.ttf)。
    • QFontDatabase::styles()QFontDatabase::weights() を使って、特定のフォントファミリーがサポートしているスタイルやウェイトをプログラム的に確認できます。
    QFont font("Arial"); // 例えばArial
    qDebug() << "Styles for Arial:" << QFontDatabase::styles(font.family());
    qDebug() << "Weights for Arial:" << QFontDatabase::standardWeights(); // 標準的なウェイト
    


QFont::setFamily() は、Qtアプリケーションでテキストのフォントを設定する際に最も基本的な関数の1つです。ここでは、いくつかの具体的な使用例を通じて、その使い方と関連するテクニックを説明します。

基本的なフォントファミリーの設定

最も一般的な使用法は、ウィジェットのフォントを設定することです。

#include <QApplication> // QApplication を使うために必要
#include <QLabel>       // テキスト表示のためにQLabelを使う
#include <QFont>        // QFont クラスを使うために必要

int main(int argc, char *argv[]) {
    // Qtアプリケーションの初期化
    QApplication app(argc, argv);

    // テキストを表示するためのQLabelウィジェットを作成
    QLabel label;
    label.setText("Qt プログラミングの例です。"); // 表示するテキストを設定

    // 現在のラベルのフォントを取得 (デフォルトフォントなど)
    QFont font = label.font();

    // QFont::setFamily() を使ってフォントファミリーを設定
    // ここでは "Arial" を指定していますが、システムにインストールされている任意のフォント名が指定可能です。
    // 例: "Meiryo UI" (Windows), "Hiragino Sans" (macOS), "Noto Sans CJK JP" (Linux/クロスプラットフォーム)
    font.setFamily("Arial");

    // 設定したフォントをラベルに適用
    label.setFont(font);

    // ラベルの表示
    label.show();

    // アプリケーションのイベントループを開始
    // これがないとウィンドウが表示されず、すぐに終了してしまいます。
    return app.exec();
}

解説

  1. QApplication を初期化し、GUIアプリケーションの基盤を準備します。
  2. QLabel を作成し、表示したいテキストを設定します。
  3. label.font() で、そのラベルが現在使用している QFont オブジェクトのコピーを取得します。
  4. font.setFamily("Arial"); で、フォントファミリーを「Arial」に設定します。
  5. label.setFont(font); で、変更した QFont オブジェクトをラベルに再設定し、フォントの変更を適用します。
  6. label.show() でウィンドウを表示し、app.exec() でアプリケーションのイベントループを開始します。

フォントの太さやサイズも同時に設定する

setFamily() はフォントファミリーのみを設定します。太さやサイズなども一緒に設定したい場合は、他の QFont メソッドと組み合わせます。

#include <QApplication>
#include <QPushButton> // ボタンウィジェットを使用
#include <QFont>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QPushButton button("クリックしてください"); // ボタンを作成

    QFont font = button.font(); // ボタンのフォントを取得

    // フォントファミリーを "Verdana" に設定
    font.setFamily("Verdana");
    // フォントサイズを 16 ポイントに設定
    font.setPointSize(16);
    // フォントの太さをBoldに設定
    font.setWeight(QFont::Bold);
    // イタリック体を有効にする
    font.setItalic(true);

    button.setFont(font); // 設定したフォントをボタンに適用

    button.resize(250, 80); // ボタンのサイズを調整
    button.show();

    return app.exec();
}

解説

  • setPointSize() でフォントの大きさを、setWeight() で太さを、setItalic() でイタリック体をそれぞれ設定しています。これらは setFamily() と組み合わせて使用することで、より詳細なフォントの制御が可能になります。

システムにインストールされているフォントを列挙して確認する

setFamily() で指定するフォント名が正確でないと、期待通りにフォントが適用されません。システムにインストールされているフォントのリストを取得し、その中から正確な名前を確認する方法は非常に役立ちます。

#include <QApplication>
#include <QLabel>
#include <QFont>
#include <QFontDatabase> // フォントデータベースにアクセスするために必要
#include <QDebug>        // デバッグ出力のために必要

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    // QFontDatabase を使ってシステム上のすべてのフォントファミリー名を取得
    QStringList availableFamilies = QFontDatabase::families();

    qDebug() << "利用可能なフォントファミリー:";
    for (const QString &family : availableFamilies) {
        qDebug() << " - " << family; // 各フォントファミリー名をコンソールに出力
    }

    // 例えば、リストから "Impact" というフォントが見つかったと仮定して設定してみる
    QLabel label;
    label.setText("インパクトのあるテキスト!");
    QFont font = label.font();

    if (availableFamilies.contains("Impact", Qt::CaseInsensitive)) { // 大文字小文字を区別せず検索
        font.setFamily("Impact");
        font.setPointSize(24);
        qDebug() << "フォント 'Impact' が見つかりました。";
    } else {
        font.setFamily("Arial Black"); // なければ代替フォント
        font.setPointSize(20);
        qDebug() << "フォント 'Impact' が見つかりませんでした。代わりに 'Arial Black' を使用します。";
    }

    label.setFont(font);
    label.resize(400, 100);
    label.show();

    return app.exec();
}

解説

  1. QFontDatabase::families() を呼び出すことで、Qtが認識しているすべてのフォントファミリー名を含む QStringList を取得できます。
  2. このリストを qDebug() で出力することで、コンソールに利用可能なフォント名が一覧表示され、setFamily() に渡すべき正確なフォント名を確認できます。
  3. QStringList::contains() を使って、特定のフォントが存在するかどうかをチェックするロジックを追加し、フォントが見つからない場合のフォールバックを設定することもできます。

アプリケーションにカスタムフォントを埋め込む

ユーザーのシステムにフォントがインストールされていることを前提にしたくない場合や、特定のカスタムフォントを使用したい場合は、フォントファイルをアプリケーションに直接埋め込むことができます。

ステップ 1: .qrc (Qt Resource File) の作成

プロジェクトに fonts.qrc のようなリソースファイルを追加します。 Qt Creator を使用している場合: File -> New File or Project -> Qt -> Qt Resource File

fonts.qrc の内容例:

<RCC>
    <qresource prefix="/fonts">
        <file>MyCustomFont.ttf</file>
        <file>AnotherFont.otf</file>
    </qresource>
</RCC>

注意
MyCustomFont.ttfAnotherFont.otf は、プロジェクトディレクトリ内の適切な場所に配置する必要があります(例: fonts サブディレクトリなど)。

ステップ 2: C++ コードでフォントをロード

#include <QApplication>
#include <QLabel>
#include <QFont>
#include <QFontDatabase> // フォントデータベースにアクセスするために必要
#include <QDebug>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    // アプリケーション起動時にカスタムフォントをロード
    // ":/fonts/MyCustomFont.ttf" は、.qrcファイルで設定したパスです。
    int fontId = QFontDatabase::addApplicationFont(":/fonts/MyCustomFont.ttf");
    if (fontId == -1) {
        qWarning() << "カスタムフォントのロードに失敗しました!";
    }

    QString customFontFamily;
    if (fontId != -1) {
        // ロードしたフォントのファミリー名を取得
        QStringList families = QFontDatabase::applicationFontFamilies(fontId);
        if (!families.isEmpty()) {
            customFontFamily = families.at(0);
            qDebug() << "カスタムフォント '" << customFontFamily << "' をロードしました。";
        }
    }

    QLabel label;
    label.setText("カスタムフォントの例");
    QFont font = label.font();

    if (!customFontFamily.isEmpty()) {
        font.setFamily(customFontFamily); // ロードしたカスタムフォントを設定
    } else {
        font.setFamily("Arial"); // ロードに失敗した場合のフォールバック
        qWarning() << "カスタムフォントが使用できないため、Arialを使用します。";
    }

    font.setPointSize(20);
    label.setFont(font);
    label.resize(300, 100);
    label.show();

    return app.exec();
}

解説

  1. QFontDatabase::addApplicationFont() を使って、リソースファイルに埋め込まれたフォントをアプリケーションにロードします。この関数は、ロードされたフォントのIDを返します。
  2. QFontDatabase::applicationFontFamilies(fontId) を使って、ロードされたフォントの正確なフォントファミリー名を取得します。この名前を setFamily() に渡します。
  3. ロードに失敗した場合に備えて、代替のフォントを設定するフォールバックロジックを追加することが重要です。

Qt 6 以降で推奨される setFamilies() の使用

Qt 6以降では、setFamily() の代わりに setFamilies() を使用することが推奨されています。これにより、複数のフォント名を優先順位順に指定でき、より堅牢なフォント設定が可能になります。

#include <QApplication>
#include <QLabel>
#include <QFont>
#include <QDebug>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QLabel label;
    label.setText("日本語と英語のテキスト");
    QFont font = label.font();

    // 複数のフォントファミリーを優先順位順に指定
    // Qtはリストの先頭から順に、システムに存在するかを確認し、最初に見つかったフォントを使用します。
    // 日本語フォント -> 英字フォント -> 一般的なサンセリフフォント
    font.setFamilies({
        "Noto Sans CJK JP",      // Googleのオープンソース日本語フォント
        "Hiragino Sans",         // macOS標準の日本語フォント
        "Yu Gothic UI",          // Windows標準の日本語フォント
        "Arial",                 // 一般的な英字フォント
        "sans-serif"             // OSのデフォルトのサンセリフフォント (最終フォールバック)
    });

    font.setPointSize(18);
    label.setFont(font);
    label.resize(400, 100);
    label.show();

    return app.exec();
}
  1. font.setFamilies({"Font1", "Font2", "Font3"}); のように、QStringList (または初期化子リスト)を使って複数のフォントファミリー名を指定します。
  2. Qtはリストの先頭から順にフォントの有無をチェックし、最初に見つかったフォントを使用します。これにより、あるOSにはあるフォントがないが、別のOSにはあるというようなクロスプラットフォームのシナリオで、より良いフォールバック動作を実現できます。


QFont::setFamily() はフォントファミリーを設定する基本的な方法ですが、Qtにはフォントを扱うための他の強力な代替手段や関連する機能があります。これらを理解することで、より柔軟で堅牢なフォント管理が可能になります。

QFont::setFamilies() (Qt 6以降の推奨)

QFont::setFamily() が単一のフォントファミリー名しか受け付けないのに対し、setFamilies() は複数のフォントファミリー名をリストとして受け取ります。Qtはリストの先頭から順にフォントの有無を確認し、最初に見つかったものを適用します。これにより、クロスプラットフォーム環境でのフォントの可用性の問題を解決しやすくなります。

利点

  • クロスプラットフォーム対応
    各OSで異なるフォントがインストールされている状況で、アプリケーションの見た目を一貫させるのに役立ちます。
  • 堅牢なフォールバック
    複数のフォントを優先順位順に指定することで、ユーザーのシステムに特定のフォントがない場合でも、適切な代替フォントが自動的に選択される可能性が高まります。

使用例

#include <QApplication>
#include <QLabel>
#include <QFont>
#include <QDebug> // デバッグ出力用

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    QLabel label;
    label.setText("Qt 6 以降の新しいフォント設定方法");

    QFont font = label.font();

    // 優先順位を付けて複数のフォントファミリーを指定
    // 1. Noto Sans JP (日本語環境でよく使われる汎用フォント)
    // 2. ヒラギノ角ゴシック (macOS標準の高品質日本語フォント)
    // 3. Yu Gothic UI (Windows標準の日本語フォント)
    // 4. Arial (一般的な欧文フォント)
    // 5. sans-serif (OSのデフォルトのサンセリフ体)
    font.setFamilies({
        "Noto Sans CJK JP",
        "Hiragino Kaku Gothic ProN",
        "Yu Gothic UI",
        "Arial",
        "sans-serif"
    });

    font.setPointSize(18);
    label.setFont(font);

    label.show();

    return app.exec();
}

解説
setFamilies() に渡す QStringList (またはC++11の初期化子リスト {...}) の順序が重要です。アプリケーションはリストの最初のフォントを試行し、それが利用できない場合に次のフォントに進みます。最後の「sans-serif」や「serif」は、OSが提供する汎用的なフォントタイプで、最終的なフォールバックとして非常に役立ちます。

QSS (Qt Style Sheets) によるフォント設定

Qt Style Sheets (QSS) は、CSSに似た構文でウィジェットの見た目をカスタマイズする方法です。フォントの設定もQSSで行うことができ、特にアプリケーション全体のテーマ設定や、特定のウィジェットグループに一貫したスタイルを適用したい場合に強力です。

利点

  • 動的な変更
    アプリケーションの実行中にスタイルシートをロードし直すことで、テーマを動的に変更できます。
  • 高い柔軟性
    特定のウィジェット、クラス、ID、またはグローバルにスタイルを適用できます。
  • 宣言的なスタイル設定
    コード内で QFont オブジェクトを操作するよりも、見た目を一目で把握しやすいです。

使用例

#include <QApplication>
#include <QLabel>
#include <QPushButton>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    // アプリケーション全体にスタイルシートを適用
    app.setStyleSheet(
        "QLabel {"
        "   font-family: 'Segoe UI', 'Meiryo UI', sans-serif;" // 複数のフォントを指定可能 (CSS形式)
        "   font-size: 16pt;"
        "   color: blue;"
        "}"
        "QPushButton {"
        "   font-family: 'Impact';"
        "   font-size: 20pt;"
        "   color: white;"
        "   background-color: darkred;"
        "}"
    );

    QLabel label("Qt Style Sheet でフォント設定");
    QPushButton button("ボタンのフォント");

    label.resize(300, 50);
    button.resize(300, 60);

    label.move(50, 50); // ウィンドウ内の位置調整
    button.move(50, 120);

    // QLabelとQPushButtonを親なしで表示 (またはQDialog/QMainWindowに追加)
    label.show();
    button.show();

    return app.exec();
}

解説

  • QSSは非常に強力で、フォントだけでなく色、背景、ボーダー、パディングなど、多くのウィジェットプロパティを制御できます。
  • font-family プロパティには、CSSと同様にカンマ区切りで複数のフォントファミリー名を指定できます。Qtはリストの最初の利用可能なフォントを試行します。
  • qApp->setStyleSheet() または QApplication::setStyleSheet() を使用して、スタイルシートの文字列を設定します。

QFontDatabase を利用したアプリケーションへのフォント埋め込み

ユーザーのシステムに依存せず、常に特定のフォントを使用したい場合は、フォントファイルをアプリケーションバイナリに埋め込み、プログラム的にロードする方法があります。これは、QFont::setFamily() の直接の代替ではありませんが、setFamily() で指定するフォントを確実に利用可能にするための重要な手段です。

利点

  • デザインの一貫性
    アプリケーションのデザインに不可欠なカスタムフォントを配布できます。
  • 確実なフォント利用
    ユーザーの環境にフォントがインストールされていなくても、常に特定のフォントを使用できます。

使用例
(この例は、事前にフォントファイルをQtリソースシステム(.qrcファイル)に組み込んでいることを前提とします。)

// .qrcファイルに例: <qresource prefix="/fonts"><file>MyCustomFont.ttf</file></qresource>
#include <QApplication>
#include <QLabel>
#include <QFont>
#include <QFontDatabase> // これが必要
#include <QDebug>

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    // アプリケーションにカスタムフォントをロード
    // : で始まるパスは、Qtリソースシステムからのパスを示します。
    int fontId = QFontDatabase::addApplicationFont(":/fonts/MyCustomFont.ttf"); // MyCustomFont.ttfは.qrcに含めたフォントファイル名

    QString customFontFamily;
    if (fontId != -1) {
        // ロードしたフォントのファミリー名を取得
        QStringList loadedFamilies = QFontDatabase::applicationFontFamilies(fontId);
        if (!loadedFamilies.isEmpty()) {
            customFontFamily = loadedFamilies.at(0);
            qDebug() << "カスタムフォント '" << customFontFamily << "' をロードしました。";
        }
    } else {
        qWarning() << "カスタムフォントのロードに失敗しました!";
    }

    QLabel label;
    label.setText("埋め込みフォントのテスト");
    QFont font = label.font();

    if (!customFontFamily.isEmpty()) {
        font.setFamily(customFontFamily); // ロードしたカスタムフォント名を設定
        font.setPointSize(24);
    } else {
        font.setFamily("Arial"); // ロードに失敗した場合のフォールバック
        font.setPointSize(18);
        qWarning() << "カスタムフォントが使用できないため、Arialを使用します。";
    }

    label.setFont(font);
    label.resize(400, 100);
    label.show();

    return app.exec();
}

解説

  • フォントのライセンスに注意し、再配布が許可されているフォントのみを使用してください。
  • ロードに成功した場合、QFontDatabase::applicationFontFamilies(fontId) を使用して、そのフォントの正確なファミリー名を取得します。この名前を QFont::setFamily() または QFont::setFamilies() に渡すことで、アプリケーション内でそのフォントを使用できるようになります。
  • QFontDatabase::addApplicationFont() は、指定されたパス(通常はリソースパス)からフォントファイルをロードし、Qtのフォントシステムに利用可能にします。

これらの代替手法は、アプリケーションの要件や複雑さに応じて使い分けられます。

  • カスタムフォントの確実な使用
    QFontDatabase を使った埋め込み
  • デザインの一貫性や動的な変更
    QSS
  • 単純な設定やQt 6以降の推奨
    QFont::setFamilies()