UI\Controls\MultilineEntry::onChange()函式—用法及示例

函式名稱：UI\Controls\MultilineEntry::onChange()

適用版本：PHP 7.4 及以上版本

函式說明：該函式用於設定或獲取多行文字輸入框（MultilineEntry）的變化事件（onChange）的處理函式。當使用者在多行文字輸入框中輸入或編輯文字時，觸發該事件，可以使用該函式指定一個回撥函式來處理該事件。

用法示例：

1. 設定onChange處理函式：

$multilineEntry = new UI\Controls\MultilineEntry();
$multilineEntry->onChange(function ($text) {
    // 在這裡處理文字變化事件
    echo "文字已變化：" . $text;
});

// 或者使用可呼叫物件作為處理函式
class MyEventHandler {
    public function handleOnChange($text) {
        echo "文字已變化：" . $text;
    }
}
$eventHandler = new MyEventHandler();
$multilineEntry->onChange([$eventHandler, 'handleOnChange']);

2. 獲取當前設定的onChange處理函式：

$multilineEntry = new UI\Controls\MultilineEntry();
$onChangeHandler = $multilineEntry->onChange();

if ($onChangeHandler !== null) {
    echo "當前onChange處理函式：" . get_class($onChangeHandler[0]) . "::" . $onChangeHandler[1];
} else {
    echo "沒有設定onChange處理函式";
}

注意事項：

• 在設定onChange處理函式時，可以使用匿名函式或者可呼叫物件作為回撥函式。
• 回撥函式的引數是使用者輸入或編輯後的文字內容。
• 如果沒有設定onChange處理函式，呼叫$multilineEntry->onChange()將返回null。