IStrokeBuilder::EndStroke-Methode (rtscom.h)

Artikel
03/01/2024

Beendet einen Strich und gibt das Strichobjekt zurück.

Syntax

HRESULT EndStroke(
  [in]      TABLET_CONTEXT_ID tcid,
  [in]      STYLUS_ID         sid,
  [in, out] IInkStrokeDisp    **ppIInkStroke,
  [in, out] RECT              *pDirtyRect
);

Parameter

[in] tcid

Der Tablet-Kontextbezeichner.

[in] sid

Der Eingabestiftbezeichner.

[in, out] ppIInkStroke

Ein Zeiger auf den neuen Strich. Dieser Wert kann NULL sein.

[in, out] pDirtyRect

Das modifiziert oder geänderte Rechteck des Tablets. Dieser Wert kann NULL sein.

Rückgabewert

Eine Beschreibung der Rückgabewerte finden Sie unter RealTimeStylus-Klassen und -Schnittstellen..

Hinweise

Eine modifiziert Region beschreibt einen geänderten Tabletbereich.

Beispiele

Das folgende C++-Beispiel zeigt die Implementierung einer IStylusPlugin::StylusUp-Methode für ein IStylusPlugin Interface-Objekt . Das Plug-In verwendet ein StrokeBuilder-Objekt , um einen neuen Freihandstrich zu erstellen. Die IStrokeBuilder::EndStroke-Methode wird von der IStylusPlugin::StylusUp-Methode aufgerufen, um die Konstruktion des Strichs abzuschließen und sie dem Ink-Objekt der StrokeBuilder-Klasse hinzuzufügen.

STDMETHODIMP CStrokeBuilderPlugin::StylusUp( 
            /* [in] */ IRealTimeStylus *piRtsSrc,
            /* [in] */ const StylusInfo *pStylusInfo,
            /* [in] */ ULONG cPropCountPerPkt,
            /* [size_is][in] */ LONG *pPacket,
            /* [out][in] */ LONG **ppInOutPkt)
{
    // Finish the stroke. This adds the stroke to the StrokeBuilder's Ink object.
    return m_pStrokeBuilder->EndStroke(pStylusInfo->tcid, pStylusInfo->cid, &m_piStroke, NULL);
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	rtscom.h
DLL	RTSCom.dll