Método IInkAnalyzer::AddStrokeForLanguage
Agrega datos de trazo para un solo trazo a IInkAnalyzer y asigna un identificador de referencia cultural específico al trazo.
Sintaxis
HRESULT AddStrokeForLanguage(
[in] LONG lStrokeId,
[in] LONG lStrokeLCID,
[in] ULONG ulStrokePacketDataCount,
[in] LONG *plStrokePacketData,
[in] ULONG ulStrokePacketDescriptionCount,
[in] GUID *pStrokePacketDescriptionGuids,
[out] IContextNode **ppContextNodeStrokeAddedTo
);
Parámetros
-
lStrokeId [in]
-
Identificador del trazo que se va a agregar.
-
lStrokeLCID [in]
-
Identificador de referencia cultural que se va a asignar al trazo.
-
ulStrokePacketDataCount [in]
-
Número de paquetes del trazo.
-
plStrokePacketData [in]
-
Matriz que contiene los datos del paquete para el trazo.
-
ulStrokePacketDescriptionCount [in]
-
Número de propiedades de cada paquete.
-
pStrokePacketDescriptionGuids [in]
-
Matriz que contiene los identificadores de propiedad de paquete.
-
ppContextNodeStrokeAddedTo [out]
-
Puntero cuyo valor se establece en el puntero del IContextNode que contiene el trazo recién agregado.
Valor devuelto
Para obtener una descripción de los valores devueltos, vea Clases e interfaces : análisis de entrada de lápiz.
Observaciones
Precaución
Para evitar una pérdida de memoria, llame a IUnknown::Release en ppContextNodeStrokeAddedTo cuando ya no necesite usar el objeto .
Cuando ppContextNodeStrokeAddedTo es NULL, indica que el autor de la llamada no está interesado en el valor devuelto del método .
IInkAnalyzer agrega el trazo a un IContextNode de tipo UnclassifiedInk (vea Tipos de nodo de contexto). Este nodo se encuentra en la colección de subnodos del nodo raíz (vea Método IInkAnalyzer::GetRootNode ymétodos IContextNode::GetSubNodes ).
IInkAnalyzer asigna el identificador de referencia cultural lStrokeLCID al trazo y agrega el trazo al primer nodo de contexto UnclassifiedInk en el nodo raíz del analizador de lápiz que contiene trazos con el mismo identificador de referencia cultural. Si el analizador de entrada de lápiz no tiene un nodo con el mismo identificador de referencia cultural, crea un nuevo nodo de contexto UnclassifiedInk en su nodo raíz y agrega el trazo al nuevo nodo de contexto UnclassifiedInk.
plStrokePacketData contiene datos de paquetes para todos los puntos del trazo. pStrokePacketDescriptionGuids contiene los identificadores únicos globales (GUID) que describen los tipos de datos de paquete incluidos para cada punto del trazo. Para obtener una lista completa de las propiedades de paquetes disponibles, consulte PacketPropertyGuids Constants.
Este método expande la región desfasada hasta la unión del valor actual de la región y el cuadro de límite del trazo agregado.
Si el IInkAnalyzer ya contiene un trazo con el mismo identificador de trazo, IInkAnalyzer devuelve un HRESULT de E_INVALIDARG.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows XP Tablet PC Edition [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
No se admite ninguno |
| Encabezado |
|
| Archivo DLL |
|