Método IInkAnalyzer::AddStrokeToCustomRecognizer
Agrega datos de trazo para un único trazo a un nodo de reconocedor personalizado.
Sintaxis
HRESULT AddStrokeToCustomRecognizer(
[in] ULONG ulStrokeId,
[in] ULONG ulStrokePacketDataCount,
[in] LONG *plStrokePacketData,
[in] ULONG ulStrokePacketDescriptionCount,
[in] GUID *pStrokePacketDescriptionGuids,
[in] IContextNode *pCustomRecognizer,
[out] IContextNode **ppContextNodeStrokeAddedTo
);
Parámetros
-
ulStrokeId [in]
-
Identificador del trazo que se va a agregar.
-
ulStrokePacketDataCount [in]
-
Número de paquetes del trazo.
-
plStrokePacketData [in]
-
Matriz que contiene los datos de paquete del trazo.
-
ulStrokePacketDescriptionCount [in]
-
Número de propiedades de paquete en cada paquete.
-
pStrokePacketDescriptionGuids [in]
-
Matriz que contiene los identificadores de propiedad de paquete.
-
pCustomRecognizer [in]
-
IContextNode de tipo CustomRecognizer al que se va a agregar el trazo.
-
ppContextNodeStrokeAddedTo [out]
-
IContextNode al que el analizador de lápiz agregó el trazo.
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 CustomRecognizer (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 del subproceso de entrada activo al trazo y agrega el trazo al primer nodo UnclassifiedInk bajo el nodo CustomRecognizer. Si no existe ningún nodo UnclassifiedInk , se crea. Si el IInkAnalysisRecognizer asociado al nodo CustomRecognizer no admite el identificador de referencia cultural, IInkAnalyzer continúa analizando y genera una advertencia de IAnalysisWarning . Esta advertencia tiene un valor AnalysisWarningCode de AnalysisWarningCode_LanguageIdNotRespected.
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 paquetes incluidos para cada punto de cada trazo. Para obtener una lista completa de las propiedades de paquete disponibles, vea PacketPropertyGuids Constants.
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 del trazo agregado.
IInkAnalyzer devuelve un HRESULT de E_INVALIDARG en las siguientes circunstancias.
- IInkAnalyzer ya contiene un trazo con el mismo identificador que el trazo que se va a agregar.
- El parámetro pCustomRecognizer contiene un nodo de reconocedor personalizado asociado a un objeto IInkAnalyzer diferente.
- El parámetro pCustomRecognizer contiene un IContextNode que no es del tipo CustomRecognizer.
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 |
|