Método ITfHandwriting::RequestHandwritingForPointer (shellhandwriting.h)

Solicita que el puntero y el trazo de lápiz especificados se usen para la experiencia de escritura a mano.

Sintaxis

HRESULT RequestHandwritingForPointer(
  [in]  UINT32                pointerId,
  [in]  UINT64                handwritingStrokeId,
  [out] BOOL                  *requestAccepted,
  [out] ITfHandwritingRequest **request
);

Parámetros

[in] pointerId

Identificador del puntero.

[in] handwritingStrokeId

Identificador de trazo de lápiz.

Debe llamar a GetHandwritingStrokeIdForPointer para recuperar el identificador único del trazo iniciado por un mensaje de WM_POINTERDOWN .

[out] requestAccepted

True, si se aceptó la solicitud; de lo contrario, false.

[out] request

Puntero a un objeto ITfHandwritingRequest .

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, devuelve un código de error HRESULT .

Comentarios

Solo se puede llamar a este método cuando el estado de escritura a mano actual del pointerId se establece en TF_HANDWRITING_POINTERDELIVERY o TF_USE_POINTER_DELIVERY es la respuesta a una devolución de llamada de proximidad de escritura a mano; de lo contrario, devolverá E_INVALIDARG.

Se debe llamar a este método en dos segundos después de recibir un mensaje de WM_POINTERDOWN para pointerId. Si no se llama a este método dentro de este segundo período de tiempo, se devuelve S_OK, pero requestAccepted se establecerá en false.

Requisitos

Consulte también

SetHandwritingState