chrome.app.window

ब्यौरा

विंडो बनाने के लिए, chrome.app.window एपीआई का इस्तेमाल करें. विंडो में टाइटल बार और साइज़ कंट्रोल के साथ एक वैकल्पिक फ़्रेम होता है. ये Chrome ब्राउज़र की किसी भी विंडो से नहीं जुड़े होते हैं. इन विकल्पों के बारे में जानने के लिए, विंडो स्टेट सैंपल देखें.

टाइप

AppWindow

प्रॉपर्टी

  • contentWindow

    विंडो

    बनाए गए चाइल्ड के लिए JavaScript 'विंडो' ऑब्जेक्ट.

  • आईडी

    स्ट्रिंग

    वह आईडी जिससे विंडो बनाई गई थी.

  • innerBounds

    Bounds

    विंडो के कॉन्टेंट की पोज़िशन, साइज़, और पाबंदियां. इसमें विंडो की सजावट शामिल नहीं है. यह प्रॉपर्टी, Chrome 36 में नई है.

  • outerBounds

    Bounds

    विंडो की पोज़िशन, साइज़, और पाबंदियां. इनमें विंडो की सजावट शामिल है, जैसे कि टाइटल बार और फ़्रेम. यह प्रॉपर्टी, Chrome 36 में नई है.

  • clearAttention

    void

    विंडो पर ध्यान दें.

    clearAttention फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • बंद करें

    void

    विंडो बंद करें.

    close फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • drawAttention

    void

    विंडो पर ध्यान खींचें.

    drawAttention फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • फ़ोकस

    void

    विंडो पर फ़ोकस करें.

    focus फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • फ़ुलस्क्रीन

    void

    विंडो को फ़ुलस्क्रीन मोड में खोलता है.

    उपयोगकर्ता, ESC दबाकर विंडो को पहले जैसा कर सकता है. कोई ऐप्लिकेशन, ESC बटन दबाने पर फ़ुलस्क्रीन मोड से बाहर निकलने से रोक सकता है. इसके लिए, उसे app.window.fullscreen.overrideEsc की अनुमति का अनुरोध करना होगा. साथ ही, keydown और keyup हैंडलर में .preventDefault() को कॉल करके इवेंट को रद्द करना होगा. जैसे:

    window.onkeydown = window.onkeyup = function(e) { if (e.keyCode == 27 /* ESC *\/) { e.preventDefault(); } };

    window.fullscreen() नोट से पूरी विंडो फ़ुलस्क्रीन हो जाएगी. इसके लिए, उपयोगकर्ता के जेस्चर की ज़रूरत नहीं होती. फ़ुलस्क्रीन मोड में जाने के लिए, HTML5 फ़ुलस्क्रीन एपीआई का भी इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, वेब एपीआई देखें.

    fullscreen फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • getBounds

    void

    अब काम नहीं करता

    innerBounds या outerBounds का इस्तेमाल करें.

    विंडो के अंदरूनी हिस्से को ContentBounds ऑब्जेक्ट के तौर पर पाएं.

    getBounds फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • छिपाएं

    void

    विंडो को छिपाएं. अगर विंडो पहले से छिपी हुई है, तो कुछ नहीं होता.

    hide फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • isAlwaysOnTop

    void

    क्या विंडो हमेशा सबसे ऊपर दिखती है?

    isAlwaysOnTop फ़ंक्शन इस तरह दिखता है: 

    () => {...}

    • returns

      बूलियन

  • isFullscreen

    void

    क्या विंडो फ़ुलस्क्रीन मोड में है? अगर विंडो को फ़ुलस्क्रीन बनाया गया है या AppWindow या HTML5 फ़ुलस्क्रीन एपीआई की मदद से फ़ुलस्क्रीन बनाया गया है, तो यह सही होगा.

    isFullscreen फ़ंक्शन इस तरह दिखता है: 

    () => {...}

    • returns

      बूलियन

  • isMaximized

    void

    क्या विंडो को बड़ा किया गया है?

    isMaximized फ़ंक्शन इस तरह दिखता है: 

    () => {...}

    • returns

      बूलियन

  • isMinimized

    void

    क्या विंडो को छोटा किया गया है?

    isMinimized फ़ंक्शन इस तरह दिखता है: 

    () => {...}

    • returns

      बूलियन

  • बड़ा करें

    void

    विंडो को बड़ा करें.

    maximize फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • छोटा करना

    void

    विंडो को छोटा करें.

    minimize फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • moveTo

    void

    Chrome 43 के बाद से इस्तेमाल नहीं किया जा रहा है

    outerBounds का इस्तेमाल करें.

    विंडो को (left, top) पोज़िशन पर ले जाएं.

    moveTo फ़ंक्शन इस तरह दिखता है: 

    (left: number, top: number) => {...}

    • बाएं

      संख्या

    • ऊपर

      संख्या

  • resizeTo

    void

    Chrome 43 के बाद से इस्तेमाल नहीं किया जा रहा है

    outerBounds का इस्तेमाल करें.

    विंडो का साइज़ बदलकर widthxheight पिक्सल करें.

    resizeTo फ़ंक्शन इस तरह दिखता है: 

    (width: number, height: number) => {...}

    • चौड़ाई

      संख्या

    • ऊंचाई

      संख्या

  • पहले जैसा करें

    void

    विंडो को पहले जैसा करें. इससे विंडो, फ़ुलस्क्रीन, मिनिमाइज़ या मैक्सिमाइज़ मोड से बाहर आ जाएगी.

    restore फ़ंक्शन इस तरह दिखता है: 

    () => {...}

  • setAlwaysOnTop

    void

    यह सेट करें कि विंडो, ज़्यादातर अन्य विंडो के ऊपर दिखनी चाहिए या नहीं. इसके लिए, alwaysOnTopWindows की अनुमति ज़रूरी है.

    setAlwaysOnTop फ़ंक्शन इस तरह दिखता है: 

    (alwaysOnTop: boolean) => {...}

    • alwaysOnTop

      बूलियन

  • setBounds

    void

    अब काम नहीं करता

    innerBounds या outerBounds का इस्तेमाल करें.

    विंडो के अंदरूनी बाउंड सेट करें.

    setBounds फ़ंक्शन इस तरह दिखता है: 

    (bounds: ContentBounds) => {...}

  • setVisibleOnAllWorkspaces

    void

    यह सेट करें कि विंडो सभी वर्कस्पेस पर दिखे या नहीं. (सिर्फ़ उन प्लैटफ़ॉर्म के लिए जो इस सुविधा के साथ काम करते हैं).

    setVisibleOnAllWorkspaces फ़ंक्शन इस तरह दिखता है: 

    (alwaysVisible: boolean) => {...}

    • alwaysVisible

      बूलियन

  • दिखाएं

    void

    विंडो दिखाएं. अगर विंडो पहले से दिख रही है, तो कुछ नहीं होता. अगर focused को 'सही है' पर सेट किया गया है या इसे शामिल नहीं किया गया है, तो विंडो पर फ़ोकस करें.

    show फ़ंक्शन इस तरह दिखता है: 

    (focused?: boolean) => {...}

    • फ़ोकस किया गया

      बूलियन ज़रूरी नहीं

Bounds

प्रॉपर्टी

  • ऊंचाई

    संख्या

    इस प्रॉपर्टी का इस्तेमाल, कॉन्टेंट या विंडो की मौजूदा ऊंचाई को पढ़ने या लिखने के लिए किया जा सकता है.

  • बाएं

    संख्या

    इस प्रॉपर्टी का इस्तेमाल, कॉन्टेंट या विंडो के मौजूदा X कोऑर्डिनेट को पढ़ने या लिखने के लिए किया जा सकता है.

  • maxHeight

    number ज़रूरी नहीं

    इस प्रॉपर्टी का इस्तेमाल, कॉन्टेंट या विंडो की मौजूदा ज़्यादा से ज़्यादा ऊंचाई को पढ़ने या लिखने के लिए किया जा सकता है. null वैल्यू का मतलब है कि 'जानकारी नहीं दी गई है'.

  • maxWidth

    number ज़रूरी नहीं

    इस प्रॉपर्टी का इस्तेमाल, कॉन्टेंट या विंडो की मौजूदा ज़्यादा से ज़्यादा चौड़ाई को पढ़ने या लिखने के लिए किया जा सकता है. null वैल्यू का मतलब है कि 'जानकारी नहीं दी गई है'.

  • minHeight

    number ज़रूरी नहीं

    इस प्रॉपर्टी का इस्तेमाल, कॉन्टेंट या विंडो की मौजूदा कम से कम ऊंचाई को पढ़ने या लिखने के लिए किया जा सकता है. null वैल्यू का मतलब है कि 'जानकारी नहीं दी गई है'.

  • minWidth

    number ज़रूरी नहीं

    इस प्रॉपर्टी का इस्तेमाल, कॉन्टेंट या विंडो की मौजूदा कम से कम चौड़ाई को पढ़ने या लिखने के लिए किया जा सकता है. null वैल्यू का मतलब है कि 'जानकारी नहीं दी गई है'.

  • ऊपर

    संख्या

    इस प्रॉपर्टी का इस्तेमाल, कॉन्टेंट या विंडो के मौजूदा Y कोऑर्डिनेट को पढ़ने या लिखने के लिए किया जा सकता है.

  • चौड़ाई

    संख्या

    इस प्रॉपर्टी का इस्तेमाल, कॉन्टेंट या विंडो की मौजूदा चौड़ाई को पढ़ने या लिखने के लिए किया जा सकता है.

  • setMaximumSize

    void

    कॉन्टेंट या विंडो के साइज़ की ज़्यादा से ज़्यादा सीमा सेट करें. पाबंदी हटाने के लिए, ज़्यादा से ज़्यादा चौड़ाई या ऊंचाई को null पर सेट किया जा सकता है. undefined की वैल्यू से, कंस्ट्रेंट में कोई बदलाव नहीं होगा.

    setMaximumSize फ़ंक्शन इस तरह दिखता है: 

    (maxWidth: number, maxHeight: number) => {...}

    • maxWidth

      संख्या

    • maxHeight

      संख्या

  • setMinimumSize

    void

    कॉन्टेंट या विंडो के लिए, कम से कम साइज़ की सीमाएं सेट करें. कम से कम चौड़ाई या ऊंचाई को null पर सेट करके, पाबंदी को हटाया जा सकता है. undefined की वैल्यू से, कंस्ट्रेंट में कोई बदलाव नहीं होगा.

    setMinimumSize फ़ंक्शन इस तरह दिखता है: 

    (minWidth: number, minHeight: number) => {...}

    • minWidth

      संख्या

    • minHeight

      संख्या

  • setPosition

    void

    कॉन्टेंट या विंडो की बाईं और सबसे ऊपर की पोज़िशन सेट करें.

    setPosition फ़ंक्शन इस तरह दिखता है: 

    (left: number, top: number) => {...}

    • बाएं

      संख्या

    • ऊपर

      संख्या

  • setSize

    void

    कॉन्टेंट या विंडो की चौड़ाई और ऊंचाई सेट करें.

    setSize फ़ंक्शन इस तरह दिखता है: 

    (width: number, height: number) => {...}

    • चौड़ाई

      संख्या

    • ऊंचाई

      संख्या

BoundsSpecification

प्रॉपर्टी

  • ऊंचाई

    number ज़रूरी नहीं

    कॉन्टेंट या विंडो की ऊंचाई.

  • बाएं

    number ज़रूरी नहीं

    कॉन्टेंट या विंडो का X कोऑर्डिनेट.

  • maxHeight

    number ज़रूरी नहीं

    कॉन्टेंट या विंडो की ज़्यादा से ज़्यादा ऊंचाई.

  • maxWidth

    number ज़रूरी नहीं

    कॉन्टेंट या विंडो की ज़्यादा से ज़्यादा चौड़ाई.

  • minHeight

    number ज़रूरी नहीं

    कॉन्टेंट या विंडो की कम से कम ऊंचाई.

  • minWidth

    number ज़रूरी नहीं

    कॉन्टेंट या विंडो की कम से कम चौड़ाई.

  • ऊपर

    number ज़रूरी नहीं

    कॉन्टेंट या विंडो का Y कोऑर्डिनेट.

  • चौड़ाई

    number ज़रूरी नहीं

    कॉन्टेंट या विंडो की चौड़ाई.

ContentBounds

प्रॉपर्टी

  • ऊंचाई

    number ज़रूरी नहीं

  • बाएं

    number ज़रूरी नहीं

  • ऊपर

    number ज़रूरी नहीं

  • चौड़ाई

    number ज़रूरी नहीं

CreateWindowOptions

प्रॉपर्टी

  • alwaysOnTop

    बूलियन ज़रूरी नहीं

    अगर सही है, तो विंडो ज़्यादातर अन्य विंडो के ऊपर रहेगी. अगर इस तरह की कई विंडो हैं, तो फ़िलहाल फ़ोकस की गई विंडो फ़ोरग्राउंड में होगी. इसके लिए, alwaysOnTopWindows की अनुमति ज़रूरी है. डिफ़ॉल्ट तौर पर, यह 'गलत' पर सेट होती है.

    प्रॉपर्टी बनाने के बाद, उसमें बदलाव करने के लिए विंडो पर setAlwaysOnTop() को कॉल करें.

  • बाउंड्री

    ContentBounds ज़रूरी नहीं है

    अब काम नहीं करता

    innerBounds या outerBounds का इस्तेमाल करें.

    विंडो में कॉन्टेंट का साइज़ और पोज़िशन (टाइटल बार को छोड़कर). अगर कोई आईडी भी दिया गया है और मेल खाने वाले आईडी वाली विंडो पहले दिखाई गई है, तो विंडो की याद रखी गई सीमाओं का इस्तेमाल किया जाएगा.

  • फ़ोकस किया गया

    बूलियन ज़रूरी नहीं

    अगर इसे 'सही है' पर सेट किया जाता है, तो विंडो बनने पर उस पर फ़ोकस किया जाएगा. डिफ़ॉल्ट रूप से, यह 'सही' पर सेट होता है.

  • फ़्रेम

    string | FrameOptions ज़रूरी नहीं

    फ़्रेम टाइप: none या chrome (डिफ़ॉल्ट रूप से chrome पर सेट होता है). none के लिए, -webkit-app-region सीएसएस प्रॉपर्टी का इस्तेमाल करके, ऐप्लिकेशन की विंडो को खींचने और छोड़ने लायक बनाया जा सकता है. -webkit-app-region: drag का इस्तेमाल करके, क्षेत्रों को खींचने और छोड़ने लायक बनाया जा सकता है. नेस्ट किए गए एलिमेंट पर इस स्टाइल को बंद करने के लिए, no-drag का इस्तेमाल किया जा सकता है.

    FrameOptions का इस्तेमाल, M36 में नया है.

  • छिपा हुआ है

    बूलियन ज़रूरी नहीं

    अगर सही है, तो विंडो छिपी हुई स्थिति में बनाई जाएगी. विंडो बन जाने के बाद, उसे दिखाने के लिए window पर show() को कॉल करें. डिफ़ॉल्ट तौर पर, यह 'गलत' पर सेट होती है.

  • आइकॉन

    string ज़रूरी नहीं

    Chrome 54+

    विंडो आइकॉन का यूआरएल. जब showInShelf को 'सही है' पर सेट किया जाता है, तो विंडो का अपना आइकॉन हो सकता है. यूआरएल, ग्लोबल या एक्सटेंशन लोकल यूआरएल होना चाहिए.

  • आईडी

    string ज़रूरी नहीं

    विंडो की पहचान करने के लिए आईडी. इसका इस्तेमाल, विंडो के साइज़ और पोज़िशन को याद रखने के लिए किया जाएगा. साथ ही, बाद में उसी आईडी वाली विंडो खोलने पर, उस ज्यामिति को वापस लाने के लिए किया जाएगा. अगर किसी आईडी वाली विंडो पहले से मौजूद है और उसी आईडी वाली एक और विंडो बनाई जाती है, तो नई विंडो बनाने के बजाय, पहले से खुली विंडो पर फ़ोकस किया जाएगा.

  • innerBounds

    BoundsSpecification ज़रूरी नहीं

    इसका इस्तेमाल, विंडो के कॉन्टेंट की शुरुआती पोज़िशन, शुरुआती साइज़, और पाबंदियों के बारे में बताने के लिए किया जाता है. इसमें विंडो की सजावट शामिल नहीं होती. अगर कोई id भी तय किया गया है और मैच होने वाले id वाली विंडो पहले दिखाई गई है, तो याद रखी गई सीमाओं का इस्तेमाल किया जाएगा.

    ध्यान दें कि इनर और आउटर बाउंड के बीच की पैडिंग, ओएस तय करता है. इसलिए, innerBounds और outerBounds, दोनों के लिए एक ही बाउंड प्रॉपर्टी सेट करने पर गड़बड़ी होगी.

    यह प्रॉपर्टी, Chrome 36 में नई है.

  • maxHeight

    number ज़रूरी नहीं

    अब काम नहीं करता

    innerBounds या outerBounds का इस्तेमाल करें.

    विंडो की ज़्यादा से ज़्यादा ऊंचाई.

  • maxWidth

    number ज़रूरी नहीं

    अब काम नहीं करता

    innerBounds या outerBounds का इस्तेमाल करें.

    विंडो की ज़्यादा से ज़्यादा चौड़ाई.

  • minHeight

    number ज़रूरी नहीं

    अब काम नहीं करता

    innerBounds या outerBounds का इस्तेमाल करें.

    विंडो की कम से कम ऊंचाई.

  • minWidth

    number ज़रूरी नहीं

    अब काम नहीं करता

    innerBounds या outerBounds का इस्तेमाल करें.

    विंडो की कम से कम चौड़ाई.

  • outerBounds

    BoundsSpecification ज़रूरी नहीं

    इसका इस्तेमाल, विंडो की शुरुआती पोज़िशन, शुरुआती साइज़, और सीमाओं को तय करने के लिए किया जाता है. इसमें विंडो की सजावट, जैसे कि टाइटल बार और फ़्रेम शामिल हैं. अगर कोई id भी तय किया गया है और मैच होने वाले id वाली विंडो पहले दिखाई गई है, तो याद रखी गई सीमाओं का इस्तेमाल किया जाएगा.

    ध्यान दें कि इनर और आउटर बाउंड के बीच की पैडिंग, ओएस तय करता है. इसलिए, innerBounds और outerBounds, दोनों के लिए एक ही बाउंड प्रॉपर्टी सेट करने पर गड़बड़ी होगी.

    यह प्रॉपर्टी, Chrome 36 में नई है.

  • साइज़ बदला जा सकता है

    बूलियन ज़रूरी नहीं

    अगर इसे 'सही है' पर सेट किया जाता है, तो उपयोगकर्ता विंडो का साइज़ बदल पाएगा. डिफ़ॉल्ट रूप से, यह 'सही' पर सेट होती है.

  • showInShelf

    बूलियन ज़रूरी नहीं

    Chrome 54+

    अगर इसे 'सही है' पर सेट किया जाता है, तो विंडो का अपना शेल्फ़ आइकॉन होगा. ऐसा न करने पर, विंडो को शेल्फ़ में उन अन्य विंडो के साथ ग्रुप किया जाएगा जो ऐप्लिकेशन से जुड़ी हैं. डिफ़ॉल्ट रूप से, यह वैल्यू false पर सेट होती है. अगर showInShelf को 'सही है' पर सेट किया गया है, तो आपको विंडो के लिए एक आईडी तय करना होगा.

  • सिंगलटन

    बूलियन ज़रूरी नहीं

    अब काम नहीं करता

    एक ही आईडी वाली कई विंडो का इस्तेमाल अब नहीं किया जा सकता.

    डिफ़ॉल्ट रूप से, अगर विंडो के लिए कोई आईडी तय किया जाता है, तो विंडो सिर्फ़ तब बनाई जाएगी, जब उसी आईडी वाली कोई दूसरी विंडो पहले से मौजूद न हो. अगर इस आईडी वाली विंडो पहले से मौजूद है, तो इसके बजाय वह विंडो चालू हो जाती है. अगर आपको एक ही आईडी वाली कई विंडो बनानी हैं, तो इस प्रॉपर्टी को 'गलत है' पर सेट करें.

  • राज्य

    राज्य ज़रूरी नहीं

    विंडो की शुरुआती स्थिति, जिससे इसे पहले से ही फ़ुलस्क्रीन, बड़ा या छोटा करके बनाया जा सकता है. डिफ़ॉल्ट रूप से, यह 'normal' पर सेट होता है.

  • टाइप

    WindowType ज़रूरी नहीं है

    Chrome 45 और इसके बाद के वर्शन Chrome 69 के बाद से, इस सुविधा का इस्तेमाल बंद कर दिया गया है

    सभी ऐप्लिकेशन विंडो, 'शेल' विंडो टाइप का इस्तेमाल करती हैं

    बनाई जाने वाली विंडो का टाइप.

  • visibleOnAllWorkspaces

    बूलियन ज़रूरी नहीं

    अगर वैल्यू 'सही' है और प्लैटफ़ॉर्म पर यह सुविधा काम करती है, तो विंडो सभी फ़ाइल फ़ोल्डर पर दिखेगी.

FrameOptions

प्रॉपर्टी

  • activeColor

    string ज़रूरी नहीं

    इससे विंडो के चालू होने पर, उसके फ़्रेम का रंग सेट किया जा सकता है. फ़्रेम को कलर करने की सुविधा सिर्फ़ तब उपलब्ध होती है, जब फ़्रेम का टाइप chrome हो.

    फ़्रेम को कलर करने की सुविधा सिर्फ़ तब उपलब्ध होती है, जब फ़्रेम का टाइप chrome हो.

    Chrome 36 में फ़्रेम को रंगने की सुविधा नई है.

  • रंग

    string ज़रूरी नहीं

    इससे फ़्रेम का रंग सेट किया जा सकता है. फ़्रेम को कलर करने की सुविधा सिर्फ़ तब उपलब्ध होती है, जब फ़्रेम का टाइप chrome हो.

    Chrome 36 में फ़्रेम को रंगने की सुविधा नई है.

  • inactiveColor

    string ज़रूरी नहीं

    इससे विंडो के इनऐक्टिव होने पर, उसके फ़्रेम के रंग को ऐक्टिव होने पर दिखने वाले रंग से अलग सेट किया जा सकता है. फ़्रेम को कलर करने की सुविधा सिर्फ़ तब उपलब्ध होती है, जब फ़्रेम का टाइप chrome हो.

    inactiveColor का इस्तेमाल, color के साथ किया जाना चाहिए.

    Chrome 36 में फ़्रेम को रंगने की सुविधा नई है.

  • टाइप

    string ज़रूरी नहीं

    फ़्रेम टाइप: none या chrome (डिफ़ॉल्ट रूप से chrome पर सेट होता है).

    none के लिए, -webkit-app-region सीएसएस प्रॉपर्टी का इस्तेमाल करके, ऐप्लिकेशन की विंडो को खींचने और छोड़ने लायक बनाया जा सकता है.

    -webkit-app-region: drag का इस्तेमाल करके, क्षेत्रों को खींचने और छोड़ने लायक बनाया जा सकता है. नेस्ट किए गए एलिमेंट पर इस स्टाइल को बंद करने के लिए, no-drag का इस्तेमाल किया जा सकता है.

State

विंडो की स्थिति: सामान्य, फ़ुलस्क्रीन, बड़ा किया गया, छोटा किया गया.

Enum

"normal"

"fullscreen"

"maximized"

"minimized"

WindowType

Chrome 45+

इससे पता चलता है कि किस तरह की विंडो बनानी है.

Enum

"shell"
डिफ़ॉल्ट विंडो टाइप.

"panel"
ओएस से मैनेज की जाने वाली विंडो (अब सेवा में नहीं है).

तरीके

canSetVisibleOnAllWorkspaces()

chrome.app.window.canSetVisibleOnAllWorkspaces(): boolean

मौजूदा प्लैटफ़ॉर्म पर, सभी वर्कस्पेस में विंडो दिखने की सुविधा काम करती है या नहीं.

रिटर्न

  • बूलियन

create()

वादा 
chrome.app.window.create(
  url: string,
  options?: CreateWindowOptions,
  callback?: function,
): Promise<AppWindow>

किसी विंडो के साइज़ और पोज़िशन को कई अलग-अलग तरीकों से तय किया जा सकता है. सबसे आसान विकल्प यह है कि कुछ भी न बताया जाए. ऐसे में, डिफ़ॉल्ट साइज़ और प्लैटफ़ॉर्म के हिसाब से पोज़िशन का इस्तेमाल किया जाएगा.

विंडो की पोज़िशन, साइज़, और पाबंदियां सेट करने के लिए, innerBounds या outerBounds प्रॉपर्टी का इस्तेमाल करें. इनर बाउंड में विंडो डेकोरेशन शामिल नहीं होते. बाहरी सीमाओं में विंडो का टाइटल बार और फ़्रेम शामिल होता है. ध्यान दें कि इनर और आउटर बाउंड के बीच की पैडिंग, ओएस तय करता है. इसलिए, इनर और आउटर बाउंड, दोनों के लिए एक ही प्रॉपर्टी सेट करने को गड़बड़ी माना जाता है. उदाहरण के लिए, innerBounds.left और outerBounds.left, दोनों को सेट करना.

विंडो की पोज़िशन अपने-आप याद रखने के लिए, उन्हें आईडी दिए जा सकते हैं. अगर किसी विंडो का आईडी है, तो इस आईडी का इस्तेमाल विंडो के साइज़ और पोज़िशन को याद रखने के लिए किया जाता है. ऐसा तब होता है, जब विंडो को मूव किया जाता है या उसका साइज़ बदला जाता है. इसके बाद, एक ही आईडी वाली विंडो को फिर से खोलने पर, तय की गई सीमाओं के बजाय इस साइज़ और पोज़िशन का इस्तेमाल किया जाता है. अगर आपको किसी आईडी वाली विंडो को डिफ़ॉल्ट जगह के बजाय किसी दूसरी जगह पर खोलना है, तो उसे छिपाकर बनाया जा सकता है. इसके बाद, उसे अपनी पसंद की जगह पर ले जाकर दिखाया जा सकता है.

पैरामीटर

  • url

    स्ट्रिंग

  • विकल्प

    CreateWindowOptions ज़रूरी नहीं

  • कॉलबैक

    function ज़रूरी नहीं

    callback पैरामीटर कुछ ऐसा दिखता है: 

    (createdWindow: AppWindow) => void

रिटर्न

  • <br>Promise<AppWindow>

    Chrome 117 या इसके बाद का वर्शन

    प्रॉमिस सिर्फ़ Manifest V3 और इसके बाद के वर्शन के लिए काम करते हैं. अन्य प्लैटफ़ॉर्म के लिए, कॉलबैक का इस्तेमाल करना ज़रूरी है.

current()

chrome.app.window.current(): AppWindow | undefined

यह मौजूदा स्क्रिप्ट कॉन्टेक्स्ट (जैसे, JavaScript 'window' ऑब्जेक्ट) के लिए, AppWindow ऑब्जेक्ट दिखाता है. इसे किसी दूसरे पेज के लिए स्क्रिप्ट कॉन्टेक्स्ट के हैंडल पर भी कॉल किया जा सकता है. उदाहरण के लिए: otherWindow.chrome.app.window.current().

रिटर्न

get()

chrome.app.window.get(
  id: string,
): AppWindow | undefined

दिए गए आईडी वाला AppWindow मिलता है. अगर दिए गए आईडी वाली कोई विंडो मौजूद नहीं है, तो शून्य वैल्यू दिखती है. यह तरीका, Chrome 33 में नया है.

पैरामीटर

  • आईडी

    स्ट्रिंग

रिटर्न

getAll()

chrome.app.window.getAll(): AppWindow[]

फ़िलहाल बनाई गई सभी ऐप्लिकेशन विंडो की कलेक्शन दिखाता है. यह तरीका, Chrome 33 में नया है.

रिटर्न

इवेंट

onBoundsChanged

chrome.app.window.onBoundsChanged.addListener(
  callback: function,
)

विंडो का साइज़ बदलने पर ट्रिगर होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर कुछ ऐसा दिखता है: 

    () => void

onClosed

chrome.app.window.onClosed.addListener(
  callback: function,
)

विंडो बंद होने पर ट्रिगर होता है. ध्यान दें, इसे बंद की जा रही विंडो के बजाय किसी दूसरी विंडो से सुना जाना चाहिए. उदाहरण के लिए, बैकग्राउंड पेज से. ऐसा इसलिए होता है, क्योंकि इवेंट ट्रिगर होने पर, बंद की जा रही विंडो को बंद करने की प्रोसेस चल रही होगी. इसका मतलब है कि विंडो के स्क्रिप्ट कॉन्टेक्स्ट में मौजूद सभी एपीआई काम नहीं करेंगे.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर कुछ ऐसा दिखता है: 

    () => void

onFullscreened

chrome.app.window.onFullscreened.addListener(
  callback: function,
)

यह इवेंट तब ट्रिगर होता है, जब विंडो को फ़ुलस्क्रीन किया जाता है. ऐसा AppWindow या HTML5 एपीआई के ज़रिए किया जाता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर कुछ ऐसा दिखता है: 

    () => void

onMaximized

chrome.app.window.onMaximized.addListener(
  callback: function,
)

विंडो को बड़ा करने पर ट्रिगर होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर कुछ ऐसा दिखता है: 

    () => void

onMinimized

chrome.app.window.onMinimized.addListener(
  callback: function,
)

विंडो को छोटा करने पर ट्रिगर होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर कुछ ऐसा दिखता है: 

    () => void

onRestored

chrome.app.window.onRestored.addListener(
  callback: function,
)

यह इवेंट तब ट्रिगर होता है, जब विंडो को छोटा या बड़ा करने के बाद, उसे पहले जैसा किया जाता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर कुछ ऐसा दिखता है: 

    () => void