chrome.app.window

ब्यौरा

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

टाइप

AppWindow

प्रॉपर्टी

  • contentWindow

    विंडो

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

  • आईडी

    स्ट्रिंग

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

  • innerBounds

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

  • outerBounds

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

  • clearAttention

    अमान्य

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

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

    () => {...}

  • बंद करें

    अमान्य

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

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

    () => {...}

  • drawAttention

    अमान्य

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

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

    () => {...}

  • फ़ोकस

    अमान्य

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

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

    () => {...}

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

    अमान्य

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

    उपयोगकर्ता 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

    अमान्य

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

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

    विंडो के इनर बाउंड को ContentBounds ऑब्जेक्ट के तौर पर पाएं.

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

    () => {...}

  • छिपाएं

    अमान्य

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

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

    () => {...}

  • isAlwaysOnTop

    अमान्य

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

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

    () => {...}

    • returns

      बूलियन

  • isFullscreen

    अमान्य

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

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

    () => {...}

    • returns

      बूलियन

  • isMaximized

    अमान्य

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

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

    () => {...}

    • returns

      बूलियन

  • isMinimized

    अमान्य

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

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

    () => {...}

    • returns

      बूलियन

  • बड़ा करें

    अमान्य

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

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

    () => {...}

  • छोटा करें

    अमान्य

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

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

    () => {...}

  • moveTo

    अमान्य

    Chrome 43 के बाद से अब तक काम नहीं करता

    बाहरी सीमाओं का इस्तेमाल करें.

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

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

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

    • बाएं

      संख्या

    • ऊपर

      संख्या

  • resizeTo

    अमान्य

    Chrome 43 के बाद से अब तक काम नहीं करता

    बाहरी सीमाओं का इस्तेमाल करें.

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

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

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

    • चौड़ाई

      संख्या

    • ऊंचाई

      संख्या

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

    अमान्य

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

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

    () => {...}

  • setAlwaysOnTop

    अमान्य

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

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

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

    • alwaysOnTop

      बूलियन

  • setBounds

    अमान्य

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

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

    विंडो के अंदर की सीमाएं तय करें.

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

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

  • setVisibleOnAllWorkspaces

    अमान्य

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

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

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

    • alwaysVisible

      बूलियन

  • दिखाएं

    अमान्य

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

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

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

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

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

Bounds

प्रॉपर्टी

  • ऊंचाई

    संख्या

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

  • बाएं

    संख्या

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

  • maxHeight

    नंबर वैकल्पिक

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

  • maxWidth

    नंबर वैकल्पिक

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

  • minHeight

    नंबर वैकल्पिक

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

  • minWidth

    नंबर वैकल्पिक

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

  • ऊपर

    संख्या

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

  • चौड़ाई

    संख्या

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

  • setMaximumSize

    अमान्य

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

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

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

    • maxWidth

      संख्या

    • maxHeight

      संख्या

  • setMinimumSize

    अमान्य

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

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

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

    • minWidth

      संख्या

    • minHeight

      संख्या

  • setPosition

    अमान्य

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

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

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

    • बाएं

      संख्या

    • ऊपर

      संख्या

  • setSize

    अमान्य

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

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

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

    • चौड़ाई

      संख्या

    • ऊंचाई

      संख्या

BoundsSpecification

प्रॉपर्टी

  • ऊंचाई

    नंबर वैकल्पिक

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

  • बाएं

    नंबर वैकल्पिक

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

  • maxHeight

    नंबर वैकल्पिक

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

  • maxWidth

    नंबर वैकल्पिक

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

  • minHeight

    नंबर वैकल्पिक

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

  • minWidth

    नंबर वैकल्पिक

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

  • ऊपर

    नंबर वैकल्पिक

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

  • चौड़ाई

    नंबर वैकल्पिक

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

ContentBounds

प्रॉपर्टी

  • ऊंचाई

    नंबर वैकल्पिक

  • बाएं

    नंबर वैकल्पिक

  • ऊपर

    नंबर वैकल्पिक

  • चौड़ाई

    नंबर वैकल्पिक

CreateWindowOptions

प्रॉपर्टी

  • alwaysOnTop

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

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

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

  • सीमाएं

    ContentBounds ज़रूरी नहीं

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

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

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

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

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

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

  • फ़्रेम

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

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

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

  • छिपा हुआ है

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

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

  • आइकॉन

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

    Chrome 54 और उसके बाद वाले वर्शन के लिए

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

  • आईडी

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

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

  • innerBounds

    BoundsSpecification ज़रूरी नहीं

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

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

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

  • maxHeight

    नंबर वैकल्पिक

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

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

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

  • maxWidth

    नंबर वैकल्पिक

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

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

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

  • minHeight

    नंबर वैकल्पिक

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

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

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

  • minWidth

    नंबर वैकल्पिक

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

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

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

  • outerBounds

    BoundsSpecification ज़रूरी नहीं

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

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

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

  • साइज़ बदलने की सुविधा

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

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

  • showInShelf

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

    Chrome 54 और उसके बाद वाले वर्शन के लिए

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

  • सिंगलटन

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

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

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

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

  • राज्य

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

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

  • टाइप

    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

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

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

तरीके

canSetVisibleOnAllWorkspaces()

chrome.app.window.canSetVisibleOnAllWorkspaces()

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

रिटर्न

  • बूलियन

create()

प्रॉमिस
chrome.app.window.create(
  url: string,
  options?: CreateWindowOptions,
  callback?: function,
)

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

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

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

पैरामीटर

  • url

    स्ट्रिंग

  • विकल्प

    CreateWindowOptions वैकल्पिक

  • कॉलबैक

    फ़ंक्शन वैकल्पिक

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

    (createdWindow: AppWindow) => void

रिटर्न

  • Promise<AppWindow>

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

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

current()

chrome.app.window.current()

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

रिटर्न

get()

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

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

पैरामीटर

  • आईडी

    स्ट्रिंग

रिटर्न

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