चीट शीट

सबसे अक्सर लिए जाने वाले निर्णय, संघनित रूप में। सभी अंश API 2026 के विरुद्ध कंपाइल होते हैं।

लेआउट — add() का हस्ताक्षर

// VerticalLayout / HorizontalLayout — पहले आकार, फिर कंपोनेंट
add(LAY_FILL, comp);   // -1f → शेष स्थान भरता है ("इलास्टिक")
add(LAY_AUTO, comp);   //  0f → सामग्री का प्राकृतिक आकार
add(0.2f, comp);       // >0  → कंटेनर के कुल आयाम का 20%

// GridLayout — सभी चौड़ाइयाँ, फिर सभी कंपोनेंट
add(0.35f, 0.65f, new Label("Nome"), new TextField(""));

// EvenlySpacedLayout — केवल कंपोनेंट (समान रूप से बाँटता है; आकार नहीं देता)
add(icone1); add(icone2);

// RelativeLayout — एंकर (नीचे मैट्रिक्स देखें)
add(comp, RelPos.AFTER, RelPos.CENTER_OF, RelSize.AUTOSIZE, RelSize.AUTOSIZE, refComp);

प्रति लेआउट विवरण: ui/layouts/।

RelativeLayout — मैट्रिक्स

add(alvo, RelPos x, RelPos y, RelSize larg, RelSize alt [, Component ref] [, Gap outgap]);

Relative — रिस्पॉन्सिव आयाम

Relative.ofFont(1.5f);                     // 1.5 × फ़ॉन्ट की ऊँचाई (UI के साथ स्केल करता है)
Relative.ofScreen(0.8f);                   // स्क्रीन का 80%
Relative.ofScreen(0.5f, ScreenSize.MIN);   // छोटी भुजा का 50% (portrait/landscape के अनुसार ढलता है)
Relative.ofPixels(24f);                    // स्थिर पिक्सेल (अपवाद के तौर पर उपयोग करें)

रंग — ARGB 0xAARRGGBB

int opaco     = 0xFF2196F3;                       // alpha FF = पूरी तरह दृश्यमान
int invisivel = 0x002196F3;                       // ⚠️ alpha 00 → दिखाई नहीं देता
int meio      = ColorUtils.withAlpha(0xFF2196F3, 128);  // 50% पारदर्शी
int escuro    = ColorUtils.darker(0xFF2196F3, 0.2f);
int claro     = ColorUtils.lighter(0xFF2196F3, 0.2f);
int mistura   = ColorUtils.lerpColor(corA, corB, 0.5f);

अल्फ़ा का जाल: अल्फ़ा बाइट के बिना एक int (0xRRGGBB) का अल्फ़ा 0 होता है → कंपोनेंट अदृश्य हो जाता है। अपारदर्शी के लिए हमेशा 0xFF... शामिल करें।

थ्रेडिंग — वापस लौटना/चलाना

Component.onUI(() -> { ... });               // paint thread पर लौटता है (किसी भी thread से)
Main.runOnPaintThread(() -> { ... });         // वही, किसी Component के बाहर
Main.runOnPaintThreadAndWait(() -> { ... });  // वही, समाप्त होने तक ब्लॉक करते हुए
comp.onActionThread(c -> { ... });            // बैकग्राउंड thread पर किसी इवेंट पर प्रतिक्रिया देता है
Component.repaint();                          // एक नया frame माँगता है (माँग पर render)

क्यों: पेंट थ्रेड।

यह भी देखें

• Enums और UIConstants · लेआउट · रंग (अध्याय 11)