ScreenDetailed

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, Screen.

availLeft Schreibgeschtzt

Eine Zahl, die die x-Koordinate (linke Kante) des verfgbaren Bildschirmbereichs darstellt.

availTop Schreibgeschtzt

Eine Zahl, die die y-Koordinate (obere Kante) des verfgbaren Bildschirmbereichs darstellt.

devicePixelRatio Schreibgeschtzt

Eine Zahl, die das Gerte-Pixelverhltnis des Bildschirms reprsentiert.

isInternal Schreibgeschtzt

Ein Boolean, der anzeigt, ob der Bildschirm intern fr das Gert oder extern ist.

isPrimary Schreibgeschtzt

Ein Boolean, der anzeigt, ob der Bildschirm als primrer Bildschirm des Betriebssystems (OS) festgelegt ist oder nicht.

label Schreibgeschtzt

Ein String, der eine beschreibende Bezeichnung fr den Bildschirm bereitstellt, zum Beispiel "Eingebautes Retina Display".

left Schreibgeschtzt

Eine Zahl, die die x-Koordinate (linke Kante) des gesamten Bildschirmbereichs darstellt.

top Schreibgeschtzt

Eine Zahl, die die y-Koordinate (obere Kante) des gesamten Bildschirmbereichs darstellt.

Ereignisse

Erbt Ereignisse von seinem Elternteil, Screen.

change

Wird auf einem spezifischen Bildschirm ausgelst, wenn sich eine Eigenschaft des Bildschirms ndert Breite oder Hhe, verfgbare Breite oder verfgbare Hhe, Farbtiefe oder Ausrichtung, Bildschirmposition und verfgbare Bildschirmposition, Gerte-Pixelverhltnis, Bezeichnung oder Bildschirmzuweisung.

Beispiele

Wenn Window.getScreenDetails() aufgerufen wird, wird der Nutzer um Erlaubnis gebeten, Fenster auf all seinen Bildschirmen zu verwalten (der Status dieser Berechtigung kann mit Permissions.query() abgefragt werden, um window-management zu berprfen). Erteilt der Nutzer die Erlaubnis, enthlt das resultierende ScreenDetails-Objekt ScreenDetailed-Objekte, die alle dem System des Nutzers zur Verfgung stehenden Bildschirme reprsentieren.

Das folgende Beispiel ffnet ein Fenster in der oberen linken Ecke des primren OS-Bildschirms:

// Return ScreenDetails
const allScreens = await window.getScreenDetails();

// Return the primary screen ScreenDetailed object
const primaryScreenDetailed = allScreens.screens.find(
  (screenDetailed) => screenDetailed.isPrimary,
);

// Open a window in the top-left corner of the OS primary screen
window.open(
  "https://example.com",
  "_blank",
  `left=${primaryScreenDetailed.availLeft},
   top=${primaryScreenDetailed.availTop},
   width=200,
   height=200`,
);

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Window Management API