blockly > IFocusableTree > getRestoredFocusableNode

Método IFocusableTree.getRestoredFocusableNode()

Retorna o IFocusableNode dessa árvore que vai receber o foco ativo quando o foco for retornado para ela.

Há algumas observações muito importantes sobre o ciclo de vida de foco de uma árvore ao implementar uma versão desse método que não retorna null: 1. Um previousNode nulo não garante o estado de foco pela primeira vez, porque os nós podem ser excluídos. 2. Esse método só é usado quando a árvore está em foco, seja pela navegação de guias ou pelo método FocusManager.focusTree(). Em muitos casos, o nó focado anteriormente é focado diretamente, o que ignora esse método. 3. O comportamento padrão (ou seja, retornar nulo aqui) envolve restaurar o nó anterior (previousNode) ou focar a raiz da árvore. 4. Às vezes, o nó fornecido pode não ser mais válido, como no caso de uma tentativa de focar um nó que foi removido recentemente da árvore pai. As implementações podem verificar a validade do nó para especializar o nó para o qual o foco deve ser redirecionado.

Esse método tem como objetivo principal fornecer às implementações de árvore um meio de especificar um nó padrão melhor do que a raiz.

Signature:

getRestoredFocusableNode(previousNode: IFocusableNode | null): IFocusableNode | null;

Parâmetros

Parâmetro Tipo Descrição
previousNode IFocusableNode | null O nó que tinha o foco passivo para essa árvore ou nulo se a árvore ainda não foi focada.

Retorna:

IFocusableNode | null

O IFocusableNode que agora vai receber o foco ou nulo se o comportamento padrão for usado.