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 及以上版本中可用。