IWMPClosedCaption::SAMIFileName-Eigenschaft
Die SAMIFileName-Eigenschaft ruft den Namen einer Datei ab, die die für Untertitel benötigten Informationen enthält, oder legt diese fest.
Syntax
public System.String SAMIFileName {get; set;}
Public Property SAMIFileName As System.String
Eigenschaftswert
Die System.String, die der Name der SAMI-Datei (Synchronized Accessible Media Interchange) ist.
Bemerkungen
Die SAMI-Datei muss eine SMI- oder SAMI-Dateinamenerweiterung verwenden.
Wenn Sie keinen Wert mit SAMIFileName festlegen, ruft diese Eigenschaft eine Zeichenfolge ab, die den Standarddateinamen oder die URL enthält, die dem aktuellen Medienelement zugeordnet ist. Diese Zuordnung kann auftreten, wenn eine SAMI-Datei mit dem Sami-URL-Parameter angegeben wird, oder automatisch, wenn die SAMI-Datei den gleichen Namen wie die digitale Mediendatei hat (mit Ausnahme der Dateinamenerweiterung). Wenn dem aktuellen Medium keine SAMI-Standarddatei zugeordnet ist, ruft diese Eigenschaft eine Zeichenfolge der Länge 0 ("") ab.
Sobald Sie einen Wert mithilfe von SAMIFileName festgelegt haben, bleibt dieser Wert erhalten, bis Sie einen neuen Wert festlegen (oder bis ein neues Medienelement mit dem Sami-URL-Parameter geöffnet wird). Daher müssen Sie einen neuen Wert für diese Eigenschaft festlegen, bevor Sie jedes neue Medienelement wiedergeben. Auf diese Weise wird der neue Wert für SAMIFileName wirksam, wenn das nächste Medienelement geöffnet wird (oder wenn AxWindowsMediaPlayer.close aufgerufen wird). Das Angeben eines neuen Werts für SAMIFileName hat keine Auswirkungen auf das aktuelle Medium.
Damit Windows Media Player die SAMI-Standarddatei verwenden, die einem bestimmten Medienelement zugeordnet ist, legen Sie SAMIFileName auf eine Zeichenfolge der Länge 0 (null) ("") fest, bevor Sie das nächste Medienelement wiedergeben.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Version |
Windows Media Player 9er Serie oder höher |
| Namespace |
WMPLib |
| Assembly |
|