Qt WidgetsにおけるQGraphicsLayoutItem::effectiveSizeHint()とは？

Qt WidgetsにおけるQGraphicsLayoutItem::effectiveSizeHint()解説

QGraphicsLayoutItem::effectiveSizeHint() は、Qt Widgetsにおけるグラフィックスレイアウトアイテムのサイズヒントを計算するための関数です。アイテムのサイズヒントは、レイアウトエンジンがアイテムをどのように配置するかを決める際に考慮されます。

詳細

effectiveSizeHint() は、以下の引数を受け取ります。

• sizeHint: アイテムのデフォルトのサイズヒント
• constraint: アイテムのサイズに適用される制約
• orientation: アイテムのレイアウト方向

この関数は、以下の値を返します。

• アイテムの有効なサイズヒント

コード例

class MyItem : public QGraphicsLayoutItem
{
public:
  MyItem() {}

  virtual QSizeF effectiveSizeHint(const QSizeF &sizeHint, const QSizeF &constraint, Qt::Orientation orientation) const override
  {
    // アイテムの有効なサイズヒントを計算

    // デフォルトのサイズヒントを使用
    QSizeF effectiveSize = sizeHint;

    // 制約を考慮
    if (constraint.isValid()) {
      effectiveSize.setWidth(qMin(effectiveSize.width(), constraint.width()));
      effectiveSize.setHeight(qMin(effectiveSize.height(), constraint.height()));
    }

    // レイアウト方向を考慮
    if (orientation == Qt::Horizontal) {
      effectiveSize.setHeight(effectiveSize.width());
    } else if (orientation == Qt::Vertical) {
      effectiveSize.setWidth(effectiveSize.height());
    }

    return effectiveSize;
  }
};

補足

• effectiveSizeHint() は、仮想関数であるため、派生クラスでオーバーライドすることができます。
• アイテムのサイズヒントは、アイテムの内容やレイアウトの状況によって異なる場合があります。
• アイテムのサイズヒントは、あくまでもヒントであり、レイアウトエンジンは必ずしもそれを尊重する必要はありません。

関連用語

• Qt Widgets
• QGraphicsLayoutItem
• QGraphicsLayout
• サイズヒント
• レイアウトエンジン

• 上記の説明は、Qt 5.15に基づいています。他のバージョンのQtでは、異なる場合があります。
• 不明な点があれば、お気軽にご質問ください。

Qt WidgetsにおけるQGraphicsLayoutItem::effectiveSizeHint()のサンプルコード

class MyItem : public QGraphicsLayoutItem
{
public:
  MyItem() {}

  virtual QSizeF effectiveSizeHint(const QSizeF &sizeHint, const QSizeF &constraint, Qt::Orientation orientation) const override
  {
    // デフォルトのサイズヒントを使用
    return sizeHint;
  }
};

制約を考慮する例

class MyItem : public QGraphicsLayoutItem
{
public:
  MyItem() {}

  virtual QSizeF effectiveSizeHint(const QSizeF &sizeHint, const QSizeF &constraint, Qt::Orientation orientation) const override
  {
    // デフォルトのサイズヒントを使用
    QSizeF effectiveSize = sizeHint;

    // 制約を考慮
    if (constraint.isValid()) {
      effectiveSize.setWidth(qMin(effectiveSize.width(), constraint.width()));
      effectiveSize.setHeight(qMin(effectiveSize.height(), constraint.height()));
    }

    return effectiveSize;
  }
};

レイアウト方向を考慮する例

class MyItem : public QGraphicsLayoutItem
{
public:
  MyItem() {}

  virtual QSizeF effectiveSizeHint(const QSizeF &sizeHint, const QSizeF &constraint, Qt::Orientation orientation) const override
  {
    // デフォルトのサイズヒントを使用
    QSizeF effectiveSize = sizeHint;

    // レイアウト方向を考慮
    if (orientation == Qt::Horizontal) {
      effectiveSize.setHeight(effectiveSize.width());
    } else if (orientation == Qt::Vertical) {
      effectiveSize.setWidth(effectiveSize.height());
    }

    return effectiveSize;
  }
};

複雑な例

class MyItem : public QGraphicsLayoutItem
{
public:
  MyItem() {}

  virtual QSizeF effectiveSizeHint(const QSizeF &sizeHint, const QSizeF &constraint, Qt::Orientation orientation) const override
  {
    // デフォルトのサイズヒントを使用
    QSizeF effectiveSize = sizeHint;

    // 制約を考慮
    if (constraint.isValid()) {
      effectiveSize.setWidth(qMin(effectiveSize.width(), constraint.width()));
      effectiveSize.setHeight(qMin(effectiveSize.height(), constraint.height()));
    }

    // レイアウト方向を考慮
    if (orientation == Qt::Horizontal) {
      effectiveSize.setHeight(effectiveSize.width());
    } else if (orientation == Qt::Vertical) {
      effectiveSize.setWidth(effectiveSize.height());
    }

    // アイテムの内容に基づいてサイズヒントを調整

    // ...

    return effectiveSize;
  }
};

その他

• 上記のサンプルコードは、あくまでも参考です。
• アイテムの内容やレイアウトの状況に合わせて、コードを修正する必要があります。

QGraphicsLayoutItem::effectiveSizeHint()の代替方法

固定サイズを使用する

アイテムのサイズが常に一定の場合、sizeHint() 関数をオーバーライドして、固定サイズを返すことができます。

class MyItem : public QGraphicsLayoutItem
{
public:
  MyItem() {}

  virtual QSizeF sizeHint() const override
  {
    return QSizeF(100, 100);
  }
};

アイテムの内容に基づいてサイズを計算する必要がある場合は、paint() 関数内でサイズを計算することができます。

class MyItem : public QGraphicsLayoutItem
{
public:
  MyItem() {}

  virtual void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) override
  {
    // アイテムの内容を描画

    // アイテムのサイズを計算
    QRectF rect = painter->boundingRect();
    setSizeHint(rect.size());
  }
};

レイアウトエンジンによっては、アイテムのサイズヒントを自動的に計算してくれる場合があります。この場合、effectiveSizeHint() 関数をオーバーライドする必要はありません。