Picker (आधार वर्ग)

Picker CrossFly की सभी चयन विंडो (तारीख, समय, फ़ाइल, फ़ोटो, रंग, बारकोड, निर्देशांक) का साझा आधार है। हर picker खुलता है, उपयोगकर्ता को इंटरैक्ट करने देता है और, पुष्टि करने पर, स्वयं बंद हो जाता है और परिणाम को असिंक्रोनस रूप से, callback के माध्यम से, उस कोड को सौंप देता है जिसने उसे खोला था।

इस पृष्ठ के पैटर्न को समझना सभी pickers को एक साथ समझना है।

🟡 · पैकेज: dev.crossfly.ui.picker · विस्तार करता है: Window · ट्रांज़िशन: डिफ़ॉल्ट रूप से FADE

केंद्रीय पैटर्न: getAnswer() + show(onAnswer)

• Picker.getAnswer() चयनित मान उत्पन्न करता है (प्रत्येक उपवर्ग ठोस प्रकार लौटाने के लिए इसे ओवरराइड करता है: String, Integer, LatLon…)। आधार में, यह null लौटाता है।
• Window.show(RunnableWith<Object> onAnswer) इस मान का उपभोग तब करता है जब विंडो बंद होती है।

दोनों के बीच की कड़ी Window.hide() में है:

public void hide() {
   ...
   Object answer = this instanceof Picker ? ((Picker) this).getAnswer() : null;
   if (onAnswer != null && answer != null)
      onAnswer.run(answer);
   ...
}

व्यावहारिक परिणाम (सभी कोड में पुष्ट):

• onAnswer callback केवल hide() में और केवल तभी ट्रिगर होता है जब getAnswer() != null। रद्द करने पर, उपवर्ग getAnswer() को null लौटाने के लिए बनाते हैं — तो onAnswer नहीं कहा जाता। जिसे रद्दीकरण पर प्रतिक्रिया देनी हो, उसे onHide()/onRemove() ओवरराइड करना चाहिए या उपवर्ग का विशिष्ट callback उपयोग करना चाहिए।
• show(onAnswer) थ्रेड-सुरक्षित है: यदि paint thread के बाहर कहा जाए, तो इसे पुनर्निर्धारित किया जाता है और पूरा होने तक ब्लॉक करता है।
• सौंपा गया मान Object है; उपभोक्ता picker के ठोस प्रकार में cast करता है।

यह Alert/ActionSheet से भिन्न है, जो Window का विस्तार करते हैं पर Picker का नहीं — उनमें show(onAnswer) ट्रिगर नहीं होता और उत्तर बटन callbacks से आता है।

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

package com.exemplo;

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

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

      Button abrir = new Button("Abrir picker");
      abrir.onAction(c ->
      {
         // Picker का कोई भी subclass वही show(onAnswer) पैटर्न अपनाता है
         DatePicker dp = new DatePicker();
         dp.show(answer ->
         {
            // 'answer' वह Object है जो getAnswer() लौटाता है; यहाँ तभी पहुँचता है जब != null
            String data = (String) answer;
            Hint.show("Selecionado: " + data, 2000);
         });
      });
      add(LAY_AUTO, abrir);
   }
}

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

बुनियादी उपयोग (किसी भी picker का सामान्य रूप)

DatePicker dp = new DatePicker();
dp.show(answer ->
{
   // 'answer' वह Object है जो getAnswer() लौटाता है; यहाँ तभी पहुँचता है जब != null
   String data = (String) answer;
   Debug.log("Selecionado: " + data);
});

सार्वजनिक विधियाँ

उपवर्ग द्वारा लौटाए गए प्रकार

अच्छे अभ्यास

• हमेशा ऊपर दी तालिका के ठोस प्रकार में Object का cast करें।
• रद्दीकरण पर प्रतिक्रिया देने के लिए, onAnswer पर भरोसा न करें — विशिष्ट callback (onSelect/onCapture) उपयोग करें या onHide() ओवरराइड करें।
• हार्डवेयर pickers (PhotoPicker, BarcodePicker, LocationPicker) बंद होने पर संसाधन मुक्त करते हैं; hide() के बाद उसी इंस्टेंस का पुनः उपयोग न करें।

सामान्य गलतियाँ

• रद्दीकरण पर onAnswer की अपेक्षा करना — यह ट्रिगर नहीं होता, क्योंकि getAnswer() null लौटाता है।
• cast भूलना — callback को Object मिलता है।

यह भी देखें

• क्षेत्र गाइड: ui/ · रेसिपी: cookbook/
• उपवर्ग: DatePicker · TimePicker · FilePicker · PhotoPicker · ColorPicker · BarcodePicker · LocationPicker