モデルとビューQt Quick

Qt Quick 。データを表示するために、モデル、ビュー、デリゲートという概念があります。これらは、開発者や設計者がデータのさまざまな側面を制御できるように、データの視覚化をモジュール化しています。開発者は、データにほとんど変更を加えることなく、リスト・ビューとグリッド・ビューを入れ替えることができる。同様に、デリゲートにデータのインスタンスをカプセル化することで、開発者はデータの表示方法や処理方法を指定することができます。

• モデル- データとその構造を含みます。モデルを作成するためのQMLの型がいくつかあります。
• ビュー- データを表示するコンテナ。ビューはデータをリストやグリッドで表示します。
• デリゲート- データがどのようにビューに表示されるかを指定します。デリゲートは、モデル内のデータの各単位を受け取り、それをカプセル化します。データはデリゲートを通してアクセスすることができます。デリゲートは、編集可能なモデルにデータを書き戻すこともできます（例えば、TextField'のonAcceptedハンドラで）。

データを視覚化するには、ビューのmodel プロパティをモデルに、delegate プロパティをコンポーネントまたは他の互換性のある型にバインドします。

ビューによるデータの表示

ビューは、アイテムのコレクションを格納するコンテナです。ビューは機能が豊富で、スタイルや動作の要件に合わせてカスタマイズすることができます。

Qt Quick グラフィカル・タイプの基本セットには、標準ビューのセットが用意されています：

• ListView - 水平または垂直のリストに項目を配置する
• GridView - 利用可能なスペース内のグリッドに項目を配置する
• PathView - パス上にアイテムを配置する
• TableView -QAbstractTableModel のデータを表に並べる。
• TreeView -QAbstractItemModel のデータをツリーに並べる

これらのタイプには、それぞれのタイプ専用のプロパティと動作があります。詳しくはそれぞれのドキュメントをご覧ください。

さらに、Qt Quick コントロールには、HorizontalHeaderView やVerticalHeaderView のように、アプリケーションのスタイルに応じたビューやデリゲートが含まれています。

ビューの装飾

ビューでは、header 、footer 、section プロパティなどの装飾プロパティによって、ビジュアルをカスタマイズすることができます。これらのプロパティにオブジェクト（通常は別のビジュアルオブジェクト）をバインドすることで、ビューは装飾可能になります。フッターには、ボーダーを表示するRectangle タイプや、リストの上にロゴを表示するヘッダーを含めることができます。

例えば、あるクラブがメンバーリストをブランドカラーで装飾したいとします。メンバーリストはmodel 、delegate にはモデルのコンテンツが表示されます。

ListModel {
    id: nameModel
    ListElement { name: "Alice" }
    ListElement { name: "Bob" }
    ListElement { name: "Jane" }
    ListElement { name: "Harry" }
    ListElement { name: "Wendy" }
}
Component {
    id: nameDelegate
    Text {
        required property string name
        text: name
        font.pixelSize: 24
        width: ListView.view.width
    }
}

クラブは、header とfooter プロパティにビジュアル・オブジェクトをバインドすることで、会員リストを装飾することができます。ビジュアル・オブジェクトは、インラインで定義することも、別のファイルで定義することも、Component タイプで定義することもできます。

ListView {
    anchors.fill: parent
    clip: true
    model: nameModel
    delegate: nameDelegate
    header: bannercomponent
    footer: Rectangle {
        width: parent.width; height: 30;
        gradient: clubcolors
    }
    highlight: Rectangle {
        color: "lightgray"
    }
}

Component {     //instantiated when header is processed
    id: bannercomponent
    Rectangle {
        id: banner
        width: parent.width; height: 50
        gradient: clubcolors
        border {color: "#9EDDF2"; width: 2}
        Text {
            anchors.centerIn: parent
            text: "Club Members"
            font.pixelSize: 32
        }
    }
}
Gradient {
    id: clubcolors
    GradientStop { position: 0.0; color: "#8EE2FE"}
    GradientStop { position: 0.66; color: "#7ED2EE"}
}

マウスとタッチのハンドリング

ビューはコンテンツのドラッグやフリックを処理しますが、個々のデリゲートとのタッチインタラクションは処理しません。デリゲートがタッチ入力に反応するためには、例えば、currentIndex 、適切なタッチハンドリングロジックを持つMouseArea 、デリゲートによって提供されなければならない。

highlightRangeMode がStrictlyEnforceRange に設定されている場合、ビューは常にcurrentIndex が指定されたハイライト範囲内にあることを保証するため、currentIndex はビューのドラッグ/フリックによって影響を受けることに注意すること。

リストビューのセクション

ListView コンテンツはセクションにグループ化することができ、関連するリスト項目はそのセクションに従ってラベル付けされます。さらに、セクションはデリゲートで装飾することができます。

リストには、人の名前とその人が所属するチームを示すリストを含めることができる。

ListModel {
    id: nameModel
    ListElement { name: "Alice"; team: "Crypto" }
    ListElement { name: "Bob"; team: "Crypto" }
    ListElement { name: "Jane"; team: "QA" }
    ListElement { name: "Victor"; team: "QA" }
    ListElement { name: "Wendy"; team: "Graphics" }
}
Component {
    id: nameDelegate
    Text {
        required property string name
        text: name;
        font.pixelSize: 24
        anchors.left: parent.left
        anchors.leftMargin: 2
    }
}

ListView 型にはsection attached プロパティがあり、隣接する型や関連する型をセクションにまとめることができる。section.property は、セクションとして使用するリスト型のプロパティを決定します。section.criteria は、セクション名の表示方法を指定でき、section.delegate は、ビューのdelegateプロパティに似ています。

ListView {
    anchors.fill: parent
    model: nameModel
    delegate: nameDelegate
    focus: true
    highlight: Rectangle {
        color: "lightblue"
        width: parent.width
    }
    section {
        property: "team"
        criteria: ViewSection.FullString
        delegate: Rectangle {
            color: "#b0dfb0"
            width: parent.width
            height: childrenRect.height + 4
            Text { anchors.horizontalCenter: parent.horizontalCenter
                font.pixelSize: 16
                font.bold: true
                text: section
            }
        }
    }
}

ビューのデリゲート

ビューはリスト内のアイテムを視覚的に表現するためにデリゲートを必要とします。ビューは、デリゲートによって定義されたテンプレートに従って、各アイテムのリストを視覚化します。モデル内のアイテムは、アイテムのプロパティと同様にindex プロパティを通してアクセスすることができます。

Component {
    id: petdelegate
    Text {
        id: label
        font.pixelSize: 24
        text: index === 0 ? type + " (default)" : type

        required property int index
        required property string type
    }
}

ビューデリゲートの配置

ビューの種類によって、アイテムの配置方法が決まります。ListView は、orientation に応じて、アイテムを直線で配置します。一方、GridView は、アイテムを2次元グリッドで配置することができます。x やy に直接バインドすることはお勧めしません。ビューのレイアウト動作が、位置バインドよりも常に優先されるからです。

デリゲートからのビューとモデルへのアクセス

デリゲートがバインドされているリストビューには、デリゲートからListView.view プロパティを通してアクセスできます。同様に、GridView GridView.view はデリゲートから利用可能です。したがって、対応するモデルとそのプロパティは、ListView.view.model を通して利用可能です。さらに、モデル内で定義されたシグナルやメソッドにもアクセスできます。

このメカニズムは、例えば、複数のビューに同じデリゲートを使用したいが、装飾やその他の機能をビューごとに異なるものにしたい場合、そして、これらの異なる設定を各ビューのプロパティにしたい場合に便利です。同様に、モデルのいくつかのプロパティにアクセスしたり、表示したりすることも興味深いでしょう。

以下の例では、デリゲートはモデルのプロパティlanguageを表示し、フィールドの1つの色はビューのプロパティfruit_colorに依存します。

Rectangle {
     width: 200; height: 200

    ListModel {
        id: fruitModel
        property string language: "en"
        ListElement {
            name: "Apple"
            cost: 2.45
        }
        ListElement {
            name: "Orange"
            cost: 3.25
        }
        ListElement {
            name: "Banana"
            cost: 1.95
        }
    }

    Component {
        id: fruitDelegate
        Row {
            id: fruit
            required property string name
            required property real cost
            Text {
                text: " Fruit: " + fruit.name
                color: fruit.ListView.view.fruit_color
            }
            Text {
                text: " Cost: $" + fruit.cost
            }
            Text {
                text: " Language: " + fruit.ListView.view.model.language
            }
        }
    }

    ListView {
        property color fruit_color: "green"
        model: fruitModel
        delegate: fruitDelegate
        anchors.fill: parent
    }
}

モデル

データは、デリゲートがバインドすることができる名前付きデータロールを通して、デリゲートに提供されます。以下は、typeと ageという2つのロールを持つListModel 、これらのロールにバインドして値を表示するデリゲートを持つListView ：

import QtQuick

Item {
    width: 200
    height: 250

    ListModel {
        id: myModel
        ListElement { type: "Dog"; age: 8; noise: "meow" }
        ListElement { type: "Cat"; age: 5; noise: "woof" }
    }

    component MyDelegate : Text {
        required property string type
        required property int age
        text: type + ", " + age
        // WRONG: Component.onCompleted: () => console.log(noise)
        // The above line would cause a ReferenceError
        // as there is no required property noise,
        // and the presence of the required properties prevents
        // noise from being injected into the scope
    }

    ListView {
        anchors.fill: parent
        model: myModel
        delegate: MyDelegate {}
    }
}

ほとんどの場合、必須プロパティを使用してデリゲートにモデルデータを渡す必要があります。デリゲートに必須プロパティが含まれている場合、QMLエンジンは必須プロパティの名前がモデルのロールの名前と一致するかどうかをチェックします。もしそうであれば、そのプロパティはモデルの対応する値にバインドされます。

まれに、必須プロパティとしてではなく、QMLコンテキストを通してモデルのプロパティを転送したい場合があります。デリゲートに必須プロパティが存在しない場合、名前付きロールはコンテキスト・プロパティとして提供されます：

import QtQuick

Item {
    width: 200; height: 250

    ListModel {
        id: myModel
        ListElement { type: "Dog"; age: 8 }
        ListElement { type: "Cat"; age: 5 }
    }

    Component {
        id: myDelegate
        Text { text: type + ", " + age }
    }

    ListView {
        anchors.fill: parent
        model: myModel
        delegate: myDelegate
    }
}

コンテキスト・プロパティはツールからは見えず、Qt Quick コンパイラによるコードの最適化を妨げます。コンテキスト・プロパティはツールからは見えず、コンパイラがコードを最適化するのを妨げます。コンテキスト・プロパティは、デリゲートが期待する特定のデータを推論するのを難しくします。QMLからQMLコンテキストを明示的に入力する方法はありません。もしあなたのコンポーネントが QML コンテキスト経由でデータが渡されることを期待するのであれば、 ネイティブな手段によって適切なコンテキストが提供されている場所でのみ、 QML コンテキストを使用することができます。これは、あなた自身のC++コードであったり、周囲の要素の特定の実装であったりします。逆に、必要なプロパティはQMLから、あるいはネイティブな手段を使って、さまざまな方法で設定することができます。したがって、QMLのコンテキストを経由してデータを渡すことは、コンポーネントの再利用性を低下させることになります。

モデルのプロパティとデリゲートのプロパティの間に名前の衝突がある場合、代わりに修飾されたモデル名でロールにアクセスすることができます。例えば、Text 型が（必須ではない）typeプロパティやageプロパティを持っていた場合、上記の例のテキストは、モデル項目からのtype値やage値の代わりに、それらのプロパティ値を表示することになります。この場合、デリゲートがモデルアイテムのプロパティ値を確実に表示するために、プロパティをmodel.type およびmodel.age として参照することができます。これを動作させるには、デリゲートにmodel プロパティを要求する必要があります（コンテキスト・プロパティを使用している場合を除く）。

モデル内のアイテムのインデックスを含む特別なインデックスロールもデリゲートで利用可能です。アイテムがモデルから削除された場合、このインデックスは-1に設定されることに注意してください。indexロールにバインドする場合は、indexが-1になる可能性、つまりアイテムがもはや無効である可能性を考慮したロジックであることを確認してください。(通常、アイテムはすぐに破棄されますが、delayRemove 添付プロパティによって、ビューによっては破棄を遅らせることができます)。

モデルとして整数や配列を使用できることを覚えておいてください：

Repeater {
    model: 5
    Text {
        required property int modelData
        text: modelData
    }
}

Repeater {
    model: ["one", "two", "three"]
    Text {
        required property string modelData
        text: modelData
    }
}

このようなモデルは、デリゲートの各インスタンスに単一の匿名データを提供します。このデータ片にアクセスすることがmodelData を使う主な理由ですが、他のモデルもmodelData を提供します。

モデルロールを通じて提供されるオブジェクトには、空の名前を持つプロパティがあります。この匿名プロパティはmodelDataを保持します。さらに、モデル・ロールを介して提供されるオブジェクトには、modelDataという別のプロパティがあります。このプロパティは非推奨であり、modelDataを保持します。

モデル・ロールに加えて、modelDataロールが提供されています。modelDataロールは、modelDataプロパティと、modelロールを介して提供されるオブジェクトのanonymousプロパティと同じデータを保持します。

modelロールとmodelDataにアクセスする様々な手段との違いは以下の通りです：

• 名前付きロールを持たないモデル（整数や文字列の配列など）は、modelDataロールを介してデータが提供されます。この場合、modelDataロールは必ずしもオブジェクトを含んでいるとは限りません。整数モデルの場合は、整数（現在のモデル項目のインデックス）が含まれます。文字列の配列の場合は、文字列が含まれます。モデルのロールにはオブジェクトが含まれますが、名前付きロールのプロパティは含まれません。モデルには通常のmodelDataと匿名プロパティが含まれます。
• モデルに名前付きロールが1つしかない場合、modelDataロールには名前付きロールと同じデータが含まれます。これは必ずしもオブジェクトではなく、通常のように名前付きロールを名前付きプロパティとして含むわけではありません。モデルロールには、名前付きロールをプロパティとして持つオブジェクトと、この場合のmodelDataプロパティとanonymousプロパティが含まれます。
• 複数のロールを持つモデルでは、modelDataロールは必須プロパティとしてのみ提供され、コンテキストプロパティとしては提供されません。これは、古いバージョンのQtとの後方互換性のためです。

modelのanonymousプロパティを使用すると、モデル・データと反応するロール名の両方を外部からプロパティとして受け取るデリゲートをきれいに記述することができます。roleとして空文字列を指定します。その場合、model[role] にアクセスするだけのバインディングは、期待通りの動作をします。この場合のために特別なコードを追加する必要はありません。

QMLでは、組み込みのQML型セットの中にいくつかのタイプのデータモデルを用意しています。さらに、Qt C++でモデルを作成し、QQmlEngine 、QMLコンポーネントで利用できるようにすることもできます。これらのモデルの作成については、C++モデルをQt Quick Viewsで使用する、QML型を作成する、などの記事を参照してください。

モデルからのアイテムの配置は、Repeater.NET Framework を使って行うことができます。

リストモデル

ListModel はQMLで指定された型の単純な階層構造です。利用可能な役割は、ListElement プロパティで指定します。

ListModel {
    id: fruitModel

    ListElement {
        name: "Apple"
        cost: 2.45
    }
    ListElement {
        name: "Orange"
        cost: 3.25
    }
    ListElement {
        name: "Banana"
        cost: 1.95
    }
}

上記のモデルには、nameと costの2つのロールがあります。これらは、例えばListView デリゲートによってバインドすることができます：

ListView {
    anchors.fill: parent
    model: fruitModel
    delegate: Row {
        id: delegate
        required property string name
        required property real cost

        Text { text: "Fruit: " + delegate.name }
        Text { text: "Cost: $" + delegate.cost }
    }
}

ListModel はJavaScriptで直接ListModel を操作するメソッドを提供します。この場合、最初に挿入された項目が、モデルを使用しているビューで利用可能なロールを決定します。例えば、空のListModel が作成され、JavaScript によって入力される場合、最初の挿入によって提供されるロールが、ビューに表示される唯一のロールとなります：

ListModel { id: fruitModel }
    ...
MouseArea {
    anchors.fill: parent
    onClicked: fruitModel.append({"cost": 5.95, "name":"Pizza"})
}

MouseArea がクリックされると、fruitModel はコストと 名前の2つのロールを持つことになります。それ以降のロールが追加されたとしても、モデルを使用するビューで扱われるのは最初の2つのみです。モデルで使用可能なロールをリセットするには、ListModel::clear （）を呼び出します。

XMLモデル

XmlListModel を使用すると、XMLデータ・ソースからモデルを構築できます。ロールはXmlListModelRole 型を介して指定されます。型をインポートする必要があります。

import QtQml.XmlListModel

以下のモデルには、title、link、pubDateの3つのロールがあります：

XmlListModel {
     id: feedModel
     source: "http://rss.news.yahoo.com/rss/oceania"
     query: "/rss/channel/item"
     XmlListModelRole { name: "title"; elementName: "title" }
     XmlListModelRole { name: "link"; elementName: "link" }
     XmlListModelRole { name: "pubDate"; elementName: "pubDate" }
}

query プロパティは、XmlListModel が XML 文書の各<item> に対してモデル項目を生成することを指定します。

RSSニュースのデモでは、XmlListModel を使用して RSS フィードを表示する方法を示しています。

オブジェクトモデル

ObjectModel には、ビューで使用するビジュアルアイテムが含まれています。ObjectModel がビューで使用されるとき、ObjectModel がすでにビジュアルデリゲート（アイテム）を含んでいるので、ビューはデリゲートを必要としません。

以下の例では、ListView に 3 つの色の付いた長方形を配置しています。

import QtQuick 2.0
import QtQml.Models 2.1

Rectangle {
    ObjectModel {
        id: itemModel
        Rectangle { height: 30; width: 80; color: "red" }
        Rectangle { height: 30; width: 80; color: "green" }
        Rectangle { height: 30; width: 80; color: "blue" }
    }

    ListView {
        anchors.fill: parent
        model: itemModel
    }
}

モデルとしての整数

整数は、ある数の型を含むモデルとして使用することができます。この場合、モデルはデータの役割を持ちません。

以下の例では、5つの要素を持つListView を作成します：

Item {
    width: 200; height: 250

    Component {
        id: itemDelegate

        Text {
            required property int index
            text: "I am item number: " + index
        }
    }

    ListView {
        anchors.fill: parent
        model: 5
        delegate: itemDelegate
    }

}

モデルとしてのオブジェクト・インスタンス

オブジェクトインスタンスは、単一のオブジェクトタイプを持つモデルを指定するために使用することができます。オブジェクトのプロパティはロールとして提供されます。

以下の例では、myTextテキストの色を示す 1 つの項目を持つリストを作成しています。デリゲート内のText型のcolorプロパティとの衝突を避けるために、完全修飾されたmodel.colorプロパティを使用していることに注意してください。

Rectangle {
    width: 200; height: 250

    Text {
        id: myText
        text: "Hello"
        color: "#dd44ee"
    }

    Component {
        id: myDelegate

        Text {
            required property var model
            text: model.color
        }
    }

    ListView {
        anchors.fill: parent
        anchors.topMargin: 30
        model: myText
        delegate: myDelegate
    }
}

C++データモデル

C++でモデルを定義し、QMLで利用できるようにすることができます。この仕組みは、既存のC++データモデルや複雑なデータセットをQMLに公開するのに便利です。

詳しくはUsing C++ Models withQt Quick Viewsをご覧ください。

配列モデル

JavaScriptの配列や様々なQMLのリストをモデルとして使用することができます。リストの各要素は、上で説明したルールに従ってモデルやモデルデータとして利用することができます：整数や文字列のような単数のデータは、単数のmodelDataとして利用可能です。JavaScriptのオブジェクトやQObjectのような構造化されたデータは、構造化されたモデルやmodelDataとして利用できます。

個々のモデルの役割も、必須プロパティとして要求されれば利用可能になります。どのようなオブジェクトが配列に現れるかを事前に知ることはできないため、デリゲート内の必須プロパティは、おそらくundefined を必須型に強制することで入力されます。しかし、個々のモデルの役割は、QMLのコンテキストからは利用できません。それらは、他のすべてのコンテキスト・プロパティに影を落とすことになります。

リピーター

リピーターは、モデルからのデータを使って、ポジショナーで使用するアイテムをテンプレートから作成します。リピーターとポジショナーを組み合わせることは、たくさんのアイテムをレイアウトする簡単な方法です。Repeater アイテムはポジショナーの中に置かれ、囲んでいるポジショナーが配置するアイテムを生成する。

各リピーターは、model プロパティを使用して指定されたモデルからのデータの各要素を、リピーター内の子アイテムとして定義されたテンプレートアイテムと組み合わせることによって、多数のアイテムを作成します。アイテムの総数は、モデルのデータ量によって決まります。

次の例では、リピータをグリッド・アイテムと共に使用して、矩形アイテムのセットを配置しています。リピーターアイテムは、Gridアイテムが5×5で配置できるように、24個の長方形を作成します。

import QtQuick

Rectangle {
    width: 400
    height: 400
    color: "black"

    Grid {
        x: 5
        y: 5
        rows: 5
        columns: 5
        spacing: 10

        Repeater {
            model: 24
            Rectangle {
                id: delegate

                required property int index

                width: 70
                height: 70
                color: "lightgreen"

                Text {
                    text: delegate.index
                    font.pointSize: 30
                    anchors.centerIn: parent
                }
            }
        }
    }
}

リピータによって作成されるアイテムの数は、count プロパティによって保持されます。このプロパティを設定して、作成されるアイテムの数を決定することはできません。代わりに、上記の例のように、モデルとして整数を使用します。

詳しくはQMLデータモデルを参照してください。

モデルが文字列リストの場合、デリゲートは文字列を保持する通常の読み取り専用のmodelData プロパティにも公開されます。例えば

Column {
    Repeater {
        model: ["apples", "oranges", "pears"]
        Text {
            required property string modelData
            text: "Data: " + modelData
        }
    }
}

リピータが作成するアイテムのテンプレートとしてデリゲートを使用することも可能です。これはdelegate プロパティを使用して指定します。

モデルデータの変更

すべての関連するビューにはdelegateModelAccessというプロパティがあります。ほとんどの場合、このプロパティをDelegateModel.ReadWrite に設定します。これにより、デリゲートは最も柔軟な方法でモデルデータを変更することができます。また、デリゲートにモデルデータを一切変更させたくない場合は、DelegateModel.ReadOnlyに設定することもできます。

以下の表では、プロパティが保持できるすべての値について詳しく説明します。

一部のモデルは、ビューが参照する独立したアイデンティティーを持つオブジェクトです。元のオブジェクトは、デリゲートを作成するための唯一の真理源です。それはコピーされません。このようなモデルは、デリゲートを通して書き込むと、目に見える形で更新されます。

他のモデルは独立したIDを持たず、ビューに割り当てる際にコピーされます。このようなモデルでは、デリゲートを通して書き込む際に、ビューの内部のみが更新されます。元のモデルは変更されません。

一般的にQMLのオブジェクト型は独立したIDを持ちますが、QMLの値型はそうではありません。そのため、ListModel や、QAbstractItemModel から派生したもの、オブジェクト型のインスタンスやオブジェクト型のインスタンスのリストは、モデルとして渡され、デリゲートを通して書き込まれたときに更新されます。しかし、JavaScriptの配列、値型のリスト、単純な数値は、デリゲートを介してモデルデータを変更しても更新を受けません。

さらに、独自のC++モデルを実装する場合、デリゲートから渡された更新を受け取るためにsetData を実装する必要があります。

setData メソッドを実装したQAbstractItemModel ベースの C++ モデルがEditableModel という名前の QML 型として登録されているとします。そして、このモデルに次のようにデータを書き込むことができます：

ListView {
    anchors.fill: parent
    model: EditableModel {}

    // Make sure that changes to the required property are propagated
    delegateModelAccess: DelegateModel.ReadWrite

    delegate: TextEdit {
        required property string edit

        width: ListView.view.width
        height: 30
        text: edit
        Keys.onReturnPressed: edit = text
    }
}

また、model オブジェクトをこのように操作することで、モデルのデータを変更することもできます：

ListView {
    anchors.fill: parent
    model: EditableModel {}
    delegate: TextEdit {
        required property QtObject model

        width: ListView.view.width
        height: 30
        text: model.edit
        Keys.onReturnPressed: model.edit = text
    }
}

詳細については、C++モデルをQt Quick ビューで使用するを参照してください。

トランジションの使用

トランジションは、ポジショナーに追加されるアイテム、ポジショナー内で移動するアイテム、ポジショナーから削除されるアイテムをアニメーション化するために使用できます。

アイテムを追加するトランジションは、ポジショナーの一部として作成されたアイテムや、ポジショナーの子になるために再ペアレントされたアイテムに適用されます。

アイテムを削除するトランジションは、ポジショナー内のアイテムが削除される場合と、ポジショナーから削除されドキュメント内の新しい親になる場合に適用されます。