Metodo IInkAnalyzer::Search

Fornisce una ricerca fuzzy, senza distinzione tra maiuscole e minuscole, per la scrittura di tratti analizzati e tratti di disegno analizzati che hanno tipi riconosciuti.

Sintassi

HRESULT Search(
  [in]      BSTR  bstrPhraseToMatch,
  [in, out] ULONG *pulSearchResultCount,
  [out]     ULONG **ppulStrokeCountPerResult,
  [in, out] ULONG *pulStrokeIdsCount,
  [out]     ULONG **ppulStrokeIds
);

Parametri

bstrPhraseToMatch [in]

La frase che verrà trovata nelle alternative per i tratti attualmente analizzati.

pulSearchResultCount [in, out]

Numero massimo di risultati restituiti dalla ricerca.

ppulStrokeCountPerResult [out]

Puntatore a una matrice del numero di tratti in ogni risultato della ricerca.

pulStrokeIdsCount [in, out]

Numero di ID tratti in ppulStrokeIds.

ppulStrokeIds [out]

Puntatore a una matrice di ID tratti che rappresentano un set di set di tratti.

Valore restituito

Per una descrizione dei valori restituiti, vedere Classi e interfacce - Analisi input penna.

Osservazioni:

Questa ricerca trova sottostringhe con più parole e singole parole. Vengono ricercati sia i risultati di riconoscimento alternativi che le segmentazioni alternative.

Tutte le stringhe in ingresso verranno convertite in un'unica combinazione di maiuscole e minuscole per il confronto utilizzando l'LCID del thread corrente per eseguire questa conversione in modo da rispettare le convenzioni dei casi culturali.

La stringa passata viene considerata come una frase. Le parole e i caratteri devono essere visualizzati nelle alternative per i tratti nell'ordine specificato. Le prime e le ultime parole della frase possono essere abbinate come sottostringhe (la prima parola che appare alla fine di un'alternativa e l'ultima parola che appare all'inizio di una), ma qualsiasi altra parola (quelle all'interno della frase) deve apparire come parole intere.

Se la stringa passata non contiene spazi vuoti tra caratteri, la sottostringa può essere trovata in un punto qualsiasi all'interno di una singola parola in un'alternativa.

Solo la presenza o l'assenza di spazi vuoti tra i caratteri modifica i risultati della ricerca. Gli spazi vuoti che non sono racchiusi tra caratteri vengono ignorati. Il tipo di spazio vuoto viene ignorato (una scheda o uno spazio tra i caratteri restituirà lo stesso risultato). La quantità di spazi vuoti non è importante: uno spazio o due spazi tra caratteri restituirà lo stesso risultato.

La ricerca non genera eventi PopulateContextNode. Verranno cercati solo i tratti già popolati.

Requisiti

Requisito	valore
Client minimo supportato	Windows XP Tablet PC Edition [solo app desktop]
Server minimo supportato	Nessuna supportata
Intestazione	IACom.h (richiede anche IACom_i.c)
DLL	IACom.dll

Vedi anche

IInkAnalyzer