chrome.app.window

Attribute

• contentWindow

  Fenster

  Das JavaScript-"Fenster" -Objekt für das erstellte untergeordnete Element.

• id

  String

  Die ID, mit der das Fenster erstellt wurde.

• innerBounds

  Grenzen

  Die Position, Größe und Beschränkungen des Fensterinhalts. Dies beinhaltet keine Fenstergestaltung. Diese Eigenschaft ist in Chrome 36 neu.

• outerBounds

  Grenzen

  Die Position, Größe und Begrenzungen des Fensters, einschließlich Fensterdekorationen wie Titelleiste und Rahmen. Diese Eigenschaft ist in Chrome 36 neu.

• clearAttention

  voidm

  Machen Sie deutlich auf das Fenster aufmerksam.

  Die Funktion clearAttention sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• Schließen

  voidm

  Schließen Sie das Fenster.

  Die Funktion close sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• drawAttention

  voidm

  Lenken Sie die Aufmerksamkeit auf das Fenster.

  Die Funktion drawAttention sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• Fokus

  voidm

  Fokussieren Sie das Fenster.

  Die Funktion focus sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• Vollbild

  voidm

  Das Fenster wird im Vollbildmodus angezeigt.

  Der Nutzer kann das Fenster mit der Esc-Taste wiederherstellen. Eine Anwendung kann verhindern, dass der Fullscreen-Status verlassen wird, wenn die Esc-Taste gedrückt wird, indem die Berechtigung app.window.fullscreen.overrideEsc angefordert und das Ereignis durch Aufrufen von „.preventDefault()“ im keydown- und keyup-Handler abgebrochen wird:

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

  Hinweis: window.fullscreen() sorgt dafür, dass das gesamte Fenster im Vollbildmodus angezeigt wird, ohne dass eine Nutzergeste erforderlich ist. Die HTML5 Fullscreen API kann auch verwendet werden, um in den Vollbildmodus zu wechseln. Weitere Informationen finden Sie unter Web-APIs.

  Die Funktion fullscreen sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• getBounds

  voidm

  <ph type="x-smartling-placeholder"></ph> Eingestellt

  Verwenden Sie „innerBounds“ oder „outerBounds“.

  Ruft die inneren Grenzen des Fensters als ContentBounds-Objekt ab.

  Die Funktion getBounds sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

  • Gibt zurück

    ContentBounds

• Ausblenden

  voidm

  Blende das Fenster aus. Tut nichts, wenn das Fenster bereits ausgeblendet ist.

  Die Funktion hide sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• isAlwaysOnTop

  voidm

  Befindet sich das Fenster immer oben?

  Die Funktion isAlwaysOnTop sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

  • Gibt zurück

    boolean

• isFullscreen

  voidm

  Wird das Fenster im Vollbildmodus angezeigt? Dies ist der Fall, wenn das Fenster im Vollbildmodus oder über die AppWindow oder HTML5 Fullscreen API erstellt wurde.

  Die Funktion isFullscreen sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

  • Gibt zurück

    boolean

• isMaximized

  voidm

  Ist das Fenster maximiert?

  Die Funktion isMaximized sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

  • Gibt zurück

    boolean

• isMinimized

  voidm

  Ist das Fenster minimiert?

  Die Funktion isMinimized sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

  • Gibt zurück

    boolean

• maximieren

  voidm

  Fenster maximieren

  Die Funktion maximize sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• minimieren

  voidm

  Minimieren Sie das Fenster.

  Die Funktion minimize sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• moveTo

  voidm

  <ph type="x-smartling-placeholder"></ph> Seit Chrome 43 verworfen

  Verwenden Sie outerBounds.

  Verschieben Sie das Fenster an die Position (left, top).

  Die Funktion moveTo sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • links

    Zahl

  • oben

    Zahl

• resizeTo

  voidm

  <ph type="x-smartling-placeholder"></ph> Seit Chrome 43 verworfen

  Verwenden Sie outerBounds.

  Ändern Sie die Größe des Fensters auf width x height Pixel.

  Die Funktion resizeTo sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • Breite

    Zahl

  • Höhe

    Zahl

• Wiederherstellen

  voidm

  Stellen Sie das Fenster wieder her, indem Sie den maximierten, minimierten oder Vollbildmodus verlassen.

  Die Funktion restore sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => {...}

• setAlwaysOnTop

  voidm

  Legen Sie fest, ob das Fenster über den meisten anderen Fenstern bleiben soll. Erfordert die Berechtigung alwaysOnTopWindows.

  Die Funktion setAlwaysOnTop sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • alwaysOnTop

    boolean

• setBounds

  voidm

  <ph type="x-smartling-placeholder"></ph> Eingestellt

  Verwenden Sie „innerBounds“ oder „outerBounds“.

  Legen Sie die inneren Grenzen des Fensters fest.

  Die Funktion setBounds sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • Grenzen

    ContentBounds

• setVisibleOnAllWorkspaces

  voidm

  Sie können festlegen, ob das Fenster in allen Arbeitsbereichen sichtbar sein soll. (Nur für Plattformen, die dies unterstützen.)

  Die Funktion setVisibleOnAllWorkspaces sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • alwaysVisible

    boolean

• Einblenden

  voidm

  Zeige das Fenster. Tut nichts, wenn das Fenster bereits sichtbar ist. Hiermit wird das Fenster fokussiert, wenn focused auf „true“ gesetzt oder weggelassen wird.

  Die Funktion show sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • Fokussiert

    Boolescher Wert optional

Attribute

• Höhe

  Zahl

  Diese Eigenschaft kann verwendet werden, um die aktuelle Höhe des Inhalts oder des Fensters zu lesen oder zu schreiben.

• links

  Zahl

  Diese Eigenschaft kann verwendet werden, um die aktuelle X-Koordinate des Inhalts oder des Fensters zu lesen oder zu schreiben.

• maxHeight

  Zahl optional

  Diese Eigenschaft kann verwendet werden, um die aktuelle maximale Höhe des Inhalts oder Fensters zu lesen oder zu schreiben. Der Wert null steht für „nicht spezifiziert“.

• maxWidth

  Zahl optional

  Diese Eigenschaft kann verwendet werden, um die aktuelle maximale Breite des Inhalts oder des Fensters zu lesen oder zu schreiben. Der Wert null steht für „nicht spezifiziert“.

• minHeight

  Zahl optional

  Diese Eigenschaft kann verwendet werden, um die aktuelle Mindesthöhe des Inhalts oder Fensters zu lesen oder zu schreiben. Der Wert null steht für „nicht spezifiziert“.

• minWidth

  Zahl optional

  Diese Eigenschaft kann verwendet werden, um die aktuelle Mindestbreite des Inhalts oder des Fensters zu lesen oder zu schreiben. Der Wert null steht für „nicht spezifiziert“.

• oben

  Zahl

  Diese Eigenschaft kann verwendet werden, um die aktuelle Y-Koordinate des Inhalts oder des Fensters zu lesen oder zu schreiben.

• Breite

  Zahl

  Diese Eigenschaft kann verwendet werden, um die aktuelle Breite des Inhalts oder des Fensters zu lesen oder zu schreiben.

• setMaximumSize

  voidm

  Legen Sie die maximalen Größenbeschränkungen für den Inhalt oder das Fenster fest. Die maximale Breite oder Höhe kann auf null festgelegt werden, um die Beschränkung zu entfernen. Der Wert undefined lässt eine Einschränkung unverändert.

  Die Funktion setMaximumSize sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • maxWidth

    Zahl

  • maxHeight

    Zahl

• setMinimumSize

  voidm

  Legen Sie die Mindestgrößenbeschränkungen für den Inhalt oder das Fenster fest. Die Mindestbreite oder -höhe kann auf null gesetzt werden, um die Beschränkung zu entfernen. Der Wert undefined lässt eine Einschränkung unverändert.

  Die Funktion setMinimumSize sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • minWidth

    Zahl

  • minHeight

    Zahl

• setPosition

  voidm

  Legen Sie die linke und obere Position des Inhalts oder Fensters fest.

  Die Funktion setPosition sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • links

    Zahl

  • oben

    Zahl

• setSize

  voidm

  Legen Sie die Breite und Höhe des Inhalts oder des Fensters fest.

  Die Funktion setSize sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

  • Breite

    Zahl

  • Höhe

    Zahl

Attribute

• Höhe

  Zahl optional

  Höhe des Inhalts oder Fensters

• links

  Zahl optional

  Die X-Koordinate des Inhalts oder des Fensters.

• maxHeight

  Zahl optional

  Die maximale Höhe des Inhalts oder Fensters.

• maxWidth

  Zahl optional

  Die maximale Breite des Inhalts oder des Fensters.

• minHeight

  Zahl optional

  Die Mindesthöhe des Inhalts oder Fensters.

• minWidth

  Zahl optional

  Die Mindestbreite des Inhalts oder des Fensters.

• oben

  Zahl optional

  Die Y-Koordinate des Inhalts oder des Fensters.

• Breite

  Zahl optional

  Die Breite des Inhalts oder des Fensters.

Attribute

• Höhe

  Zahl optional

• links

  Zahl optional

• oben

  Zahl optional

• Breite

  Zahl optional

Attribute

• alwaysOnTop

  Boolescher Wert optional

  Falls wahr, bleibt das Fenster über den meisten anderen Fenstern. Wenn es mehrere Fenster dieser Art gibt, wird das aktuell fokussierte Fenster im Vordergrund angezeigt. Erfordert die Berechtigung alwaysOnTopWindows. Die Standardeinstellung ist "false".

  Rufen Sie setAlwaysOnTop() im Fenster auf, um diese Eigenschaft nach dem Erstellen zu ändern.

• Grenzen

  ContentBounds optional

  <ph type="x-smartling-placeholder"></ph> Eingestellt

  Verwenden Sie „innerBounds“ oder „outerBounds“.

  Größe und Position des Inhalts im Fenster (ohne Titelleiste). Wenn auch eine ID angegeben wird und zuvor ein Fenster mit einer übereinstimmenden ID angezeigt wurde, werden stattdessen die gespeicherten Grenzen des Fensters verwendet.

• Fokussiert

  Boolescher Wert optional

  Falls wahr, wird das Fenster beim Erstellen fokussiert. Der Standardwert ist „true“.

• Rahmen

  string | FrameOptions optional

  Frametyp: none oder chrome (standardmäßig chrome). Für none kann die CSS-Eigenschaft -webkit-app-region verwendet werden, um Ziehbarkeit auf das App-Fenster anzuwenden. Mit -webkit-app-region: drag können Regionen als ziehbar markiert werden. Mit no-drag kann dieser Stil bei verschachtelten Elementen deaktiviert werden.

  Die Verwendung von FrameOptions ist in M36 neu.

• ausgeblendet

  Boolescher Wert optional

  Falls wahr, wird das Fenster ausgeblendet. Rufen Sie show() für das Fenster auf, um es nach der Erstellung anzuzeigen. Die Standardeinstellung ist "false".

• Symbol

  String optional

  Chrome 54 und höher

  URL des Fenstersymbols Ein Fenster kann ein eigenes Symbol haben, wenn showInShelf auf „true“ gesetzt ist. Die URL sollte eine globale URL oder eine lokale URL einer Erweiterung sein.

• id

  String optional

  ID zur Identifizierung des Fensters. Dies wird verwendet, um die Größe und Position des Fensters zu speichern und diese Geometrie wiederherzustellen, wenn später ein Fenster mit derselben ID geöffnet wird. Wenn ein Fenster mit einer bestimmten ID erstellt wird, während ein anderes Fenster mit derselben ID bereits existiert, wird der Fokus auf das aktuell geöffnete Fenster gelegt, anstatt ein neues Fenster zu erstellen.

• innerBounds

  BoundsSpecification optional

  Wird zur Angabe der Anfangsposition, Anfangsgröße und der Begrenzungen des Fensterinhalts (mit Ausnahme von Fenstergestaltungen) verwendet. Wenn auch ein id angegeben ist und zuvor ein Fenster mit einer übereinstimmenden id angezeigt wurde, werden stattdessen die gespeicherten Grenzen verwendet.

  Beachten Sie, dass das Padding zwischen den inneren und äußeren Grenzen vom Betriebssystem bestimmt wird. Daher führt das Festlegen derselben bounds-Eigenschaft für innerBounds und outerBounds zu einem Fehler.

  Diese Eigenschaft ist in Chrome 36 neu.

• maxHeight

  Zahl optional

  <ph type="x-smartling-placeholder"></ph> Eingestellt

  Verwenden Sie „innerBounds“ oder „outerBounds“.

  Maximale Höhe des Fensters.

• maxWidth

  Zahl optional

  <ph type="x-smartling-placeholder"></ph> Eingestellt

  Verwenden Sie „innerBounds“ oder „outerBounds“.

  Maximale Breite des Fensters.

• minHeight

  Zahl optional

  <ph type="x-smartling-placeholder"></ph> Eingestellt

  Verwenden Sie „innerBounds“ oder „outerBounds“.

  Mindesthöhe des Fensters.

• minWidth

  Zahl optional

  <ph type="x-smartling-placeholder"></ph> Eingestellt

  Verwenden Sie „innerBounds“ oder „outerBounds“.

  Mindestbreite des Fensters.

• outerBounds

  BoundsSpecification optional

  Legt die Anfangsposition, Anfangsgröße und -beschränkungen des Fensters fest (einschließlich Fenstergestaltungen wie Titelleiste und Frame). Wenn auch eine id angegeben ist und zuvor ein Fenster mit einer übereinstimmenden id angezeigt wurde, werden stattdessen die gespeicherten Grenzen verwendet.

  Beachten Sie, dass das Padding zwischen den inneren und äußeren Grenzen vom Betriebssystem bestimmt wird. Daher führt das Festlegen derselben bounds-Eigenschaft für innerBounds und outerBounds zu einem Fehler.

  Diese Eigenschaft ist in Chrome 36 neu.

• in der Größe veränderbar

  Boolescher Wert optional

  Falls wahr, kann die Größe des Fensters vom Nutzer angepasst werden. Der Standardwert ist „true“.

• showInShelf

  Boolescher Wert optional

  Chrome 54 und höher

  Falls wahr, hat das Fenster ein eigenes Ablagesymbol. Andernfalls wird das Fenster in der Ablage mit anderen Fenstern gruppiert, die mit der App verknüpft sind. Die Standardeinstellung ist „false“. Wenn showInShelf auf „true“ gesetzt ist, müssen Sie eine ID für das Fenster angeben.

• Singleton

  Boolescher Wert optional

  <ph type="x-smartling-placeholder"></ph> Eingestellt

  Mehrere Fenster mit derselben ID werden nicht mehr unterstützt.

  Wenn Sie eine ID für das Fenster angeben, wird das Fenster standardmäßig nur erstellt, wenn noch kein anderes Fenster mit derselben ID vorhanden ist. Wenn bereits ein Fenster mit derselben ID vorhanden ist, wird dieses Fenster stattdessen aktiviert. Wenn Sie mehrere Fenster mit derselben ID erstellen möchten, können Sie diese Eigenschaft auf "false" setzen.

• Bundesstaat

  Bundesland optional

  Der Anfangszustand des Fensters, sodass es bereits im Vollbildmodus erstellt, maximiert oder minimiert werden kann. Die Standardeinstellung ist „normal“.

• Typ

  WindowType optional

  Chrome (ab Version 45) Seit Chrome 69 eingestellt

  Alle App-Fenster verwenden die Shell Fenstertyp

  Typ des Fensters, das erstellt werden soll.

• visibleOnAllWorkspaces

  Boolescher Wert optional

  Falls wahr, und von der Plattform unterstützt, ist das Fenster in allen Arbeitsbereichen sichtbar.

Attribute

• activeColor

  String optional

  Hier kann die Rahmenfarbe des Fensters festgelegt werden, wenn es aktiv ist. Die Rahmenfarbe ist nur verfügbar, wenn der Rahmentyp chrome ist.

  Die Rahmenfarbe ist nur verfügbar, wenn der Rahmentyp chrome ist.

  Die Rahmenfärbung ist in Chrome 36 neu.

• Farbe

  String optional

  Die Rahmenfarbe kann festgelegt werden. Die Rahmenfarbe ist nur verfügbar, wenn der Rahmentyp chrome ist.

  Die Rahmenfärbung ist in Chrome 36 neu.

• inactiveColor

  String optional

  Ermöglicht, dass die Rahmenfarbe des Fensters bei Inaktivität von der aktiven Farbe abweicht. Die Rahmenfarbe ist nur verfügbar, wenn der Rahmentyp chrome ist.

  inactiveColor muss in Verbindung mit color verwendet werden.

  Die Rahmenfärbung ist in Chrome 36 neu.

• Typ

  String optional

  Frametyp: none oder chrome (standardmäßig chrome).

  Für none kann die CSS-Eigenschaft -webkit-app-region verwendet werden, um Ziehbarkeit auf das App-Fenster anzuwenden.

  Mit -webkit-app-region: drag können Regionen als ziehbar markiert werden. Mit no-drag kann dieser Stil bei verschachtelten Elementen deaktiviert werden.

Enum

Enum

Gibt Folgendes zurück:

• boolean

Parameter

• URL

  String

• Optionen

  CreateWindowOptions – optional

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (createdWindow: AppWindow) => void

  • createdWindow

    AppWindow

Gibt Folgendes zurück:

• Promise&lt;AppWindow&gt;

  Chrome 117 oder höher

  Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

Gibt Folgendes zurück:

• AppWindow | nicht definiert

Parameter

• id

  String

Gibt Folgendes zurück:

• AppWindow | nicht definiert

Gibt Folgendes zurück:

• AppWindow[]

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void