QIconEngine::actualSize() 関数の詳細解説

Qt GUI の QIconEngine::actualSize() 関数について

QIconEngine::actualSize() 関数は、Qt GUI でアイコンの実際のサイズを取得するために使用されます。アイコンはさまざまなサイズで表示されることがあり、この関数は、特定のサイズとモード、状態に対してアイコンが実際に描画されるサイズを返します。

詳細

• 引数
  • size: アイコンの希望サイズを表す QSize オブジェクト
  • mode: アイコンのモードを表す QIcon::Mode 列挙型の値。デフォルトは Normal
  • state: アイコンの状態を表す QIcon::State 列挙型の値。デフォルトは Off
• 戻り値

例

// アイコンエンジンを作成
QIconEngine *engine = new QIconEngine;

// アイコンファイルを追加
engine->addFile("icon.png");

// 実際のサイズを取得
QSize actualSize = engine->actualSize(QSize(32, 32));

// アイコンを描画
QPainter painter;
painter.drawPixmap(0, 0, actualSize.width(), actualSize.height(), engine->pixmap(actualSize));

補足

• QIconEngine::actualSize() 関数は、アイコンエンジンによって実装されます。
• アイコンエンジンは、さまざまな形式のアイコンをサポートできます。
• アイコンの実際のサイズは、アイコンエンジンによって異なる場合があります。
• アイコンの実際のサイズは、デバイスピクセル比によって影響を受ける場合があります。

関連用語

• Qt GUI
• QIcon
• QIconEngine
• QSize
• QIcon::Mode
• QIcon::State

この情報は参考用であり、予告なく変更される場合があります。

QIconEngine::actualSize() 関数のサンプルコード

QIconEngine *engine = new QIconEngine;
engine->addFile("icon.png");

QSize actualSize = engine->actualSize(QSize(32, 32));

// アイコンを描画
QPainter painter;
painter.drawPixmap(0, 0, actualSize.width(), actualSize.height(), engine->pixmap(actualSize));

さまざまなモードと状態でのアイコンの実際のサイズを取得する

QIconEngine *engine = new QIconEngine;
engine->addFile("icon.png");

for (QIcon::Mode mode : QIcon::Mode::values()) {
  for (QIcon::State state : QIcon::State::values()) {
    QSize actualSize = engine->actualSize(QSize(32, 32), mode, state);

    // アイコンを描画
    QPainter painter;
    painter.drawPixmap(0, 0, actualSize.width(), actualSize.height(), engine->pixmap(actualSize, mode, state));
  }
}

デバイスピクセル比を考慮したアイコンの実際のサイズを取得する

QIconEngine *engine = new QIconEngine;
engine->addFile("icon.png");

QScreen *screen = QGuiApplication::primaryScreen();
qreal devicePixelRatio = screen->devicePixelRatio();

QSize actualSize = engine->actualSize(QSize(32, 32) * devicePixelRatio);

// アイコンを描画
QPainter painter;
painter.drawPixmap(0, 0, actualSize.width(), actualSize.height(), engine->pixmap(actualSize));

アイコンエンジンの種類による違い

• QPixmapEngine: ピクセルマップ形式のアイコンをサポートします。
• QSvgEngine: SVG 形式のアイコンをサポートします。
• QFontEngine: フォントアイコンをサポートします。

QIconEngine::actualSize() 関数の代替方法

方法 1: QIcon::pixmap() 関数を使用する

QIcon icon("icon.png");

QSize actualSize = icon.pixmap(QSize(32, 32)).size();

// アイコンを描画
QPainter painter;
painter.drawPixmap(0, 0, actualSize.width(), actualSize.height(), icon.pixmap(actualSize));

方法 2: QPixmap::size() 関数を使用する

QPixmap pixmap("icon.png");

QSize actualSize = pixmap.size();

// アイコンを描画
QPainter painter;
painter.drawPixmap(0, 0, actualSize.width(), actualSize.height(), pixmap);

方法 3: QImage::size() 関数を使用する

QImage image("icon.png");

QSize actualSize = image.size();

// アイコンを描画
QPainter painter;
painter.drawImage(0, 0, image);

それぞれの方法の比較

QIconEngine::actualSize() 関数は、アイコンの実際のサイズを取得する最も汎用性が高い方法ですが、他の方法も状況に応じて使用できます。