QPaintDevice Class

メンバ関数のドキュメント

[noexcept protected] QPaintDevice::QPaintDevice()

ペイントデバイスを生成します。このコンストラクタは、QPaintDevice のサブクラスからのみ呼び出すことができます。

[virtual noexcept] QPaintDevice::~QPaintDevice()

ペイントデバイスを破棄し、ウィンドウシステムのリソースを解放します。

int QPaintDevice::colorCount() const

ペイントデバイスで使用可能な異なる色の数を返します。使用可能な色の数が多すぎて int データ型で表現できない場合は、代わりに INT_MAX が返されます。

int QPaintDevice::depth() const

ペイントデバイスのビット深度（ビットプレーンの数）を返します。

qreal QPaintDevice::devicePixelRatio() const

指定されたデバイスのデバイス・ピクセル比を返します。

一般的な値として、標準DPIのディスプレイでは1、高DPIの「Retina」ディスプレイでは2となります。

qreal QPaintDevice::devicePixelRatioF() const

そのデバイスのデバイス・ピクセル比を浮動小数点数として返します。

[static, since 6.8] int QPaintDevice::encodeMetricF(QPaintDevice::PaintDeviceMetric metric, double value)

メトリック `metric` に対してエンコードされた `value ` を返します。metric() を実装するサブクラスは、この関数を使用してエンコードを行う必要があります

この関数は Qt 6.8 で導入されました。

int QPaintDevice::height() const

デフォルトの座標系単位（例：QPixmap やQWidget ではピクセル）で、ペイントデバイスの高さを返します。

heightMM()も参照してください 。

int QPaintDevice::heightMM() const

ペイントデバイスの高さをミリメートル単位で返します。プラットフォームの制限により、この関数を使用して画面上のウィジェットの実際の物理的なサイズを特定できない場合があります。

height()も参照してください 。

int QPaintDevice::logicalDpiX() const

デバイスの水平解像度をドット/インチ単位で返します。これはフォントサイズの計算に使用されます。X11の場合、これは通常、widthMM() から算出される値と同じです。

logicalDpiX() の値がphysicalDpiX() の値と等しくない場合、対応するQPaintEngine が解像度のマッピングを処理する必要があることに注意してください。

logicalDpiY() およびphysicalDpiX()も参照してください 。

int QPaintDevice::logicalDpiY() const

デバイスの垂直解像度をドット/インチ単位で返します。これはフォントサイズの計算に使用されます。X11の場合、これは通常、heightMM() から算出される値と同じになります。

logicalDpiY() の値がphysicalDpiY() の値と一致しない場合、対応するQPaintEngine が解像度のマッピングを処理する必要があることに注意してください。

logicalDpiX() およびphysicalDpiY()も参照してください 。

[virtual protected] int QPaintDevice::metric(QPaintDevice::PaintDeviceMetric metric) const

指定されたペイントデバイス `metric` のメトリック情報を返します。

「PaintDeviceMetric」も参照してください 。

[pure virtual] QPaintEngine *QPaintDevice::paintEngine() const

デバイスへの描画に使用されるペイントエンジンへのポインタを返します。

bool QPaintDevice::paintingActive() const

デバイスが現在描画中である場合（つまり、このデバイスに対してQPainter::begin()が呼び出されているが、QPainter::end()はまだ呼び出されていない場合）、true を返します。それ以外の場合はfalse を返します。

QPainter::isActive()も参照してください 。

int QPaintDevice::physicalDpiX() const

デバイスの水平解像度をドット/インチ（dpi）単位で返します。たとえば、印刷時には、この解像度はプリンタの物理的な解像度を指します。一方、論理DPIとは、実際の描画エンジンで使用される解像度を指します。

physicalDpiX() の値がlogicalDpiX() の値と等しくない場合、対応するQPaintEngine が解像度のマッピングを処理する必要があることに注意してください。

physicalDpiY() およびlogicalDpiX()も参照してください 。

int QPaintDevice::physicalDpiY() const

デバイスの水平解像度をドット/インチ（dpi）単位で返します。たとえば、印刷時には、この解像度はプリンタの物理的な解像度を指します。一方、論理DPIとは、実際の描画エンジンで使用される解像度を指します。

なお、physicalDpiY() の値がlogicalDpiY() の値と一致しない場合、対応するQPaintEngine は解像度のマッピングを処理する必要があります。

physicalDpiX() およびlogicalDpiY()も参照してください 。

int QPaintDevice::width() const

デフォルトの座標系単位（例：QPixmap やQWidget ではピクセル）で、ペイントデバイスの幅を返します。

widthMM()も参照してください 。

int QPaintDevice::widthMM() const

ペイントデバイスの幅をミリメートル単位で返します。プラットフォームの制限により、この関数を使用して画面上のウィジェットの実際の物理的なサイズを特定できない場合があります。

width()も参照してください 。