EFFECTS-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 EFFECTS-Element bietet eine Möglichkeit, Visualisierungen mithilfe der folgenden Attribute und Methoden zu organisieren und zu bearbeiten. Zur Vereinfachung wird auch ein vordefiniertes EFFECTS-Element bereitgestellt.

Das EFFECTS-Element unterstützt die folgenden Attribute.

attribute BESCHREIBUNG
allowAll Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob alle Visualisierungen in die Registrierung eingeschlossen werden sollen.
currentEffect Gibt die aktuelle Visualisierung an oder ruft sie ab.
currentEffectPresetCount Ruft die Anzahl der verfügbaren Voreinstellungen für die aktuelle Visualisierung ab.
currentEffectTitle Ruft den Anzeigetitel der aktuellen Visualisierung ab.
currentEffectType Ruft den Registrierungsnamen der aktuellen Visualisierung ab.
currentPreset Gibt die aktuelle Voreinstellung der aktuellen Visualisierung an oder ruft sie ab.
currentPresetTitle Ruft den Titel der aktuellen Voreinstellung der aktuellen Visualisierung ab.
effectCanGoFullScreen Ruft einen Wert ab, der angibt, ob die aktuelle Visualisierung im Vollbildmodus angezeigt werden kann.
effectCount Ruft die Anzahl der verfügbaren Visualisierungen ab.
effectHasPropertyPage Ruft einen Wert ab, der angibt, ob die aktuelle Visualisierung über eine Eigenschaftenseite verfügt.
Fullscreen Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob die aktuelle Visualisierung im Vollbildmodus angezeigt wird. Kann nur zur Laufzeit festgelegt werden.
windowed Gibt einen Wert an oder ruft einen Wert ab, der angibt, ob die Visualisierung fenster- oder fensterlos ist, d. h. ob das gesamte Rechteck des Steuerelements jederzeit sichtbar ist oder ob es abgeschnitten werden kann. Kann nur zur Entwurfszeit festgelegt werden.

 

Das EFFECTS-Element unterstützt die folgenden Methoden.

Methode BESCHREIBUNG
effectTitle Ruft den Anzeigenamen der Visualisierung mit dem angegebenen Registrierungsindex ab.
effectType Ruft den Registrierungsnamen der Visualisierung mit dem angegebenen Registrierungsindex ab.
Weiter Zeigt die nächste Visualisierungsvoreinstellung an und wechselt bei Bedarf zur nächsten Visualisierung.
nextEffect Zeigt die erste Voreinstellung der nächsten Visualisierung an, wobei die dazwischen liegenden Voreinstellungen übersprungen werden.
nextPreset Zeigt die nächste Voreinstellung der aktuellen Visualisierung an.
previous Zeigt die vorherige Visualisierungsvoreinstellung an, und wechselt bei Bedarf zur letzten Voreinstellung der vorherigen Visualisierung.
previousEffect Zeigt die vorherige Visualisierung an, wobei Voreinstellungen übersprungen werden.
previousPreset Zeigt die vorherige Voreinstellung der aktuellen Visualisierung an.
settings Zeigt die Attributseite für die aktuelle Visualisierung an, sofern vorhanden.

 

Das EFFECTS-Element unterstützt die Ambient-Attribute und kann die Ambient-Ereignishandler implementieren. Weitere Informationen finden Sie unter Ambient-Attribute und Ambient-Ereignishandler.

Vordefinierte Effekte sind normale EFFECTS-Elemente mit verschiedenen allgemeinen Attributeinstellungen, die standardmäßig angegeben sind. Die folgenden vordefinierten Effekte sind verfügbar.

Vordefinierte EFFEKTE BESCHREIBUNG
WMPEFFECTS Ein EFFECTS-Element , das die verfügbaren Effekte durchläuft.

 

Skin-Programmierreferenz