Freigeben über


SRModeID-Eigenschaft

[Der Microsoft-Agent ist ab Windows 7 veraltet und kann in nachfolgenden Versionen von Windows nicht verfügbar sein.]

Beschreibung

Gibt das Spracherkennungsmodul zurück, das das Zeichen verwendet, oder legt dieses fest.

Syntax

Agent**. Characters("CharacterID"). SRModeID** [ = ModeID]

Teil Beschreibung
ModeID- Ein Zeichenfolgenausdruck, der der Modus-ID eines Sprachmoduls entspricht.

 

Bemerkungen

Die Eigenschaft bestimmt das Spracherkennungsmodul, das vom Zeichen für die Spracheingabe verwendet wird. Die Modus-ID für ein Spracherkennungsmodul ist eine formatierte Zeichenfolge, die vom Sprachanbieter definiert wird, der das Modul eindeutig identifiziert. Weitere Informationen finden Sie unter Zugreifen auf ein Sprachmodul in Ihrem Code.

Wenn Sie eine Modus-ID für ein nicht installiertes Sprachmodul angeben, wenn der Benutzer die Spracherkennung deaktiviert hat (im Eigenschaftenblatt des Microsoft Agent), oder wenn die Sprache des angegebenen Sprachmoduls nicht mit der LanguageID Einstellung des Zeichens übereinstimmt, löst der Server einen Fehler aus.

Wenn Sie diese Eigenschaft abfragen und das Spracherkennungsmodul noch nicht (erfolgreich) festgelegt haben, gibt der Server die Modus-ID des Moduls zurück, das SAPI basierend auf der einstellung LanguageID des Zeichens zurückgibt. Wenn Sie die LanguageID-des Zeichens nicht festgelegt haben, gibt der Agent die Modus-ID des Moduls zurück, das SAPI basierend auf der Standardeinstellung für die Sprach-ID des Benutzers zurückgibt. Wenn kein übereinstimmende Modul vorhanden ist, gibt der Server eine leere Zeichenfolge ("") zurück. Die Abfrage dieser Eigenschaft erfordert nicht, dass SpeechInput.Enabled auf Truefestgelegt werden. Wenn Sie die Eigenschaft jedoch abfragen, wenn die Spracheingabe deaktiviert ist, gibt der Server eine leere Zeichenfolge zurück.

Wenn die Spracheingabe aktiviert ist (im Fenster "Erweiterte Zeichenoptionen"), wird durch Abfragen oder Festlegen dieser Eigenschaft das zugeordnete Modul geladen (sofern sie noch nicht geladen ist) und Spracherkennungsdienste gestartet. Das heißt, die Hörtaste ist verfügbar, und der Hörhinweis kann angezeigt werden. (Die Zuhören-Taste und der Zuhören-Tipp sind nur aktiviert, wenn sie auch in erweiterten Zeichenoptionen aktiviert sind.) Wenn Sie die Eigenschaft jedoch abfragen, wenn die Spracherkennung deaktiviert ist, startet der Server keine Sprachdienste.

Diese Eigenschaft gilt nur für die Verwendung des Zeichens ihrer Clientanwendung; Die Einstellung wirkt sich nicht auf andere Clients des Zeichens oder anderer Zeichen Ihrer Clientanwendung aus.

Die Anforderungen des Sprachmoduls von Microsoft Agent basieren auf der Microsoft-Sprach-API. Engines, die die SAPI-Anforderungen von Microsoft Agent unterstützen, können mit Agent installiert und verwendet werden.

Anmerkung

Diese Eigenschaft gibt auch die leere Zeichenfolge zurück, wenn auf Ihrem System keine kompatible Soundunterstützung installiert ist.

 

Anmerkung

Beim Abfragen dieser Eigenschaft wird in der Regel kein Fehler zurückgegeben. Wenn das Sprachmodul jedoch eine ungewöhnlich lange Ladezeit benötigt, wird möglicherweise ein Fehler angezeigt, der angibt, dass die Abfrage timeout war.

 

Siehe auch

LanguageID-Eigenschaft