UI\Control::getTopLevel()函数—用法及示例

函数名：UI\Control::getTopLevel()

适用版本：PHP 7.4.0 及以上

用法：

UI\Control::getTopLevel() 函数用于获取当前控件所属的顶级控件。

语法：

public function UI\Control::getTopLevel(): ?UI\Control

参数： 该函数没有参数。

返回值：

• 如果当前控件是顶级控件，则返回当前控件本身；
• 如果当前控件是子控件，则返回当前控件所属的顶级控件；
• 如果当前控件没有父控件，则返回 null。

示例：

// 创建一个顶级窗口
$window = new UI\Window("My Window", 800, 600);

// 创建一个按钮作为子控件添加到窗口中
$button = new UI\Button("Click me");
$window->add($button);

// 获取按钮所属的顶级控件
$topLevel = $button->getTopLevel();

// 输出顶级控件的标题
echo "Top level control: " . $topLevel->getTitle(); // 输出 "My Window"

在上面的示例中，我们创建了一个名为 "My Window" 的顶级窗口，并在窗口中添加了一个按钮。然后，通过调用按钮的 getTopLevel() 方法，我们获取了按钮所属的顶级控件，即窗口。最后，我们输出了顶级控件的标题，即 "My Window"。

请注意，UI\Control::getTopLevel() 函数在 PHP 7.4.0 及以上版本中可用。