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

Demande que le pointeur et le trait d’encre spécifiés soient utilisés pour l’expérience d’écriture manuscrite.

Syntaxe

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

Paramètres

[in] pointerId

Identificateur du pointeur.

[in] handwritingStrokeId

Identificateur du trait d’encre.

Vous devez appeler GetHandwritingStrokeIdForPointer pour récupérer l’ID unique du trait démarré par un message WM_POINTERDOWN .

[out] requestAccepted

True, si la demande a été acceptée ; sinon, false.

[out] request

Pointeur vers un objet ITfHandwritingRequest .

Valeur retournée

Si la méthode réussit, elle retourne S_OK. En cas d’échec, elle retourne un code d’erreur HRESULT .

Remarques

Cette méthode ne peut être appelée que lorsque l’état d’écriture manuscrite actuel de pointerId est défini sur TF_HANDWRITING_POINTERDELIVERY ou TF_USE_POINTER_DELIVERY est la réponse à un rappel de proximité d’écriture manuscrite, sinon elle retourne E_INVALIDARG.

Cette méthode doit être appelée dans les deux secondes suivant la réception d’un message WM_POINTERDOWN pour pointerId. Si cette méthode n’est pas appelée dans ce délai de deux secondes, S_OK est retourné, mais requestAccepted est défini sur false.

Configuration requise

Voir aussi

SetHandwritingState