ClosedCaptionTheme Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt ein Untertiteldesign dar, das zugriff auf den Anzeigenamen, den eindeutigen Bezeichner und die Formatierungseinstellungen für das Design bereitstellt. Verwenden Sie die statischen Methoden dieser Klasse, um verfügbare Designs abzurufen, das ausgewählte Design abzurufen oder festzulegen und Designänderungsbenachrichtigungen zu abonnieren.
public ref class ClosedCaptionTheme sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 983040)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ClosedCaptionTheme final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 983040)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ClosedCaptionTheme
Public NotInheritable Class ClosedCaptionTheme
- Vererbung
- Attribute
Windows-Anforderungen
| Anforderungen | Beschreibung |
|---|---|
| Gerätefamilie |
Windows 11, version 24H2 (eingeführt in 10.0.26100.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v19.0)
|
Hinweise
Ein ClosedCaptionTheme-Objekt ist eine Momentaufnahme der Einstellungen eines Designs zum Zeitpunkt des Abrufs. Das Objekt wird nicht aktualisiert, wenn der Benutzer das Design über die Windows-Einstellungs-App ändert. Verwenden Sie die ThemesChanged - und SelectedThemeChanged-Ereignisse , um Änderungen zu erkennen und aktualisierte Designdaten abzurufen.
Durch Festlegen eines Designs über TrySetSelectedTheme wird das systemweite Untertiteldesign für den aktuellen Benutzer geändert, was sich auf alle Anwendungen auswirkt, die Untertitel rendern.
Eigenschaften
| Name | Beschreibung |
|---|---|
| BackgroundColor |
Ruft die Hintergrundfarbe für das Design ab. |
| BackgroundOpacity |
Ruft die Deckkraft des Hintergrunds für das Design ab. |
| ComputedBackgroundColor |
Ruft die berechnete Hintergrundfarbe für das Design ab. |
| ComputedFontColor |
Ruft die berechnete Schriftfarbe für das Design ab. |
| ComputedRegionColor |
Ruft die berechnete Bereichsfarbe für das Design ab. |
| DisplayName |
Ruft den Anzeigenamen des Designs ab. |
| FontColor |
Ruft die Schriftfarbe für das Design ab. |
| FontEffect |
Ruft den Schrifteffekt für das Design ab. |
| FontOpacity |
Ruft die Deckkraft der Schriftart für das Design ab. |
| FontSize |
Ruft den Schriftgrad für das Design ab. |
| FontStyle |
Ruft den Schriftschnitt für das Design ab. |
| Id |
Ruft den eindeutigen Bezeichner für das Design ab. |
| RegionColor |
Ruft die Regionsfarbe für das Design ab. |
| RegionOpacity |
Ruft die Bereichsdurchsichtigkeit für das Design ab. |
Methoden
| Name | Beschreibung |
|---|---|
| GetAvailableThemes() |
Ruft die verfügbaren Untertiteldesigns ab. |
| GetSelectedTheme() |
Ruft das aktuell ausgewählte Design für Untertitel ab. |
| TrySetSelectedTheme(ClosedCaptionTheme) |
Legt das angegebene Design als das aktuell ausgewählte Untertiteldesign für den aktuellen Benutzer fest. |
Ereignisse
| Name | Beschreibung |
|---|---|
| SelectedThemeChanged |
Tritt auf, wenn sich das ausgewählte Design für Untertitel ändert oder wenn die Einstellungen des aktuell ausgewählten Designs geändert werden. |
| ThemesChanged |
Tritt auf, wenn sich die Liste der verfügbaren Untertiteldesigns ändert. Dies schließt ein, wenn ein Design hinzugefügt, entfernt oder die Einstellungen eines Designs geändert werden. |