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	IACom.h (também requer IACom_i.c)
DLL	IACom.dll

Confira também

IInkAnalyzer