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

Solicita que o ponteiro e o traço de tinta especificados sejam usados para a experiência de manuscrito.

Sintaxe

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

Parâmetros

[in] pointerId

O identificador de ponteiro.

[in] handwritingStrokeId

O identificador de traço de tinta.

Você deve chamar GetHandwritingStrokeIdForPointer para recuperar a ID exclusiva do traço iniciado por uma mensagem WM_POINTERDOWN .

[out] requestAccepted

True, se a solicitação foi aceita; caso contrário, false.

[out] request

Um ponteiro para um objeto ITfHandwritingRequest .

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Se falhar, retornará um código de erro HRESULT .

Comentários

Esse método só pode ser chamado quando o estado de manuscrito atual da pointerId é definido como TF_HANDWRITING_POINTERDELIVERY ou TF_USE_POINTER_DELIVERY é a resposta a um retorno de chamada de proximidade de manuscrito, caso contrário, retornará E_INVALIDARG.

Esse método deve ser chamado dentro de dois segundos após receber uma mensagem de WM_POINTERDOWN para pointerId. Se esse método não for chamado dentro desse segundo período, S_OK será retornado, mas requestAccepted será definido como false.

Requisitos

Cabeçalho	shellhandwriting.h

Confira também

SetHandwritingState