PythonでQt GUIプログラミング：`PyQt`における`QGuiApplication::primaryScreen`の使い方

What is QGuiApplication::primaryScreen?

QGuiApplication::primaryScreen() is a static function that returns a pointer to the primary screen of the application. The primary screen is the screen where windows are initially shown, unless otherwise specified. It is also the screen that is used for certain operations, such as displaying error messages.

Why is QGuiApplication::primaryScreen useful?

QGuiApplication::primaryScreen() can be used to obtain information about the primary screen, such as its size, resolution, and device pixel ratio. This information can be used to position windows and other graphical elements on the screen.

How to use QGuiApplication::primaryScreen

To use QGuiApplication::primaryScreen(), you simply call the function and access the returned pointer. Here is an example of how to get the size of the primary screen:

QScreen *primaryScreen = QGuiApplication::primaryScreen();
QSize size = primaryScreen->size();

Here are some additional things to keep in mind about QGuiApplication::primaryScreen

• You can use the screens() function to get a list of all screens, including the primary screen.
• The primary screen can change during the execution of the application. If the primary screen changes, the primaryScreenChanged() signal will be emitted.
• The primary screen is determined by the operating system.

QScreen *primaryScreen = QGuiApplication::primaryScreen();
QRect geometry = primaryScreen->geometry();

QWidget *window = new QWidget;
window->setGeometry(geometry);
window->show();

---

#include <QApplication>
#include <QWidget>

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

  QWidget window;
  window.setWindowTitle("中央揃えウィンドウ");

  // ウィンドウのサイズを設定する
  window.resize(200, 150);

  // ウィンドウを中央に配置する
  QScreen *primaryScreen = QGuiApplication::primaryScreen();
  QRect geometry = primaryScreen->geometry();
  int x = (geometry.width() - window.width()) / 2;
  int y = (geometry.height() - window.height()) / 2;
  window.move(x, y);

  // ウィンドウを表示する
  window.show();

  return app.exec();
}

このコードは以下の動作をします。

1. QApplication オブジェクトを作成します。
2. QWidget オブジェクトを作成します。
3. ウィンドウのタイトルを設定します。
4. ウィンドウのサイズを設定します。
5. QGuiApplication::primaryScreen() を使用してプライマリスクリーンを取得します。
6. プライマリスクリーンのジオメトリを取得します。
7. ウィンドウの左上隅の位置を計算します。
8. ウィンドウを指定した位置に移動します。
9. ウィンドウを表示します。

このコードは、アプリケーションウィンドウを常にプライマリスクリーンの中央に配置したい場合に役立ちます。

#include <QApplication>
#include <QScreen>

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

  QScreen *primaryScreen = QGuiApplication::primaryScreen();
  QSize size = primaryScreen->size();

  // 画面解像度を出力する
  qDebug() << "画面解像度：" << size.width() << "x" << size.height();

  return app.exec();
}

1. QApplication オブジェクトを作成します。
2. QGuiApplication::primaryScreen() を使用してプライマリスクリーンを取得します。
3. プライマリスクリーンのサイズを取得します。
4. 画面解像度をコンソールに出力します。

このコードは、アプリケーションが画面解像度に応じてレイアウトを調整したい場合に役立ちます。

#include <QApplication>
#include <QScreen>

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

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

  // デバイスピクセル比率を出力する
  qDebug() << "デバイスピクセル比率：" << devicePixelRatio;

  return app.exec();
}

1. QApplication オブジェクトを作成します。
2. QGuiApplication::primaryScreen() を使用してプライマリスクリーンを取得します。
3. プライマリスクリーンのデバイスピクセル比率を取得します。
4. デバイスピクセル比率をコンソールに出力します。

---

Using QWidget::screen()

The screen() method of a QWidget widget provides access to the screen on which the widget is displayed. This approach is particularly useful when you're working with a specific widget and want to obtain information about its associated screen.

QWidget *myWidget = new QWidget;
QScreen *screen = myWidget->screen();
// Access screen properties using 'screen' pointer

Iterating through available screens

If you need to handle multiple screens or want a more general approach, you can iterate through the list of available screens using the QGuiApplication::screens() function. This function returns a list of QScreen pointers, allowing you to access each screen's information.

QList<QScreen *> screens = QGuiApplication::screens();
for (QScreen *screen : screens) {
  // Access screen properties for each screen in the list
}

Choosing the Right Approach

The choice between these methods depends on your specific use case:

• QGuiApplication::screens()
  Use this when handling multiple screens or requiring a more general approach for screen access.

• QWidget::screen()
  Use this when working with a specific widget and need information about its associated screen.

• QGuiApplication::primaryScreen()
  Use this when you need the primary screen directly, especially for common tasks like centering a window.