Método IInkAnalyzer::AddStrokesForLanguage

Artículo
06/13/2023

Agrega datos de trazo para varios trazos al IInkAnalyzer y asigna el identificador de referencia cultural especificado a los trazos.

Sintaxis

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
);

Parámetros

ulStrokeIdsCount [in]: Número de trazos que se van a agregar.
plIdofStrokesToAdd [in]: Matriz que contiene los identificadores de trazo.
lStrokesLCID [in]: Valor que representa el identificador de referencia cultural que se va a asignar a los trazos.
ulStrokePacketDescriptionCount [in]: Número de propiedades de cada paquete.
pStrokePacketDescriptionGuids [in]: Matriz que contiene los identificadores de propiedad de paquete.
pulPacketDataCountPerStroke [in]: Matriz que contiene el número de paquetes de cada trazo.
plStrokePacketData [in]: Matriz que contiene los datos de paquete de los trazos.
ppContextNodeStrokeAddedTo [out]: IContextNode al que el analizador de lápiz agregó los trazos.

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 los trazos 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 y métodos IContextNode::GetSubNodes ).

IInkAnalyzer asigna el identificador de referencia cultural lStrokeLCID a los trazos y agrega los trazos al primer nodo de contexto UnclassifiedInk bajo 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 los trazos al nuevo nodo de contexto UnclassifiedInk.

plStrokePacketData contiene datos de paquetes para todos los trazos. pStrokePacketDescriptionGuids contiene los identificadores únicos globales (GUID) que describen los tipos de datos de paquetes incluidos para cada punto de cada trazo. Para obtener una lista completa de las propiedades de paquete disponibles, vea PacketPropertyGuids Constants.

Nota

Solo se pueden agregar trazos con las mismas descripciones de paquetes en una sola llamada a IInkAnalyzer::AddStrokes (Método).

Este método expande la región desfasada a la unión del valor actual de la región y el cuadro de límite de los trazos agregados.

Si el IInkAnalyzer ya contiene un trazo con el mismo identificador que uno de los trazos que se van a agregar, 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	IACom.h (también requiere IACom_i.c)
Archivo DLL	IACom.dll

Consulte también

IInkAnalyzer
IInkAnalyzer::AddStroke (Método)
IInkAnalyzer::AddStrokeForLanguage (Método)
IInkAnalyzer::AddStrokes (Método)
IInkAnalyzer::RemoveStroke (Método)
IInkAnalyzer::RemoveStrokes (Método)
Referencia de análisis de entrada de lápiz

Compartir a través de