Método IInkAnalyzer::Search
Fornece uma pesquisa baseada em frase difusa e que não diferencia maiúsculas de minúsculas para traços de escrita analisados e traços de desenho analisados que têm tipos reconhecidos.
Sintaxe
HRESULT Search(
[in] BSTR bstrPhraseToMatch,
[in, out] ULONG *pulSearchResultCount,
[out] ULONG **ppulStrokeCountPerResult,
[in, out] ULONG *pulStrokeIdsCount,
[out] ULONG **ppulStrokeIds
);
Parâmetros
-
bstrPhraseToMatch [in]
-
A frase que será encontrada nas alternativas para os traços analisados no momento.
-
pulSearchResultCount [in, out]
-
O número máximo de resultados retornados da pesquisa.
-
ppulStrokeCountPerResult [out]
-
Ponteiro para uma matriz do número de traços em cada resultado da pesquisa.
-
pulStrokeIdsCount [in, out]
-
O número de IDs de traço em ppulStrokeIds.
-
ppulStrokeIds [out]
-
Ponteiro para uma matriz de IDs de traço que representa um conjunto de conjuntos de traços.
Valor retornado
Para obter uma descrição dos valores retornados, confira Classes e interfaces – análise de tinta.
Comentários
Essa pesquisa localiza subcadeias de caracteres de várias palavras e palavras simples. Os resultados de reconhecimento alternativo e as segmentações alternativas são pesquisados.
Todas as cadeias de caracteres de entrada serão convertidas em um único uso de maiúsculas e minúsculas para comparação utilizando o LCID do thread atual para fazer essa conversão de modo a respeitar as convenções culturais de uso de maiúsculas e minúsculas.
A cadeia de caracteres passada é tratada como uma frase. Palavras e caracteres devem aparecer nas alternativas para os traços na ordem especificada. A primeira e a última palavras da frase podem ser combinadas como subcadeias (a primeira palavra que aparece no final de uma alternativa e a última palavra que aparece no início), mas quaisquer outras palavras (aquelas dentro da frase) devem aparecer como palavras inteiras.
Se a cadeia de caracteres passada não tiver espaço em branco entre caracteres, a substring de caracteres poderá ser encontrada em qualquer lugar dentro de uma única palavra em uma alternativa.
Somente a presença ou ausência de espaço em branco entre caracteres altera os resultados da pesquisa. Espaços em branco que não estejam cercados por caracteres são ignorados. O tipo do espaço em branco é ignorado (uma guia ou um espaço entre caracteres terá o mesmo resultado). A quantidade de espaços em branco não importa – um espaço ou dois espaços entre caracteres dará o mesmo resultado.
A pesquisa não gera eventos PopulateContextNode. Somente os traços que já foram preenchidos serão pesquisados.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows XP Tablet PC Edition [somente aplicativos de desktop] |
| Servidor mínimo com suporte |
Nenhum compatível |
| Cabeçalho |
|
| DLL |
|