Metodo IInkAnalyzer::AddStrokesForLanguage
Aggiunge i dati del tratto per più tratti a IInkAnalyzer e assegna l'identificatore delle impostazioni cultura specificato ai tratti.
Sintassi
HRESULT AddStrokesForLanguage(
[in] ULONG ulStrokeIdsCount,
[in] LONG *plIdofStrokesToAdd,
[in] LONG lStrokesLCID,
[in] ULONG ulStrokePacketDescriptionCount,
[in] GUID *pStrokePacketDescriptionGuids,
[in] ULONG *pulPacketDataCountPerStroke,
[in] LONG *plStrokePacketData,
[out] IContextNode **ppContextNodeStrokeAddedTo
);
Parametri
-
ulStrokeIdsCount [in]
-
Numero di tratti da aggiungere.
-
plIdofStrokesToAdd [in]
-
Matrice contenente gli identificatori del tratto.
-
lStrokesLCID [in]
-
Valore che rappresenta l'identificatore delle impostazioni cultura da assegnare ai tratti.
-
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.
-
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 UnclassifiedInk (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 lStrokeLCID ai tratti e aggiunge i tratti al primo nodo di contesto UnclassifiedInk nel nodo radice dell'analizzatore input penna che contiene tratti con lo stesso identificatore delle impostazioni cultura. Se l'analizzatore input penna non ha un nodo con lo stesso identificatore delle impostazioni cultura, crea un nuovo nodo di contesto UnclassifiedInk nel nodo radice e aggiunge i tratti al nuovo nodo di contesto UnclassifiedInk.
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::AddStrokes.
Questo metodo espande l'area dirty all'unione del valore corrente dell'area e al rettangolo di selezione dei tratti aggiunti.
Se IInkAnalyzer contiene già un tratto con lo stesso identificatore di uno dei tratti da aggiungere, IInkAnalyzer restituisce un valore HRESULT di E_INVALIDARG.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows XP Tablet PC Edition [solo app desktop] |
| Server minimo supportato |
Nessuno supportato |
| Intestazione |
|
| DLL |
|