blockly > IFocusableTree > getRestoredFocusableNode
IFocusableTree.getRestoredFocusableNode() 方法
傳回此樹狀結構的 IFocusableNode,當樹狀結構本身獲得焦點時,應接收有效焦點。
實作不會傳回空值的此方法版本時,請務必留意樹狀結構的焦點生命週期:1. 由於節點可刪除,因此 previousNode 為空值並不能保證首次聚焦狀態。2. 只有在透過分頁導覽或 FocusManager.focusTree() 將焦點放在樹狀結構本身時,才會使用這個方法。在許多情況下,系統會直接將焦點放在先前已聚焦的節點,而略過這個方法。3. 預設行為 (即在此處傳回空值) 包括還原先前的節點 (previousNode),或將焦點設為樹狀結構的根節點。4. 提供的節點有時可能不再有效,例如嘗試將焦點放在最近從父樹狀結構移除的節點時。實作項目可以檢查節點的有效性,以便將焦點指定為應備援的節點。
這個方法主要用於提供樹狀結構實作項目,以便指定比根目錄更佳的預設節點。
Signature:
getRestoredFocusableNode(previousNode: IFocusableNode | null): IFocusableNode | null;
參數
參數 | 類型 | 說明 |
---|---|---|
previousNode | IFocusableNode | null | 先前為此樹狀結構保留被動焦點的節點,如果樹狀結構尚未聚焦,則為空值。 |
退貨:
IFocusableNode | null
應現在接收焦點的 IFocusableNode,如果應使用預設行為,則為空值。