Metodo IInkAnalyzer::AddStrokeToCustomRecognizer

  • Articolo

Aggiunge i dati del tratto per un singolo tratto a un nodo di riconoscimento personalizzato.

Sintassi

HRESULT AddStrokeToCustomRecognizer(
  [in]  ULONG        ulStrokeId,
  [in]  ULONG        ulStrokePacketDataCount,
  [in]  LONG         *plStrokePacketData,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [in]  IContextNode *pCustomRecognizer,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

Parametri

ulStrokeId [in]

Identificatore del tratto da aggiungere.

ulStrokePacketDataCount [in]

Numero di pacchetti nel tratto.

plStrokePacketData [in]

Matrice contenente i dati del pacchetto per il tratto.

ulStrokePacketDescriptionCount [in]

Numero di proprietà dei pacchetti in ogni pacchetto.

pStrokePacketDescriptionGuids [in]

Matrice contenente gli identificatori di proprietà del pacchetto.

pCustomRecognizer [in]

IContextNode di tipo CustomRecognizer a cui aggiungere il tratto.

ppContextNodeStrokeAddedTo [out]

IContextNode a cui l'analizzatore dell'input penna ha aggiunto il tratto.

Valore restituito

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

Commenti

Attenzione

Per evitare una perdita di memoria, chiamare IUnknown::Release in ppContextNodeStrokeAddedTo quando non è più necessario usare l'oggetto.

Quando ppContextNodeStrokeAddedTo è NULL, indica che il chiamante non è interessato al valore restituito dal metodo .

IInkAnalyzer aggiunge il tratto a un IContextNode di tipo CustomRecognizer (vedere Tipi di nodi di contesto). Questo nodo si trova nella raccolta di sottonodi del nodo radice (vedere Metodi IInkAnalyzer::GetRootNode e IContextNode::GetSubNodes ).

IInkAnalyzer assegna l'identificatore delle impostazioni cultura del thread di input attivo al tratto e aggiunge il tratto al primo nodo UnclassifiedInk nel nodo CustomRecognizer. Se non esiste alcun nodo UnclassifiedInk , viene creato. Se IInkAnalysisRecognizer associato al nodo CustomRecognizer non supporta l'identificatore delle impostazioni cultura, IInkAnalyzer continua ad analizzare e generare un avviso IAnalysisWarning . Questo avviso ha un valore AnalysisWarningCode pari a AnalysisWarningCode_LanguageIdNotRespected.

plStrokePacketData contiene i dati dei pacchetti per tutti i punti del tratto. pStrokePacketDescriptionGuids contiene gli identificatori univoci globali (GUID) che descrivono i tipi di dati dei pacchetti inclusi per ogni punto in ogni tratto. Per un elenco completo delle proprietà dei pacchetti disponibili, vedere Costanti PacketPropertyGuids.

Questo metodo espande l'area dirty all'unione del valore corrente dell'area e al rettangolo di selezione del tratto aggiunto.

IInkAnalyzer restituisce un valore HRESULT di E_INVALIDARG nelle circostanze seguenti.

  • IInkAnalyzer contiene già un tratto con lo stesso identificatore del tratto da aggiungere.
  • Il parametro pCustomRecognizer contiene un nodo di riconoscimento personalizzato associato a un oggetto IInkAnalyzer diverso.
  • Il parametro pCustomRecognizer contiene un IContextNode che non è di tipo CustomRecognizer.

Requisiti

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

Vedi anche

IInkAnalyzer

Tipi di nodo di contesto

Metodo IInkAnalyzer::AddStrokesToCustomRecognizer

Metodo IInkAnalyzer::CreateCustomRecognizer

Riferimento all'analisi dell'input penna