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.

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

Weitere Informationen

HitTest(Rectangle, Single)-Methode

IInkStrokeDisp-Schnittstelle

InkRectangle-Klasse