Cómo abrir y cerrar una pantalla

Propósito. En CrossFly no hay “rutas”: toda pantalla es una Window y la navegación es una pila. Abrir una pantalla es show() (push); volver es hide() (pop). La UI de la pantalla debe montarse en onShow().

APIs usadas

• Window.show() — apila la ventana en el EventsProcessor y llama a onShow() (push). Si se llama fuera del paint thread, agenda y espera.
• Window.hide() — desapila la ventana y llama a onRemove() (pop). Dispara la transición inversa, si la hay.
• Window.onShow() — gancho de ciclo de vida llamado por el framework al apilar; monta la UI aquí. Siempre llama a super.onShow() primero (recalcula bounds y llama a onAdd(true)).
• EventsProcessor.topWindow() — retorna la ventana en la cima de la pila (la que recibe eventos).

Ejemplo completo (copiar, pegar y ejecutar)

package com.exemplo;

import dev.crossfly.ui.*;
import dev.crossfly.ui.layout.*;

/** Pantalla principal ejecutable. Apunta el launcher (classname) y corre: gradlew :lwjgl3:run */
public class MainWindow extends Window
{
   @Override
   public void onShow() throws Exception
   {
      super.onShow();
      setLayout(new VerticalLayout());

      add(new Label("Tela inicial"));
      add(new Button("Abrir detalhe").onAction(e -> new OutraTela().show()));  // push
   }
}

/** Pantalla apilada; el botón "Volver" hace pop (hide) y regresa a MainWindow. */
class OutraTela extends Window
{
   @Override
   public void onShow() throws Exception
   {
      super.onShow();            // OBLIGATORIO: recalcula bounds y dispara onAdd()
      setLayout(new VerticalLayout());

      add(new Label("Detalhe do pedido"));
      add(new Button("Voltar").onAction(e -> hide()));  // pop: vuelve a la pantalla anterior
   }
}

El fragmento de abajo muestra solo el núcleo. Para ejecutarlo, colócalo en el esqueleto MainWindow de arriba.

Fragmento mínimo

// verificado en la fuente: Window.show()/hide()/onShow(); super.onShow() hace updateBounds()+onAdd(true)
public class MinhaTela extends Window
{
   @Override
   public void onShow() throws Exception
   {
      super.onShow();            // OBLIGATORIO: recalcula bounds y dispara onAdd()
      setLayout(new GridLayout());

      add(new Label("Detalhe do pedido"));
      add(new Button("Voltar").onAction(e -> hide()));  // pop: vuelve a la pantalla anterior
   }
}

// En cualquier lugar (ej.: en el onAction de un botón de la pantalla anterior):
new MinhaTela().show();          // push: apila y muestra

Reglas que evitan bugs:

• Nunca montes la UI en el constructor de forma que dependa del tamaño de pantalla — Screen.width/height solo está estabilizado cuando onShow() se ejecuta. Usa onShow().
• hide() cierra la propia ventana. Para cerrar la ventana de la cima desde fuera, usa EventsProcessor.topWindow().hide().
• show() es seguro fuera del paint thread: reencamina al thread de pintura y espera.

Profundiza

• Navegar entre pantallas · La pila de ventanas
• Receta hermana: Recibir resultado de una pantalla