Qt: アイテムの見た目と挙動を思いのままに！QGraphicsWidget::polishEvent() を駆使したカスタマイズテクニック

QGraphicsWidget::polishEvent() は、QGraphicsWidget アイテムがシーンに追加された後に呼び出される仮想保護イベントです。このイベントハンドラーを使用すると、アイテムが完全に構築された後に、最後の初期化を実行できます。

用途

主に以下の用途で使用されます。

アイテムのイベントハンドラーを接続する
アイテムのデータモデルを初期化する
アイテムの外観をカスタマイズする
アイテムのサイズと位置を調整する

イベント処理

polishEvent() は、アイテムがシーンに追加された後、アイテムが表示される前またはシーンを通じてアクセスされる前に呼び出されます。つまり、このイベントハンドラーは、アイテムが完全に構築され、シーン内の他のアイテムとの関係が確立された後に実行されます。

例

次のコードは、QGraphicsWidget::polishEvent() を使用して、アイテムのサイズと位置を調整する方法を示しています。

void MyGraphicsWidget::polishEvent()
{
    QGraphicsWidget::polishEvent();

    // アイテムのサイズを調整する
    setFixedSize(100, 50);

    // アイテムの位置を調整する
    setPos(100, 200);
}

polishEvent() は、アイテムが表示される前またはシーンを通じてアクセスされる前に呼び出されます。このイベントハンドラーでアイテムの表示に依存する操作を実行すると、予期しない動作が発生する可能性があります。
polishEvent() は、アイテムがシーンに追加された後のみ呼び出されます。アイテムがシーンに追加される前にこのイベントハンドラーを呼び出すと、予期しない動作が発生する可能性があります。

polishEvent() は、アイテムの初期化にのみ使用してください。アイテムの描画またはイベント処理には使用しないでください。
QGraphicsWidget::polishEvent() は、QWidget::polishEvent() と同じように機能します。ただし、QGraphicsWidget アイテムはシーン内の他のアイテムと関係するため、QWidget::polishEvent() で実行できない追加の初期化が必要になる場合があります。

class MyGraphicsWidget : public QGraphicsWidget
{
public:
    MyGraphicsWidget(QGraphicsItem *parent = nullptr);

protected:
    void paintEvent(QPainter *painter) override;
    void polishEvent() override;
};

MyGraphicsWidget::MyGraphicsWidget(QGraphicsItem *parent)
    : QGraphicsWidget(parent)
{
    // アイテムの初期設定を行う
    setFixedSize(100, 50);
    setPos(100, 200);
}

void MyGraphicsWidget::paintEvent(QPainter *painter)
{
    // アイテムを描画する
    painter->setPen(Qt::black);
    painter->drawRect(0, 0, width(), height());
}

void MyGraphicsWidget::polishEvent()
{
    QGraphicsWidget::polishEvent();

    // アイテムのサイズと位置を調整する
    setFixedSize(150, 75);
    setPos(200, 300);
}

例 2: アイテムの外観をカスタマイズする

この例では、QGraphicsWidget::polishEvent() を使用して、アイテムの外観をカスタマイズする方法を示します。

class MyGraphicsWidget : public QGraphicsWidget
{
public:
    MyGraphicsWidget(QGraphicsItem *parent = nullptr);

protected:
    void paintEvent(QPainter *painter) override;
    void polishEvent() override;
};

MyGraphicsWidget::MyGraphicsWidget(QGraphicsItem *parent)
    : QGraphicsWidget(parent)
{
    // アイテムの初期設定を行う
    setFixedSize(100, 50);
    setPos(100, 200);
}

void MyGraphicsWidget::paintEvent(QPainter *painter)
{
    // アイテムを描画する
    painter->setPen(Qt::black);
    painter->setBrush(Qt::green);
    painter->drawRect(0, 0, width(), height());
}

void MyGraphicsWidget::polishEvent()
{
    QGraphicsWidget::polishEvent();

    // アイテムの外観をカスタマイズする
    setPen(Qt::red);
    setBrush(Qt::yellow);
}

例 3: アイテムのデータモデルを初期化する

この例では、QGraphicsWidget::polishEvent() を使用して、アイテムのデータモデルを初期化する方法を示します。

class MyGraphicsWidget : public QGraphicsWidget
{
public:
    MyGraphicsWidget(QGraphicsItem *parent = nullptr);

protected:
    void paintEvent(QPainter *painter) override;
    void polishEvent() override;
};

MyGraphicsWidget::MyGraphicsWidget(QGraphicsItem *parent)
    : QGraphicsWidget(parent)
{
    // アイテムの初期設定を行う
    setFixedSize(100, 50);
    setPos(100, 200);
}

void MyGraphicsWidget::paintEvent(QPainter *painter)
{
    // アイテムを描画する
    painter->setPen(Qt::black);
    painter->drawText(rect(), Qt::AlignCenter, "データモデル");
}

void MyGraphicsWidget::polishEvent()
{
    QGraphicsWidget::polishEvent();

    // アイテムのデータモデルを初期化する
    dataModel = new MyDataModel();
}

例 4: アイテムのイベントハンドラーを接続する

この例では、QGraphicsWidget::polishEvent() を使用して、アイテムのイベントハンドラーを接続する方法を示します。

class MyGraphicsWidget : public QGraphicsWidget
{
public:
    MyGraphicsWidget(QGraphicsItem *parent = nullptr);

protected:
    void paintEvent(QPainter *painter) override;
    void polishEvent() override;

private:
    void handleClickEvent(QGraphicsSceneMouseEvent *event);
};

MyGraphicsWidget::MyGraphicsWidget(QGraphicsItem *parent)
    : QGraphicsWidget(parent)
{
    // アイテムの初期設定を行う
    setFixedSize(100, 50);
    setPos(100, 200);
}

void MyGraphicsWidget::paintEvent(QPainter *painter)
{
    //

コンストラクタを使用する

アイテムの初期化は、コンストラクタ内で行うことができます。これは、最も単純でわかりやすい方法です。

class MyGraphicsWidget : public QGraphicsWidget
{
public:
    MyGraphicsWidget(QGraphicsItem *parent = nullptr);

protected:
    void paintEvent(QPainter *painter) override;
};

MyGraphicsWidget::MyGraphicsWidget(QGraphicsItem *parent)
    : QGraphicsWidget(parent)
{
    // アイテムの初期化を行う
    setFixedSize(100, 50);
    setPos(100, 200);
}

void MyGraphicsWidget::paintEvent(QPainter *painter)
{
    // アイテムを描画する
    painter->setPen(Qt::black);
    painter->drawRect(0, 0, width(), height());
}

setup() メソッドを使用する

QGraphicsWidget クラスには、setup() という仮想メソッドが用意されています。このメソッドは、アイテムがシーンに追加された後に呼び出されます。polishEvent() と同様に、アイテムの初期化に使用できます。

class MyGraphicsWidget : public QGraphicsWidget
{
public:
    MyGraphicsWidget(QGraphicsItem *parent = nullptr);

protected:
    void paintEvent(QPainter *painter) override;
    void setup() override;
};

MyGraphicsWidget::MyGraphicsWidget(QGraphicsItem *parent)
    : QGraphicsWidget(parent)
{
}

void MyGraphicsWidget::paintEvent(QPainter *painter)
{
    // アイテムを描画する
    painter->setPen(Qt::black);
    painter->drawRect(0, 0, width(), height());
}

void MyGraphicsWidget::setup()
{
    // アイテムの初期化を行う
    setFixedSize(100, 50);
    setPos(100, 200);
}

アイテムのデータモデルを使用する

class MyGraphicsWidget : public QGraphicsWidget
{
public:
    MyGraphicsWidget(QGraphicsItem *parent = nullptr);

protected:
    void paintEvent(QPainter *painter) override;

private:
    MyDataModel *dataModel;
};

MyGraphicsWidget::MyGraphicsWidget(QGraphicsItem *parent)
    : QGraphicsWidget(parent),
      dataModel(new MyDataModel())
{
    // アイテムの初期設定を行う
    setFixedSize(100, 50);
    setPos(100, 200);
}

void MyGraphicsWidget::paintEvent(QPainter *painter)
{
    // アイテムを描画する
    painter->setPen(Qt::black);
    painter->drawText(rect(), Qt::AlignCenter, dataModel->text());
}

アイテムの状態をプロパティとして公開する

アイテムの状態をプロパティとして公開すると、コードから直接アクセスして設定することができます。これは、シンプルなアイテムの場合に有効な方法です。

class MyGraphicsWidget : public QGraphicsWidget
{
public:
    MyGraphicsWidget(QGraphicsItem *parent = nullptr);

    int size() const { return _size; }
    void setSize(int size) { _size = size; }

    QPoint position() const { return _position; }
    void setPosition(const QPoint &position) { _position = position; }

protected:
    void paintEvent(QPainter *painter) override;

private:
    int _size;
    QPoint _position;
};

MyGraphicsWidget::MyGraphicsWidget(QGraphicsItem *parent)
    : QGraphicsWidget(parent),
      _size(100),
      _position(QPoint(100, 200))
{
}

void MyGraphicsWidget::paintEvent(QPainter *painter)
{
    // アイテムを描画する
    painter->setPen(Qt::black);
    painter->drawRect(0, 0, _size, _size);
    painter->drawText(rect(),