RecognizerContext.IsStringSupported, méthode

Article
11/05/2008

Mise à jour : November 2007

Retourne une valeur qui indique si le dictionnaire système, le dictionnaire utilisateur ou WordList contient une chaîne spécifiée.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Function IsStringSupported ( _
    s As String _
) As Boolean
'Utilisation
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

Paramètres

s
Type : System.String
Chaîne à chercher dans les dictionnaires et la liste de mots.

Valeur de retour

Type : System.Boolean
Valeur qui indique si le dictionnaire système, le dictionnaire utilisateur ou WordList contient une chaîne spécifiée.

Valeur	Signification
true	La chaîne se trouve dans le dictionnaire ou la liste de mots
false	La chaîne ne se trouve ni dans le dictionnaire ni dans la liste de mots

Notes

Cette méthode tient compte de tous les indicateurs et des éléments, entre autres, qui donnent du contexte à la chaîne testée.

La méthode IsStringSupported vérifie le dictionnaire système, le dictionnaire utilisateur et WordList selon l'état d'activation de la voix dans Microsoft Office. Le tableau suivant répertorie les emplacements auxquels le module de reconnaissance recherche la chaîne spécifiée.

Condition WordList	La reconnaissance vocale de Microsoft® Office est activée	La reconnaissance vocale de Microsoft® Office est désactivée
WordList est définie	WordList	WordList
WordList est nullune référence null (Nothing en Visual Basic)	Dictionnaire utilisateur et dictionnaire système	Dictionnaire système

Utilisez la propriété Factoid pour limiter la recherche au dictionnaire système ou à la liste de mots associée au contexte. Par exemple, pour limiter la recherche au dictionnaire système, spécifiez l'élément SystemDictionary. Pour améliorer les résultats, vous pouvez définir la propriété RecognitionFlags.

Exemples

Dans cet exemple, un objet RecognizerContext est instancié et un nouvel objet WordList est assigné à sa propriété WordList. La méthode IsStringSupported est ensuite utilisée pour déterminer si une chaîne spécifiée est prise en charge. Si ce n'est pas le cas, la chaîne est ajoutée au WordList.

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;
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.