VIEW-Element

  • Artikel

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer abgelöst. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, mediaPlayer anstelle von Windows Medienwiedergabe SDK für neuen Code zu verwenden. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Das VIEW-Element enthält die Benutzeroberflächendetails einer Skin und verwendet die Attribute, Methoden und Ereignishandler, die in den folgenden Tabellen gezeigt werden.

Mehrere VIEW-Elemente können als untergeordnete Elemente des THEME-Elements einer Skin definiert werden, um unterschiedliche Schnittstellen für verschiedene Situationen bereitzustellen. VIEW-Elemente können nicht als untergeordnete Elemente eines anderen Elements angegeben werden, und sie enthalten alle anderen Skinelemente. Beachten Sie, dass jede Ansicht über einen eigenen Variablenbereich verfügt, was bedeutet, dass sie keine Attributwerte mit anderen Ansichten gemeinsam nutzen kann.

Das globale View-Attribut kann verwendet werden, um von überall aus auf ein bestimmtes VIEW-Element zu verweisen. Dies ist eine Alternative zur Verwendung des id-Attributs , das innerhalb anderer VIEW-Elemente oder innerhalb des THEME-Elements verwendet werden muss.

Das VIEW-Element unterstützt die folgenden Attribute. Attribute, die mit einem Sternchen (*) gekennzeichnet sind, werden auch vom SUBVIEW-Element unterstützt.

attribute Beschreibung
Backgroundcolor * Gibt die Hintergrundfarbe von VIEW oder SUBVIEW an oder ruft sie ab.
Backgroundimage * Gibt das Hintergrundbild von VIEW oder SUBVIEW an oder ruft es ab.
backgroundImageHueShift Gibt an oder ruft den Betrag ab, um den der Farbton des Hintergrundbilds verschoben wird.
backgroundImageSaturation Gibt den Sättigungswert des Hintergrundbilds an oder ruft sie ab.
backgroundTiled * Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob das Hintergrundbild von VIEW oder SUBVIEW gekachelt ist.
category Gibt die Kategorie an, für die die Benutzeroberfläche angezeigt wird, oder ruft sie ab.
focusObjectID Gibt einen Wert an oder ruft einen Wert ab, der angibt, welches Element über den Tastaturfokus verfügt.
maxHeight Gibt die maximale Höhe des VIEW an oder ruft sie ab, wenn die Größe geändert wird.
maxWidth Gibt die maximale Breite des VIEW an oder ruft sie ab, wenn die Größe geändert wird.
minHeight Gibt die Mindesthöhe von VIEW an oder ruft sie ab, wenn die Größe geändert wird.
Minwidth Gibt die Mindestbreite von VIEW an oder ruft sie ab, wenn die Größe geändert wird.
Resizable Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob die GRÖßE des VIEW-Werts geändert werden kann.
resizeBackgroundImage Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob die Größe des Hintergrundbilds geändert werden kann.
scriptFile Gibt die Dateinamen der begleitenden JScript-Dateien an.
timerInterval Gibt das Intervall in Millisekunden an oder ruft es ab, in dem der Timer Ereignisse für den ontimer-Ereignishandler ausgibt.
title Gibt den Titel der ANSICHT an oder ruft den Titel ab. Kann nur zur Entwurfszeit festgelegt werden.
Titlebar Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob die Fenstertitelleiste angezeigt wird.
transparencyColor * Gibt die Transparenzfarbe des Hintergrundbilds an oder ruft sie ab.

 

Das VIEW-Element unterstützt die folgenden Methoden.

Methode Beschreibung
close Schließt die ANSICHT.
Maximieren Maximiert die ANSICHT.
Minimieren Minimiert die ANSICHT.
restore Stellt die VIEW-Datei wieder her.
returnToMediaCenter Gibt den Benutzer in den vollständigen Modus der Windows Medienwiedergabe zurück.
size Ändert die Größe der ANSICHT an einem angegebenen Rand.

 

Das VIEW-Element kann die folgenden Ereignishandler implementieren.

Ereignishandler Beschreibung
Onclose Behandelt ein Ereignis, das auftritt, wenn view geschlossen werden soll.
Onerror Behandelt ein Fehlerereignis, wenn Settings.enableErrorDialogs auf false festgelegt ist.
Onload Behandelt ein Ereignis, das auftritt, wenn die ANSICHT zum ersten Mal angezeigt wird.
ontimer Verarbeitet Timerereignisse.

 

Das VIEW-Element unterstützt die Ambient-Attribute und kann die Ambient-Ereignishandler implementieren, sofern nicht angegeben. Weitere Informationen finden Sie unter Ambient-Attribute und Ambient-Ereignishandler.

Skin-Programmierreferenz