Metodo IInkAnalyzer::AddStrokeForLanguage
Aggiunge i dati del tratto per un singolo tratto a IInkAnalyzer e assegna un identificatore di impostazioni cultura specifico al tratto.
Sintassi
HRESULT AddStrokeForLanguage(
[in] LONG lStrokeId,
[in] LONG lStrokeLCID,
[in] ULONG ulStrokePacketDataCount,
[in] LONG *plStrokePacketData,
[in] ULONG ulStrokePacketDescriptionCount,
[in] GUID *pStrokePacketDescriptionGuids,
[out] IContextNode **ppContextNodeStrokeAddedTo
);
Parametri
-
lStrokeId [in]
-
Identificatore del tratto da aggiungere.
-
lStrokeLCID [in]
-
Identificatore delle impostazioni cultura da assegnare al tratto.
-
ulStrokePacketDataCount [in]
-
Numero di pacchetti nel tratto.
-
plStrokePacketData [in]
-
Matrice contenente i dati del pacchetto per il tratto.
-
ulStrokePacketDescriptionCount [in]
-
Numero di proprietà in ogni pacchetto.
-
pStrokePacketDescriptionGuids [in]
-
Matrice contenente gli identificatori di proprietà del pacchetto.
-
ppContextNodeStrokeAddedTo [out]
-
Puntatore il cui valore è impostato sul puntatore del nodo IContextNode che contiene il tratto appena aggiunto.
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 UnclassifiedInk (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 lStrokeLCID identificatore delle impostazioni cultura al tratto e aggiunge il tratto al primo nodo di contesto UnclassifiedInk nel nodo radice dell'analizzatore dell'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 il tratto al nuovo nodo di contesto UnclassifiedInk.
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 del 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.
Se IInkAnalyzer contiene già un tratto con lo stesso identificatore di tratto, 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 |
|