chrome.app.window

ब्यौरा

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

टाइप

AppWindow

प्रॉपर्टी

  • contentWindow

    विंडो

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

  • id

    स्ट्रिंग

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

  • innerBounds

    सीमाएं

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

  • outerBounds

    सीमाएं

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

  • clearAttention

    void

    विंडो की ओर ध्यान दें.

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

    ()=> {...}

  • बंद करें

    void

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

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

    ()=> {...}

  • drawAttention

    void

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

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

    ()=> {...}

  • focus

    void

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

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

    ()=> {...}

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

    void

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

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

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

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

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

    ()=> {...}

  • getBounds

    void

    अब सेवा में नहीं है

    इनरबाउंड या आउटरबाउंड का इस्तेमाल करें.

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

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

    ()=> {...}

  • छिपाएं

    void

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

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

    ()=> {...}

  • isAlwaysOnTop

    void

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

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

    ()=> {...}

    • returns

      boolean

  • isFullscreen

    void

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

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

    ()=> {...}

    • returns

      boolean

  • isMaximized

    void

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

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

    ()=> {...}

    • returns

      boolean

  • isMinimized

    void

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

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

    ()=> {...}

    • returns

      boolean

  • बड़ा करें

    void

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

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

    ()=> {...}

  • छोटा करें

    void

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

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

    ()=> {...}

  • moveTo

    void

    Chrome 43 के बाद से अब सेवा में नहीं है

    आउटरबाउंड का इस्तेमाल करें.

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

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

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

    • बाएं

      नंबर

    • टॉप इनिंग

      नंबर

  • resizeTo

    void

    Chrome 43 के बाद से अब सेवा में नहीं है

    आउटरबाउंड का इस्तेमाल करें.

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

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

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

    • चौड़ाई

      नंबर

    • ऊंचाई

      नंबर

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

    void

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

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

    ()=> {...}

  • setAlwaysOnTop

    void

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

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

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

    • alwaysOnTop

      boolean

  • setBounds

    void

    अब सेवा में नहीं है

    इनरबाउंड या आउटरबाउंड का इस्तेमाल करें.

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

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

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

  • setVisibleOnAllWorkspaces

    void

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

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

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

    • alwaysVisible

      boolean

  • दिखाएं

    void

    विंडो दिखाएं. अगर विंडो पहले से दिख रही है, तो कोई कार्रवाई नहीं की जाएगी. अगर focused सही पर सेट है या नहीं है, तो विंडो पर फ़ोकस करें.

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

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

    • फ़ोकस्ड

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

Bounds

प्रॉपर्टी

  • ऊंचाई

    नंबर

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

  • बाएं

    नंबर

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

  • maxHeight

    नंबर ज़रूरी नहीं

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

  • maxWidth

    नंबर ज़रूरी नहीं

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

  • minHeight

    नंबर ज़रूरी नहीं

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

  • minWidth

    नंबर ज़रूरी नहीं

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

प्रॉपर्टी

  • ऊंचाई

    नंबर ज़रूरी नहीं

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

  • बाएं

    नंबर ज़रूरी नहीं

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

  • maxHeight

    नंबर ज़रूरी नहीं

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

  • maxWidth

    नंबर ज़रूरी नहीं

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

  • minHeight

    नंबर ज़रूरी नहीं

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

  • minWidth

    नंबर ज़रूरी नहीं

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

  • टॉप इनिंग

    नंबर ज़रूरी नहीं

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

  • चौड़ाई

    नंबर ज़रूरी नहीं

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

ContentBounds

प्रॉपर्टी

  • ऊंचाई

    नंबर ज़रूरी नहीं

  • बाएं

    नंबर ज़रूरी नहीं

  • टॉप इनिंग

    नंबर ज़रूरी नहीं

  • चौड़ाई

    नंबर ज़रूरी नहीं

CreateWindowOptions

प्रॉपर्टी

  • alwaysOnTop

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

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

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

  • सीमाएं

    ContentBounds ज़रूरी नहीं

    अब सेवा में नहीं है

    इनरबाउंड या आउटरबाउंड का इस्तेमाल करें.

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

  • फ़ोकस्ड

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

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

  • फ़्रेम

    स्ट्रिंग|FrameOptions ज़रूरी नहीं

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

    FrameOptions का इस्तेमाल, M36 में नई सुविधा है.

  • छिपा हुआ है

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

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

  • आइकॉन

    स्ट्रिंग ज़रूरी नहीं

    Chrome 54 और इसके बाद के वर्शन

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

  • id

    स्ट्रिंग ज़रूरी नहीं

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

  • innerBounds

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

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

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

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

  • maxHeight

    नंबर ज़रूरी नहीं

    अब सेवा में नहीं है

    इनरबाउंड या आउटरबाउंड का इस्तेमाल करें.

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

  • maxWidth

    नंबर ज़रूरी नहीं

    अब सेवा में नहीं है

    इनरबाउंड या आउटरबाउंड का इस्तेमाल करें.

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

  • minHeight

    नंबर ज़रूरी नहीं

    अब सेवा में नहीं है

    इनरबाउंड या आउटरबाउंड का इस्तेमाल करें.

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

  • minWidth

    नंबर ज़रूरी नहीं

    अब सेवा में नहीं है

    इनरबाउंड या आउटरबाउंड का इस्तेमाल करें.

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

  • outerBounds

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

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

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

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

  • resizable

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

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

  • showInShelf

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

    Chrome 54 और इसके बाद के वर्शन

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

  • सिंगलटन

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

    अब सेवा में नहीं है

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

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

  • state

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

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

  • टाइप

    WindowType ज़रूरी नहीं

    Chrome 45+ Chrome 69 के बाद से अब सेवा में नहीं है

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

    बनाने के लिए विंडो का टाइप.

  • visibleOnAllWorkspaces

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

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

FrameOptions

प्रॉपर्टी

  • activeColor

    स्ट्रिंग ज़रूरी नहीं

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

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

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

  • रंग

    स्ट्रिंग ज़रूरी नहीं

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

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

  • inactiveColor

    स्ट्रिंग ज़रूरी नहीं

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

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

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

  • टाइप

    स्ट्रिंग ज़रूरी नहीं

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

    none के लिए, -webkit-app-region सीएसएस प्रॉपर्टी का इस्तेमाल, ऐप्लिकेशन की विंडो पर ड्रैग करने की सुविधा लागू करने के लिए किया जा सकता है.

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

State

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

Enum

WindowType

Chrome 45+

यह बताता है कि किस तरह की विंडो बनानी है.

Enum

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

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

तरीके

canSetVisibleOnAllWorkspaces()

chrome.app.window.canSetVisibleOnAllWorkspaces()

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

रिटर्न

  • boolean

create()

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

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

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

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

पैरामीटर

  • यूआरएल

    स्ट्रिंग

  • विकल्प

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

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

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

    (createdWindow: AppWindow)=>void

रिटर्न

  • Promise<AppWindow>

    Chrome 117 और उसके बाद के वर्शन

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

current()

chrome.app.window.current()

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

रिटर्न

get()

chrome.app.window.get(
  id: string,
)

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

पैरामीटर

  • id

    स्ट्रिंग

रिटर्न

getAll()

chrome.app.window.getAll()

हाल ही में बनाई गई सभी ऐप्लिकेशन विंडो का कलेक्शन लाया जाता है. यह तरीका 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 API के ज़रिए) सक्रिय होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    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