chrome.app.window

ब्यौरा

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

टाइप

AppWindow

प्रॉपर्टी

  • contentWindow

    विंडो

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

  • आईडी

    स्ट्रिंग

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

  • innerBounds

    सीमाएं

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

  • outerBounds

    सीमाएं

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

  • clearAttention

    अमान्य

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

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

    () => {...}

  • बंद करें

    अमान्य

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

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

    () => {...}

  • drawAttention

    अमान्य

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

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

    () => {...}

  • फ़ोकस

    अमान्य

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

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

    () => {...}

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

    अमान्य

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

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

    अमान्य

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

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

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

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

    () => {...}

  • छिपाएं

    अमान्य

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

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

    () => {...}

  • isAlwaysOnTop

    अमान्य

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

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

    () => {...}

    • returns

      बूलियन

  • isFullscreen

    अमान्य

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

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

    () => {...}

    • returns

      बूलियन

  • isMaximized

    अमान्य

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

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

    () => {...}

    • returns

      बूलियन

  • isMinimized

    अमान्य

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

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

    () => {...}

    • returns

      बूलियन

  • बड़ा करें

    अमान्य

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

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

    () => {...}

  • कम से कम करें

    अमान्य

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

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

    () => {...}

  • moveTo

    अमान्य

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

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

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

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

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

    • बाएं

      संख्या

    • ऊपर

      संख्या

  • resizeTo

    अमान्य

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

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

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

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

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

    • चौड़ाई

      संख्या

    • ऊंचाई

      संख्या

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

    अमान्य

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

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

    () => {...}

  • setAlwaysOnTop

    अमान्य

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

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

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

    • alwaysOnTop

      बूलियन

  • setBounds

    अमान्य

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

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

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

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

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

  • setVisibleOnAllWorkspaces

    अमान्य

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

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

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

    • alwaysVisible

      बूलियन

  • दिखाएं

    अमान्य

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

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

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

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

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

Bounds

प्रॉपर्टी

  • ऊंचाई

    संख्या

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

  • बाएं

    संख्या

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

  • maxHeight

    number ज़रूरी नहीं

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

  • maxWidth

    number ज़रूरी नहीं

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

  • minHeight

    number ज़रूरी नहीं

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

  • minWidth

    number ज़रूरी नहीं

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

प्रॉपर्टी

  • ऊंचाई

    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 optional

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

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

  • छिपा हुआ है

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

    अगर यह वैल्यू सही है, तो विंडो को छिपाकर बनाया जाएगा. विंडो बनाने के बाद, उसे दिखाने के लिए उस पर 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 को true पर सेट किया गया है, तो आपको विंडो के लिए आईडी तय करना होगा.

  • सिंगलटन

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

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

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

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

  • राज्य

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

    विंडो की शुरुआती स्थिति. इससे विंडो को पहले से ही फ़ुलस्क्रीन, ज़्यादा से ज़्यादा या कम से कम किया जा सकता है. डिफ़ॉल्ट रूप से, इसकी वैल्यू '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"
OS मैनेज की गई विंडो (अब सेवा में नहीं है).

तरीके

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 optional

  • कॉलबैक

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

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

    (createdWindow: AppWindow) => void

रिटर्न

  • Promise<AppWindow>

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

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