Qt GUI でアイコン画像を取得する：QIcon::pixmap() 関数の使い方

Qt GUI の QIcon::pixmap() 関数

関数の概要

QPixmap QIcon::pixmap(const QSize &size, QIcon::Mode mode = Normal, QIcon::State state = Off) const;

引数

• size: 取得するピクセマップのサイズ
• mode: アイコンの表示モード
  • Normal: 通常のアイコン
  • Active: アクティブなアイコン
  • Disabled: 無効なアイコン
• state: アイコンの状態
  • Off: 通常の状態
  • On: オン状態
  • Selected: 選択状態

戻り値

• 指定されたサイズ、モード、状態に対応したピクセマップ

使用例

// 通常サイズのアイコンを取得
QPixmap pixmap = icon.pixmap(QSize(32, 32));

// アクティブ状態のアイコンを取得
QPixmap activePixmap = icon.pixmap(QSize(32, 32), QIcon::Active);

// 選択状態のアイコンを取得
QPixmap selectedPixmap = icon.pixmap(QSize(32, 32), QIcon::Selected, QIcon::On);

補足

• QIcon::pixmap() は、アイコン画像だけでなく、マスク画像も取得できます。マスク画像を取得するには、QIcon::pixmap(const QSize &size, QIcon::Mode mode = Normal, QIcon::State state = Off, QPixmap::Format format = QPixmap::Format_ARGB32) のように、format 引数を QPixmap::Format_ARGB32 に設定します。
• アイコン画像のサイズが指定されたサイズよりも大きい場合、QIcon::pixmap() は画像を縮小します。

QIcon::pixmap() 関数のサンプルコード

ボタンにアイコンを設定

// ボタンを作成
QPushButton button;

// アイコンを設定
QIcon icon("icon.png");
button.setIcon(icon);

// ボタンを表示
button.show();

ラベルにアイコンを設定

// ラベルを作成
QLabel label;

// アイコンを設定
QIcon icon("icon.png");
label.setPixmap(icon.pixmap(QSize(32, 32)));

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

ツールバーにアイコンを設定

// ツールバーを作成
QToolBar toolbar;

// アクションを作成
QAction action("Action");
action.setIcon(QIcon("icon.png"));

// ツールバーにアクションを追加
toolbar.addAction(action);

// ツールバーを表示
toolbar.show();

メニューにアイコンを設定

// メニューを作成
QMenu menu;

// アクションを作成
QAction action("Action");
action.setIcon(QIcon("icon.png"));

// メニューにアクションを追加
menu.addAction(action);

// メニューを表示
menu.exec();

アイコンの状態に応じた画像を取得

// アイコンを作成
QIcon icon("icon.png");

// 通常状態のアイコンを取得
QPixmap normalPixmap = icon.pixmap(QSize(32, 32));

// アクティブ状態のアイコンを取得
QPixmap activePixmap = icon.pixmap(QSize(32, 32), QIcon::Active);

// 選択状態のアイコンを取得
QPixmap selectedPixmap = icon.pixmap(QSize(32, 32), QIcon::Selected, QIcon::On);

// 画像を表示
// ...

マスク画像を取得

// アイコンを作成
QIcon icon("icon.png");

// マスク画像を取得
QPixmap maskPixmap = icon.pixmap(QSize(32, 32), QIcon::Normal, QIcon::Off, QPixmap::Format_ARGB32);

// マスク画像を表示
// ...

補足

QIcon::pixmap() 関数の代替方法

QPixmap::load() 関数

// アイコン画像を読み込む
QPixmap pixmap("icon.png");

// アイコンを作成
QIcon icon(pixmap);

QImage::load() 関数

// アイコン画像を読み込む
QImage image("icon.png");

// アイコンを作成
QIcon icon(image);

QSvgRenderer クラス

// SVG アイコンを読み込む
QSvgRenderer renderer("icon.svg");

// アイコン画像を取得
QPixmap pixmap = renderer.render(QSize(32, 32));

// アイコンを作成
QIcon icon(pixmap);

QIcon::fromTheme() 関数

// テーマアイコンを取得
QIcon icon = QIcon::fromTheme("icon-name");

QIcon::addFile() 関数

// 複数の画像ファイルからアイコンを作成
QIcon icon;
icon.addFile("icon-16.png", QSize(16, 16));
icon.addFile("icon-32.png", QSize(32, 32));

// アイコンを表示
// ...

• アイコン画像が PNG 形式の場合は、QPixmap::load() 関数を使うのが最も簡単です。
• アイコン画像が SVG 形式の場合は、QSvgRenderer クラスを使うのが最適です。
• テーマアイコンを使用したい場合は、QIcon::fromTheme() 関数を使うのが便利です。
• 複数の画像ファイルからアイコンを作成したい場合は、QIcon::addFile() 関数を使う必要があります。