Metodo IInkAnalyzer::AddStrokesToCustomRecognizer
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 |
|
| DLL |
|