Qt GUIにおけるアクセシビリティ実装：QAccessibleInterface::~QAccessibleInterface()の役割

QAccessibleInterface::~QAccessibleInterface()は、Qt GUIにおけるアクセシビリティ機能の重要な要素であるQAccessibleInterfaceクラスのデストラクタです。このデストラクタは、QAccessibleInterfaceオブジェクトが破棄されるときに自動的に呼び出され、オブジェクトが保持していたリソースを解放します。

詳細

QAccessibleInterfaceクラスは、アクセシビリティツール（スクリーンリーダーや点字ディスプレイなど）がアプリケーション内のアクセシブルオブジェクトに関する情報を取得するために使用するインターフェースを定義します。アクセシブルオブジェクトとは、ユーザーが操作したり反応したりできるすべての要素であり、主にウィジェットやウィジェット要素などの視覚的なオブジェクトですが、音声などのコンテンツも含まれます。

QAccessibleInterface::~QAccessibleInterface()デストラクタは、以下の処理を行います。

子オブジェクトのデストラクション
デストラクタは、まずQAccessibleInterfaceオブジェクトが保持しているすべての子オブジェクトを破棄します。これは、再帰的に行われます。

例

class MyAccessibleWidget : public QWidget, public QAccessibleInterface
{
public:
    MyAccessibleWidget(QWidget *parent = nullptr);
    ~MyAccessibleWidget();

private:
    QAccessibleInterface *child1;
    QAccessibleInterface *child2;
};

MyAccessibleWidget::MyAccessibleWidget(QWidget *parent)
    : QWidget(parent)
{
    child1 = new QAccessibleInterface(this);
    child2 = new QAccessibleInterface(this);
}

MyAccessibleWidget::~MyAccessibleWidget()
{
    delete child1;
    delete child2;
}

注意事項

QAccessibleInterface::~QAccessibleInterface()デストラクタを明示的に呼び出す必要はありません。デストラクタは、オブジェクトが破棄されるときに自動的に呼び出されます。

QAccessibleInterfaceの継承とデストラクタ

class MyAccessibleWidget : public QWidget, public QAccessibleInterface
{
public:
    MyAccessibleWidget(QWidget *parent = nullptr);
    ~MyAccessibleInterface();

private:
    QAccessibleInterface *child1;
    QAccessibleInterface *child2;
};

MyAccessibleWidget::MyAccessibleWidget(QWidget *parent)
    : QWidget(parent)
{
    child1 = new QAccessibleInterface(this);
    child2 = new QAccessibleInterface(this);
}

MyAccessibleWidget::~MyAccessibleWidget()
{
    delete child1;
    delete child2;
}

QAccessibleInterfaceオブジェクトの破棄

MyAccessibleWidget *widget = new MyAccessibleWidget();

// ...

delete widget;

この例では、MyAccessibleWidgetオブジェクトがnew演算子で作成され、delete演算子で破棄されます。delete演算子が呼び出されると、~MyAccessibleWidget()デストラクタが自動的に呼び出され、オブジェクトが保持していたリソースが解放されます。

class MyAccessibleParentWidget : public QWidget
{
public:
    MyAccessibleParentWidget(QWidget *parent = nullptr);
};

class MyAccessibleChildWidget : public QWidget, public QAccessibleInterface
{
public:
    MyAccessibleChildWidget(MyAccessibleParentWidget *parent);
    ~MyAccessibleInterface();

private:
    QAccessibleInterface *child1;
    QAccessibleInterface *child2;
};

MyAccessibleChildWidget::MyAccessibleChildWidget(MyAccessibleParentWidget *parent)
    : QWidget(parent)
{
    child1 = new QAccessibleInterface(this);
    child2 = new QAccessibleInterface(this);
}

MyAccessibleChildWidget::~MyAccessibleInterface()
{
    delete child1;
    delete child2;
}

QAccessibleInterface::~QAccessibleInterface()デストラクタは、QAccessibleInterfaceオブジェクトが破棄されるときに自動的に呼び出され、オブジェクトが保持していたリソースを解放します。しかし、状況によっては、デストラクタ以外の方法でオブジェクトを破棄したい場合があります。

代替方法

QAccessibleInterfaceオブジェクトを破棄する代替方法はいくつかあります。

delete演算子を使用する
delete演算子は、動的に割り当てられたオブジェクトを破棄するために使用されます。QAccessibleInterfaceオブジェクトは動的に割り当てられたオブジェクトであるため、delete演算子を使用して破棄することができます。

QAccessibleInterface *interface = new QAccessibleInterface();

// ...

delete interface;

QAccessibleInterface::release()メソッドを使用する
QAccessibleInterfaceクラスにはrelease()メソッドが定義されており、オブジェクトを破棄するために使用することができます。release()メソッドは、デストラクタと同様に、オブジェクトが保持しているすべてのリソースを解放します。

QAccessibleInterface *interface = new QAccessibleInterface();

// ...

interface->release();

QAccessibleInterface::deleteLater()メソッドを使用する
QAccessibleInterfaceクラスにはdeleteLater()メソッドが定義されており、オブジェクトを破棄するために使用することができます。deleteLater()メソッドは、オブジェクトをイベントループの次のイベント処理時に破棄するようにスケジュールします。

QAccessibleInterface *interface = new QAccessibleInterface();

// ...

interface->deleteLater();

release()メソッドを使用する場合は、オブジェクトがイベントループから確実に削除されるように、deleteLater()メソッドと組み合わせて使用する必要がある場合があります。
delete演算子を使用する場合は、オブジェクトが保持しているすべての子オブジェクトも破棄されることに注意する必要があります。