विंडो स्टैक

मॉडल को समझना अधिकांश नेविगेशन बग से बचाता है।

मॉडल (LIFO)

EventsProcessor Window का एक स्टैक बनाए रखता है। शीर्ष विंडो वह है जो इवेंट प्राप्त करती है और ऊपर पेंट की जाती है। नीचे वाली जीवित रहती हैं (नष्ट नहीं होतीं), केवल ढकी रहती हैं।

┌─────────────┐  ← topo: recebe toque/teclado, é pintada
│ TelaDetalhe │
├─────────────┤
│ TelaLista   │  ← coberta, viva
├─────────────┤
│ TelaHome    │  ← base
└─────────────┘

• show() → push: EventsProcessor में पंजीकृत करता है, onShow() को कॉल करता है।
• hide() → pop: पंजीकरण हटाता है, onRemove() को कॉल करता है; नीचे की विंडो शीर्ष पर लौट आती है।

प्रति विंडो जीवनचक्र

Fullscreen बनाम popup

समान Window क्लास तल स्क्रीन या popup हो सकती है — यह WindowStyle पर निर्भर करता है (widthRatio/heightRatio < 1 ⇒ popup; डायलॉग और मोडल देखें)। Popup पिछली स्क्रीन के ऊपर रहते हैं (जो पीछे दिखाई देती रहती है)।

Back बटन (Android) और बाहर टैप करना

• भौतिक Back बटन एप्लिकेशन द्वारा कैप्चर किया जाता है और डिफ़ॉल्ट रूप से शीर्ष विंडो का hide() करता है।
• canHide = true वाले popup में, बाहर टैप करना popup को बंद करता है।
• बाहर निकलने को रोकने के लिए (उदा.: छोड़ने की पुष्टि), hide() होने देने से पहले इरादे को संभालें।

पूर्ण उदाहरण (कॉपी करें, पेस्ट करें और चलाएँ)

स्टैक में push/pop और स्टैक की गई स्क्रीन के WindowStyle में कॉन्फ़िगर किए गए एक प्रवेश ट्रांज़िशन को प्रदर्शित करता है।

package com.exemplo;

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

/** चलाने योग्य मुख्य स्क्रीन। launcher (classname) की ओर संकेत करें और चलाएँ: gradlew :lwjgl3:run */
public class MainWindow extends Window
{
   @Override
   public void onShow() throws Exception
   {
      super.onShow();
      setLayout(new VerticalLayout());

      add(LAY_AUTO, new Label("Base da pilha (MainWindow)"));

      Button empilhar = new Button("Empilhar tela (push)");
      empilhar.onAction(c -> new TelaEmpilhada().show());   // push: स्टैक के शीर्ष पर आता है
      add(LAY_AUTO, empilhar);
   }
}

/** स्क्रीन जो ट्रांज़िशन के साथ शीर्ष पर आती है और hide() से लौटती है (pop)। */
class TelaEmpilhada extends Window
{
   @Override
   public void onShow() throws Exception
   {
      super.onShow();
      // इस विंडो का प्रवेश/निकास ट्रांज़िशन (नीचे वाली पीछे जीवित रहती है)
      getStyle().transition(UIConstants.Transition.SLIDE_LEFT);
      setLayout(new VerticalLayout());

      add(LAY_AUTO, new Label("Topo da pilha — a tela de baixo continua viva"));

      Button voltar = new Button("Voltar (pop)");
      voltar.onAction(c -> hide());   // pop: स्टैक से निकलता है, नीचे वाली शीर्ष पर लौटती है
      add(LAY_AUTO, voltar);
   }
}

नीचे दिए गए अंश केवल मूल भाग दिखाते हैं (जो onShow() के अंदर जाता है)। चलाने के लिए, उन्हें ऊपर दिए गए MainWindow ढाँचे में रखें।

ट्रांज़िशन

प्रवेश/निकास एनिमेशन WindowStyle.transition (UIConstants.Transition) से आता है: NONE (डिफ़ॉल्ट), FADE, SLIDE_LEFT/RIGHT/UP/DOWN, SCALE, SCALE_DOWN। Pickers डिफ़ॉल्ट रूप से FADE का उपयोग करते हैं।

getStyle().transition = UIConstants.Transition.SLIDE_LEFT;   // खुलने पर स्लाइड करता है

अच्छी प्रथाएँ

• नीचे की विंडो के संदर्भ आवश्यकता से अधिक न पकड़ें — hide() पर उन्हें एकत्रित होने दें।
• हर show() का एक संगत hide() होना चाहिए (बिना वापसी के स्क्रीनों को ढेर करने से बचें)।

सामान्य त्रुटियाँ

• स्थिति को संरक्षित किए बिना onReposition() में UI का पुनर्निर्माण करना (स्क्रॉल, चयन)।
• यह मान लेना कि दूसरी खोलने पर नीचे की विंडो नष्ट हो गई — वह जीवित रहती है।

यह भी देखें

• स्क्रीनों के बीच नेविगेट करें · डायलॉग और मोडल