IInkStrokeDisp::Clip-Methode (msinkaut.h)

Entfernt Teile eines IInkStrokeDisp-Objekts oder einer InkStrokes-Auflistung , die sich außerhalb eines Rechtecks befinden.

Syntax

HRESULT Clip(
  [in] IInkRectangle *Rectangle
);

Parameter

[in] Rectangle

Gibt das Rechteck an, außerhalb dessen die Striche oder Striche abgeschnitten werden. Das Rechteck wird in Freihandraumkoordinaten angegeben.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_POINTER	Ein Parameter enthielt einen ungültigen Zeiger.
REGDB_CLASSNOTREG	Das InkDisp-Objekt ist nicht registriert.
E_INVALIDARG	Ungültiges Cliprechteck.
E_INK_EXCEPTION	Innerhalb der -Methode ist eine Ausnahme aufgetreten.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Bei einem InkDisp-Objekt werden alle vom Rechteck überschnittenen Striche an den Schnittpunkten geteilt. Alle Teile von Strichen außerhalb des Rechtecks werden aus dem InkDisp-Objekt entfernt. Die -Methode kann einem Strich an dem Punkt, an dem der Strich das Rechteck überschneidet, neue Punkte hinzufügen. Nachdem Sie die Clip-Methode für ein InkDisp-Objekt aufgerufen haben, sind die IDs der Striche in der Strichauflistung des InkDisp-Objekts garantiert eindeutig, aber nicht garantiert, dass sie andere Informationen beibehalten.

Bei dieser Methode wird die Stiftbreite beim Ausschneiden nicht berücksichtigt. Es klammert nur die tatsächlichen Freihand- oder Strichdaten ab.

Für ein IInkStrokeDisp-Objekt oder eine InkStrokes-Auflistung aktualisiert die Clip-Methode das übergeordnete InkDisp-Objekt . Wenn Freihand aus einem InkDisp-Objekt entfernt wird, werden alle für dieses InkDisp-Objekt definierten IInkStrokeDisp-Objekte oder InkStrokes-Auflistungen möglicherweise ungültig.

Weitere Informationen zu Freihanddaten finden Sie unter Freihanddaten.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	msinkaut.h
Bibliothek	InkObj.dll

Weitere Informationen

HitTest(Rectangle, Single)-Methode

IInkStrokeDisp-Schnittstelle

InkRectangle-Klasse