presentationControllerのメソッドやパラメータの説明

Question

presentationControllerのメソッドに、コメントでメソッドやパラメータの説明をつけたいのですが、ドキュメンテーションの説明を直訳してもいまいちよくわかりません。メソッドは以下のとおりです。

optional func presentationController(forPresented presented: UIViewController, presenting: UIViewController?, source: UIViewController) -> UIPresentationController?

optional func presentationController(forPresented presented: UIViewController, presenting: UIViewController?, source: UIViewController) -> UIPresentationController?

私の理解でのコメントを貼っておきます。

    /// ビュー階層を管理するために使用するカスタムプレゼンテーションコントローラの受け渡し
    ///
    /// - Parameters:
    ///   - presented: 遷移前ViewController
    ///   - presenting: 遷移後ViewController
    ///   - sourse: このメソッドを呼んだViewController
    ///
    func presentationController(forPresented presented: UIViewController, presenting: UIViewController?, source: UIViewController) -> UIPresentationController?

ご理解ある方、ご説明いただけると助かります。

Answer 1

Apple のドキュメント では、このメソッドの説明は以下のとおりです。

Asks your delegate for the custom presentation controller to use for managing the view hierarchy when presenting a view controller.

ビューコントローラを提示するときにビュー階層を管理するために使用するカスタムプレゼンテーションコントローラを代理人に依頼します。(Google 翻訳より)

ただし、この説明は呼び出す側から見たものになってます。ドキュメントを書くのは実装する側 (呼び出される側) なので、このメソッドの一般的な説明としては、「ビューコントローラを提示するときにビュー階層を管理するために使用するカスタムプレゼンテーションコントローラを返す」ですね。

その上で、できれば具体的に、このメソッドがプレゼンテーションコントローラをどのようにカスタマイズして、どのように使われることを想定しているかを書くのが親切だと思います。

例えば、こちらの記事 【Swift】PresentationControllerでモーダルを表示したい - Qiita ではモーダル表示のために使ってるので、「ビューコントローラをモーダル表示するために PresentationController (← 実際のクラス名) のインスタンスを返す」でしょうか。