ITfHandwriting::RequestHandwritingForPointer-Methode (shellhandwriting.h)

Fordert an, dass der angegebene Zeiger und Freihandstrich für die Handschrift verwendet werden soll.

Syntax

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

Parameter

[in] pointerId

Der Zeigerbezeichner.

[in] handwritingStrokeId

Der Freihandstrichbezeichner.

Sie müssen GetHandwritingStrokeIdForPointer aufrufen, um die eindeutige ID des Strichs abzurufen, der von einer WM_POINTERDOWN-Nachricht gestartet wurde.

[out] requestAccepted

True, wenn die Anforderung akzeptiert wurde; andernfalls false.

[out] request

Ein Zeiger auf ein ITfHandwritingRequest-Objekt .

Rückgabewert

Wenn die Methode erfolgreich ist, gibt sie S_OK zurück. Wenn ein Fehler auftritt, wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Diese Methode kann nur aufgerufen werden, wenn der aktuelle Handschriftzustand für die Zeiger-ID auf TF_HANDWRITING_POINTERDELIVERY festgelegt ist oder TF_USE_POINTER_DELIVERY die Antwort auf einen Rückruf der Handschriftnäherung ist, andernfalls wird E_INVALIDARG zurückgegeben.

Diese Methode muss innerhalb von zwei Sekunden aufgerufen werden, nachdem eine WM_POINTERDOWN Nachricht für pointerId empfangen wurde. Wenn diese Methode innerhalb dieses Zeitraums von zwei Sekunden nicht aufgerufen wird, wird S_OK zurückgegeben, aber requestAccepted wird auf false festgelegt.

Anforderungen

Weitere Informationen

SetHandwritingState