RecognizerContext.IsStringSupported-Methode

Artikel
11/26/2008

Gibt einen Wert zurück, der angibt, ob das Systemwörterbuch, das Benutzerwörterbuch oder das WordList-Objekt eine angegebene Zeichenfolge enthält.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Function IsStringSupported ( _
    s As String _
) As Boolean
'Usage
Dim instance As RecognizerContext
Dim s As String
Dim returnValue As Boolean

returnValue = instance.IsStringSupported(s)

public bool IsStringSupported(
    string s
)

public:
bool IsStringSupported(
    String^ s
)

public boolean IsStringSupported(
    String s
)

public function IsStringSupported(
    s : String
) : boolean

Parameter

s
Typ: System.String
Die Zeichenfolge, die in den Wörterbüchern und der Wortliste nachgeschlagen werden soll.

Rückgabewert

Typ: System.Boolean
Ein Wert, der angibt, ob das Systemwörterbuch, das Benutzerwörterbuch oder das WordList-Objekt eine angegebene Zeichenfolge enthält.

Wert	Bedeutung
true	Die Zeichenfolge ist im Wörterbuch oder der Wortliste enthalten.
false	Die Zeichenfolge ist weder im Wörterbuch oder noch in der Wortliste enthalten.

Hinweise

Die Methode betrachtet unter anderem alle Flags und Faktoiden, die einen Kontext zu der zu überprüfenden Zeichenfolge liefern.

Die IsStringSupported-Methode überprüft das Systemwörterbuch, das Benutzerwörterbuch und die WordList, je nachdem, ob Spracheingaben in Microsoft Office aktiviert wurden. In der folgende Tabelle ist aufgeführt, an welchen Stellen das Erkennungsmodul nach der angegebenen Zeichenfolge sucht.

WordList-Bedingung	Die Microsoft® Office-Spracherkennung ist aktiviert.	Die Microsoft® Office-Spracherkennung ist nicht aktiviert.
WordList ist festgelegt.	WordList	WordList
WordList = nullNULL-Verweis (Nothing in Visual Basic)	Benutzerwörterbuch und Systemwörterbuch	Systemwörterbuch

Verwenden Sie die Factoid-Eigenschaft, um die Suche auf das Systemwörterbuch oder die Wortliste, das bzw. die dem Kontext zugeordnet ist, zu beschränken. Um z. B. die Suche auf das Systemwörterbuch zu beschränken, geben Sie das SystemDictionary-Faktoid an. Um die Ergebnisse zu verbessern, müssen Sie möglicherweise auch die RecognitionFlags-Eigenschaft festlegen.

Beispiele

In diesem Beispiel wird ein RecognizerContext-Objekt instanziiert, und ein neues WordList-Objekt wird dessen WordList-Eigenschaft zugewiesen. Mithilfe der IsStringSupported-Methode wird dann bestimmt, ob die angegebene Zeichenfolge unterstützt wird. Wenn nicht, wird die Zeichenfolge der WordList-Wortliste hinzugefügt.

Dim RC As RecognizerContext = New RecognizerContext()
RC.WordList = New WordList()
Dim testStr As String = "thunk"
If Not RC.IsStringSupported(testStr) Then
    Dim WL As WordList = RC.WordList
    WL.Add(testStr)
    ' testStr is not available for use in recognition
    ' until the WordList property is re-assigned
    RC.WordList = WL
End If

RecognizerContext RC = new RecognizerContext();
RC.WordList = new WordList();
string testStr = "thunk";
if (!RC.IsStringSupported(testStr))
{
    WordList WL = RC.WordList;
    WL.Add(testStr);
    // testStr is not available for use in recognition
    // until the WordList property is re-assigned
    RC.WordList = WL;
}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.