Metodo IInkAnalyzer::AddStrokesToCustomRecognizer

Articolo
06/13/2023

Aggiunge i dati del tratto per più tratti a un nodo di riconoscimento personalizzato.

Sintassi

HRESULT AddStrokesToCustomRecognizer(
  [in]  ULONG        ulStrokeIdsCount,
  [in]  LONG         *plStrokeIds,
  [in]  ULONG        ulStrokePacketDescriptionCount,
  [in]  GUID         *pStrokePacketDescriptionGuids,
  [in]  ULONG        *pulPacketDataCountPerStroke,
  [in]  LONG         *plStrokePacketData,
  [in]  IContextNode *pCustomRecognizer,
  [out] IContextNode **ppContextNodeStrokeAddedTo
);

Parametri

ulStrokeIdsCount [in]: Numero di tratti da aggiungere.
plStrokeIds [in]: Matrice contenente gli identificatori del tratto.
ulStrokePacketDescriptionCount [in]: Numero di proprietà in ogni pacchetto.
pStrokePacketDescriptionGuids [in]: Matrice contenente gli identificatori di proprietà del pacchetto.
pulPacketDataCountPerStroke [in]: Matrice contenente il numero di pacchetti in ogni tratto.
plStrokePacketData [in]: Matrice contenente i dati del pacchetto per i tratti.
pCustomRecognizer [in]: IContextNode di tipo CustomRecognizer a cui aggiungere i tratti.
ppContextNodeStrokeAddedTo [out]: IContextNode a cui l'analizzatore input penna ha aggiunto i tratti.

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 i tratti a un IContextNode di tipo CustomRecognizer (vedere Tipi di nodo 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 ai tratti e aggiunge i tratti 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 tratti. 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.

Nota

Solo i tratti con le stesse descrizioni dei pacchetti possono essere aggiunti in una singola chiamata al metodo IInkAnalyzer::AddStrokesToCustomRecognizer.

Questo metodo espande l'area dirty all'unione del valore corrente dell'area e al rettangolo di selezione dei tratti aggiunti.

IInkAnalyzer restituisce un valore HRESULT di E_INVALIDARG nelle circostanze seguenti.

IInkAnalyzer contiene già un tratto con lo stesso identificatore di uno dei tratti 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::AddStrokeToCustomRecognizer
Metodo IInkAnalyzer::CreateCustomRecognizer
Riferimento all'analisi dell'input penna